...

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

Installation

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:

• agent_install.xml (installer response file)
• install_agent.txt (installation hintsnotes)
• js7_agent_windows.<release>.jar (installer library for a given release)
• license.gpl (copy of  GPLv3 (General Public License) )
• license.txt, license.html (copy of JS7 JobScheduler Commercial License)
• setup.cmd (installer script)

Consider the following implications before running the installer:

• The installer can be run in graphical mode or in headless mode, see JS7 - Agent - Use of Unix/Windows Headless Installation.

• The installer asks for elevated administrative 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 Agent -port=<port>"
  • an executable file .\service\js7_agent_<port>.exe that is started by the Windows Service.

...

• Run the installer for the JS7 Agent using

  Code Block
  language bash title Windows command to run the installer GUI
  > C:\Temp\agent.<release>\setup.cmd

• The installer asks for administrative permissionsprivileges.  
• Select the language to be used for the setup: English and German are available.
  
  

...

License Options

• The License page window displays licenses available for the JS7 Agent.
  • The Open Source License GPLv3 (General Public License) is available.
  • The SOS Commercial License can be selected. When using this license then the license certificate file that you receive from SOS after purchase of a license is added when installing the Controller that forwards the license to the Agent. For details see JS7 - FAQ - How to apply a JS7 License Key.
    
    
    
    

...

• Add the HTTP port that is used by the JS7 Agent. Make sure that the HTTP port is available , i.e. and is not otherwise used. If you run other applications that use this port then choose a different port.
• If you specify a Windows Service account then make sure that this account has "Log on as service permissions". Consider that credentials that you enter to this window are stored in clear text with the installer response file. It is considered more secure not to add credentials with this step, but to add credentials directly with the Windows Service panel after installation.
  
  

...

• The resulting directory structure after installation includes (only files and folders immediately relevant):
  • agent 
    • bin
      • agent.cmd|sh
        • The Start Script for Windows/Unix platforms
      • agent_watchdog.cmd|sh
        • Restarts the Agent for Windows/Unix platforms
      • agent_instance.sh-example
        • The template for the Agent Instance Start Script
    • libThe lib (directory for Java libraries)
    • service (directory for serviceFor operation as a Windows Service)
    • var
      (configuration directory)
      
      • logs (logsThe directory for log files)
      • config/private (directory for configuration files)
        • For setting up HTTPS connections see JS7 - Agent Configuration Items
      • tmpThe tmp (directory for temporary files)
    • yade For use (directory of the YADE file transfer utility)
    • 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 Agent)

Updating the JS7 Agent

...