- Created by Andreas Püschel, last modified on Dec 19, 2022
You are viewing an old version of this page. View the current version.
Compare with Current View Page History
« Previous Version 5 Next »
Introduction
In the JS7 - Deployment process a Deployment Descriptor specifies
- which JS7 components of JOC Cockpit, Controller instances and Agents should be installed,
- where to install each JS7 component,
- which installation options to use, for example the installation directory,
- which configuration options to use, for example port usage.
Deployment Descriptors are specified from files in JSON format and include instructions, for example to deploy a larger number of Agents on target machines.
The JS7 - Deployment Packaging makes use of the Deployment Descriptor to install and to package JS7 components.
Deployment Descriptor
Deployment Descriptors are specified from .json files.
- Users are strongly encouraged to validate their .json files against the Deployment Descriptor Schema, see JS7 - Deployment Descriptor JSON Schema.
- The basic structure includes to specify an array of Agent, Controller and JOC Cockpit objects.
Examples
Agent, Standalone Controller and JOC Cockpit using HTTP Connections
The Deployment Descriptor specifies a complete job scheduling environment including
- Host
centostest-primaryoperating an Agent, a Standalone Controller instance and JOC Cockpit instance. - All components use HTTP connections.
Download example: agent-controller-joc-http-2022-12-04.json
Example for Deployment Descriptor Expand source
{
"descriptor": {
"descriptorId": "agent-controller-joc-http-20221204",
"title": "Install or update Agent, Controller and JOC Cockpit using HTTP connections",
"account": "sos",
"scheduled": "2022-12-02T06:19:12+01:00",
"created": "2022-11-30T23:19:12+01:00"
},
"agents": [
{
"agent_001": {
"target": {
"connection": {
"host": "centostest-primary",
"port": 22
},
"authentication": {
"method": "publickey",
"user": "sos",
"keyFile": "/home/sos/.ssh/sos_rsa"
},
"packageLocation": "/tmp",
"execPre": "StopService",
"execPost": "StartService",
"makeService": true
},
"media": {
"release": "2.5.0",
"tarball": "2.5.0/js7_agent_unix.2.5.0.tar.gz"
},
"installation": {
"home": "/opt/sos-berlin.com/js7/agent-primary",
"data": "/var/sos-berlin.com/js7/agent-primary",
"httpPort": "31445"
}
}
}
],
"controllers": [
{
"standalone": {
"primary": {
"target": {
"connection": {
"host": "centostest-primary",
"port": 22
},
"authentication": {
"method": "publickey",
"user": "sos",
"keyFile": "/home/sos/.ssh/sos_rsa"
},
"packageLocation": "/tmp",
"execPre": "StopService",
"execPost": "StartService",
"makeService": true
},
"media": {
"release": "2.5.0",
"tarball": "2.5.0/js7_controller_unix.2.5.0.tar.gz"
},
"installation": {
"home": "/opt/sos-berlin.com/js7/controller-primary",
"data": "/var/sos-berlin.com/js7/controller-primary",
"httpPort": "21444"
},
"configuration": {
"templates": [
"controllers/templates/http.primary/config"
]
}
}
}
}
],
"joc": [
{
"standalone": {
"primary": {
"target": {
"connection": {
"host": "centostest-primary",
"port": 22
},
"authentication": {
"method": "publickey",
"user": "sos",
"keyFile": "/home/sos/.ssh/sos_rsa"
},
"packageLocation": "/tmp",
"execPre": "StopService",
"execPost": "StartService",
"makeService": true
},
"media": {
"release": "2.5.0",
"tarball": "2.5.0/js7_joc_linux.2.5.0.tar.gz"
},
"installation": {
"setupDir": "/opt/sos-berlin.com/js7/joc-primary.setup",
"home": "/opt/sos-berlin.com/js7/joc-primary",
"data": "/var/sos-berlin.com/js7/joc-primary",
"httpPort": "11446",
"isUser": true,
"isPreserveEnv": true,
"javaOptions": "-Xmx512m -Djava.security.egd=file:///dev/urandom"
},
"configuration": {
"responseDir": "joc/templates/http/response",
"templates": [
"joc/templates/http/resources"
]
}
}
}
}
]
}
Agents, Controller Cluster and JOC Cockpit Cluster using HTTPS Connections
The Deployment Descriptor specifies a complete job scheduling environment including
- Host
centostest-primaryandcentostest-secondaryeach operate an Agent, a Controller instance and a JOC Cockpit instance. - Controller and JOC Cockpit instances on both hosts act as a cluster. Use of clustering includes to deploy a JS7 license.
- All components use HTTPS connections and are equipped with certificates.
Download example: agent-controller-joc-https-2022-12-04.json
Example for Deployment Descriptor Expand source
{
"descriptor": {
"descriptorId": "joc-controller-agents-all-20221204",
"title": "Install or update Agent, Controller and JOC Cockpit using HTTPS connections",
"account": "sos",
"scheduled": "2022-12-02T06:19:12+01:00",
"created": "2022-11-30T23:19:12+01:00"
},
"license": {
"licenseKeyFile": "licenses/sos.pem",
"licenseBinFile": "licenses/js7-license.jar"
},
"certificates": {
"controller": {
"primaryControllerCert": "controllers/instances/cluster.primary/config/private/centostest-primary.crt",
"secondaryControllerCert": "controllers/instances/cluster.secondary/config/private/centostest-secondary.crt"
},
"joc": {
"primaryJocCert": "joc/instances/cluster.primary/resources/centostest-primary.crt",
"secondaryJocCert": "joc/instances/cluster.primary/resources/centostest-secondary.crt"
}
},
"agents": [
{
"agent_001": {
"target": {
"connection": {
"host": "centostest-primary",
"port": 22
},
"authentication": {
"method": "publickey",
"user": "sos",
"keyFile": "/home/sos/.ssh/sos_rsa"
},
"packageLocation": "/tmp",
"execPre": "StopService",
"execPost": "StartService",
"makeService": true
},
"media": {
"release": "2.5.0",
"tarball": "2.5.0/js7_agent_unix.2.5.0.tar.gz"
},
"installation": {
"home": "/opt/sos-berlin.com/js7/agent-primary",
"data": "/var/sos-berlin.com/js7/agent-primary",
"httpPort": "localhost:31445",
"httpsPort": "centostest-primary:31443"
},
"configuration": {
"controller": {
"controllerId": "cluster"
},
"certificates": {
"keyStore": "agents/instances/agent_001/config/private/https-keystore.p12",
"keyStorePassword": "jobscheduler",
"keyPassword": "jobscheduler",
"trustStore": "agents/instances/agent_001/config/private/https-truststore.p12",
"trustStorePassword": "jobscheduler"
},
"templates": [
"agents/templates/https/config"
]
}
}
},
{
"agent_002": {
"target": {
"connection": {
"host": "centostest-secondary",
"port": 22
},
"authentication": {
"method": "publickey",
"user": "sos",
"keyFile": "/home/sos/.ssh/sos_rsa"
},
"packageLocation": "/tmp",
"execPre": "StopService",
"execPost": "StartService",
"makeService": true
},
"media": {
"release": "2.5.0",
"tarball": "2.5.0/js7_agent_unix.2.5.0.tar.gz"
},
"installation": {
"home": "/opt/sos-berlin.com/js7/agent-secondary",
"data": "/var/sos-berlin.com/js7/agent-secondary",
"httpPort": "localhost:32445",
"httpsPort": "centostest-secondary:32443"
},
"configuration": {
"controller": {
"controllerId": "cluster"
},
"certificates": {
"keyStore": "agents/instances/agent_002/config/private/https-keystore.p12",
"keyStorePassword": "jobscheduler",
"keyPassword": "jobscheduler",
"trustStore": "agents/instances/agent_002/config/private/https-truststore.p12",
"trustStorePassword": "jobscheduler"
},
"templates": [
"agents/templates/https/config"
]
}
}
}
],
"controllers": [
{
"cluster": {
"primary": {
"target": {
"connection": {
"host": "centostest-primary",
"port": 22
},
"authentication": {
"method": "publickey",
"user": "sos",
"keyFile": "/home/sos/.ssh/sos_rsa"
},
"packageLocation": "/tmp",
"execPre": "StopService",
"execPost": "StartService",
"makeService": true
},
"media": {
"release": "2.5.0",
"tarball": "2.5.0/js7_controller_unix.2.5.0.tar.gz"
},
"installation": {
"home": "/opt/sos-berlin.com/js7/controller-primary",
"data": "/var/sos-berlin.com/js7/controller-primary",
"httpPort": "localhost:21444",
"httpsPort": "centostest-primary:21443",
"javaOptions": "-Xmx256m"
},
"configuration": {
"certificates": {
"keyStore": "controllers/instances/cluster.primary/config/private/https-keystore.p12",
"keyStorePassword": "jobscheduler",
"keyPassword": "jobscheduler",
"trustStore": "controllers/instances/cluster.primary/config/private/https-truststore.p12",
"trustStorePassword": "jobscheduler"
},
"templates": [
"controllers/templates/https.primary/config"
]
}
},
"secondary": {
"target": {
"connection": {
"host": "centostest-secondary",
"port": 22
},
"authentication": {
"method": "publickey",
"user": "sos",
"keyFile": "/home/sos/.ssh/sos_rsa"
},
"packageLocation": "/tmp",
"execPre": "StopService",
"execPost": "StartService",
"makeService": true
},
"media": {
"release": "2.5.0",
"tarball": "2.5.0/js7_controller_unix.2.5.0.tar.gz"
},
"installation": {
"home": "/opt/sos-berlin.com/js7/controller-secondary",
"data": "/var/sos-berlin.com/js7/controller-secondary",
"httpPort": "localhost:22444",
"httpsPort": "centostest-secondary:22443",
"javaOptions": "-Xmx256m"
},
"configuration": {
"certificates": {
"keyStore": "controllers/instances/cluster.secondary/config/private/https-keystore.p12",
"keyStorePassword": "jobscheduler",
"keyPassword": "jobscheduler",
"trustStore": "controllers/instances/cluster.secondary/config/private/https-truststore.p12",
"trustStorePassword": "jobscheduler"
},
"templates": [
"controllers/templates/https.secondary/config"
]
}
}
}
}
],
"joc": [
{
"cluster": {
"primary": {
"target": {
"connection": {
"host": "centostest-primary",
"port": 22
},
"authentication": {
"method": "publickey",
"user": "sos",
"keyFile": "/home/sos/.ssh/sos_rsa"
},
"packageLocation": "/tmp",
"execPre": "StopService",
"execPost": "StartService",
"makeService": true
},
"media": {
"release": "2.5.0",
"tarball": "2.5.0/js7_joc_linux.2.5.0.tar.gz"
},
"installation": {
"setupDir": "/opt/sos-berlin.com/js7/joc-primary.setup",
"home": "/opt/sos-berlin.com/js7/joc-primary",
"data": "/var/sos-berlin.com/js7/joc-primary",
"httpPort": "localhost:11446",
"httpsPort": "centostest-primary:11443",
"isUser": true,
"isPreserveEnv": true,
"javaOptions": "-Xmx512m -Djava.security.egd=file:///dev/urandom"
},
"configuration": {
"responseDir": "joc/templates/https/response",
"certificates": {
"keyStore": "joc/instances/cluster.primary/resources/https-keystore.p12",
"keyStorePassword": "jobscheduler",
"keyPassword": "jobscheduler",
"trustStore": "joc/instances/cluster.primary/resources/https-truststore.p12",
"trustStorePassword": "jobscheduler"
},
"templates": [
"joc/templates/https/resources"
]
}
},
"secondary": {
"target": {
"connection": {
"host": "centostest-secondary",
"port": 22
},
"authentication": {
"method": "publickey",
"user": "sos",
"keyFile": "/home/sos/.ssh/sos_rsa"
},
"packageLocation": "/tmp",
"execPre": "StopService",
"execPost": "StartService",
"makeService": true
},
"media": {
"release": "2.5.0",
"tarball": "2.5.0/js7_joc_linux.2.5.0.tar.gz"
},
"installation": {
"setupDir": "/opt/sos-berlin.com/js7/joc-secondary.setup",
"home": "/opt/sos-berlin.com/js7/joc-secondary",
"data": "/var/sos-berlin.com/js7/joc-secondary",
"httpPort": "localhost:12446",
"httpsPort": "centostest-secondary:12443",
"isUser": true,
"isPreserveEnv": true,
"javaOptions": "-Xmx512m -Djava.security.egd=file:///dev/urandom"
},
"configuration": {
"responseDir": "joc/templates/https/response",
"certificates": {
"keyStore": "joc/instances/cluster.secondary/resources/https-keystore.p12",
"keyStorePassword": "jobscheduler",
"keyPassword": "jobscheduler",
"trustStore": "joc/instances/cluster.secondary/resources/https-truststore.p12",
"trustStorePassword": "jobscheduler"
},
"templates": [
"joc/templates/https/resources"
]
}
}
}
}
]
}
Resources
- No labels
Overview
Content Tools