Versions Compared

Key

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

...

Code Block
languagepowershell
titleExample for use of Installation Script
Invoke-WebRequest `
    -Uri 'https://download.sos-berlin.com/JobScheduler.2.6/js7_agent_unix.2.6.0.tar.gz' `
    -Outfile /tmp/js7_agent_unix.2.6.0.tar.gz
 Invoke-WebRequest `
    -Uri 'https://download.sos-berlin.com/JobScheduler.2.6/js7-license.jar' `
    -Outfile /tmp/js7-license.jar
 
./Install-JS7Agent.ps1 `
    -Tarball /tmp/js7_agent_unix.2.6.0.tar.gz `
    -HomeDir /home/sos/agent `
    -ControllerId controller `
    -AgentClusterId agent-cluster `
    -HttpPort localhost:4445 `
    -HttpsPort batch.example.com:4445 `
    -LicenseKey /home/sos/agent-deployment/example.pem `
    -License-bin /tmp/js7-license.jar `
    -PrivateConf /home/sos/agent-deployment/private.conf-template-agent `
    -ControllerPrimaryCert /home/sos/agent-deployment/centostest-primary.crt `
    -ControllerSecondaryCert /home/sos/agent-deployment/centostest-secondary.crt `
    -DirectorPrimaryCert /home/sos/agent-deployment/centostest-primary.crt `
    -DirectorSecondaryCert /home/sos/agent-deployment/centostest-secondary.crt `
    -Keystore /home/sos/agent-deployment/https-keystore.p12 `
    -KeystorePassword ('jobscheduler' | ConvertTo-SecureString -AsPlainText -Force) `
    -Truststore /home/sos/agent-deployment/https-truststore.p12 `
    -TruststorePassword ('jobscheduler' | ConvertTo-SecureString -AsPlainText -Force) ` 
    -ExecStart StartService `
    -ExecStop StopService `
    -MakeService `
    -Active `
    -MakeDirs

# downloads the release tarball from the SOS Web Site using curlInvoke-WebRequest
# downloads the binary file for licensed code to enable cluster operations
# extracts the release tarball to the Agent's home directory
# specifies the Controller ID of the Controller to which the Agent is dedicated
# specifies the Agent Cluster ID
# specifies HTTP port 4445 on the localhost network interface and the same HTTPS port on the server network interface
# specifies the paths to the Primary and Secondary Controller's server certificates if a Controller Cluster is used
#     for a Standalone Controller the --controller-secondary-cert argument is omitted
# specifies the paths to the Primary and Secondary Director Agent's server certificates if an Agent Cluster is used
#     for a Standalone Director Agent the -DirectorSecondaryCert argument is omitted
# deploys the Agent private configuration file which holds references to keystore and truststore
# deploys keystore and truststore files
# makes the Agent the active Director Agent in an Agent Cluster
# stops and starts the Agent's systemd service

...

Code Block
languagepowershell
titleExample for use of Installation Script
./Install-JS7Agent.ps1 `
    -HomeDir /home/sos/agent `
    -HttpPort 4445 `
    -ExecStop StopService `
    -NoInstall

# stops the Agent's systemd service should the Agent be running

Install Agent for Windows

...

Patch from Download

Code Block
languagepowershellbash
titleExample for use of Agent Installation Script
./Install-JS7Agent.ps1 `
     -Release 2.52.23 `
    -HomeDir "C:\Program Files\sos-berlin.com\js7\agent"Patch JS-1984 `
    -Data "C:\ProgramData\sos-berlin.com\js7\agent_4445"HomeDir /home/sos/agent `
    -HttpPortExecStart 4445StartService `
    -MakeDirsExecStop StopService
 
# downloads the releasepatch tarball from the SOS Web Site
# createsextracts the homepatch andtarball datato directoriesthe ifAgent's they doe not existhome directory
# extractsstores the patch tarballfiles to the Agent's home <home>/lib/patches sub-directory
# stops and operatesstarts the Agent's systemd service

Patch from Tarball

Code Block
languagebash
titleExample for use of Agent Installation Script
Invoke-WebRequest `
    -Uri 'https://download.sos-berlin.com/patches/2.2.3-patch/js7_agent.2.2.3-PATCH.JS-1984.tar.gz' `
    -Outfile /tmp/js7_agent.2.2.3-PATCH.JS-1984.tar.gz

./Install-JS7Agent.ps1 `
    -Tarball /tmp/js7_agent.2.2.3-PATCH.JS-1984.tar.gz `
    -Patch JS-1984 `
    -HomeDir /home/sos/agent `
    -ExecStart StartService `
    -ExecStop StopService

# downloads the patch tarball from the SOS Web Site using Invoke-WebRequest
# extracts the patch tarball to the Agent's home directory
# stores patch files to the Agent's <home>/lib/patches sub-directory
# stops and starts the Agent's systemd service

Patch from .jar File

Code Block
languagebash
titleExample for use of Agent Installation Script
Invoke-WebRequest `
    -Uri 'https://download.sos-berlin.com/patches/2.2.3-patch/js7_agent.2.2.3-PATCH.JS-1984.jar' \
    -Outfile /tmp/js7_agent.2.2.3-PATCH.JS-1984.jar

./Install-JS7Agent.ps1 `
    -PatchJar /tmp/js7_agent.2.2.3-PATCH.JS-1984.jar `
    -Patch JS-1984 `
    -HomeDir /home/sos/agent `
    -ExecStart StartService `
    -ExecStop StopService

# downloads the patch .jar file from the SOS Web Site using Invoke-WebRequest
# stores patch files to the Agent's <home>/lib/patches sub-directory
# stops and starts the Agent's systemd service

Install Agent for Windows

Install or Update from Download

Code Block
languagepowershell
titleExample for use of Installation Script
./Install-JS7Agent.ps1 `
    -Release 2.5.2 `
    -HomeDir "C:\Program Files\sos-berlin.com\js7\agent" `
    -Data "C:\ProgramData\sos-berlin.com\js7\agent_4445" `
    -HttpPort 4445 `
    -MakeDirs

# downloads the release tarball from the SOS Web Site
# creates the home and data directories if they doe not exist
# extracts the tarball to the Agent's home directory
# operates the Agent for HTTP for HTTP port 4445

Install or Update from .zip Archive

...

Patch

Patch Agent for Unix

Patch from Download

Code Block
languagepowershellbash
titleExample for use of Agent Installation Script
./Install-JS7Agent.ps1 `
     -Release 2.2.3 `
    -Patch JS-1984 `
     -HomeDir /home/sos/agent `
    -HttpPort 4445 `
    -ExecStart StartService `
    -ExecStop StopService
 
# downloads the patch tarball from the SOS Web Site
# downloadsextracts the patch tarball fromto the SOSAgent's Webhome Sitedirectory
# extractsstores the patch files to the Agent's <home>/lib/patches sub-directory
# stops and starts the Agent's systemd Serviceservice

Patch from Tarball

Code Block
languagepowershellbash
titleExample for use of Agent Installation Script
Invoke-WebRequest `
    -Uri 'https://download.sos-berlin.com/patches/JobScheduler2.2.23-patch/js7_agent_unix.2.2.3-PATCH.JS-1984.tar.gz' `
    -Outfile /tmp/js7_agent_unix.2.2.3-PATCH.JS-1984.tar.gz

./Install-JS7Agent.ps1 `
    -Tarball /tmp/js7_agent_unix.2.2.3-PATCH.JS-1984.tar.gz `
     -Patch JS-1984 `
     -HomeDir /home/sos/agent `
     -HttpPort 4445 `
    -ExecStart StartService `
    -ExecStop StopService

# downloads the patch tarball from the SOS Web Site using Invoke-WebRequest
# extracts the patch tarball to the Agent's home directory
# stores patch files to the Agent's <home>/lib/patches sub-directory
# stops and starts the Agent's systemd Serviceservice

Patch from .jar File

Code Block
languagepowershellbash
titleExample for use of Agent Installation Script
Invoke-WebRequest `
    -Uri 'https://download.sos-berlin.com/patches/JobScheduler2.2.2/patch-20220331-JS-1984-3-patch/js7_agent.2.2.3-PATCH.JS-1984.jar' `
    -Outfile /tmp/patch-20220331-JS-1984-js7_agent.2.2.3-PATCH.JS-1984.jar

./Install-JS7Agent.ps1 `
    -JarPatchJar /tmp/patch-20220331-JS-1984-js7_agent.2.2.3-PATCH.JS-1984.jar `
     -Patch JS-1984 `
     -HomeDir /home/sos/agent `
     -HttpPort 4445 ` 
     -ExecStart StartService `
    -ExecStop StopService

# downloads the patch .jar file from the SOS Web Site using Invoke-WebRequest
# stores the patch .jar filefiles to the Agent's <home>/lib/patches sub-directory
# stops and starts the Agent's systemd Serviceservice

Patch Agent for Windows

Patch from Download

Code Block
languagepowershell
titleExample for use of Installation Script
./Install-JS7Agent.ps1 `
    -Release 2.2.3 `
    -Patch JS-1984 `
    -HomeDir "C:\Program Files\sos-berlin.com\js7\agent" `
    -HttpPort 4445 `
    -ExecStart StartService `
    -ExecStop StopService

# downloads the patch tarball from the SOS Web Site
# extracts the patch files to the Agent's <home>\lib\patches sub-directory
# stops and starts the Agent's Windows service

Patch from

...

Tarball

Code Block
languagepowershell
titleExample for use of Installation Script
Invoke-WebRequest `
    -Uri 'https://download.sos-berlin.com/JobSchedulerpatches/2.2.23-patch/js7_agent_windows.2.2.3-PATCH.JS-1984.tar.zipgz' `
      -Outfile C:\tmp\js7_agent_windows.2.2.3-PATCH.JS-1984.ziptar.gz

./Install-JS7Agent.ps1 `
    -Tarball "C:\tmp\js7_agent_windows.2.2.3.JS-1984.zip" `
    -Patch JS-1984 `
    -HomeDir "C:\Program Files\sos-berlin.com\js7\agent" `
    -HttpPort 4445 `
    -ExecStart StartService `
    -ExecStop StopService 

# downloads the patch tarball from the SOS Web Site using Invoke-WebRequest
# extracts patch files to the Agent's <home>\lib\patches sub-directory
# stops and starts the Agent's Windows service

Patch from .jar File

Code Block
languagepowershell
titleExample for use of Installation Script
Invoke-WebRequest `
    -Uri 'https://download.sos-berlin.com/JobSchedulerpatches/2.2.2/patch-20220331-JS-1984-3-patch/js7_agent.2.2.3-PATCH.JS-1984.jar' `
      -Outfile C:\tmp\patch-20220331-JS-1984-js7_agent.2.2.3-PATCH.JS-1984.jar 

./Install-JS7Agent.ps1 `
    -Jar "C:\tmp\patch-20220331-JS-1984-js7_agent.2.2.3-PATCH.JS-1984.jar" `
    -Patch JS-1984 `
    -HomeDir "C:\Program Files\sos-berlin.com\js7\agent" `
    -HttpPort 4445 `
    -ExecStart StartService `
    -ExecStop StopService 

# downloads the patch .jar file from the SOS Web Site using Invoke-WebRequest
# stores the patch .jar file to the Agent's <home>\lib\patches sub-directory
# stops and starts the Agent's Windows service

...