Settings.xml
This topic explains how XperienCentral’s settings.xml
file should be modified to fit the XperienCentral installation. The settings.xml
file is located in the root of the XperienCentral installation (/vol/www/webmanager-mywebsite
) and can be modified with a text editor.
In This Topic
General Settings
Property |
|
Default value | externaldb-mssql |
New value | externaldb-mysql |
Explanation | Profiles can be defined in the settings.xml . The activeProfile property allows you to indicate which profiles are loaded when the settings.xml is read. Part of the data is not stored in the JCR but directly in a relational database. This property is used to indicate which database type should be used. |
Possible values |
|
Property | activeProfile |
Default value | jcr-standalone-derby |
New value | jcr-standalone-mysql |
Explanation | Various storage mechanisms can be selected to store data in the JCR. By default, data is stored in the Apache Derby database. |
Possible values | j |
Property | webmanager.project.basedir |
Default value | <xperiencentral-root>/yoursite |
New value | /vol/www/xperiencentral-mywebsite |
Explanation | This is the directory that contains the XperienCentral release. This directory is actually a temporary directory: After a successful build of XperienCentral, this directory is deleted. |
Property | webmanager.project.name |
Default value | Your site |
New value | This is the name of MyWebsite |
Property | webmanager.project.description |
Default value | Your site |
New value | This is the description of MyWebsite |
Property | webmanager.project.url |
Default value | http://www.yoursite.nl |
New value | http://www.mywebsite.com |
Property |
|
Default value | 8080 |
New value | 80 |
Explanation | This is the port number that allows access to the website in a browser. In a production environment, the Tomcat environment will only be available via the AJP protocol (in this sample installation on port 8009). The Apache web server catches the HTTP requests on port 80 and, if necessary, forwards them to XperienCentral which runs in Tomcat. The communication between the Apache web server and Tomcat runs via the AJP protocol (on port 8009). |
Property |
|
Default value | 127.0.0.1 |
New value | www.mywebsite.com |
Explanation | The name of the server that allows access to the external XperienCentral environment. This is the URL the website visitor will access. |
Property |
|
Default value | localhost |
New value | edit.mywebsite.com |
Explanation | The name of the server that allows access to the backend XperienCentral environment. All users use this address to log in to XperienCentral. |
Property |
|
Default value | localhost |
New value | edit.mywebsite.com |
Explanation | In XperienCentral, it is possible to access logs that analyze what happens on the website. The access to this log is limited to the user defined in this property. This user should also be defined in the admin-users.xml file. The address for accessing the log is http://www.mywebsite.com/web/admin/log . See also Log and Administrative Pages. |
Property |
|
Default value | CHANGEMECHANGEME |
New value | Enter a new password. |
Explanation | The password for the user wmadmin_user |
Property |
|
Default value | ${webmanager.project.basedir}/work |
New value | /vol/www/mywebsite/work |
Explanation | Temporary files and directories created while XperienCentral is running are located here. When XperienCentral is restarted, a number of these directories need to be deleted. These directories are listed in the rc scripts of Tomcat’s start/stop. |
Property |
|
Default value |
|
New value | /vol/www/mywebsite/web-docs |
Explanation | The location for all the static content (images and style sheets that determine the website’s design). |
Property |
|
Default value |
|
New value | no-backenddir |
Explanation | Contains a reference to the location of the XperienCentral application. Because the setup of the environment is based on .WAR files, this parameter can be disabled. This is done by entering the |
Property |
|
Default value | None |
New value | For Tomcat: leave it empty. For JBoss: set to: |
Explanation | Set the |
Property |
|
Default value |
|
New value |
|
Explanation | The reference to XperienCentral’s configuration file. Which license components are available for which host names is determined in this file. |
Property |
|
Default value |
|
New value |
|
Explanation | The reference to XperienCentral’s clean site. The clean site is a file that contains the default XperienCentral design. After the clean site is read, XperienCentral is ready. The clean site includes a channel, a home page, a workflow, users, etc. |
Property |
|
Default value |
|
New value |
|
Explanation | The |
Property |
|
Default value |
|
New value |
|
Explanation | This property contains the SMTP server used to send all outgoing e-mails. Example of e-mails sent by XperienCentral:
|
Property |
|
Default value |
|
Explanation | This property points to the files used by the Spring framework (see the file
|
Property |
|
Default value |
|
Explanation | This property points to the directory containing the XperienCentral plugins. |
Clustering Settings
Property |
|
Default value |
|
Explanation | In a clustered environment, XperienCentral uses a file store mechanism to copy files such as the contents of the GX Software strongly recommends that you use the File Distribution Service in dual read/write node clustered environment. If you do not use the File Distribution Service in a clustered environment, you must use another mechanism such as Robocopy or Rsync to synchronize files between the nodes in the cluster. |
Property |
|
Default value | None |
Explanation | In a clustered environment, each node must have a unique identifier. The best practice is to use the name of the server as the cluster ID so you can easily match the two together. |
Property |
|
Default value |
|
Explanation | In a clustered environment, you must define each node as either a read/write or read-only node. |
Database Settings
During the configuration of the general activeProfile
property, which profiles should be used for the database are indicated. This topic uses MySQL as a database, so only the MySQL-specific profiles (externaldb-mysql
and jcr-standalone-mysql
) are modified.
Property |
|
Default value |
|
New value | 127.0.0.1 |
Explanation | The host for the database. |
Property |
|
Default value |
|
New value | 3306 |
Explanation | The port number for the database. |
Property |
|
Default value |
|
New value | wm9mywebsite |
Explanation | The name of the database used for storing all external data. |
Property |
|
Default value |
|
New value | root |
Explanation | The name of the user who has database rights. |
Property |
|
Default value |
|
New value | myDBpassword |
Explanation | The database user's password. |
JCR Database Settings
Property |
|
Default value |
|
New value | 127.0.0.1 |
Explanation | The host name of the database. |
Property |
|
Default value |
|
New value | 3306 |
Explanation | The port number of the database. |
Property | webmanager.jcr.dbname |
Default value |
|
New value | wm9mywebsite |
Explanation | The name of the database where the JCR data is stored. |
Property | webmanager.jcr.dbuser |
Default value |
|
New value | root |
Explanation | The user who accesses the database. |
Property | webmanager.jcr.dbpassword |
Default value |
|
New value | myDBpassword |
Explanation | The database user's password. |