...
To use Tomcat, Java has to be installed. The Java Development Kit has to be installed before installing XperienCentral. The version made available by Oracle is used which is not the same version that comes with some Microsoft products. Use at least Java version 8 (official support for Java 7 ended in April 2015)11.
To install XperienCentral, Apache Maven is required. Apache Maven is used to build XperienCentral based on the system-specific settings in the settings.xml. Download the Maven ZIP file from http://maven.apache.org/. Download the latest release of version 3.6.xx (do not use the 4.x.xx versions of Maven). Unzip the ZIP-file into D:\Program Files\
. After unzipping, Maven will be installed in:
...
Note |
---|
If in the "System Properties" window the value is too long, the complete path is not visible. To see the complete values, the |
...
Anchor | ||||
---|---|---|---|---|
|
...
9.
...
0.
...
50
XperienCentral is written in Java and requires a servlet container to run. Apache Tomcat is such a servlet container in which XperienCentral can operate. XperienCentral has been tested with Apache Tomcat 89.50.3550. Follow the steps in this section to install and configure it.
...
Note |
---|
GX Software strongly recommends that if you are doing a clean install of a Tomcat installation that you use version 89.50.3550. |
Install Tomcat
Download Tomcat 89.50.35 50 from the link available at http://tomcat.apache.org/ (download the Windows Service Installer). Double-click the downloaded file and then follow the wizard to install Tomcat.
...
Start > All Programs > Apache Tomcat 89.50.35 50 > Monitor Tomcat
Navigate to the Start screen and then select “Monitor Tomcat”.
...
For debugging purposes, XperienCentral uses the authentication mechanism of Tomcat. The server.xml
contains a reference to the admin-users.xml
file in which one or more users are defined. Create the file D:\Program Files\Tomcat 89.50.3550\conf\admin-users.xml
and add the following lines to it:
...
Create the file D:\Program Files\Tomcat 89.50.3550\conf\context.xml
and add the following lines to it:
...
- Open the
D:\Program Files\Tomcat 89.50.3550\conf\logging.properties
file. - At the end of the file, add these lines:
...
Obtain a copy of the database driver from the /ext
folder of the XperienCentral installation. Copy the driver for your database to the directory D:\Program Files\Tomcat 89.50.3550\lib
. Use the following JAR files for the following databases:
- For MSSQL, copy
jtds-x.jar
toD:\Program Files\Tomcat 89.50.3550\lib
. - For Oracle, copy
oraclejdbcdriver-x.jar
toD:\Program Files\Tomcat 89.50.3550\lib
.
where x in the .jar files above is the version number of the database driver you are using.
In XperienCentral versions 10.19.1 and earlier, the mysql-connector-java driver was available in the SDK in the/ext
and/maven-repository
directories. This library has been removed from the 10.20.0 and later SDKs and must be manually downloaded and installed inD:\Program Files\Tomcat 89.50.3550\lib
.
ISAPI Redirector
After following all the steps in this part, the webserver (IIS) will receive all the requests for the website. If it’s a request for an image, the webserver can handle that request on its own and will return the image. If the request is for a page, IIS will request the page from XperienCentral (running inside Tomcat). The communication between IIS and Tomcat is handled by the ISAPI Redirector. The ISAPI Redirector can be downloaded from the Tomcat website (http://apache.mirror1.spango.com/tomcat/tomcat-connectors/jk/binaries/windows/).
...