...

• 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 file .\service\js7_controller_<Controller ID>.exe that is started by the Windows service

• Run the installer dialog for the JS7 Controller using

  Code Block
  language bash title Windows command to open the installer GUI
  > C:\Temp\controller.x.x.x\setup.cmd

• The installer asks for elevated administrator permissions.  
• Select the language to be used for the setup: English and German are available.
  
  
  
  
  
• Click Next on the Welcome to the Installation screen
  
  
  
  
• The License Agreement shown in Step 2 of the installation must be accepted before installation can occur.
  
  
  
  
• The installer opens a GUI to specify the installation path after you accepted accept the terms of the license agreement.
  
  
  
  
• Add the HTTP port which can be used by the JS7 Controller. Make sure that the HTTP port is available, i.e. not otherwise used. If you run other applications that use this port then choose a different port.
• If you specify a service account then make sure that this account has "Log on as service rightspermissions".
  
  
  
  
• If you selected the installation path to be located in C:\Program Files then it is recommended to choose the log directory outside of the installation path, e.g. C:\ProgramData\sos-berlin.com\js7\controller\logs.
• The installer sets read/write permissions for the specified Windows service user but normally exclusively the administrator group should have write permissions for C:\Program Files.
  
  
  
  
• This step shows the progress of the first part of the installation procedure.
• Changes to the installation configuration can no longer be made once this step has was started.
  
  
  
  
• The Perform External Process shows the progress of the second part of the installation procedure.
  
  
  
  

  • The information shown in displayed with this step will be is written to the installation log file, which can is to be found in the JS7_CONTROLLER_DATA/logs folder.
    
    

• The last step of the installation shows a summary of the installation (success/error) and paths to relevant informationfiles.
  
  

  

• Note that if a problem occurs during installation a warning message will be

  shown here

  displayed and a link to the installation log file will be provided.

Updating the JS7 Controller

The update to the JS7 Controller is performed from the same download file archive as we use used for any fresh installation:

...

• Stop the JS7 Controller instance
• Prepare a to rollback in case that the updating update of 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.

...

The update using the GUI can be done by rerunning the installer (setup.cmd) file from the .zip archive and provide by providing the same parameters such as installation paths, ports etc.

...

• 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>]

...

• The default path of the logs directory for the Controller areis:
  
  • C:\ProgramData\sos-berlin.com\js7\controller/<Controller-ID> on Windows.
• Installation log files are named according to the pattern, Install_V[release]_[date&time]_....log where release is the version release number and date and time refer to the installation.

• For further references about the logging refer to the complete overview of log files JS7 - Logging

Further References

• JS7 - Controller - Command Line Operation