...

• First of all, you don't need to read this article in all its parts. For most situations it is sufficient to check the prerequisites, to download the software and to run the installer that will guide you.
• In this article you find the details about available installer options, updates and rollbacks rollback for interested parties.
• The Controller can be installed by use of the graphical installer, for headless installation see JS7 - Controller - Use of Linux/Windows Headless Installation.

Installing the JS7 Controller

Prerequisites

• Java Runtime Environment 1.8 or newer is required. For details see Which Java versions is JobScheduler available for?
• Technically the Controller can be operated for any Unix environment, however, the JS7 - Platforms include support for Controller operation with Linux.

Download

• Choose the Controller archive for Windows systems and the graphical installer from the JS7 - Download page.
• For Windows systems a .zip archive including the installer is available from js7_controller_windows_installer.<release>.zip.

Installing the JS7 Controller

Installation

Extract the downloaded archive to a directory, e.g. C:\Temp.

...

• The resulting directory structure after installation includes (only files and folders immediately relevant):
  • C:\Program Files\sos-berlin.com\js7\controller (installation directory)
    • license.gpl (copy of  GPLv3 (General Public License) )
    • license.html, license.txt (copy of JS7 JobScheduler Commercial License Agreement)
    • ThirdParty.txt (list of 3rd party components and licenses included with the JS7 Controller) 
    • bin
      • controller.cmd|sh
        • The Start Script for Windows/Unix platforms
      • controller_watchdog.cmd|sh
        • Restarts the Controller for Windows/Unix platforms.
      • environment_variables.cmd|sh
        • Environment Startup Script for the JS7 Controller
    • lib (directory for Java libraries)
    • service (directory for operation as a Windows Service)
      • amd64
      • manager
      • x86
      • install_controller_windows_service.cmd
      • js7_controller_<controller-id>.exe
      • js7_controller_<controller-id>w.exe
      • LICENSE.txt
      • NOTICE.txt
      • RELEASE-NOTES.txt
      • uninstall_controller_windows_service.cmd
    • user_bin
      • environment_variables.cmd|sh-example 
        • Sample configuration file to set individual environment variables. Drop the -example extension to activate this file.
    • Uninstaller (Uninstaller directory for Windows only, the empty directory remains in place after uninstall)
      
      • install.log
      • js7.ico
      • shortcut.vbs
      • uninstall.cmd
      • uninstall_prepare.cmd
      • uninstaller.jar
  • C:\ProgramData\sos-berlin.com\js7\controller (configuration directory)
    • var (data directory)
      
      • config (directory for configuration files)
        • controller.conf (general Controller configuration)
        • private (directory for security related configuration files)
          • private.conf-example (security related configuration)
            • For setting up HTTPS connections see JS7 - Controller Configuration Items
            • For setting up authentication and digital signature checks
      • logs (directory for log files)
      • state (directory for journal files)

Rollback

To perform a rollback on Windows systems follow the below steps:

• Run the JS7 Controller uninstaller.
  • The default location of the uninstall.cmd file is:
    
    • C:\Program Files\sos-berlin.com\js7\controller\<controller-id>\Uninstaller

Updating the JS7 Controller

...

The update using the graphical installer can be done by rerunning the installer setup.cmd file from the .zip archive and by providing the same parameters such as installation directory, port etc.

Rollback

To perform a rollback on Windows systems follow the below steps:

...