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 JOC Cockpit objects.
Deployment Descriptor JSON Schema for JOC Cockpit
TODO
Examples
Standalone JOC Cockpit using HTTP Connections
The Deployment Descriptor specifies a Standalone JOC Cockpit instance:
- Host
centostest-primary
operates the JOC Cockpit instance. - JOC Cockpit makes use of HTTP connections.
Download example: joc-http-20221204.json
{
"descriptor": {
"descriptorId": "joc-http-20221204",
"title": "Install or update Standalone JOC Cockpit using HTTP connections",
"account": "sos",
"scheduled": "2022-12-02T06:19:12+01:00",
"created": "2022-11-30T23:19:12+01:00"
},
"agents": [],
"controllers": [],
"joc": [
{
"joc_001": {
"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": "/mnt/releases/scheduler_setups/2.5.0/js7_joc_linux.2.5.0.tar.gz"
},
"installation": {
"setupDir": "/home/sos/js7.target/opt/joc-primary.setup",
"home": "/home/sos/js7.target/opt/joc-primary",
"data": "/home/sos/js7.target/var/joc-primary",
"httpPort": "11446",
"isUser": true,
"isPreserveEnv": true,
"javaOptions": "-Xmx512m -Djava.security.egd=file:///dev/urandom"
},
"configuration": {
"responseDir": "joc/instances/joc_001.primary/response",
"templates": [
"joc/templates/http/resources"
]
}
}
}
}
]
}
Standalone JOC Cockpit using HTTPS Connections
The Deployment Descriptor specifies a Standalone JOC Cockpit instance:
- Host
centostest-primary
operates the JOC Cockpit instance. - JOC Cockpit makes use of HTTPS connections.
Download example: joc-https-20221204.json
{
"descriptor": {
"descriptorId": "joc-https-20221204",
"title": "Install or update Standalone JOC Cockpit using HTTPS connections",
"account": "sos",
"scheduled": "2022-12-02T06:19:12+01:00",
"created": "2022-11-30T23:19:12+01:00"
},
"agents": [],
"controllers": [],
"joc": [
{
"joc_001": {
"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": "/mnt/releases/scheduler_setups//2.5.0/js7_joc_linux.2.5.0.tar.gz"
},
"installation": {
"setupDir": "/home/sos/js7.target/opt/joc-primary.setup",
"home": "/home/sos/js7.target/opt/joc-primary",
"data": "/home/sos/js7.target/var/joc-primary",
"httpsPort": "11443",
"isUser": true,
"isPreserveEnv": true,
"javaOptions": "-Xmx512m -Djava.security.egd=file:///dev/urandom"
},
"configuration": {
"responseDir": "joc/instances/joc_001.primary/response",
"certificates": {
"keyStore": "joc/instances/joc_001.primary/resources/https-keystore.p12",
"keyStorePassword": "jobscheduler",
"keyPassword": "jobscheduler",
"trustStore": "joc/instances/joc_001.primary/resources/https-truststore.p12",
"trustStorePassword": "jobscheduler"
},
"templates": [
"joc/templates/https/resources"
]
}
}
}
}
]
}
Resources