Page History

...

...

Required software

Download and install the following software:

...

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.
      
      

      rmdir apache-tomcat-89.50.31 21 /s /q
7z x <name of compressed file>
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-8.5.31\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