Upgrading Snap Creator Server 4.0.x on UNIX-based systems

Download PDF of this page

You can upgrade directly from Snap Creator Server 4.0.x on UNIX-based systems.

  • If you have any user names that contain special characters in Snap Creator, you must have renamed those users using only alphabetic characters (a through z or A through Z).

  • You have stopped the Snap Creator processes before backing up the Snap Creator directories to ensure that the backed up data is complete.

    For example, enter the following commands:

    /install_path/scServer4.0.x/bin/scServer stop
    /install_path/scAgent4.0.x/bin/scAgent stop
  • You have backed up the following directories, and all associated subdirectories and files, within the Snap Creator 4.0.x Server engine subdirectory (/install_path/scServer4.0.x/engine):

    • Snap Creator database (../snapcreator)

    • Snap Creator Server properties (../etc)

    • Profiles and configuration (../configs)

    • Logs (../logs) Note: You must not have deleted the Snap Creator 4.0.x backup copies that you created.

The paths provided in the following steps refer to the default installation path. The paths in the commands below might differ from your installation path.

After the upgrade process is complete, you should consider the following issues:

  • If the Snap Creator database that is upgraded contains some tasks marked as "in progress," then the state remains the same even after the upgrade process is complete.

  • The default administrator in the latest Snap Creator must be an administrator in Snap Creator 4.0.x. If the 4.0.x user is not an administrator, then the upgrade assigns an operator role to the 4.0.x user.

    1. Stop the Snap Creator processes if you have not already done so.

      For information about stopping the processes, see the details provided earlier in this topic.

    2. Install the latest Snap Creator, but do not start the Snap Creator Server service.

      For details, see information about installing the Snap Creator Server on UNIX.

    3. Copy the backed up Snap Creator 4.0.x database directory to the latest location (/install_path/scServer4.1.x/engine/snapcreator).

    4. Copy the backed up 4.0.x profiles and configuration directory to the latest location (/install_path/scServer4.1.x/engine/configs).

    5. Copy the backed up 4.0.x logs directory to the latest location (/install_path/scServer4.1.x/engine/logs).

    6. Change directories to the engine subdirectory in the Snap Creator install path (/install_path/scServer4.1.x/engine).

    7. Upgrade Snap Creator by entering the following command: java -jar snapcreator.jar -upgrade

After the upgrade process is complete, start the Snap Creator Server service by entering the following command:

/install_path/scServer4.1.x/bin/scServer start

Also, delete the Snap Creator 4.0 installation directory.

Do not delete your backup copies until you are certain that you do not need to revert to an older version.

You must also validate the Snap Creator Framework GUI startup by navigating to the local host on the specified port (https://IP_address:gui_port).

You must connect using HTTPS; otherwise, the connection is not automatically redirected to an HTTPS connection and the GUI will not work.

Related information