The documentation of the JOC Cockpit Installation Script is available from JS7 - PowerShell Installation Script - Install-JS7Joc.ps1.
Installation Scripts are available for download from from (verify signed scripts) JS7 - Download.
Considering the fact that PowerShell for Unix based environments misses support for sudo the JOC Cockpit Installation Script does not own directories to other user accounts. Therefore below examples do not make use of --home-owner and --data-owner arguments that are available from the Unix Shell version of the Installation Script with JS7 - JOC Cockpit - Unix Shell Installation Script - js7_install_joc.sh.

Install and Update

Install JOC Cockpit for Linux

...

Code Block

language	powershell
title	Example for use of Installation Script

./Install-JS7Joc.ps1 `
    -Release 2.5.2 `
    -HomeDir /home/sos/joc `
    -HttpPort 4446 `
    -DBMSConfig /home/sos/joc-deployment/hibernate.cfg.xml `
    -JavaHome /opt/java/jdk-1117.0.2+9 `
    -AsUser `
    -MakeDirs

# installs JOC Cockpit for the current user account
# requires that the user creates a hibernate.cfg.xml file for database access prior to installation
# specifies the Java home location
# downloads the JOC Cockpit release tarball from the SOS Web Site
# creates the home directory if it does not exist
# extracts the tarball and runs the JOC Cockpit installer
# operates JOC Cockpit for HTTP port 4446

...

Code Block

language	powershell
title	Example for use of Installation Script

Invoke-WebRequest `
    -Uri 'https://repo1.maven.org/maven2/com/h2database/h2/1.4.200/h2-1.4.200.jar' `
    -Outfile /tmp/h2-1.4.200.jar

./Install-JS7Joc.ps1 `
    -Release 2.5.2 `
    -HomeDir /home/sos/joc `
    -HttpPort 4446 `
    -DBMSConfig H2 `
    -DBMSDriver /tmp/h2-1.4.200.jar `
    -JavaHome /opt/java/jdk-1117.0.2+9 `
    -AsUser `
    -MakeDirs

# downloads the H2 embedded database from Maven Central using Invoke-WebRequest
# downloads the JOC Cockpit release tarball from the SOS Web Site
# specifies the built-in H2 configuration to be used and the location of the JDBC Driver .jar file
# specifies the Java home location
# creates the home directory if it does not exist
# extracts the tarball and runs the JOC Cockpit installer
# operates JOC Cockpit for HTTP port 4446

...

Code Block

language	powershell
title	Example for use of Installation Script

Invoke-WebRequest `
    -Uri 'https://download.sos-berlin.com/JobScheduler.2.5/js7_joc_linux.2.5.2.tar.gz' `
    -Outfile /tmp/js7_joc_linux.2.5.2.tar.gz

./Install-JS7Joc.ps1 `
    -Tarball /tmp/js7_joc_linux.2.5.2.tar.gz `
    -HomeDir /home/sos/joc `
    -HttpPort 4446 `
    -DBMSConfig /home/sos/joc-deployment/hibernate.cfg.xml `
    -JavaHome /opt/java/jdk-1117.0.2+9 `
    -AsUser `
    -MakeDirs

# downloads the H2JOC embeddedCockpit release databasetarball from Maventhe CentralSOS usingWeb Invoke-WebRequestSite
# downloadsrequires that the user creates JOC Cockpit release tarball from the SOS Web Sitea hibernate.cfg.xml file for database access prior to installation
# specifies the Java home location
# creates the home directory if it does not exist
# extracts the tarball and runs the JOC Cockpit installer
# operates JOC Cockpit for HTTP port 4446

...

Code Block

language	powershell
title	Example for use of Installation Script

Invoke-WebRequest `
    -Uri 'https://download.sos-berlin.com/JobScheduler.2.5/js7_joc_linux.2.5.2.tar.gz' `
    -Outfile /tmp/js7_joc_linux.2.5.2.tar.gz

./Install-JS7Joc.ps1 `
    -Tarball /tmp/js7_joc_linux.2.5.2.tar.gz `
    -HomeDir /opt/sos-berlin.com/js7/joc `
    -Data /var/sos-berlin.com/js7/joc `
    -HttpPort 4446 `
    -DBMSConfig /home/sos/joc-deployment/hibernate.cfg.xml `
    -JavaHome /opt/java/jdk-1117.0.2+9 `
    -AsUser `
    -MakeDirs

# downloads the JOC Cockpit release tarball from the SOS Web Site using Invoke-WebRequest
# users might prefer to store configuration data and log data separately from the home directory
# installs JOC Cockpit for the current user account
# requires that the user creates a hibernate.cfg.xml file for database access prior to installation
# specifies the Java home location
# creates the home directory if it does not exist
# extracts the tarball and runs the JOC Cockpit installer
# operates JOC Cockpit for HTTP port 4446

...

Code Block

language	powershell
title	Example for use of Installation Script

./Install-JS7Joc.ps1 `
    -Releae 2.5.2 `
    -HomeDir /home/sos/joc `
    -HttpPort 4446 `
    -DBMSConfig /home/sos/joc-deployment/hibernate.cfg.xml `
    -LicenseKey /home/sos/joc-deployment/example.pem `
    -JavaHome /opt/java/jdk-1117.0.2+9 `
    -AsUser `
    -MakeDirs

# installs JOC Cockpit for the current user account
# requires that the user creates a hibernate.cfg.xml file for database access prior to installation
# specifies the location of the JS7 license key
# specifies the Java home location
# downloads the JOC Cockpit release tarball from the SOS Web Site
# creates the home directory if it does not exist
# extracts the tarball and runs the JOC Cockpit installer
# operates JOC Cockpit for HTTP port 4446

...

Code Block

language	powershell
title	Example for use of Installation Script

Invoke-WebRequest `
    -Uri 'https://download.sos-berlin.com/JobScheduler.2.5/js7_joc_linux.2.5.2.tar.gz' `
    -Outfile /tmp/js7_joc_linux.2.5.2.tar.gz
Invoke-WebRequest `
    -Uri 'https://download.sos-berlin.com/JobScheduler.2.5/js7-license.jar' `
    -Outfile /tmp/js7-license.jar

./Install-JS7Joc.ps1 `
    -Tarball /tmp/js7_joc_linux.2.5.2.tar.gz `
    -HomeDir /home/sos/joc `
    -HttpPort 4446 `
    -DBMSConfig /home/sos/joc-deployment/hibernate.cfg.xml `
    -LicenseKey /home/sos/joc-deployment/example.pem `
    -LicenseBin /tmp/js7_joc_linux.2.5.2.tar.gzlicense.jar `
    -JavaHome /opt/java/jdk-1117.0.2+9 `
    -AsUser `
    -MakeDirs

# downloads the JOC Cockpit release tarball from the SOS Web Site using Invoke-WebRequest
# downloads the binary file for licensed code to enable cluster operations using Invoke-WebRequest
# specifies the location of the JS7 license key and of the .jar file for licensed binary code
# specifies the Java home location
# creates the home directory if it does not exist
# extracts the tarball and runs the JOC Cockpit installer
# operates JOC Cockpit for HTTP port 4446

Install or Update Secondary JOC Cockpit

...

Instance for Cluster Operations

Code Block

language	powershell
title	Example for use of Installation Script

Invoke-WebRequest `
    -Uri 'https://download.sos-berlin.com/JobScheduler.2.5/js7_joc_linux.2.5.2.tar.gz' `
    -Outfile /tmp/js7_joc_linux.2.5.2.tar.gz
Invoke-WebRequest `
    -Uri 'https://download.sos-berlin.com/JobScheduler.2.5/js7-license.jar' `
    -Outfile /tmp/js7-license.jar

./Install-JS7Joc.ps1 `
    -Tarball /tmp/js7_joc_linux.2.5.2.tar.gz `
    -ClusterIdInstanceId joc1 `
    -InstanceIdTitle 1 `
    -Title "Secondary JOC "Secondary JOC Cockpit" `
    -HomeDir /home/sos/joc `  
    -HttpPort 4446 `
    -DBMSConfig /home/sos/joc-deployment/hibernate.cfg.xml `
    -LicenseKey /home/sos/joc-deployment/example.pem `
    -LicenseBin /tmp/js7_joc_linux.2.5.2.tar.gz-license.jar `
    -JavaHome /opt/java/jdk-1117.0.2+9 `
    -AsUser `
    -MakeDirs

# downloads the JOC Cockpit release tarball from the SOS Web Site using Invoke-WebRequest
# downloads the binary file for licensed code to enable cluster operations using Invoke-WebRequest
# specifies the Cluster ID that is the same for all JOC Cockpit instances in a cluster
# specifies the Instance ID that is a number between 0 and 99:
#   Instance IDs specify the ordering of JOC Cockpit icons in the Dashboard
#   the first JOC Cockpit started becomes the active node in a cluster independent from its Instance ID
# specifies the title that acts as a caption for JOC Cockpit icons in the Dashbaord
# specifies the location of the JS7 license key and of the .jar file for licensed binary code
# specifies the Java home location
# creates the home directory if it does not exist
# extracts the tarball and runs the JOC Cockpit installer
# operates JOC Cockpit for HTTP port 4446

...

Code Block

language	powershell
title	Example for use of Installation Script

Invoke-WebRequest `
    -Uri 'https://download.sos-berlin.com/JobScheduler.2.5/js7_joc_linux.2.5.2.tar.gz' `
    -Outfile /tmp/js7_joc_linux.2.5.2.tar.gz

./Install-JS7Joc.ps1 `
    -Tarball /tmp/js7_joc_linux.2.5.2.tar.gz `
    -ResponseDir /home/sos/joc-deployment/response `
    -HomeDir /home/sos/joc `
    -HttpPort 4446 `
    -JavaHome /opt/java/jdk-1117.0.2+9 `
    -AsUser `
    -MakeDirs

# downloads the JOC Cockpit release tarball from the SOS Web Site using Invoke-WebRequest
# specifies a response directory that holds
#    the joc_install.xml file for installation options such as the HTTP Port
#    the hibernate.cfg.xml configuration file for database access
# specifies the Java home location
# creates the home and data directories if they doe not exist
# extracts the tarball and runs the JOC Cockpit installer
# operates JOC Cockpit for HTTP port 4446

...

Code Block

language	powershell
title	Example for use of Installation Script

Invoke-WebRequest `
    -Uri 'https://download.sos-berlin.com/JobScheduler.2.5/js7_joc_linux.2.5.2.tar.gz' `
    -Outfile /tmp/js7_joc_linux.2.5.2.tar.gz

./Install-JS7Joc.ps1 `
    -Tarball /tmp/js7_joc_linux.2.5.2.tar.gz `
    -HomeDir /home/sos/joc `
    -HttpPort 4446 `
    -DBMSConfig /home/sos/joc-deployment/hibernate.cfg.xml `
    -JavaHome /opt/java/jdk-1117.0.2+9 `
    -ExecStart StartService `
    -ExecStop StopService `
    -MakeService `
    -AsUser `
    -MakeDirs

# downloads the JOC Cockpit release tarball from the SOS Web Site using Invoke-WebRequest
# creates the home directory if it does not exist
# extracts the tarball and runs the JOC Cockpit installer
# creates the JOC Cockpit's systemd service
# stops and starts the JOC Cockpit's systemd service
# operates JOC Cockpit for HTTP port 4446

...

Code Block

language	powershell
title	Example for use of Installation Script

Invoke-WebRequest `
    -Uri 'https://download.sos-berlin.com/JobScheduler.2.5/js7_joc_linux.2.5.2.tar.gz' `
    -Outfile /tmp/js7_joc_linux.2.5.2.tar.gz

./Install-JS7Joc.ps1 `
    -Tarball /tmp/js7_joc_linux.2.5.2.tar.gz `
    -HomeDir /home/sos/joc `
    -HttpPort 4446 `
    -DBMSConfig /home/sos/joc-deployment/hibernate.cfg.xml `
    -JavaHome /opt/java/jdk-1117.0.2+9 `
    -ExecStart "sudo systemctl start js7_joc" `
    -ExecStop "sudo systemctl start js7_joc" `
    -AsUser `
    -MakeDirs

# downloads the JOC Cockpit release tarball from the SOS Web Site using Invoke-WebRequest
# creates the home directory if it does not exist
# extracts the tarball and runs the JOC Cockpit installer
# stops and starts the JOC Cockpit by individual commands
# operates JOC Cockpit for HTTP port 4446

...

Code Block

language	powershell
title	Example for use of Installation Script

Invoke-WebRequest `
    -Uri 'https://download.sos-berlin.com/JobScheduler.2.5/js7_joc_linux.2.5.2.tar.gz' `
    -Outfile /tmp/js7_joc_linux.2.5.2.tar.gz

./Install-JS7Joc.ps1 `
    -Tarball /tmp/js7_joc_linux.2.5.2.tar.gz `
    -HomeDir /home/sos/joc `
    -HttpPort 4446 `
    -DBMSConfig /home/sos/joc-deployment/hibernate.cfg.xml `
    -JavaHome /opt/java/jdk-1117.0.2+9 `
    -ExecStart "/home/sos/joc/jetty/bin/jetty.sh stop" `
    -ExecStop "/home/sos/joc/jetty/bin/jetty.sh start" `
    -AsUser `
    -MakeDirs

# downloads the JOC Cockpit release tarball from the SOS Web Site using Invoke-WebRequest
# creates the home directory if it does not exist
# extracts the tarball and runs the JOC Cockpit installer
# stops and starts the JOC Cockpit by its instance start script <home>/jetty/bin/jetty.sh
# operates JOC Cockpit for HTTP port 4446

...

Code Block

language	powershell
title	Example for use of Installation Script

Invoke-WebRequest `
    -Uri 'https://download.sos-berlin.com/JobScheduler.2.5/js7_joc_linux.2.5.2.tar.gz' `
    -Outfile /tmp/js7_joc_linux.2.5.2.tar.gz

./Install-JS7Joc.ps1 `
    -Tarball /tmp/js7_joc_linux.2.5.2.tar.gz `
    -HomeDir /homeopt/sos-berlin.com/js7/joc `
    -Data /var/sos-berlin.com/js7/joc `  
    -HttpsPort 4446 `
    -DBMSConfig /home/sos/joc-deployment/hibernate.cfg.xml `
    -JavaHome /opt/java/jdk-1117.0.2+9 `
    -Keystore /home/sos/joc-deployment/https-keystore.p12 `
    -KeystorePassword ('jobscheduler' | ConvertTo-SecureString -AsPlainText -Force) `
    -Truststore /home/sos/joc-deployment/https-truststore.p12 `
    -TruststorePassword ('jobscheduler' | ConvertTo-SecureString -AsPlainText -Force) `
    -ExecStart StartService `
    -ExecStop StopService `
    -MakeService `
    -AsUser `
    -MakeDirs

# downloads the JOC Cockpit release tarball from the SOS Web Site using Invoke-WebRequest
# creates the home directory if it does not exist
# extracts the tarball and runs the JOC Cockpit installer
# deploys keystore and truststore files
# creates the systemd service
# stops and starts JOC Cockpit by its systemd service
# operates JOC Cockpit for HTTPS port 4446

...

Code Block

language	powershell
title	Example for use of Installation Script

./Install-JS7Joc.ps1 `
    -HomeDir /homeopt/sos-berlin.com/js7/joc `
    -Data /var/sos-berlin.com/js7/joc ` 
    -HttpsPort 4446 `
    -JavaHome /opt/java/jdk-1117.0.2+9 `
    -Keystore /home/sos/joc-deployment/https-keystore.p12 `
    -KeystorePassword ('jobscheduler' | ConvertTo-SecureString -AsPlainText -Force) `
    -Truststore /home/sos/joc-deployment/https-truststore.p12 `
    -TruststorePassword ('jobscheduler' | ConvertTo-SecureString -AsPlainText -Force) `
    -ExecStart StartService `
    -ExecStop StopService `
    -NoInstall

# performs no installation but certificate renewal only
# addresses an existing JOC Cockpit instance operated for HTTPS port 4446
# deploys keystore and truststore files
# stops and starts JOC Cockpit by its systemd service

...

Start JOC Cockpit

...

Service

Code Block

language	powershell
title	Example for use of Installation Script

./Install-JS7Joc.ps1 `
    -HomeDir /home/sos/joc `
    -Release 2.5.2HttpPort 4446 `
      -HomeDir "C:\Program Files\sos-berlin.com\js7\joc" ExecStart StartService `
    -Data "C:\ProgramData\sos-berlin.com\js7\joc"ExecStop StopService `
    -HttpPortNoInstall 4446 `
    -DBMSConfig C:\js7\joc-deployment\hibernate.cfg.xml `
    -JavaHome "C:\Program Files\Java\jdk-11.0.2+9" `
    -AsUser `
    -MakeDirs

# installs JOC Cockpit for the current user account
# requires that the user creates a hibernate.cfg.xml file for database access prior to installation
# specifies the Java home location
# downloadsNoConfig

# stops the JOC Cockpit's systemd service if JOC Cockpit is running
# starts the JOC Cockpit's systemd service

Stop JOC Cockpit Service

Code Block

language	powershell
title	Example for use of Installation Script

./Install-JS7Joc.ps1 `
    -HomeDir /home/sos/joc `
    -HttpPort 4446 `
    -ExecStop StopService `
    -NoInstall `
    -NoConfig

# stops the JOC Cockpit's release tarball from the SOS Web Site
# creates the home and data directories if they do not exist
# extracts the tarball and runs the JOC Cockpit installer
# operates JOC Cockpit for HTTP port 4446

Note:

...

systemd service

Install JOC Cockpit for Windows

Install or Update from Download using

...

individual Database

Code Block

language	powershell
title	Example for use of Installation Script

Invoke-WebRequest./Install-JS7Joc.ps1 `
    -Uri 'https://repo1.maven.org/maven2/com/h2database/h2/1.4.200/h2-1.4.200.jar' `
    -Outfile C:\tmp\h2-1.4.200.jar

./Install-JS7Joc.ps1 `
    -Release 2.5.2 `
  Release 2.5.2 `
    -HomeDir "C:\Program Files\sos-berlin.com\js7\joc" `
    -Data "C:\ProgramData\sos-berlin.com\js7\joc" `
     -HttpPort 4446 `
    -DBMSConfig H2 `
    -DBMSDriver C:\tmpjs7\h2joc-1deployment\hibernate.4cfg.200.jarxml `
    -JavaHome "C:\Program Files\Java\jdk-1117.0.2+9" `
      -AsUser `
    -MakeDirs

# downloadsinstalls theJOC H2Cockpit embeddedfor databasethe fromcurrent Maven Central using Invoke-WebRequestuser account
# requires downloadsthat the user creates JOC Cockpit release tarball from the SOS Web Sitea hibernate.cfg.xml file for database access prior to installation
# specifies the built-in H2 configuration to be used and the location ofJava home location
# downloads the JDBCJOC DriverCockpit .jar file
# specifiesrelease tarball from the JavaSOS homeWeb locationSite
# creates the home and data directories if they do not exist
# extracts the tarball and runs the JOC Cockpit installer
# operates JOC Cockpit for HTTP port 4446

Note:

For details about Hibernate configuration files see JS7 - Database

Install or Update from

...

Download using

...

embedded Database

Code Block

language	powershell
title	Example for use of Installation Script

Invoke-WebRequest `
    -Uri 'https://downloadrepo1.sos-berlin.com/JobScheduler.2.5/js7_joc_windows.2.5.2.zipmaven.org/maven2/com/h2database/h2/1.4.200/h2-1.4.200.jar' `
    -Outfile C:\tmp\js7_joc_windows.2.5.2.ziph2-1.4.200.jar

./Install-JS7Joc.ps1 `
    -Tarball C:\tmp\js7_joc_windows.Release 2.5.2.zip `
    -HomeDir "C:\Program Files\sos-berlin.com\js7\joc" `
    -Data "C:\ProgramData\sos-berlin.com\js7\joc" `
     -HttpPort 4446 `
    -DBMSConfig H2 `
    -DBMSDriver C:\js7tmp\joc-deployment\hibernate.cfg.xml ` h2-1.4.200.jar `
    -JavaHome "C:\Program Files\Java\jdk-1117.0.2+9" `
     -AsUser `
    -MakeDirs

# downloads the H2 embedded database from Maven Central using Invoke-WebRequest
# downloads the JOC Cockpit release tarball from the SOS Web Site
# specifies the Javabuilt-in homeH2 location
#configuration creates the home directory if it doesto be used and the location of the JDBC Driver .jar file
# specifies the Java home location
# creates the home and data directories if they do not exist
# extracts the tarball and runs the JOC Cockpit installer
# operates JOC Cockpit for HTTP port 4446

Install or Update from

...

Tarball using individual database

Code Block

language	powershell
title	Example for use of Installation Script

./Install-JS7Joc.ps1Invoke-WebRequest `
    -Releae Uri 'https://download.sos-berlin.com/JobScheduler.2.5/js7_joc_windows.2.5.2.zip' `
      -HomeDirOutfile "C:\Program Files\sos-berlin.comtmp\js7\joc"_joc_windows.2.5.2.zip

./Install-JS7Joc.ps1 `
    -Tarball C:\tmp\js7_joc_windows.2.5.2.zip `
    -HomeDir "C:\Program Files\sos-berlin.com\js7\joc" `
    -Data "C:\ProgramData\sos-berlin.com\js7\joc" `
     -HttpPort 4446 `
    -DBMSConfig C:\js7\joc-deployment\hibernate.cfg.xml `
    -LicenseKey C:\js7\joc-deployment\example.pem `
   
    -JavaHome "C:\Program Files\Java\jdk-1117.0.2+9" `
     -AsUser `
    -MakeDirs

# installsdownloads JOCthe CockpitH2 for the current user accountembedded database from Maven Central using Invoke-WebRequest
# requiresdownloads that the userJOC createsCockpit a hibernate.cfg.xml file for database access prior to installation
# specifiesrelease tarball from the locationSOS of the JS7 license keyWeb Site
# specifies the Java home location
# downloads the JOC Cockpit release tarball from the SOS Web Site
# creates the home directory if it does not exist
# extracts the tarball and runs the JOC Cockpit installer
# operates JOC Cockpit for HTTP port 4446

Install or Update from

...

Download with Commercial License

Code Block

language	powershell
title	Example for use of Installation Script

Invoke-WebRequest./Install-JS7Joc.ps1 `
    -Uri 'https://download.sos-berlin.com/JobScheduler.2.5/js7_joc_windows.2.5.2.zip'Releae 2.5.2 `
      -OutfileHomeDir "C:\tmp\js7_joc_windows.2.5.2.zip
Invoke-WebRequest -Uri 'https://download.Program Files\sos-berlin.com/JobScheduler.2.5/js7-license.jar'\js7\joc" `
    -OutfileData "C:\tmpProgramData\js7sos-license.jar

./Install-JS7Joc.ps1berlin.com\js7\joc" `
    -HttpPort 4446 `
    -TarballDBMSConfig C:\tmpjs7\js7_joc_windows.2.5.2.zipjoc-deployment\hibernate.cfg.xml `
      -HomeDirLicenseKey "C:\Program Filesjs7\sosjoc-berlin.com\js7\joc"deployment\example.pem `
     -DataJavaHome "C:\Program Files\ProgramDataJava\sosjdk-berlin.com\js7\joc17.0.2" `
    -HttpPort 4446AsUser `
    -DBMSConfig C:\js7\joc-deployment\hibernate.cfg.xml `
    -LicenseKey C:\js7\joc-deployment\example.pem `
    -LicenseBin C:\tmp\js7-license.jar `
    -JavaHome "C:\Program Files\Java\jdk-11.0.2+9" `
    -AsUser `
    -MakeDirs
 -MakeDirs

# installs JOC Cockpit for the current user account
# requires that the user creates a hibernate.cfg.xml file for database access prior to installation
# specifies the location of the JS7 license key
# specifies the Java home location
# downloads the JOC Cockpit release tarball from the SOS Web Site using Invoke-WebRequest
# downloadscreates the binaryhome directory fileif forit licenseddoes codenot toexist
# enableextracts clusterthe operationstarball using Invoke-WebRequest
# specifies the location of the JS7 license key and of the .jar file for licensed binary code
# specifies the Java home location
# creates the home directory if it does not exist
# extracts the tarball and and runs the JOC Cockpit installer
# operates JOC Cockpit for HTTP port 4446

Install or Update

...

from Tarball with Commercial License

Code Block

language	powershell
title	Example for use of Installation Script

Invoke-WebRequest `
    -Uri 'https://download.sos-berlin.com/JobScheduler.2.5/js7_joc_windows.2.5.2.zip' `
    -Outfile C:\tmp\js7_joc_windows.2.5.2.zip
Invoke-WebRequest `
    -Uri 'https://download.sos-berlin.com/JobScheduler.2.5/js7-license.jar' `
    -Outfile C:\tmp\js7-license.jar

./Install-JS7Joc.ps1 `
    -Tarball C:\tmp\js7_joc_windows.2.5.2.zip `
      -ClusterId joc `
    -InstanceId 1 `
    -Title "Secondary JOC Cockpit" `
    -HomeDir "HomeDir "C:\Program Files\sos-berlin.com\js7\joc" `
    -Data "C:\ProgramData\sos-berlin.com\js7\joc" `
    -HttpPort 4446 `
    -DBMSConfig C:\js7\joc-deployment\hibernate.cfg.xml `
    -LicenseKey C:\js7\joc-deployment\example.pem `
    -LicenseBin C:\tmp\js7-license.jar `
    -JavaHome "C:\Program Files\Java\jdk-1117.0.2+9" `
    -AsUser `
    -MakeDirs

# downloads the JOC Cockpit release tarball from the SOS Web Site using Invoke-WebRequest
# downloads the binary file for licensed code to enable cluster operations using Invoke-WebRequest
# specifies the location Clusterof IDthe thatJS7 islicense thekey sameand forof allthe JOC.jar Cockpitfile instancesfor inlicensed abinary clustercode
# specifies the Instance ID that is a number between 0 and 99:
#   Instance IDs specify the ordering of JOC Cockpit icons in the Dashboard
#   the first JOC Cockpit started becomes the active node in a cluster independent from its Instance ID
# specifies the title that acts as a caption for JOC Cockpit icons in the Dashbaord
# specifies the location of the JS7 license key and of the .jar file for licensed binary code
# specifies the Java home location
# creates the home directory if it does not exist
# extracts the tarball and runs the JOC Cockpit installer
# operates JOC Cockpit for HTTP port 4446

Install or Update from Tarball using a Response Directory

 Java home location
# creates the home directory if it does not exist
# extracts the tarball and runs the JOC Cockpit installer
# operates JOC Cockpit for HTTP port 4446

Install or Update Secondary JOC Cockpit Instances for Cluster Operations

Code Block

language	powershell
title	Example for use of Installation Script

Invoke-WebRequest `
    -Uri 'https://download.sos-berlin.com/JobScheduler.2.5/js7_joc_windows.2.5.2.zip' `
    -Outfile C:\tmp\js7_joc_windows.2.5.2.zip
Invoke-WebRequest `
    -Uri 'https://download.sos-berlin.com/JobScheduler.2.5/js7-license.jar' `
    -Outfile C:\tmp\js7-license.jar

./Install-JS7Joc.ps1 `
    -Tarball C:\tmp\js7_joc_windows.2.5.2.zip `
    -InstanceId 1 `
    -Title "Secondary JOC Cockpit" `
    -HomeDir "C:\Program Files\sos-berlin.com\js7\joc" `
    -Data "C:\ProgramData\sos-berlin.com\js7\joc" `
    -HttpPort 4446

Code Block

language	powershell
title	Example for use of Installation Script

Invoke-WebRequest -Uri 'https://download.sos-berlin.com/JobScheduler.2.5/js7_joc_windows.2.5.2.zip' `
   -Outfile C:\tmp\js7_joc_windows.2.5.2.zip

./Install-JS7Joc.ps1 `
    -TarballDBMSConfig C:\tmpjs7\js7_joc_windows.2.5.2.zipjoc-deployment\hibernate.cfg.xml `
    -ResponseDirLicenseKey C:\js7\joc-deployment\responseexample.pem `
      -HomeDirLicenseBin "C:\Program Filestmp\sosjs7-berlin.com\js7\joc"license.jar `
     -HttpPort 4446 `
    -JavaHome JavaHome "C:\Program Files\Java\jdk-1117.0.2+9" `
    -AsUser `
    -MakeDirs

# downloads the JOC Cockpit release tarball from the SOS Web Site using Invoke-WebRequest
# specifies a response directory that holds
#    the joc_install.xmldownloads the binary file for licensed installationcode optionsto suchenable ascluster theoperations HTTPusing PortInvoke-WebRequest
# specifies the Instance ID the hibernate.cfg.xml configuration file for database accessthat is a number between 0 and 99:
# specifies the JavaInstance home location
# createsIDs specify the homeordering andof dataJOC directoriesCockpit ificons theyin doethe not existDashboard
# extracts  the tarball and runs the first JOC Cockpit started becomes the active node in a cluster independent from its Instance ID
# specifies the title that acts as a caption for JOC Cockpit installer
# operates JOC Cockpit for HTTP port 4446

Note:

For details about the joc_install.xml response file see JS7 - JOC Cockpit - Headless Installation on Linux and Windows
For details about Hibernate configuration files see JS7 - Database

...

 icons in the Dashbaord
# specifies the location of the JS7 license key and of the .jar file for licensed binary code
# specifies the Java home location
# creates the home directory if it does not exist
# extracts the tarball and runs the JOC Cockpit installer
# operates JOC Cockpit for HTTP port 4446

Install or Update from Tarball using a Response Directory

Code Block

language	powershell
title	Example for use of Installation Script

Invoke-WebRequest `
    -Uri 'https://download.sos-berlin.com/JobScheduler.2.5/js7_joc_windows.2.5.2.zip' `
    -Outfile C:\tmp\js7_joc_windows.2.5.2.zip

./Install-JS7Joc.ps1 `
    -Tarball C:\tmp\js7_joc_windows.2.5.2.zip `
      -HomeDirResponseDir "C:\Program Filesjs7\sosjoc-berlin.com\js7\joc"deployment\response `
      -DataHomeDir "C:\ProgramDataProgram Files\sos-berlin.com\js7\joc" `
      -HttpPort 4446 `
    -DBMSConfig C:\js7\joc-deployment\hibernate.cfg.xml `
    -JavaHome "C:\Program Files\Java\jdk-1117.0.2+9" `
    -ExecStart StartService `
    -ExecStop StopService `
    -MakeService `
    -AsUser `
    -MakeDirs

# downloads the JOC Cockpit release tarball from the SOS Web Site using Invoke-WebRequest
# createsspecifies thea homeresponse directory if it does not exist
# extractsthat holds
#    the tarball and runs the JOC Cockpit installerjoc_install.xml file for installation options such as the HTTP Port
#    the hibernate.cfg.xml configuration file for database access
# specifies the Java home location
# creates the JOC Cockpit's systemd service
# stops and starts home and data directories if they doe not exist
# extracts the tarball and runs the JOC Cockpit's systemd serviceinstaller
# operates JOC Cockpit for HTTP port 4446

Install or Update and Apply Certificates for HTTPS Connections

Note:

For details about the joc_install.xml response file see JS7 - JOC Cockpit - Headless Installation on Linux and Windows
For details about Hibernate configuration files see JS7 - Database

Install or Update and Stop/Start using Windows Service

Code Block

language	powershell
title	Example for use of Installation Script

Invoke-WebRequest `
    -Uri 'https://download.sos-berlin.com/JobScheduler.2.5/js7_joc_windows.2.5.2.zip' `
    -Outfile C:\tmp\js7_joc_windows.2.5.2.zip

./Install-JS7Joc.ps1 `
    -Tarball C:\tmp\js7_joc_windows.2.5.2.zip `
    -HomeDir "C:\Program Files\sos-berlin.com\js7\joc" `
    -Data "C:\ProgramData\sos-berlin.com\js7\joc" `
     -HttpsPortHttpPort 4446 `
    -DBMSConfig C:\js7\joc-deployment\hibernate.cfg.xml `
      -JavaHome "C:\Program Files\Java\jdk-1117.0.2+9" `
  `
    -Keystore C:\js7\joc-deployment/https-keystore.pfxExecStart StartService `
    -KeystorePassword ('jobscheduler' | ConvertTo-SecureString -AsPlainText -Force)ExecStop StopService `
    -MakeService `
    -Truststore C:\js7\joc-deployment\https-truststore.pfxAsUser `
    -TruststorePassword ('jobscheduler' | ConvertTo-SecureString -AsPlainText -Force) `
    -ExecStart StartService `
    -ExecStop StopService `
    -MakeService `
    -AsUser `
    -MakeDirs

# downloads the  -MakeDirs

# downloads the JOC Cockpit release tarball from the SOS Web Site using Invoke-WebRequest
# creates the home directory if it does not exist
# extracts the tarball and runs the JOC Cockpit installer
# deployscreates keystorethe and truststore files
# creates theJOC Cockpit's systemd service
# stops and starts the JOC Cockpit by its Windows's systemd service
# operates JOC Cockpit for HTTPSHTTP port 4446

...

Install or Update and Apply Certificates for HTTPS Connections

Code Block

language	powershell
title	Example for use of Installation Script

./Install-JS7Joc.ps1Invoke-WebRequest `
    -  -Uri 'https://download.sos-berlin.com/JobScheduler.2.5/js7_joc_windows.2.5.2.zip' `
    -Outfile C:\tmp\js7_joc_windows.2.5.2.zip

./Install-JS7Joc.ps1 `
    -Tarball C:\tmp\js7_joc_windows.2.5.2.zip `
    -HomeDir "C:\Program Files\sos-berlin.com\js7\joc" `
    -Data "C:\ProgramData\sos-berlin.com\js7\joc" `
    -HttpsPort 4446 `
    -JavaHomeDBMSConfig "C:\Program js7\joc-deployment\hibernate.cfg.xml `
    -JavaHome "C:\Program Files\Java\jdk-1117.0.2+9" `
    -Keystore C:\js7\joc-deployment/https-keystore.pfx `
    -KeystorePassword ('jobscheduler' | ConvertTo-SecureString -AsPlainText -Force) `
    -Truststore C:\js7\joc-deployment\https-truststore.pfx `
    -TruststorePassword ('jobscheduler' | ConvertTo-SecureString -AsPlainText -Force) `
    -ExecStart StartService `
    -ExecStop StopService `
    -NoInstall

# performs no installation but certificate renewal only
# addresses an existing JOC Cockpit instance operated for HTTPS port 4446
# deploys keystore and truststore files
# stops and starts JOC Cockpit by its Windows service

Patch

Patch JOC Cockpit for Linux

...

MakeService `
    -AsUser `
    -MakeDirs

# downloads the JOC Cockpit release tarball from the SOS Web Site using Invoke-WebRequest
# creates the home directory if it does not exist
# extracts the tarball and runs the JOC Cockpit installer
# deploys keystore and truststore files
# creates the systemd service
# stops and starts JOC Cockpit by its Windows service
# operates JOC Cockpit for HTTPS port 4446

Renew Certificates for HTTPS Connections

Code Block

language	powershell
title	Example for use of Installation Script

./Install-JS7Joc.ps1 `
    -HomeDir "C:\Program Files\sos-berlin.com\js7\joc" `
    -Data "C:\ProgramData\sos-berlin.com\js7\joc" `
    -HttpsPort 4446 `
    -JavaHome "C:\Program Files\Java\jdk-17.0.2" `
    -Keystore C:\js7\joc-deployment/https-keystore.pfx `
    -KeystorePassword ('jobscheduler' | ConvertTo-SecureString -AsPlainText -Force) `
    -Truststore C:\js7\joc-deployment\https-truststore.pfx `
    -TruststorePassword ('jobscheduler' | ConvertTo-SecureString -AsPlainText -Force) `
    -ExecStart StartService `
    -ExecStop StopService `
    -NoInstall

# performs no installation but certificate renewal only
# addresses an existing JOC Cockpit instance operated for HTTPS port 4446
# deploys keystore and truststore files
# stops and starts JOC Cockpit by its Windows service

Start JOC Cockpit Service

Code Block

language	powershell
title	Example for use of Installation Script

./Install-JS7Joc.ps1 `
    -HomeDir "C:\Program Files\sos-berlin.com\js7\joc" `
    -HttpPort 4446 `
    -ExecStart StartService `
    -ExecStop StopService `
    -NoInstall `
    -NoConfig

# stops the JOC Cockpit's Windows service if JOC Cockpit is running
# starts the JOC Cockpit's Windows service

Stop JOC Cockpit Service

Code Block

language	powershell
title	Example for use of Installation Script

./Install-JS7Joc.ps1 `
    -HomeDir "C:\Program Files\sos-berlin.com\js7\joc" `
    -HttpPort 4446 `
    -ExecStop StopService `
    -NoInstall `
    -NoConfig

# stops the JOC Cockpit's Windows service

Patch

Patch JOC Cockpit for Linux

Patch API from Download

Code Block

language	powershell
title	Example for use of Installation Script

./Install-JS7Joc.ps1 `
    -Release 2.2.3 `
    -Patch JS-1984 `
    -PatchKey API-1 `
    -HomeDir /opt/sos-berlin.com/js7/joc `
    -Data /var/sos-berlin.com/js7/joc ` 
    -HttpPort 4446 `
    -JavaHome /opt/java/jdk-17.0.2 `
    -ExecStart StartService `
    -ExecStop StopService

# downloads the patch tarball from the SOS Web Site
# extracts the tarball to the JOC Cockpit's data directory assuming that this corresponds to the home directory
# stores the patch files to the JOC Cockpit's <data>/webapps/joc/WEB-INF/classes sub-directory
# stops and starts the JOC Cockpit's systemd service

Patch API from Tarball

Code Block

language	powershell
title	Example for use of Installation Script

Invoke-WebRequest `
    -Uri 'https://download.sos-berlin.com/patches/2.2.3-patch/js7_joc.2.2.3-PATCH.API-1.JS-1984.tar.gz' `
    -Outfile /tmp/js7_joc.2.2.3-PATCH.API-1.JS-1984.tar.gz

./Install-JS7Joc.ps1 `
    -Tarball /tmp/js7_joc.2.2.3-PATCH.API-1.JS-1984.tar.gz `
    -Patch JS-1984 `
    -PatchKey API-1 `
    -HomeDir /opt/sos-berlin.com/js7/joc `
    -Data /var/sos-berlin.com/js7/joc ` 
    -HttpPort 4446 `
    -JavaHome /opt/java/jdk-17.0.2 `
    -ExecStart StartService `
    -ExecStop StopService
 
# downloads the patch tarball from the SOS Web Site using Invoke-WebRequest
# extracts the tarball to the JOC Cockpit's data directory assuming that this corresponds to the home directory
# stores the patch files to the JOC Cockpit's <data>/webapps/joc/WEB-INF/classes sub-directory
# stops and starts the JOC Cockpit's systemd service

Patch GUI from Tarball

Code Block

language	powershell
title	Example for use of Installation Script

Invoke-WebRequest `
    -Uri 'https://download.sos-berlin.com/patches/2.5.3-patch/js7_joc.2.5.3-PATCH.GUI-1.JOC-1550.tar.gz' `
    -Outfile /tmp/js7_joc.2.5.3-PATCH.GUI-1.JOC-1550.tar.gz

./Install-JS7CJoc.ps1 `
    -Tarball /tmp/js7_joc.2.5.3-PATCH.GUI-1.JOC-1550.tar.gz `
    -Patch JS-1550Install-JS7Joc.ps1 `
    -Release 2.2.3PatchKey GUI-1 `
    -Patch JS-1984HomeDir /opt/sos-berlin.com/js7/joc `
    -HomeDirData /homevar/sos-berlin.com/js7/joc `
    -HttpPort 4446 `
    -JavaHome /opt/java/jdk-1117.0.2+9 `
    -ExecStart StartService `
    -ExecStop StopService
 
# downloads the patch tarball from the SOS Web Site using Invoke-WebRequest
# extracts the tarball to the JOC Cockpit's data directory assuming that this corresponds to the home directory
# stores the patch files to the JOC Cockpit's <data>/\webapps/\joc/\WEB-INF/\classes sub-directory
# stops and starts the JOC Cockpit's systemdWindows service

Patch API from

...

.jar File

Code Block

language	powershell
title	Example for use of Installation Script

Invoke-WebRequest `
    -Uri 'https://download.sos-berlin.com/patches/JobScheduler2.2.23-patch/js7_joc_linux.2.2.3-PATCH.API-1.JS-1984.tar.gzjar' `
    -Outfile /tmp/js7_joc_linux.2.2.3-PATCH.API-1.JS-1984.tar.gzjar

./Install-JS7Joc.ps1 `
    -TarballPatchJar /tmp/js7_joc_unix.2.2.3-PATCH.API-1.JS-1984.tar.gzjar `
    -PatchKey API-1 `
    -Patch JS-1984 ` 
    -HomeDir /homeopt/sos-berlin.com/js7/joc `
    -Data /var/sos-berlin.com/js7/joc `
    -HttpPort 4446 `
    -JavaHome /opt/java/jdk-1117.0.2+9 `
    -ExecStart StartService `
    -ExecStop StopService
 
# downloads the patch tarball from the SOS Web Site using Invoke-WebRequest
# extracts the tarball to the JOC Cockpit's data directory assuming that this corresponds to the home directory.jar file from the SOS Web Site using Invoke-WebRequest
# stores the patch files.jar file to the JOC Cockpit's <data>/webapps/joc/WEB-INF/classes sub-directory
# stops and starts the JOC Cockpit's systemd service

Patch

...

JOC Cockpit for Windows

Patch API from Download

Code Block

language	powershell
title	Example for use of Installation Script

Invoke-WebRequest 'https://download.sos-berlin.com/JobScheduler.2.2/patch-20220331-JS-1984-2.2.3.jar' `
   -Outfile /tmp/patch-20220331-JS-1984-2.2.3.jar

./Install-JS7Joc.ps1 `
    -Jar /tmp/patch-20220331-JS-1984-   -Release 2.2.3.jar `
    -Patch JS-1984 `
    -PatchKey API-1 `
    -HomeDir /home/sos/joc"C:\Program Files\sos-berlin.com\js7\joc" `
    -Data "C:\ProgramData\sos-berlin.com\js7\joc" `
    -HttpPort 4446 `
    -JavaHome /opt/java/jdk-11 "C:\Program Files\Java\jdk-17.0.2+9" `
    -ExecStart StartService `
    -ExecStop StopService
 
# downloads the patch .jar filetarball from the SOS Web Site using Invoke-WebRequest
# extracts the tarball to the JOC Cockpit's data directory
# stores the patch .jarfiles file to the JOC Cockpit's <data>/\webapps/\joc/\WEB-INF/\classes sub-directory
# stops and starts the JOC Cockpit's systemd service

Patch JOC Cockpit for Windows

Patch from Download

 and starts the JOC Cockpit's Windows service

Patch API from Tarball

Code Block

language	powershell
title	Example for use of Installation Script

Invoke-WebRequest `
    -Uri 'https://download.sos-berlin.com/patches/2.2.3-patch/js7_joc.2.2.3-PATCH.API-1.JS-1984.tar.gz' `
    -Outfile C:\tmp\js7_joc.2.2.3-PATCH.API-1.JS-1984.tar.gz

./Install-JS7CJoc

Code Block

language	powershell
title	Example for use of Installation Script

./Install-JS7Joc.ps1 `
    -Release Tarball "C:\tmp\js7_joc.2.2.3.3-PATCH.API-1.JS-1984.tar.gz" `
    -Patch JS-1984 `
    -PatchPatchKey JSAPI-19841 `
    -HomeDir "C:\Program Files\sos-berlin.com\js7\joc" `
    -Data "C:\ProgramData\sos-berlin.com\js7\joc" `
    -HttpPort 4446 `
    -JavaHome "C:\Program Files\Java\jdk-1117.0.2+9" `
    -ExecStart StartService `
    -ExecStop StopService
 
# downloads the patch tarball from the SOS Web Site using Invoke-WebRequest
# extracts the tarball to the JOC Cockpit's data directory
# stores the patch files to the JOC Cockpit's <data>\webapps\joc\WEB-INF\classes sub-directory
# stops and starts the JOC Cockpit's Windows service

Patch GUI from

...

Tarball

Code Block

language	powershell
title	Example for use of Installation Script

Invoke-WebRequest `
    -Uri 'https://download.sos-berlin.com/JobSchedulerpatches/2.25.23-patch/js7_joc_windows.2.25.3.JS-1984.zip-PATCH.GUI-1.JOC-1550.tar.gz' `
    -Outfile C:\tmp\js7_joc_windows.2.25.3.JS-1984.zip-PATCH.GUI-1.JOC-1550.tar.gz

./Install-JS7CJoc.ps1 `
    -Tarball "C:\tmp\js7_joc_windows.2.25.3.JS-1984.zip-PATCH.GUI-1.JOC-1550.tar.gz" `
    -Patch JS-1984-1550 `
    -PatchKey GUI-1 `
    -HomeDir "C:\Program Files\sos-berlin.com\js7\joc" `
    -Data "C:\ProgramData\sos-berlin.com\js7\joc" `
    -HttpPort 4446 `
    -JavaHome "C:\Program Files\Java\jdk-1117.0.2+9" `
    -ExecStart StartService `
    -ExecStop StopService
 
# downloads the patch tarball from the SOS Web Site using Invoke-WebRequest
# extracts the tarball to the JOC Cockpit's data directory
# stores the patch files to the JOC Cockpit's <data>\webapps\joc\WEB-INF\classes sub-directory
# stops and starts the JOC Cockpit's Windows service

Patch API from .jar File

Code Block

language	powershell
title	Example for use of Installation Script

Invoke-WebRequest `
    -Uri 'https://download.sos-berlin.com/JobSchedulerpatches/2.2.3-patch/js7_joc.2.2/patch-20220331-.3-PATCH.API-1.JS-1984-2.2.3.jar' `
    -Outfile C:\tmp\patch-20220331-js7_joc.2.2.3-PATCH.API-1.JS-1984-2.2.3.jar

./Install-JS7CJoc.ps1 `
    -JarPatchJar "C:\tmp\patch-20220331-js7_joc.2.2.3-PATCH.API-1.JS-1984-2.2.3.jar" `
    -Patch JS-1984 `
    -PatchKey API-1 `
    -HomeDir "C:\Program Files\sos-berlin.com\js7\joc" `
    -Data "C:\ProgramData\sos-berlin.com\js7\joc" `
    -HttpPort 4446 `
    -JavaHome "C:\Program Files\Java\jdk-1117.0.2+9" `
    -ExecStart StartService `
    -ExecStop StopService
 
# downloads the patch .jar file from the SOS Web Site using Invoke-WebRequest
# stores the patch .jar file to the JOC Cockpit's <data>\webapps\joc\WEB-INF\classes sub-directory
# stops and starts the JOC Cockpit's Windows service

...

Code Block

language	powershell
title	Example for use of Installation Script

./Install-JS7Joc.ps1 `
    -HomeDir /opt/sos-berlin.com/js7/joc `
    -Data /var/sos-berlin.com/js7/joc `
    -JavaHome /opt/java/jdk-1117.0.2+9 `
    -ExecStop StopService `
    -Uninstall

# stops the JOC Cockpit's systemd service
# removes the JOC Cockpit's systemd services
# removes the home and data directories

...

Code Block

language	powershell
title	Example for use of Installation Script

./Install-JS7Joc.ps1 `
    -HomeDir "C:\Program Files\sos-berlin.com\js7\joc" `
    -Data "C:\ProgramData\sos-berlin.com\js7\joc" `
    -JavaHome "C:\Program Files\Java\jdk-1117.0.2+9" `
    -ExecStop StopService `
    -Uninstall

# stops the JOC Cockpit's Windows service
# removes the JOC Cockpit's Windows service
# removes the home directory and data directory

...

Space shortcuts

Page tree

Page History

Versions Compared

Old Version 6

New Version Current

Key

Install and Update

Install JOC Cockpit for Linux

Install or Update Secondary JOC Cockpit

Instance for Cluster Operations

Start JOC Cockpit

Service

Stop JOC Cockpit Service

Install JOC Cockpit for Windows

Install or Update from Download using

individual Database

Install or Update from

Download using

embedded Database

Install or Update from

Tarball using individual database

Install or Update from

Download with Commercial License

Install or Update

from Tarball with Commercial License

Install or Update from Tarball using a Response Directory

Install or Update Secondary JOC Cockpit Instances for Cluster Operations

Install or Update from Tarball using a Response Directory

Install or Update and Apply Certificates for HTTPS Connections

Install or Update and Stop/Start using Windows Service

Install or Update and Apply Certificates for HTTPS Connections

Patch

Patch JOC Cockpit for Linux

Renew Certificates for HTTPS Connections

Start JOC Cockpit Service

Stop JOC Cockpit Service

Patch

Patch JOC Cockpit for Linux

Patch API from Download

Patch API from Tarball

Patch GUI from Tarball

Patch API from

.jar File

Patch

JOC Cockpit for Windows

Patch API from Download

Patch JOC Cockpit for Windows

Patch from Download

Patch API from Tarball

Patch GUI from

Tarball

Patch API from .jar File