Install and Update
Install Agent for Unix
Example for use of Installation Script
#!/usr/bin/env pwsh ./Install-JS7Agent.ps1 ` -HomeDir /opt/sos-berlin.com/js7/agent ` -Data /var/sos-berlin.com/js7/agent ` -Tarball /mnt/releases/scheduler_setups/current/js7_agent_unix.2.5.2.tar.gz ` -HttpPort 4445 ` -ExecStart StartService ` -ExecStop StopService ` -MakeService ` -JavaHome /opt/java/jdk-11.0.2+9 ` -MakeDirs # Install Agent and create systemd service # Specify Java from the given location # The Agent's Windows Service is created for the system account # The Agent's Windows Service is stopped and is started before and after installation
Install Agent for Windows
Install Agent for HTTP Connections
Example for use of Installation Script
./Install-JS7Agent.ps1 ` -HomeDir "C:\Program Files\sos-berlin.com\js7\agent" ` -Data "C:\ProgramData\sos-berlin.com\js7\agent_4445" ` -Tarball "C:\js7\downloads\js7_agent_windows.2.5.2.zip" ` -HttpPort 4445 ` -ExecStart StartService ` -ExecStop StopService ` -MakeService ` -ServiceCredentials ( New-Object -typename System.Management.Automation.PSCredential -ArgumentList '.\sos', ( 'sos' | ConvertTo-SecureString -AsPlainText -Force) ) ` -MakeDirs # Install Agent from the indicated tarball # The Agent's Windows Service is created for the local account ".\sos" using the password "sos" # There are alternative ways how to avoid passwords from being specified in plain text # The Agent's Windows Service is stopped and is started before and after installation
Install Agent for HTTPS Connections
Example for use of Installation Script
./Install-JS7Agent.ps1 ` -HomeDir "C:\Program Files\sos-berlin.com\js7\agent" ` -Data "C:\ProgramData\sos-berlin.com\js7\agent_4445" ` -Tarball "C:\js7\downloads\js7_agent_windows.2.5.2.zip" ` -HttpPort localhost:4445 ` -HttpsPort 4443 ` -PrivateConf "C:\js7\templates\private.conf-template-agent" ` -ControllerPrimaryCert "C:\js7\certs\demo.sos-berlin.com.crt" ` -Keystore "C:\js7\keys\https-keystore.pfx" ` -KeystorePassword "jobscheduler" ` -KeyAlias "centostest-primary" ` -Truststore "C:\js7\certs\https-truststore.pfx" ` -TruststorePassword "jobscheduler" ` -ExecStart StartService ` -ExecStop StopService ` -MakeService ` -MakeDirs # Install Agent from the indicated tarball # Limit the HTTP port to the localhost network interface, make the HTTPS port available for any network interfaces # Apply a template file for SSL/TLS related settings that is automatically updated from arguments to the installation script # Use a keystore in PKCS12 format with the given alias name and password and a truststore respectively
Patch
Patch Agent for Linux
Patch Agent from Download
Example for use of Installation Script
#!/usr/bin/env pwsh ./Install-JS7Agent.ps1 ` -HomeDir /opt/sos-berlin.com/js7/agent ` -HttpPort 4445 ` -Release 2.2.3 ` -Patch JS-1984 ` -Restart # Patch Agent by downloading the indicated Patch from the SOS Web Site # The systemd service is restarted
Patch Agent from Tarball
Example for use of Installation Script
#!/usr/bin/env pwsh ./Install-JS7Agent.ps1 ` -HomeDir /opt/sos-berlin.com/js7/agent ` -HttpPort 4445 ` -Tarball /tmp/js7_agent_unix.2.2.3.JS-1984.tar.gz ` -Patch JS-1984 ` -Restart # Patch Agent from a previously downloaded patch archive # The systemd service is restarted
Patch Agent for Windows
Patch Agent from Download
Example for use of Installation Script
./Install-JS7Agent.ps1 ` -HomeDir "C:\Program Files\sos-berlin.com\js7\agent" ` -HttpPort 4445 ` -Release 2.2.3 ` -Patch JS-1984 ` -Restart # Patch Agent by downloading the indicated Patch from the SOS Web Site # The Agent's Windows Service is restarted to apply the patch
Patch Agent from .zip Archive
Example for use of Installation Script
./Install-JS7Agent.ps1 ` -HomeDir "C:\Program Files\sos-berlin.com\js7\agent" ` -HttpPort 4445 ` -Tarball "C:/tmp/js7_agent_windows.2.2.3.JS-1984.zip" ` -Patch JS-1984 ` -Restart # Patch Agent using the previously downloaded archive # The Agent Windows Service is restarted to apply the patch
Uninstall
Uninstall Agent for Linux
Example for use of Installation Script
#!/usr/bin/env pwsh ./Install-JS7Agent.ps1 ` -HomeDir "/opt/sos-berlin.com/js7/agent" ` -Data "/var/sos-berlin.com/js7/agent" ` -HttpPort 4445 ` -ExecStop "StopService" ` -Uninstall # Uninstall Agent using systemd to stop the Agent service # The systemd service is removed # Home directory and data directory are removed during uninstallation
Uninstall Agent for Windows
Example for use of Installation Script
./Install-JS7Agent.ps1 ` -HomeDir "C:\Program Files\sos-berlin.com\js7\agent" ` -Data "C:\ProgramData\sos-berlin.com\js7\agent_4445" ` -HttpPort 4445 ` -StopTimeout 10 ` -Uninstall # Uninstall Agent waiting for a maximum of 10s for the Agent to terminate before aborting the Agent. # The Agent's Windows Service is stopped and removed # Home directory and data directory are removed during uninstallation
Overview
Content Tools