Versions Compared

Key

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

Table of Contents

Install and Update

Install

...

JOC Cockpit for Unix

Code Block
languagepowershell
titleExample for use of Installation Script
#!/usr/bin/env pwsh

./Install-JS7ControllerJS7Joc.ps1 `
    -InstanceId 1 `
    -User sos `
    -HomeDir "/opt/sos-berlin.com/js7/controllerjoc" `
    -Data "/var/sos-berlin.com/js7/controller/jobschedulerjoc" `
    -Tarball /mnt/releases/scheduler_setups/current/js7_controllerjoc_unix.2.5.2.tar.gz `
    -HttpPort 4446 `
    -ControllerId "jobschedulerTitle "Primary JOC Cockpit" `
    -DBMSConfig "/home/sos/hibernate.cfg.xml" `
    -HttpPort 4444JavaHome "/opt/java/jdk-11.0.2+9" `
    -PreserveEnv `
    -AsUser `
    -ExecStart StartService `
    -ExecStop StopService `
    -MakeService `
    -JavaHome "/opt/java/jdk-11.0.2+9" `
    -MakeDirs

# Installs the JOC ControllerCockpit from the given tarball for the current user account
# Operates the ControllerJOC Cockpit for HTTP port 44444446 running infor the currentindicated run-time user account
# Specifies a Hibernate configuration file for database access
# Specifies Java from the given location
# Creates the ControllerJOC Cockpit's systemd service

Install

...

JOC Cockpit for Windows

Install

...

JOC Cockpit for HTTP Connections

Code Block
languagepowershell
titleExample for use of Installation Script
./Install-JS7ControllerJS7Joc.ps1 `
    -InstanceId 1 `
    -HomeDir "C:\Program Files\sos-berlin.com\js7\controllerjoc" `
    -Data "C:\ProgramData\sos-berlin.com\js7\controller\jobschedulerjoc" `
    -Tarball /js7/downloads/"C:\js7\downloads\js7_controllerjoc_windows.2.5.2.zip `
    -HttpPort 4446 `
    -ControllerIdTitle "jobschedulerPrimary JOC Cockpit" `
     -HttpPort 4444DBMSConfig "C:\js7\hibernate.cfg.xml" `
     -ExecStart StartService `
    -ExecStop StopService `
    -MakeService `
     -ServiceCredentials ( New-Object -typename System.Management.Automation.PSCredential -ArgumentList '.\sos', ( 'sos' | ConvertTo-SecureString -AsPlainText -Force) ) `
    -MakeDirs
 
# Installs the JOC ControllerCockpit from the indicated .zip archive
# Creates the ControllerJOC Cockpit's Windows Service for the local account ".\sos" using the password "sos"
# There are alternative ways how to avoid passwords from being specified in plain text
# Specifies a Hibernate configuration file for database access
# Stops the ControllerJOC Cockpit's Windows Service before installation and starts the service after installation

Install

...

JOC Cockpit for HTTPS Connections

Code Block
languagepowershell
titleExample for use of Installation Script
./Install-JS7ControllerJS7Joc.ps1 `
    -HomeDir "C:\Program Files\sos-berlin.com\js7\controllerjoc" `
    -Data "C:\ProgramData\sos-berlin.com\js7\controller\jobschedulerjoc" `
    -Tarball "C:\js7\downloads\js7_controllerjoc_windows.2.5.2.zip" `
    -ControllerId "jobscheduler" `
    -HttpPort localhost:4444 `
    -HttpsPort 444434446 `
    -PrivateConfDBMSConfig "C:\js7\templates\private.conf-template-controller" `
    -JocPrimaryCert "C:\js7\certs\wintest-primary-joc.crthibernate.cfg.xml" `
    -Keystore "C:\js7\keys\https-keystore.pfx" `
    -KeystorePassword "jobscheduler"('jobscheduler' | ConvertTo-SecureString -AsPlainText -Force) `
    -KeyAlias "wintest-primary-controllerjoc" ` 
    -Truststore "C:\js7\certs\https-truststore.pfx" `
    -TruststorePassword "jobscheduler"('jobscheduler' | ConvertTo-SecureString -AsPlainText -Force) ` 
    -ExecStart StartService `
    -ExecStop StopService `
    -MakeService `
    -MakeDirs

# Installs the ControllerJOC Cockpit from the indicated tarball
# Does not Limitsoffer thean HTTP port to the localhost network interface, but makes the HTTPS port available for any network interfaces
# Applies a template file for SSL/TLS related settings that is automatically updated from arguments to the installation script
# Specifies the server certificate location of the JOC Cockpit instance that is used to manage the Controller
# Makes use of a keystore in PKCS12 format with the given alias name and password and a truststore respectively

Find an example for a private.conf template file for download: private.conf-template-controller

Patch

Patch

...

JOC Cockpit for Linux

Patch

...

JOC Cockpit from Download

Code Block
languagepowershell
titleExample for use of Installation Script
#!/usr/bin/env pwsh

./Install-JS7ControllerJS7Joc.ps1 `
    -HomeDir /opt/sos-berlin.com/js7/controllerjoc `
    -HttpPort 4444 `
    -Release 2.2.3 `
    -Patch JS-1984 `
    -Restart

# Patches the ControllerJOC Cockpit by downloading the indicated patch for the given release from the SOS Web Site
# Restarts the systemd service

Patch

...

JOC Cockpit from Tarball

Code Block
languagepowershell
titleExample for use of Installation Script
#!/usr/bin/env pwsh

./Install-JS7ControllerJS7Joc.ps1 `
    -HomeDir /opt/sos-berlin.com/js7/controllerjoc `
    -HttpPort 4444 `
    -Tarball  /tmp/js7_controllerjoc_unix.2.2.3.JS-1984.tar.gz `
    -Patch JS-1984 `
    -Restart

# Patches the ControllerJOC Cockpit from a previously downloaded patch tarball
# Restarts the systemd service

Patch

...

JOC Cockpit for Windows

Patch

...

JOC Cockpit from Download

Code Block
languagepowershell
titleExample for use of Installation Script
./Install-JS7ControllerJS7Joc.ps1 `
    -HomeDir "C:\Program Files\sos-berlin.com\js7\controllerjoc" `
    -HttpPort 4444Data "C:\ProgramData\sos-berlin.com\js7\joc" `
    -Release 2.2.3 `
    -Patch JS-1984 `
    -Restart

# Patches the ControllerJOC Cockpit by downloading the indicated patch for the given release from the SOS Web Site
# Restarts the ControllerJOC Cockpit's Windows Service to apply the patch

Patch

...

JOC Cockpit from .zip Archive

Code Block
languagepowershell
titleExample for use of Installation Script
./Install-JS7ControllerJS7CJoc.ps1 `
    -HomeDir "C:\Program Files\sos-berlin.com\js7\controllerjoc" `
    -HttpPort 4444Data "C:\ProgramData\sos-berlin.com\js7\joc" `
    -Tarball "C:/tmp/\js7\downloads\js7_controllerjoc_windows.2.2.3.JS-1984.zip" `
    -Patch JS-1984 `
    -Restart

# Patches the JOC ControllerCockpit using the previously downloaded .zip archive
# Restarts the JOC ControllerCockpit's Windows Service to apply the patch

Uninstall

Uninstall

...

JOC Cockpit for Linux

Code Block
languagepowershell
titleExample for use of Installation Script
#!/usr/bin/env pwsh

./Install-JS7ControllerJS7Joc.ps1 `
    -HomeDir "/opt/sos-berlin.com/js7/controllerjoc" `
    -Data "/var/sos-berlin.com/js7/`controller/jobscheduler" `
    -ControllerId "jobscheduler" `
    -HttpPort 4445joc" `
    -ExecStop "StopService" `
    -Uninstall

# UninstallsStops the Controller using systemd to stop the Controller service
# Removes the and removes the JOC Cockpit's systemd service
# Removes the home directory and data directory

Uninstall

...

JOC Cockpit for Windows

Code Block
languagepowershell
titleExample for use of Installation Script
./Install-JS7ControllerJS7Joc.ps1 `
    -HomeDir "C:\Program Files\sos-berlin.com\js7\controllerjoc" `
    -Data "C:\ProgramData\sos-berlin.com\js7\controller\jobscheduler" `
    -ControllerId "jobschedulerjoc" `
    -HttpPort 4445 `
    -StopTimeout 10 `
    -Uninstall

# Uninstalls the Controller waiting for a maximum of 10s for the Controller to terminate before aborting the Controller
# Stops and removes the ControllerJOC Cockpit's Windows Service
# Removes the home directory and data directory

...