Versions Compared

Key

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

...

Preparation

  • Choose the Controller archive for the target system from the JobScheduler Download page.
    • For Windows systems a .zip archive is available.

Installation

  • Extract the downloaded archive js7_controller_windows_installer.x.x.x.zip to an arbitrary directory, e.g. C:\Temp.

  • The installer can run with or without a GUI.

  • The installer asks for elevated administrator privileges, therefore it is not necessary to change the permissions in the .\service directory and the installer sets read/write permissions for the log directory.
  • After the installation you will find ...
    • a Windows service "SOS JS7 Controller -id=<Controller ID>"
    • an executable .\service\js7_controller_<Controller ID>.exe that is started by the Windows service

...

  • js7_controller_windows.x.x.x.zip for windows
  • js7_agent_unix.x.x.x.tar.gz for Linux

Preparation

  • Stop the JS7 Controller instance
  • Prepare a rollback in case the updating the JS7 Controller is not successful then a backup is necessary.
    • Create a .zip archive for the:
      • Installation Directory:
        • The default installation path for the Controller is C:\Program Files\sos-berlin.com\js7\controller\<controller-ID> on Windows.
      • Configuration Directory
        • The default configuration path for the Controller is C:\ProgramData\sos-berlin.com\js7\controller\<controller-ID> on Windows.
  • Take a Backup of the above archives created.

...

  • To perform JS7 Controller instance rollback run the uninstaller.
    • The default location of the uninstall.cmd file is:
      • C:\Program Files\sos-berlin.com\js7\controller\<controller-ID>\Uninstaller on Windows.
  • Restore the folders from the backup by unzipping the .tar.gz/.zip archive for the installation directory and configuration directory to the respective location.
  • Re-Install the windows service from the command line:
    • Switch to the ./bin directory for the Controller from the command line
      • The default location of the ./bin directory is:
        • C:\Program Files\sos-berlin.com\js7\controller\<controller-ID>\bin on Windows.

    • Run the below command. This command installs the Controller's Windows Service. 

      controller.cmd install-service [-http-port=<number>] [-ip-address=<hostname or ip address>]

Installation Log

The installer creates a log file in the directory that is pointed to by the environment variable JS7_CONTROLLER_LOGS or in the logs subdirectory of the Controller configuration directory.

...