Versions Compared

Key

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

...

  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 <name of compressed file> 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.

...