Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

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\.

 


Back to top 


...

Placing the configuration.xml

...

<xperiencentral-root>\webmanager-mywebsite\webmanager-webapps\webmanager-backend-webapp\src\main\webapp\WEB-INF\siteworks\configuration.xml

 


Back to top 


...

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.

Back to top 


...

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 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
themeEclipse
optimizer_switch = derived_merge=off

...



Warning

Restart the MySQL service (Windows Task Manager > Services) whenever you modify the file my.ini.

 

 

...


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






Back to top

 


...

Installing the XperienCentral Release

...

D:\XperienCentral\work\edition-bundles 


Back to top 


...

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:

  1. Click on “edit.mywebsite.com”;
  2. Click on “wm”;
  3. Click on “b”;
  4. Double-click the “HTTP Response Headers” option;
  5. In the right panel, click the option “Set Common Headers”.





  6. Leave the "Enable HTTP keep-alive" selected.
  7. Enable the "Expire Web content" option and set the expiration time 10 minutes.
  8. Click [OK].

 


Back to top 


...

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. 


Back to top 


...

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 Server startup in <x> ms and XperienCentral started successfully in <x> ms appear, the following message will appear in the browser:

...




 


Back to top 


...

Deleting Folders with a New Deploy

...

Remove also the entire D:\XperienCentral\deploy\web folder.

 



Back to top

 

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/.

 

Back to top