Content Comparison

...

...

Required

...

Software

Download and install the following software:

• Download and install the latest version of Apache Maven
• Java — See the Hardware and Software Requirements for what the supported Java version(s) are for the version of XperienCentral you plan to use.
• 7zip (Optional - Windows Explorer is able to read and unpack ZIP files since Windows 10)
• Node.js (Only required when building/installing XperienCentral from the source code)
• NPM (Only required when building/installing XperienCentral R45 and higher)

Install one of the following databases:

• MSSQL database Express edition (latest version)
• MySQL 5.7 — See the Hardware and Software Requirements for what the supported database version(s) are for the version of XperienCentral you plan to use. Perform the configuration steps described in Preparing XperienCentral#CreatingtheDatabase(s)
  • I noticed the following issue when trying to install MySQL 5.7.44 (included MySQL installer 1.6.8.0) and didn't solve it (moved to mssql)
  • https://dba.stackexchange.com/questions/340192/failure-to-initialise-mysql-server-5-7-due-to-mysqlx-port-0-0
• Oracle 12 — See the Hardware and Software Requirements for what the supported database version(s) are for the version of XperienCentral you plan to use. Perform the configuration steps described in Preparing XperienCentral#CreatingtheDatabase(s)7zip
  
  

Back to Top

...

Check the System Settings

...

1. Open the System properties of your PC.
2. Select the [Advanced] tab.
3. Click the button [Environment variables].
4. Ensure that the variable JAVA_HOME exists under system variables and/or user variables.
5. If the JAVA_HOME variable is not present, click the top [New] button and enter JAVA_HOME as the name and then add the path to Java (C:\GX\Java\jdkx.x.x_XX, for example).
6. Click the top [New] button and enter PATH as the name and enter the values for the following directories:
   1. JAVA\bin
   2. Apache Maven\bin
   3. 7zip
   (C:\GX\apache-maven-x.x.X\bin;C:\GX\Java\jdkx.x.x_XX\bin, for example).

Back to Top

...

Installing XperienCentral

...

1. Make sure one of the supported databases is installed. It is most easy to use MySQL or MSSQL.
2. Create a folder for the XperienCentral installation, for example C:\GX\XperienCentral\. This folder will be used as an example in all the instructions underneath.
3. Unzip the XperienCentral release zip file in this folder.
4. Open the settings.xml and modify it according to your local settings:

   1. At ActiveProfiles, change the externaldb profile and the jcr-standalone .  When you use MSSQL the defaults can be used. For MYSQL change this to externaldb-mysql and jcr-standalone-mysql. Do the same for Oracle.

   2. Change the webmanager.project.basedir to (C:\GX\XperienCentral, in this example).
      
      

      Note
      You must use either forward slashes in the pathname or double backslashes (C:/GX/XperienCentral-mywebsite or C:\\XperienCentral/XperienCentral-mywebsite).

      
      
      

   3. Check the properties beneath the header <!-- webapp settings -->. By default don't change them.
   4. Check the database settings and adjust the following properties for externaldb and jcr-standalone.:
      1. dbport
      2. dbuser  
      3. dbpassword
      4. Optional: dbname  

   5. Change localRepository from a relative path to an absolute path.
      
      

5. Create a file named cleaninstall.bat in the root of XperienCentral release folder C:\GX\XperienCentral and add the following commands:
   1. The command to create-mssql-db , should be replaced when using MySqL or Oracle.
   2. The version number of Apache Tomcat should be changed depending on the version that is included in the SDK.
      
      

      rmdir apache-tomcat-9.0.21 /s /q
7z x ext\apache-tomcat-9.0.21-windows-x64.zip
rmdir /Q /S C:\GX\XperienCentral\work\
call mvn -s settings.xml -P build-project
call mvn -s settings.xml -P create-mssql-db
call mvn -s settings.xml -P configure-jcr-repository
      call mvn -s settings.xml -P configure-tomcat
      pause
      
      

6. Reboot your PC to make sure the environment variables are set and the database is started. 
7. Double-click C:\GX\XperienCentral\cleaninstall.bat (XperienCentral is now built) and follow the progress, you can adjust the Command Prompt properties to have more Screen size and buffer.
8. You should see four "Build Success" messages in the Command prompt. Wait for the message Press a key… to appear -  XperienCentral is now successfully installed.
   
   

Back to Top

...

Start and Stop XperienCentral

...

See Logging in to XperienCentral for complete information on logging in.

Back to Top

...

Resetting the Whole Installation

...

1. Stop Tomcat, .\apache-tomcat-9.0.58\bin\shutdown.bat 
2. Double-click C:\GX\XperienCentral\cleaninstall.bat.

Back to Top

...

Uninstalling XperienCentral

...

1. Remove the folder C:\GX\XperienCentral (if you want to remove all your installations of XperienCentral plus additional software, you can also remove the complete C:\GX\ folder).
2. Remove the database that is being used by XperienCentral. Remove the database with the database administration that comes with the database software.

Back to Top