...

• Run the installer for the JS7 Agent using the following command:

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

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

...

• The resulting directory structure after installation includes (only files and folders immediately relevant):
  • agent 
    • .js7agentinstallinformation (binary insta
    • .version (release information)
    • agent_install.xml (installer response file used from previous installation)
    • license.gpl (copy of  GPLv3 (General Public License)  used for the Open Source JS7 - License)
    • license.html,  (HTML format of license terms for the commercial JS7 - License)
    • license.txt (copy of JS7 JobScheduler Commercial License Agreementplain text format of license terms for the commercial JS7 - License)
    • ThirdParty.txt (list of 3rd party components and licenses included with the JS7 Agentused by JS7)
    • var_<http-port> (symbolic link/junction to configuration directory)
    • bin
    • • agentanonymize-logs.cmd (used to anonymize log files, see JS7 - Log Anonymization)
      • agent.cmd (The Start Script)
      • agent_<http-port>.cmd The Agent (Instance Start Script.)
      • agent_credential_value.cmd |shThe script (Script for access to a credential storeCredential Store)
      • agent_watchdog.cmd
        • Restarts the Agent
        cmd (restarts the Agent if not operated as a Windows Service, called by Start Script)
    • lib (directory for Java libraries)
      • log4j2.xml (used for based console logging to stdout, see JS7 - Logging)
      • patches (used for JS7 - Patches for Agent, the directory is cleaned up when running the installer)
      • user_lib (used for individual .jar files such as JDBC Drivers, see JS7 - Database)
      • (additional directories for
      lib (directory for
      • Java libraries)
    • service (directory for operation as a Windows Service)
      • install_agent_windows_service.cmd (used by installer)
      • LICENSE.txt (copy of Apache License, Version 2.0)
      • NOTICE.txt (Apache Commons Daemon license notice)
      • RELEASE-NOTES.txt (Apache Commons Daemon release notes)
      • uninstall_agent_windows_service.cmd (used by uninstaller)
      • amd64
      • manager
      • x86
    • u
      • install.log (lists installed files)
      • js7.ico (uninstaller icon)
      • shortcut.vbs (creates shortcuts for the Windows start menu)
      • uninstall.cmd (used by uninstaller)
      • uninstall_prepare.cmd (used by uninstaller)
      • uninstaller.jar (used by uninstaller)
  • C:\ProgramData\sos-berlin.com\js7\agent (configuration directory)
  • • var_<http-port> (data directory)
      
      • config (directory for configuration files)
        • agent.conf (general Agent configuration, see JS7 - Agent Configuration Items) 
        • private (directory for security related configuration files)
          • private.conf-example  (security related configuration, see JS7 - Agent Configuration Items)
            • For setting up HTTPS connections see up JS7 - Agent HTTPS Connections
            • For setting up authentication and digital signature checks
          • trusted-pgp-keys (empty directory, can be used to add individual PGP public keys for signing, see JS7 - Secure Deployment)
          • trusted-x509-keys (directory to hold X.509 certificates for signing, see JS7 - Secure Deployment)
            • sos.intermediate-ca.pem (default certificate of SOS to allow deployment with JOC Cockpit)
      • logs (directory for log files)
      • state (directory for journal files)
      • work (directory for temporary files)
    • yade (directory of the YADE file transfer client)

...

• The default path of the logs directory for the Agent is:
  
  • C:\ProgramData\sos-berlin.com\js7\agent_<http-port> for Windows.
• Installation log files use names according to the pattern Install_V<release>_<date-time>_....log where <release> is the release number and <date-time> refers to the point in time of installation.
• For further information about logging see the JS7 - Logging article.

Automated

...

Start-up and Shutdown

It is recommended that on Windows systems an the Agent is operated as a Windows Service as such services can be configured to start/stop automatically on server startup start-up and shutdown.

• Consider assigning a service account to the JS7 Agent service with the Windows Service Panel.
• Consider allowing the JS7 Agent service to be automatically started on server startupstart-up.

Initial Operation

Having completed the installation or update of a JS7 Agent you can either start the Agent manually or from its Unix daemon/Windows Service - see the JS7 - Agent Command Line Operation article for details.

...