...
Before XperienCentral can be configured, the release has to be downloaded and unpacked. Perform the following steps to download and unpack XperienCentral. To unpack the XperienCentral release, unzip the ZIP-file to D:\XperienCentral\webmanager-mywebsite\
.
...
Placing the configuration.xml
...
<xperiencentral-root>\webmanager-mywebsite\webmanager-webapps\webmanager-backend-webapp\src\main\webapp\WEB-INF\siteworks\configuration.xml
...
Modifying the settings.xml
The XperienCentral configuration is set in settings.xml
. This file is located in the root of the unpacked XperienCentral release (D:\XperienCentral\webmanager-mywebsite\
). Settings.xml provides additional information about the most important properties that need to be modified in the settings.xml
.
...
Creating the Database(s)
XperienCentral data is stored in a relational database (MS SQL, MySQL, or Oracle). Create the databases desired for this installation. A complete XperienCentral installation requires only one database. In some cases for performance and/or security reasons, it is possible to save specific items in separate databases. A separate database can be created for the following components:
...
cd D:\GX-WebManager\webmanager-mywebsite mvn -s settings.xml -P create-mysql-db # If the content of JCR should be stored in another DB, then run: # mysqladmin create wm9mywebsite_jcr -u root -p
Actions for Oracle
...
Actions for MSSQL
cd D:\GX-WebManager\webmanager-mywebsite
mvn -s settings.xml -P create-mssql-db
# If the content of JCR should be stored in another DB, then
# create the DB using the Enterprise Manager
The default MySQL settings need to be adjusted to make it work smoothly with XperienCentral. Add the following properties and values to the the my.ini
file file. It is located at e.g g C:\ProgramData\MySQL\MySQL Server 5.7.
The initial contents of this file should be:
...
For MySQL versions 5.7 and higher, add the following to the the [mysqld]
section section:
Code Block | ||
---|---|---|
| ||
optimizer_switch = derived_merge=off |
...
Warning |
---|
Restart the MySQL service (Windows Task Manager > Services) whenever you modify the file |
...
Actions for Oracle
Use SQL Plus, for example, to create the database(s). Run the webmanager-oracle-scripts.sql
script located in the D:\XperienCentral\webmanager-mywebsite\webmanager-sqlscripts\
directory.
Actions for MSSQL
cd D:\GX-WebManager\webmanager-mywebsite
mvn -s settings.xml -P create-mssql-db
# If the content of JCR should be stored in another DB, then
# create the DB using the Enterprise Manager
...
Installing the XperienCentral Release
...
D:\XperienCentral\work\edition-bundles
...
Create the wm\b Folder
For the next action, create the folder D:\XperienCentral\wwwroot\mywebsite\wm\b
in IIS. It is important that an expiration date is set for files in this folder. Follow these steps to set the expiration time:
- Click on “edit.mywebsite.com”;
- Click on “wm”;
- Click on “b”;
- Double-click the “HTTP Response Headers” option;
- In the right panel, click the option “Set Common Headers”.
- Leave the "Enable HTTP keep-alive" selected.
- Enable the "Expire Web content" option and set the expiration time 10 minutes.
- Click [OK].
...
Make the Hostnames Resolvable
The server on which XperienCentral is installed needs to be able to resolve the hostnames that are used for the Edit environment and the external environment of XperienCentral. In this example the hostnames are “www.mywebsite.com” and “edit.mywebsite.com”. Add the hostnames to the file C:\WINDOWS\system32\drivers\etc\hosts
if the used hostnames don’t resolve to the correct IP address on the server.
...
Starting the Software
At this point all files are in place and are properly configured. The database and JCR have been initialized and configured. To run XperienCentral make sure that the database, Tomcat, and IIS are running. Make sure that these programs run automatically after a reboot of the server. To test this, reboot the server now and see if XperienCentral runs. To check whether XperienCentral is running properly you can monitor the Tomcat catalina.out
log file. You can also log in to the Setup Tool of XperienCentral. If no one has logged in before, the username/password is: Administrator/Administrator.
Note |
---|
eIf If XperienCentral receives a request for a page from the front-end frontend and/or backend during the startup sequence between the time that the log messages |
...
...
Deleting Folders with a New Deploy
...
Remove also the entire D:\XperienCentral\deploy\web
folder.
Supporting Drag to Scroll in Firefox
In the XperienCentral Editor, if you use the web browsers Internet Explorer and Chrome, you can drag an item to the bottom of the window and the content scrolls up, which allows you to drag the item below the visible area. Firefox does not natively support this browser feature, however, an add-on is available from Mozilla that adds this functionality. If your XperienCentral users want to use this feature in Firefox, you can download and install the add-on from the following URL: https://addons.mozilla.org/en-US/firefox/addon/drag-to-scroll-reloaded/.