Manually downgrading CIC Agent

When an Agent is updated to a new version, a backup of the current version is made before the update is executed. You can use this backup to manually revert to the version that was installed before the update was applied. This article describes how to revert a CIC Agent to the version that was in use prior to the most recent update.

Note: There is a command-line option that performs the downgrade without any manual steps.  See Downgrade Subcommand in CIC Agent Command Summary.

Both the Windows and Linux instructions assume the CIC Agent has been installed to the default locations:

Windows:
c:\program files\cleo\

Linux:
/opt/cleo/

The file paths used in the instructions are specific to the sub-domain used during the initial installation of the CIC Agent. Insert your sub-domain in place of the "{sub-domain}" reference used in the instructions.

Windows

Any commands entered in a command prompt assume the command prompt was started with Administrative privileges.

1. Stop the CIC Agent Service. This can be done from the Windows Service Control Panel.
   

   net stop cleo-agent-{sub-domain}

2. Back up the existing installation to a temporary location by copying the entire contents (files and sub-directories) of the installation directory.
   

   mkdir \temp\cleo-agent-backup
   xcopy "c:\program files\cleo\agent-{sub-domain}\*" \temp\cleo-agent-backup\* /S

3. Delete the files and sub-folders in the current installation directory.
   

   rmdir "c:\program files\cleo\agent-{sub-domain}" /S /Q
   mkdir "c:\program files\cleo\agent-{sub-domain}"

4. Copy the previous version backup that was created during the last update to the installation directory. Note that the backup directory name will contain the date and time the update was originally made so the actual directory name will vary.
   

   xcopy "c:\ProgramData\Cleo\agent-{sub-domain}\backup\update-1.0.25-2022-04-20T06-31-58-10-00\*" 
         "c:\program files\cleo\agent-{sub-domain}\*" /S

5. Start the CIC Agent service. This can be done from the Windows Control Panel.
   

   net start cleo-agent-{sub-domain}

   Verify the CIC Agent is running/active in the CIC Chassis and that it is now running the previous version.

Linux

1. Stop the CIC Agent Service. 
   

   sudo systemctl stop cleo-agent-{sub-domain}

2. Backup the existing installation to a temporary location by copying the entire contents (files and sub-directories) of /opt/cleo/agent-{sub-domain} to a temporary folder.
   

   sudo cp /opt/cleo/agent-{sub-domain} /tmp/cleo-agent-backup

3. Delete the files and sub-folders in the current installation directory.
   

   sudo rm -R /opt/cleo/agent-{sub-domain}/*

4. Copy the previous version backup that was created during the last update. Note that the directory name will contain the date and time the update was made so the actual directory name will vary.
   

   sudo cp -R /var/lib/cleo/agent-{sub-domain}/backup/update-1.0.25-2022-04-20T20-54-32Z/* /opt/cleo/agent-{sub-domain}/
   sudo chown -R cleo:cleo /opt/cleo/agent-{sub-domain}

5. Start the CIC Agent service.
   

   sudo systemctl start cleo-agent-{sub-domain}

6. Verify the CIC Agent is running/active in the CIC Chassis and that it is now running the previous version.
   

   ps -ef | grep java