Versions Compared

Key

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

...

Code Block
languagebash
titleExample for use of Controller Installation Script
curl 'https://download.sos-berlin.com/JobScheduler.2.5/js7_controller_unix.2.5.2.tar.gz' \
    -o /tmp/js7_controller_unix.2.5.2.tar.gz

./js7_install_controller.sh \
    --tarball=/tmp/js7_controller_unix.2.5.2.tar.gz \
    --home=/home/sos/controller \
    --controller-id="controller" \
    --http-port=4444 \
    --make-dirs

# downloads the release tarball from the SOS Web Site using curl
# creates the home directory if it does not exist
# specifies the Controller ID that is a unique identifier:
#   in a Controller Cluster all Controller instances use the same Controller ID
#   for Standalone Controller instances each instance requires a unique Controller ID
# extracts the tarball to the Controller's home directory
# operates the Controller for HTTP port 4444

...

Code Block
languagebash
titleExample for use of Controller Installation Script
curl 'https://download.sos-berlin.com/JobScheduler.2.5/js7_controller_unix.2.5.2.tar.gz' \
    -o /tmp/js7_controller_unix.2.5.2.tar.gz
 
./js7_install_controller.sh \
    --tarball=/tmp/js7_controller_unix.2.5.2.tar.gz \
    --home=/opt/sos-berlin.com/js7/controller \
    --controller-id="controller" \
    --http-port=4444 \
    --Standby \
    --make-dirs

# downloads the Controller release tarball from the SOS Web Site using curl
# specifies the Controller ID that is used by all instances in the Controller Cluster
# puts the Controller instance to initial standby mode for use in a cluster, the following applies for cluster setup:
#    the Primary Controller instance is not configured for standby mode
#    the Secondary Controller instance is configured for standby mode
# creates the home directory if it does not exist
# extracts the tarball to the Controller's home directory
# populates the data directory from initial configuration files
# operates the Controller for HTTP port 4444

...

Code Block
languagebash
titleExample for use of Controller Installation Script
curl 'https://download.sos-berlin.com/JobScheduler.2.5/js7_controller_unix.2.5.2.tar.gz' \
    -o /tmp/js7_controller_unix.2.5.2.tar.gz

./js7_install_controller.sh \
    --tarball=/tmp/js7_controller_unix.2.5.2.tar.gz \ 
    --home=/opt/sos-berlin.com/js7/controller \
    --data=/var/sos-berlin.com/js7/controller \
    --controller-id="controller" \
    --http-port=4444 \
    --make-dirs

# downloads the Controller release tarball from the SOS Web Site using curl
# suggests use of separate home and data directories for configuration data, log data etc.
# creates the home and data directories if they do not exist
# extracts the tarball to the Controller's home directory
# populates the data directory from initial configuration files
# operates the Controller for HTTP port 4444

...

Code Block
languagebash
titleExample for use of Controller Installation Script
curl 'https://download.sos-berlin.com/JobScheduler.2.5/js7_controller_unix.2.5.2.tar.gz' \
    -o /tmp/js7_controller_unix.2.5.2.tar.gz
curl 'https://download.sos-berlin.com/JobScheduler.2.5/js7-license.jar' \
    -o /tmp/js7-license.jar

./js7_install_controller.sh \
    --tarball=/tmp/js7_controller_unix.2.5.2.tar.gz \
    --home=/home/sos/controller \
    --controller-id="controller" \
    --http-port=4444 \
    --license-key=/home/sos/controller-deployment/example.pem \
    --license-bin=/tmp/js7-license.jar \
    --make-dirs

# downloads the release tarball from the SOS Web Site using curl
# downloads the binary file for licensed code to enable cluster operations
# creates the home directory if it does not exist
# extracts the tarball to the Controller's home directory
# installs the license key file and binary file for licensed code
# operates the Controller for HTTP port 4444

...

Code Block
languagebash
titleExample for use of Controller Installation Script
curl 'https://download.sos-berlin.com/JobScheduler.2.5/js7_controller_unix.2.5.2.tar.gz' \
    -o /tmp/js7_controller_unix.2.5.2.tar.gz

./js7_install_controller.sh \
    --tarball=/tmp/js7_controller_unix.2.5.2.tar.gz \
    --home=/home/sos/controller \
    --controller-id="controller" \
    --http-port=4444 \
    --exec-start="StartService" \
    --exec-stop="StopService" \
    --make-service \
    --make-dirs

# downloads the release tarball from the SOS Web Site using curl
# extracts the tarball to the Controller's home directory
# creates the Controller's systemd service
# stops and starts the Controller's systemd service
# operates the Controller for HTTP port 4444

...

Code Block
languagebash
titleExample for use of Controller Installation Script
curl 'https://download.sos-berlin.com/JobScheduler.2.5/js7_controller_unix.2.5.2.tar.gz' \
    -o /tmp/js7_controller_unix.2.5.2.tar.gz

./js7_install_controller.sh \
    --tarball=/tmp/js7_controller_unix.2.5.2.tar.gz \
    --home=/home/sos/controller \
    --controller-id="jobscheduler" \
    --http-port=4444 \
    --exec-start="sudo systemctl start js7_controller_jobscheduler" \
    --exec-stop="sudo systemctl stop js7_controller_jobscheduler" \
    --make-dirs

# downloads the release tarball from the SOS Web Site using curl
# extracts the tarball to the Controller's home directory
# stops and starts the Controller instance by use of individual commands
# operates the Controller for HTTP port 4444

...

Code Block
languagebash
titleExample for use of Controller Installation Script
curl 'https://download.sos-berlin.com/JobScheduler.2.5/js7_controller_unix.2.5.2.tar.gz' \
    -o /tmp/js7_controller_unix.2.5.2.tar.gz

./js7_install_controller.sh \
    --tarball=/tmp/js7_controller_unix.2.5.2.tar.gz \
    --home=/home/sos/controller \
    --controller-id="controller" \
    --http-port=4444 \
    --restart \
    --make-dirs

# downloads the release tarball from the SOS Web Site using curl
# extracts the tarball to the Controller's home directory
# stops and starts the Controller from its instance start script <home>/bin/controller_instance.sh
# operates the Controller for HTTP port 4444

...

Code Block
languagebash
titleExample for use of Controller Installation Script
curl 'https://download.sos-berlin.com/JobScheduler.2.5/js7_controller_unix.2.5.2.tar.gz' \
    -o /tmp/js7_controller_unix.2.5.2.tar.gz

./js7_install_controller.sh \
    --tarball=/tmp/js7_controller_unix.2.5.2.tar.gz \
    --home=/home/sos/controller \
    --controller-id="controller" \
    --http-port=4444 \
    --java-home=/opt/java/jdk-11.0.2+9 \
    --java-options="-Xmx512m -Xms256m" \
    --restart \
    --make-dirs

# downloads the release tarball from the SOS Web Site using curl
# extracts the tarball to the Controller's home directory
# specifies the Java version and Java options to be used
# stops and starts the Controller from its instance start script <home>/bin/controller_instance.sh
# operates the Controller for HTTP port 4444

...

Code Block
languagebash
titleExample for use of Controller Installation Script
curl 'https://download.sos-berlin.com/JobScheduler.2.5/js7_controller_unix.2.5.2.tar.gz' \
    -o /tmp/js7_controller_unix.2.5.2.tar.gz
retval=/tmp/js7_install_controller.$$.tmp

./js7_install_controller.sh \
    --tarball=/tmp/js7_controller_unix.2.5.2.tar.gz \
    --home=/home/sos/controller \
    --controller-id="controller" \
    --http-port=4444 \
    --backup-dir=/tmp/backups \
    --log-dir=/tmp/logs \
    --return-values=$retval \
    --exec-start="StartService" \
    --exec-stop="StopService" \
    --make-service \
    --make-dirs
 
log_file=$(cat $retval | grep "log_file" | cut -d'=' -f2)
backup_file=$(cat $retval | grep "backup_file" | cut -d'=' -f2)

# downloads the release tarball from the SOS Web Site using curl
# creates a backup archive and log file
# extracts the tarball to the Controller's home directory
# provides return values from a temporary file which includes the path to the log file and to the backup archive
# stops and starts the Controller from its systemd service
# operates the Controller for HTTP port 4444

...

Code Block
languagebash
titleExample for use of Controller Installation Script
curl 'https://download.sos-berlin.com/JobScheduler.2.5/js7_controller_unix.2.5.2.tar.gz' \
    -o /tmp/js7_controller_unix.2.5.2.tar.gz
retval=/tmp/js7_install_controller.$$.tmp

./js7_install_controller.sh \
    --tarball=/tmp/js7_controller_unix.2.5.2.tar.gz \
    --home=/home/sos/controller \
    --controller-id="controller" \
    --http-port=4444 \
    --backup-dir=/tmp/backups \
    --log-dir=/tmp/logs \
    --return-values=$retval \
    --restart \
    --show-logs \
    --make-dirs
 || ( backup=$(cat $retval | grep "backup_file" | cut -d'=' -f2 ) \
      && ( test -e "$backup" ) && \
      ./js7_install_controller.sh \
          --tarball=$backup \
          --home=/home/sos/controller \
          --controller-id="controller" \
          --http-port=4444 \
          --log-dir=/tmp/logs \
          --restart \
          --show-logs )

log_file=$(cat $retval | grep "log_file" | cut -d'=' -f2)
backup_file=$(cat $retval | grep "backup_file" | cut -d'=' -f2)

# downloads the release tarball from the SOS Web Site using curl
# creates a backup archive and log file
# extracts the tarball to the Controller's home directory
# reverts the installation from the backup archive in case of failure
# stops and starts the Controller from its instance start script <home>/bin/controller_instance.sh
# operates the Controller for HTTP port 4444

...

Code Block
languagebash
titleExample for use of Controller Installation Script
curl 'https://download.sos-berlin.com/JobScheduler.2.5/js7_controller_unix.2.5.2.tar.gz' \
    -o /tmp/js7_controller_unix.2.5.2.tar.gz

./js7_install_controller.sh \
    --tarball=/tmp/js7_controller_unix.2.5.2.tar.gz \
    --home=/home/sos/controller \
    --controller-id="controller" \
    --http-port=localhost:4444 \
    --https-port=batch.example.com:4444 \
    --private-conf=/home/sos/controller-deployment/private.conf \
    --controller-secondary-cert=/home/sos/controller-deployment/centostest-secondary.crt \
    --joc-primary-cert=/home/sos/controller-deployment/centostest-primary.crt \
    --joc-secondary-cert=/home/sos/controller-deployment/centostest-secondary.crt \ 
    --keystore=/home/sos/controller-deployment/https-keystore.p12 \
    --keystore-password=jobscheduler \
    --truststore=/home/sos/controller-deployment/https-truststore.p12 \
    --truststore-password=jobscheduler \ 
    --exec-start=StartService \
    --exec-stop=StopService \
    --make-service \
    --make-dirs

# downloads the release tarball from the SOS Web Site using curl
# extracts the tarball to the Controller's home directory
# specifies HTTP port 4444 on the localhost network interface and the same HTTPS port on the server network interface
# specifies the path to the Secondary Controller's server certificate used by the Primary Controller instance if a Controller Cluster is used
#    a Primary Controller instance requires the server certificate of the Secondary Controller instance
#    a Secondary Controller instance requires the server certificate of the Primary Controller instance
#    for a Standalone Controller both --controller-primary-cert and --controller-secondary-cert arguments are omitted
# specifies the paths to the Primary and Secondary JOC Cockpit's server certificates if a JOC Cockpit Cluster is used
#     for a Standalone JOC Cockpit the --joc-secondary-cert argument is omitted
# deploys the Controller private configuration file which holds references to keystore and truststore
# deploys keystore and truststore files
# stops and starts the Controller's systemd service

...

Code Block
languagebash
titleExample for use of Controller Installation Script
curl 'https://download.sos-berlin.com/JobScheduler.2.2/js7_controller_unix.2.2.3.JS-1984.tar.gz' \
    -o /tmp/js7_controller_unix.2.2.3.JS-1984.tar.gz

./js7_install_controller.sh \
    --tarball=/tmp/js7_controller_unix.2.2.3.JS-1984.tar.gz \
    --patch=JS-1984 \
    --home=/home/sos/controller \
    --controller-id=controller \
    --exec-start="StartService" \
    --exec-stop="StopService"

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

...

Code Block
languagebash
titleExample for use of Controller Installation Script
curl 'https://download.sos-berlin.com/JobScheduler.2.2/patch-20220331-JS-1984-2.2.3.jar' \
    -o /tmp/patch-20220331-JS-1984-2.2.3.jar

./js7_install_controller.sh \
    --jar=/tmp/patch-20220331-JS-1984-2.2.3.jar \
    --patch=JS-1984 \
    --home=/home/sos/controller \
    --controller-id=controller \
    --exec-start="StartService" \
    --exec-stop="StopService"

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

...