Page History

...

• to hold the script environment for JS7 - Automated Installation and Update and the JS7 - Deployment Packaging,
• to hold the configuration files and certificates for deployment of JS7 componentsproducts,
• to hold the JS7 installations per JS7 release and component product such as JOC Cockpit, Controller, Agent,
• to hold the archive of deployment packages per JS7 releases and target machine,
• to operate a JS7 Agent that is used to perform the JS7 - Deployment Workflow.

...

• archive (holds Deployment Packages)
  • <deployment-descriptor> (specifies the Deployment Descriptor)
    • agents (holds Agent Deployment Packages)
      • <agent-id>(directory for a specific Agent identified by its Agent ID)
        • js7_deploy_agent_unix.<agent-id>.<release>.config.tar.gz (tarball for the Agent's configuration directory)
        • js7_deploy_agent_unix.<agent-id>.<release>.install.tar.gz (tarball for the Agent's installation directory)
        • run_deploy_agent.sh (Deployment Script for execution on the target host)
        • run_install_agent.sh (wrapper script for the parameterized call to the js7_install_agent.sh Installer Script)
        • run_rollout_agent.sh (Rollout Script for transfer of tarballs and Deployment Script to the target host)
      • <agent-id>(directory for a specific Agent identified by its Agent ID)
      • ...
    • controllers (holds Controller Deployment Packages)
      • <controller-id> (directory for a specific Controller identified by its Controller ID)
        • <instance-type> (specifies the type of the Controller instance which is primary or secondary) 
          • js7_deploy_controller_unix.<controller-id>.<instance-type>.<release>.config.tar.gz (tarball for the Controller instance's configuration directory)
          • js7_deploy_controller_unix.<controller-id>.<instance-type>.<release>.install.tar.gz (tarball for the Controller instance's installation directory)
          • run_deploy_controller.sh (Deployment Script for execution on the target host)
          • run_install_controller.sh (Wrapper Script for the parameterized call to the js7_install_controller.sh Installer Script)
          • run_rollout_controller.sh (Rollout Script for transfer of tarballs and Deployment Script to the target host)
        • <instance-type> (specifies the type of the Controller instance which is primary or secondary) 
      • <controller-id> (directory for a specific Controller identified by its Controller ID)
      • ...
    • joc (holds JOC Cockpit Deployment Packages)
      • <joc-id>(directory for a specific JOC Cockpit identified by its Cockpit ID)
        • <instance-type> (specifies the type of the JOC Cockpit instance which is primary or secondary) 
          • js7_deploy_joc_linux.<joc-id>.<instance-type>.<release>.config.tar.gz (tarball for the JOC Cockpit instance's configuration directory)
          • js7_deploy_joc_linux.<joc-id>.<instance-type>.<release>.install.tar.gz (tarball for the JOC Cockpit instance's installation directory)
          • run_deploy_joc.sh (Deployment Script for execution on the target host)
          • run_install_joc.sh (Wrapper Script for the parameterized call to the js7_install_joc.sh Installer Script.
          • run_rollout_joc.sh (Rollout Script for transfer of tarballs and Deployment Script to the target host)
        • <instance-type> (specifies the type of the JOC Cockpit instance which is primary or secondary) 
      • <joc-id>(directory for a specific JOC Cockpit identified by its JOC Cockpit ID)
      • ...
    • js7_import_tar.gz (holds the Deployment Workflow for import to JS7 JOC Cockpit, see JS7 - Deployment Workflow)
    • run_deploy.sh (Wrapper Script to run all run_deploy_*.sh Deployment Scripts for Agent, Controller and JOC Cockpit instances in the same Deployment Descriptor)
  • <deployment-descriptor> (specifies the Deployment Descriptor)
  • ...
• bin (holds executable files, preferably individual scripts, Deployment Scripts and Installer Scripts available from JS7 - Download)
  • jq  (jq JSON processor for Linux as available from https://github.com/stedolan/jq under the license  https://opensource.org/licenses/MIT) 
  • 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)
  • js7_install_agent.sh (used to install Agents, see JS7 - Unix Shell Installation Script - js7_install_agent.sh)
  • js7_install_controller.sh (used to install Controller instances, see JS7 - Unix Shell Installation Script - js7_install_controller.sh)
  • js7_install_joc.sh (used to install JOC Cockpit instances, see JS7 - Unix Shell Installation Script - js7_install_joc.sh)
• 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 self-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 in a user environment)
      
      • <agent-id>(specifies the Agent ID for directories and files that are specific to an Agent)
        • config (general configuration)
          • private (specific configuration)
            • https-keystore.p12 (default location and file name of a PKCS12 keystore holding the Agent's private key and certificate)
            • https-truststore.p12 (default location and file name of a PKCS12 truststore holding the Root CA Certificate)
      • <agent-id>(specifies the Agent ID for directories and files that are specific to an Agent)
      • ...
    • templates (holds configuration files that ship as templates for a number of Agents)
      • <template-name> (an arbitrary directory name for templates can be used)
        • 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)
              • ...
            • private.conf (optional configuration file, for example to specify keystore, truststore and Distinguished Names of Controller certificates, 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)
      • <template-name> (an arbitrary directory name for templates can be used)
      • ...
  • controllers (holds Controller configuration files)
    • instances (holds configuration files specific for Controller instances in a user environment)
      • <controller-id>.<controller-type>(specifies the Controller ID for directories and files that are specific to a Controller instance with the instance type being primary or secondary)
        • config (general configuration)
          • private (specific configuration)
            • <controller-cert> (the Controller instance's server authentication certificate)
            • https-keystore.p12 (default location and file name of a PKCS12 keystore holding the Controller instance's private key and certificate)
            • https-truststore.p12 (default location and file name of a PKCS12 truststore holding the Root CA Certificate)
      • <controller-id>.<controller-type>(specifies the Controller ID for directories and files that are specific to a Controller)
      • ...
    • templates (holds configuration files that ship as templates for a number of Controllers)
      • <template-name> (an arbitrary directory name for templates can be used)
        • 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)
              • ...
            • private.conf (optional configuration file, for example to specify keystore, truststore and Distinguished Names of JOC Cockpit certificate, see JS7 - Controller Configuration Items)
            • log4j2.xml (optional log configuration file, see JS7 - Log Levels and Debug Options)
          • controller.conf (optional configuration file, see JS7 - Controller Configuration Items)
      • <template-name> (an arbitrary directory name for templates can be used)
      • ...
  • joc  (holds JOC Cockpit configuration files)
    • instances (holds configuration files that are specific for JOC Cockpit instance in a user environment)
      • <joc-id>.<instance-type> (holds configuration files for a JOC Cockpit instance with the instance type being primary or secondary)
        • resources (optionally holds configuration files such as the joc.properties file, keystore, truststore files etc.)
        • response (optionally holds response files, mainly the joc_install.xml response file, that will be copied to the JOC Cockpit's setup directory)
      • <joc-id>.<instance-type> (holds configuration files for a JOC Cockpit instance with the instance type being primary or secondary)
      • ...
    • templates (holds configuration files that ship as templates for a number of JOC Cockpit instances)
      • dbms (holds sample response files per supported DBMS, mainly the joc_install.xml response file and hibernate.cfg.xml file that will be copied to the JOC Cockpit's setup directory)
        • h2 (H2®)
        • mariadb (MariaDB®)
        • mssql (SQL Server®)
        • mysql (MySQL®)
        • oracle (Oracle®)
        • pgsql (PostgreSQL®)
      • http (holds sample configuration files for use with HTTP connections)
        • resources (holds configuration files such as the joc.properties file)
        • start.d (holds configuration files such as http.ini, https.ini, ssl.ini)
      • https (holds sample configuration files for use with HTTPS connections)
        • resources (holds configuration files such as the joc.properties file with keystore and truststore settings)
        • start.d (holds configuration files such as http.ini, https.ini, ssl.ini)
      • <template-name> (an arbitrary directory name for templates can be used)
      • ...
  • licenses (optionally holds files related to JS7 licenses in a user environment)
    • js7-license.jar (holds binary licensed code, see JS7 - How to apply a JS7 License Key)
    • *.pem (holds the user's license key, see JS7 - How to apply a JS7 License Key)
• desc (holds Deployment Descriptors)
  • standalone (holds sample files related to Standalone instances of JS7 Agents, Controller, JOC Cockpit)
  • cluster (holds sample files related to Cluster instances of JS7 Agents, Controller, JOC Cockpit)
  • <deployment-descriptor>.json (Deployment Descriptor .json file specific for a user environment)
  • <deployment-descriptor>.json (Deployment Descriptor .json file specific for a user environment)
  • ...
• logs (optionally holds log files)
  • deployment_package.<deployment-descriptor>.<host>.<timestamp>.log (Packaging Script log files)
  • install_js7_agent.<host>.<timestamp>.log (Agent Installer log files)
  • install_js7_controller.<host>.<timestamp>.log (Controller Installer log files)
  • install_js7_joc.<host>.<timestamp>.log (JOC Cockpit Installer log files)
• release  (holds the installation tarballs of 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 products 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-directories 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-directories 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 then files will remain in this directory which suggests cleanup by the user)
• env.sh (Environment Script, see next chapter)

...