Starting with version 1.0.17, you can install multiple CIC Agents on a single machine and have them run concurrently. Agent instances are differentiated by subdomain and can service different environments or tenants.
Sub-commands to install, activate, update, and uninstall an agent instance require the --subdomain
(-s
) command-line flag.
Installed subdomain instances are not required to use the same version. For example, one instance can run the 1.0.16 version and another instance can run the 1.0.17 version.
Each subdomain instance is updated independently of other installed instances.
Note: Cloning or copying an Agent installation is not supported. Each Agent must be installed individually. For information about configuring multiple Agents for high availability (HA), see High Availability CIC Agents.
Installing Agent Instances
To install an Agent instance, use either the install
or activate
sub-commands.
For example, to install a new agent instance for subdomain "stage-apname" to the default location, run the following command:
cleo-agent-downloader install -v latest -s stage-apname
This command installs the agent to the following location:
- Windows
c:\program files\cleo\agent-stage-apname\
- Linux
/opt/cleo/agent-stage-apname/
An optional --agent-dir
flag can be used to override the base installation location:
cleo-agent-downloader install -v latest -s stage-apname --agent-dir /thirdparty/apps
results in the agent being installed to:
- Windows
c:\thirdparty\apps\agent-stage-apname\
- Linux
/thirdparty/apps/agent-stage-apname/
Linux Install Note
When installing a new subdomain instance on a Linux machine that has a previously installed agent running version 1.0.16 or earlier, the following error message displays:
Previously installed agent is required to be updated before installing another subdomain instance. You may initiate the update locally by running: sudo -u cleo ./cleo-agent-downloader update -v latest -s _legacy_ -i
You can update the previously installed agent through the Cockpit or using the command line. After the agent is updated, you can install the new subdomain instance.
Service Naming
Each subdomain is installed as a separate service and the service name includes the subdomain name.
For a subdomain named "stage-apname", the service name would be:
- Windows
cleo-agent-stage-apname
- Linux
cleo-agent-stage-apname
On Windows, the agent will appear in the service control panel as:
Cleo Agent (stage-apname)
To start the service from the command line:
- Windows
net start cleo-agent-stage-apname
- Linux SystemD
sudo systemctl start cleo-agent-stage-apname
- Linux SysVInit
sudo service cleo-agent-stage-apname start
To stop the service from the command line:
- Windows
net stop cleo-agent-stage-apname
- Linux SystemD
sudo systemctl stop cleo-agent-stage-apname
- Linux SysVInit
sudo service cleo-agent-stage-apname stop
"status" sub-command
The cleo-agent status
sub-command displays a list of currently installed agent instances.
Note: The status
sub-command requires administrative privileges.
cleo-agent status 2 agent(s) installed - Cleo Agent (legacy installer) sub-domain: _legacy_ version: pr-1144 install date: last updated: 2021-11-16T10:41:21-10:00 home: C:\Program Files\Cleo\Agent\ rest port: 17081 service: CleoAgent (running) activated: true aversion: PR-1144::46 asub-domain: _legacy_ agent id: 9e073c56-cc87-402c-a890-f2ff91d0ff0f - Cleo Agent (stage-apname) sub-domain: stage-apname version: PR-1144::46 install date: 2021-11-16T10:39:52-10:00 last updated: home: C:\Program Files\Cleo\agent-stage-apname rest port: 17082 service: cleo-agent-stage-apname (running) activated: true aversion: PR-1144::46 asub-domain: stage-apname agent id: e258cc10-bab1-4ee8-9e58-a1bf7798221a
Updating an Agent Instance
You can update an Agent instance through the Cockpit when a newer version becomes available. Alternatively, you can initiate an update from the command line using the cleo-agent update
sub-command:
- Windows
cleo-agent update -v latest -s stage-apname -i
- Linux
sudo -u cleo cleo-agent update -v latest -s stage-apname -i
This command will initiate an update for the agent instance identified by the subdomain, "stage-apname".
Backups
The update process stores a backup of the current agent instance to an instance-specific location in an OS-specific common program data location:
- Windows
C:\ProgramData\Cleo\
- Linux
/var/lib/cleo/
An update to an instance with a subdomain of stage-apname would have a backup stored at:
- Windows
c:\ProgramData\Cleo\agent-stage-apname\backup\
- Linux
/var/lib/cleo/agent-stage-apname/backup/
Uninstalling CIC Agent
You can uninstall the CIC Agent from the command line. On a Windows system, you can uninstall using "Add Remove Programs" (App & features). If uninstalling from the command line, the --sub-domain
command-line flag is required:
- Windows
cleo-agent uninstall -s stage-apname
- Linux
sudo cleo-agent uninstall -s stage-apname
This command uninstalls the instance for the "stage-apname" sub-domain. Note that the uninstall must be run with administrative privileges. To uninstall Agent version 1.0.16 or earlier (legacy install), you must use their corresponding package uninstallers.
- Windows - Add/Remove Programs
- Linux - Debian or RPM
Comments
0 comments
Please sign in to leave a comment.