Page History

...

• archive (holds deployment packages)
  • <deployment-descriptor> (specifies the Deployment Descriptor)
    • agents (holds Agent deployment packages)
      • <agent-id>(specifies the Agent ID)
        • js7_deploy_agent_unix.<agent-id>.<release>.config.tar.gz (deployment package for the Agent's configuration directory)
        • js7_deploy_agent_unix.<agent-id>.<release>.install.tar.gz (deployment package for the Agent's installation directory)
        • run_deploy_agent.sh (deployment script)
        • run_install_agent.sh (wrapper script for parameterized call to js7_install_agent.sh)
      • <agent-id>(specifies the Agent ID)
      • ...
    • controllers (holds Controller deployment packages)
      • <controller-id> (specifies the Controller ID)
        • <controller-type> (specifies the type of the Controller instance which is primary or secondary) 
          • js7_deploy_controller_unix.<controller-id>.<controller-type>.<release>.config.tar.gz (deployment package for the Controller instance's configuration directory)
          • js7_deploy_controller_unix.<controller-id>.<controller-type>.<release>.install.tar.gz (deployment package for the Controller instance's installation directory)
          • run_deploy_controller.sh (deployment script)
          • run_install_controller.sh (wrapper script for parameterized call to js7_install_controller.sh)
        • <controller-type> (specifies the type of the Controller instance which is primary or secondary) 
    • js7_import_tar.gz (holds the Deployment Workflow for import to JS7 JOC Cockpit)
  • <deployment-descriptor> (specifies the Deployment Descriptor)
  • ...
• bin (holds executable files, preferably individual scripts, deployment scripts and installer scripts available from JS7 - Download)
  • js7_create_certificate_store.sh (used to add certificates to keystores and truststores, see JS7 - How to add SSL TLS Certificates to Keystore and Truststore)
  • js7_create_deployment_package.sh (used to create deployment packages, see JS7 - Deployment Packaging Script)
  • js7_install_agent.sh (used to install Agents, see JS7 - Automated Installation and Update of Agent)
  • js7_install_controller.sh (used to install Controller instances, see JS7 - Automated Installation and Update of Controller)
  • js7_install_joc.sh (used to install JOC Cockpit instances, see JS7 - Automated Installation and Update of JOC Cockpit)
• ca  (holds the Certificate Authority as explained from  JS7 - How to create self-signed Certificates, not used if an external Certificate Authority is in place)
  • certs (holds CA-signed Certificates)
  • csr (holds Certificate Signing Requests)
  • private (holds Private Keys)
• config (holds configuration files)
  • agents (holds Agent configuration files)
    • instances (holds configuration files specific for an Agent)
      
      • <agent-id>(specifies the Agent ID for directories and files that are specific to an Agent)
        • config (general configuration)
          • private (specific configuration)
            • trusted-pgp-keys (optionally holds PGP public key files and keyring files used for signing, see JS7 - Deployment of Scheduling Objects)
              • <pgp-public-key> (public key file or keyring file)
              • <pgp-public-key> (public key file or keyring file)
              • ...
            • trusted-x509-keys (optionally holds X.509 certificate files used for signing, see JS7 - Deployment of Scheduling Objects)
              • <x509-certificate> (X.509 certificate file)
              • <x509-certificate> (X.509 certificate file)
              • ...
            • https-keystore.p12 (optional default location and file name of a PKCS12 truststore)
            • https-truststore.p12 (optional default location and file name of a PKCS12 truststore)
            • private.conf (optional configuration file, for example to specify keystore, truststore and Distinguished Names of Controller certificate, see JS7 - Agent Configuration Items)
            • log4j2.xml (optional log configuration file, see JS7 - Log Levels and Debug Options)
          • agent.conf (optional configuration file, see JS7 - Agent Configuration Items)
      • <agent-id>(specifies the Agent ID for directories and files that are specific to an Agent)
      • ...
    • templates (holds configuration files that act as templates for a number of Agents)
      • <ag
  • certs (holds certificate files for deployment with Agents and Controllers)
    • ca  (the optional Root Certificate Authority used for self-signed certificates)
      • <root-ca-certificate> (the Root CA Certificate file, frequently available with a .pem, .crt extension)
    • server (Server Authentication Certificates)
      • <server-certificate>^{(Server Certificate file, frequently available with a .pem, .crt extension).}
      • <server-certificate>^{(Server Certificate file, frequently available with a .pem, .crt extension).}
      • ^....
    • client (Client Authentication Certificates)
      • <client-certificate>^{(Client Certificate file, frequently available with a .pem, .crt extension).}
      • <client-certificate>^{(Client Certificate file, frequently available with a .pem, .crt extension).}
      • ...
  • controllers
    • <controller-id>(specifies the Controller ID for directories and files that are specific to a Controller)
  • joc
• desc (holds Deployment Descriptors)
  • <deployment-descriptor>.json (Deployment Descriptor .json file)
  • <deployment-descriptor>.json (Deployment Descriptor .json file)
  • ...
• release  (holds the installation tarballs for JS7 releases)
  • ... (users can apply an arbitrary directory hierarchy at this level)
    
    • js7_agent_unix.<release>.tar.gz (JS7 Agent installation tarball as download from the SOS Web Site)
    • js7_controller_unix.<release>.tar.gz (JS7 Controller installation tarball as download from the SOS Web Site)
    • js7_joc_linux.<release>.tar.gz (JS7 JOC Cockpit installation tarball as download from the SOS Web Site)
• work (the working area is preferably used to perform installation of JS7 components during packaging)
  • agents (directory for Agent installation during packaging)
    • <agent-id>(specifies the Agent ID for directories and files that are specific to an Agent)
      • ... (sub-directory used for Agent installation)
    • <agent-id>(specifies the Agent ID for directories and files that are specific to an Agent)
    • ...
  • controllers (directory for Controller installation during packaging)
    • <controller-id>(specifies the Controller ID for directories and files that are specific to a Controller)
      • ... (sub-directory used for Controller installation)
    • <controller-id>(specifies the Controller ID for directories and files that are specific to a Controller)
    • ...
  • tmp (temporary files are written to this directory, if the --keep-work switch is used when invoking the JS7 - Deployment Packaging Script then files will remain in this directory which suggests cleanup by the user)
• env.sh (Environment Script, see next chapter)

...

The Environment Script initializes a number of environment variables that map to directories as explained above:.

The script has to be invoked before running any script to install, to package and to deploy packages to target machines.



#!/bin/sh

SCRIPT_HOME=$HOME/js7.deploy

DEP_ARCHIVE="${DEP_ARCHIVE:-$SCRIPT_HOME/archive}"
DEP_BIN="${DEP_BIN:-$SCRIPT_HOME/bin}"
DEP_CONFIG="${DEP_CONFIG:-$SCRIPT_HOME/config}"
DEP_DESC="${DEP_DESC:-$SCRIPT_HOME/desc}"
DEP_INSTALL="${DEP_INSTALL:-$SCRIPT_HOME/install}"
DEP_RELEASE=/mnt/releases/scheduler_setups
DEP_TARGET="/home/sos/js7.target"
DEP_WORK="${DEP_WORK:-$SCRIPT_HOME/work}"

JAVA_HOME="${SCRIPT_HOME}"/jdk-11.0.2
PATH=${JAVA_HOME}/bin:${PATH}

export JAVA_HOME PATH DEP_ARCHIVE DEP_BIN DEP_CONFIG DEP_DESC DEP_INSTALL DEP_RELEASE DEP_TARGET DEP_WORK

...