Versions Compared

Key

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

...

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

  • After extraction of the .zip archive that includes the installer the directory structure includes:
    • controller_install.xml (installer response file)
    • install_controller.txt (installation hints)
    • js7_controller_windows.<release>.jar (installer for a given release)
    • license.txt, license.html (copy of JS7 JobScheduler Commercial License)
    • setup.cmd (installer script)
  • The installer can be run in graphical mode or in headless mode, see JS7 - Controller - Use of Linux/Windows Headless Installation.

  • The installer asks for elevated administrator privileges, therefore it is not required to change the permissions in the .\service directory and the installer sets read/write permissions for the .\logs 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.

Directory Structure

  • The resulting directory structure after installation includes (only files and folders immediately relevant):
    • C:\Program Files\sos-berlin.com\js7\controller (installation directory)
      • 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
        • The directory for Java libraries
      • service (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 -example extension to activate this file.
      • Uninstaller (Windows only, the empty directory remains in place after uninstall)
        • install.log
        • js7.ico
        • shortcut.vbs
        • uninstall.cmd
        • uninstall_prepare.cmd
        • uninstaller.jar
      • license.gpl (copy of  GPLv3 (General Public License) )
      • license.html, license.txt (copy of JS7 JobScheduler Commercial License)
      • ThirdParty.txt (list of 3rd party components and licenses included with Controller)
    • C:\ProgramData\sos-berlin.com\js7\controller (configuration directory)varlogs (directory for log files)
    • config (directory for configuration files)
    • state (directory for Controller journal files)

Start Installer

  • Run the installer for the JS7 Controller using

    Code Block
    languagebash
    titleWindows command to run the graphical installer
    > C:\Temp\controller.<release>\setup.cmd
  • The installer asks for administrative permissions.  
  • Select the language to be used for the setup: English and German are available.

...

  • Note that if a problem occurs during installation a warning will be displayed and a link to the installation log file will be provided.

  • A failed installation can be repeated at any time, no uninstallation is required.

Directory Structure

  • The resulting directory structure after installation includes (only files and folders immediately relevant):
    • C:\Program Files\sos-berlin.com\js7\controller (installation directory)
      • 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
        • The directory for Java libraries
      • service (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 -example extension to activate this file.
      • Uninstaller (Windows only, the empty directory remains in place after uninstall)
        • install.log
        • js7.ico
        • shortcut.vbs
        • uninstall.cmd
        • uninstall_prepare.cmd
        • uninstaller.jar
      • license.gpl (copy of  GPLv3 (General Public License) )
      • license.html, license.txt (copy of JS7 JobScheduler Commercial License)
      • ThirdParty.txt (list of 3rd party components and licenses included with Controller)
    • C:\ProgramData\sos-berlin.com\js7\controller (configuration directory)
      • var
        • logs (directory for log files)
        • config (directory for configuration files)
        • state (directory for Controller journal files)

Updating the JS7 Controller

...