Skip to main content
Snap Creator Framework

Upgrading the Snap Creator Agent 4.0.x on UNIX


You can upgrade directly from Snap Creator Agent 4.0.x on UNIX.

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

    For example, enter the following command:

    /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 Agent directory (/install_path/scAgent4.0.x):

    • agent.conf file (../config/agent.conf)

    • Logs directory, if enabled (../logs)

    • Plug-ins directory (../plugins)

Snap Creator Agent in versions prior to 4.1 used a file named agent.conf to list commands outside of Snap Creator that might be executed on Snap Creator Agent. In 4.1, the allowed_commands.config file is used.

Similarly, the agent.conf file listed hosts that Snap Creator Agent was allowed to communicate with. By default, Snap Creator Agent allowed communications with all Snap Creator Servers. However, if you chose to use this feature in previous versions of Snap Creator, the AUTHORIZED_HOSTS parameter in the file replaces that feature.

Note If you did not use these parameters, a simple installation of the new agent is all that is required.

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.

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

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

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

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

  3. Open the backed up copy of the agent.conf file in a text editor.

    The following is an example of the agent.conf file:

    host: scServer@Lyon
    command: rc_domino
  4. Open the new allowed_commands.config file (/install_path/scAgent4.1.x/etc/allowed_commands.config) in a text editor and copy the command line from agent.conf to the allowed_commands.config file; however, due to the enhanced security in the latest Snap Creator, make sure that the command is fully qualified.

    From the previous example, the allowed_commands.config file should contain the following:

    command: /etc/init.d/rc_domino
    Note If the command contains any spaces, then you must encapsulate the command within quotation marks.

    You can add commands as needed, with each command on a separate line.

    Save and close the file after making changes.

  5. Open the file (/install_path/scAgent4.1.x/etc/ in a text editor and change the default entry of AUTHORIZED_HOSTS=* to reflect the host setting in the agent.conf file.

    From the previous example, the AUTHORIZED_HOSTS parameter should contain the following:


    Hosts can be added as needed, using commas to separate host names. Both host names and IP addresses are supported:

    AUTHORIZED_HOSTS=Lyon,, Fuji01

    Save and close the file after making changes.

  6. Start Snap Creator Agent by entering the following command:

    /install_path/scAgent4.1.x/bin/scAgent start
    Note Any changes to the allowed_commands.config or files require restarting the Snap Creator Agent if it is running when the changes are made.

Related information