docs.intersystems.com
InterSystems IRIS Data Platform 2019.2  /  InterSystems Cloud Manager Guide

InterSystems Cloud Manager Guide
Containerless Deployment
Previous section           Next section
InterSystems: The power behind what matters   
Search:  


If you want to use ICM to provision cloud infrastructure and deploy noncontainerized InterSystems IRIS instances on that infrastructure, or to install InterSystems IRIS on a PreExisting cluster, you can do so using containerless mode.
In essence, containerless mode replaces the containerized deployment of InterSystems IRIS by ICM with direct installation from traditional kits, while retaining all the other steps in the ICM provisioning and deployment process. This is accomplished by adding two commands to ICM and adapting several others.
In containerless mode, Docker is not installed on the provisioned nodes and the icm run command cannot be used to deploy containers on those nodes.
Enabling Containerless Mode
Enable containerless mode by adding the Containerless field to the defaults.json file with a value of True, for example:
{
    "Containerless": "True",
    "Provider": "AWS",
    "Label": "ACME",
    "Tag": "TEST"
    "LicenseDir": "/Samples/license/",
    "Credentials": "/Samples/AWS/sample.credentials",
    ...
}
Installing InterSystems IRIS
To install InterSystems IRIS on your provisioned nodes using the installation kit you have selected, use the icm install command, which does not exist in container mode. The kit is identified by the KitURL field, which specifies the path to the installation kit and can be added to either defaults.json or definitions.json. The specified kit must be all of the following:
For example, in the definitions file:
[
    {
        "Role": "DM",
        "Count": "1",
        "DataVolumeSize": "50",
        "InstanceType": "m4.xlarge",
        "KitURL": "http://kits.acme.com/iris/2019.2.0/unix/IRIS-2019.2.0.792.0-lnxrhx64.tar.gz"
    },
    {
        "Role": "AM",
        "Count": "2",
        "StartCount": "2",
        "LoadBalancer": "true",
        "KitURL": "http://kits.acme.com/iris/2019.2.0/unix/IRIS-2019.2.0.792.0-lnxrhx64.tar.gz"
    }
]
In the defaults file:
{
    "Containerless": "True",
    "KitURL": "http://kits.acme.com/iris/2019.2.0/unix/IRIS-2019.2.0.792.0-lnxrhx64.tar.gz"
    "Provider": "AWS",
    "Label": "ACME",
    "Tag": "TEST"
    "LicenseDir": "/Samples/license/",
    "Credentials": "/Samples/AWS/sample.credentials",
    ...
}
Note:
The KitURL can be a reference to a local file copied to the provisioned nodes, which may be convenient under some circumstances. For example, you can include this KitURL in the defaults file:
"KitURL": "file://tmp/IRIS-2019.2.0.792.0-lnxrhx64.tar.gz"
and use the icm scp command to copy the kit to the provisioned nodes before executing the icm install command, for example:
icm scp -localFile IRIS-2019.2.0.792.0-lnxrhx64.tar.gz -remoteFile /tmp
When you execute the icm install command, ICM installs InterSystems IRIS from the specified kit on each applicable node, resulting in output like the following:
Downloading kit on ACME-DM-TEST-0001...
Downloading kit on ACME-AM-TEST-0002...
Downloading kit on ACME-AM-TEST-0003...
...downloaded kit on ACME-AM-TEST-0002
...downloaded kit on ACME-AM-TEST-0003
...downloaded kit on ACME-DM-TEST-0001
Installing kit on ACME-AM-TEST-0003...
Installing kit on ACME-DM-TEST-0001...
Installing kit on ACME-AM-TEST-0002...
...installed kit on ACME-AM-TEST-0002
...installed kit on ACME-DM-TEST-0001
...installed kit on ACME-AM-TEST-0003
Starting InterSystems IRIS on ACME-DM-TEST-0001...
Starting InterSystems IRIS on ACME-AM-TEST-0002...
Starting InterSystems IRIS on ACME-AM-TEST-0003...
...started InterSystems IRIS on ACME-AM-TEST-0002
...started InterSystems IRIS on ACME-AM-TEST-0003
...started InterSystems IRIS on ACME-DM-TEST-0001
Management Portal available at: http://172.16.110.14:52773/csp/sys/UtilHome.csp
Uninstalling InterSystems IRIS
The icm uninstall command, which does not exist in container mode, is used in containerless mode to stop and uninstall all InterSystems IRIS instances in the deployment (without options). You can use the -role and -machine options, as usual, to limit the command to a specific role or node. For example,
icm uninstall
uninstalls InterSystems IRIS on all nodes in the deployment, while
icm uninstall -role AM
uninstalls InterSystems IRIS on the AM nodes only.
Additional Containerless Mode Commands
Several container mode commands work in the same way, or an analagous way, in containerless mode, including use of the -machine and -role options, as follows:


Previous section           Next section
Send us comments on this page
View this book as PDF   |  Download all PDFs
Copyright © 1997-2019 InterSystems Corporation, Cambridge, MA
Content Date/Time: 2019-08-23 05:35:26