Upgrading an Installation

     Note: Before performing an upgrade to an existing installation, ensure all sessions are stopped and perform a backup of your repository.

     Note: These instructions apply when upgrading from one version to the immediately subsequent release only (e.g. from 1.1 to 1.2). If you are performing an upgrade from any older version, please consult your release notes or contact 1Spatial Support.

Upgrade an Installation

Upgrading an installation consists of unpacking your new release folder, copying across your existing settings files, and editing the Java location in your interface and engine component files.

     Note: The following instructions use an example where currently version 1.A is installed, and we want to upgrade to 1.B. We have used C:\1Spatial as a directory within which to store our installation package files, organised into C:\1Spatial\Product-1.A and C:\1Spatial\Product-1.B.

  1. Unzip your new Release Package, and the 1Integrate folder within it.

  2. Copy the following properties files from the SETTINGS folder in your existing installation directory (e.g. C:\Program Files\[1Integrate_Directory]\SETTINGS, into the SETTINGS folder in your new installation directory:
    • settings.properties
    • roles.properties
    • users.properties

  3. Copy any custom extensions such as built-ins or data stores (.jar files) from your existing EXTENSIONS directory into the corresponding EXTENSIONS folder within your new installation directory. If you have previously defined a directory containing custom extensions, ensure the 1integrate.extension.dir parameter in your new settings.properties file points to the correct location.

  4. Before running your start-up scripts, you must first ensure your deployment is configured to refer to the correct version of Java. For the Java version supported for your release of 1Integrate, please refer to the release notes.

    JAVA_HOME

    Once you are sure you have the correct version of Java installed, you will need to ensure that the JAVA_HOME environment variable points to this for the user running 1Integrate.

         Note: If the JAVA_HOME variable is already defined on your system with the correct version of Java, then you do not need to do anything.

    If the JAVA_HOME environment variable is not set, you have the following options:

    • Set the JAVA_HOME environment variable for the user running 1Integrate to point to the correct version of Java.

    • Follow the steps below for Windows and Linux to set JAVA_HOME from the 1Integrate start-up script.

    To set the JAVA_HOME environment variable in the start-up scripts, carry out the following steps:

    ClosedWindows

    1. Edit start-Interface.cmd and start-Engine.cmd.

    2. Locate the following lines:

      3. @REM Optionally uncomment and set this path to be the correct for your environment
REM SET "JAVA_HOME=C:\PROGRA~1\Java\[jdk_version]

    3. Uncomment the second line by removing "REM", so that it begins with "SET". Ensure that it is pointing to the location of Java home for the correct version of Java installed as part of the pre-requisites. The resulting line should appear as follows:

      SET "JAVA_HOME=C:\PROGRA~1\Java\[jdk_version]"

    4. Once configured, run the scripts to start the 1Integrate components.

    ClosedLinux

    1. Edit start-Interface.sh and start-Engine.sh.

    2. Uncomment the line just below “#Optionally uncomment and set this path to be the correct for your environment”:

      export JAVA_HOME="/opt/jdk"

    3. Once configured, run the scripts to start the 1Integrate components.

     Note: If you encounter any problems during the upgrade procedure, please see Uninstallation Troubleshooting or contact 1Spatial Support.