uc4 agent upgrade document from 11.2 to 12.x.x

[penu]

Hi, 

       the uc4 agents running on my linux machines are on 11.2 and i am planning to uprgde the version both on uc4 server and the uc4 clients

can i get a proper document to upgrade the current uc4 version to the higer versions.

[Tim Osgood]

I don't have my upgrade instructions from 11.2 to 12.1 but the below are for the upgrade from 12.1 to 12.3 I gave my server admins.  This includes installing the CA.PKI.  I have done some editing based on what I remeber from my 12.1 upgrade but should be close.  These are the condensed version instructions I created from https://docs.automic.com/documentation/webhelp/english/AA/12.3/DOCU/12.3/Automic%20Automation%20Guides/help.htm#Installation_Manual/InstallAgents/InstallAgentUNIX.htm%3FTocPath%3DInstalling%7CManual%2520Installation%7CInstalling%2520the%2520Agents%7C_____11

The key to the UNIX upgrade is permissions.  Make a copy of the old Automic folder so you can reference them after the fact.  

PREREQUISITE
Set up steps can be completed prior to upgrade.  You may already have a folder named something like /opt/Automic_files, leave this folder alone for the moment.

I downloaded the full image and created zips for the Agent Unix and CA.PKI Unix and then uploaded them to the server, so all my pathing statements may look different in your environment using the full image.

Automation.Engine_Image_12_3_19-09-26-1.zip

CA.PKI_Installer_5_2_4+build.2.zip

SETUP

UNIX/Linux

1. Find the <path> to your existing Automic folder
2. sudo su - automic_svc  (or your service account name for Automic)
3. Place AutomicAgents123_UNIX.zip provided into the same root as your Automic folder /<path>/Automic
4. Unzip the file - this will create /<path>/AutomicAgents123 (this is based on my zip creation)
5. Extract all files from CA.PKI_Installer_UNIX.zip into the /<path>/Automic folder
1. This will create /<path>/Automic/linux/x64 folder  (this is based on my zip creation)
2. Navigate to /<path>/Automic/linux/x64 folder
3. chmod +x setup
6. Create backup of Automic 11.2 files
1. Make a copy of /<path>/Automic as /<path>/Automic_112

Automic Agent Installation For UNIX/Linux - Upgrade

**Make sure you are performing the following actions as the service account that has been setup for Automic (e.g., automic_svc) ** 

1. sudo su - automic_svc  (or your service account name)
2. Find the Automic process that is running
1. ps -ef | grep ucx
3. Kill the process  
1. kill -9 <pid>
4. Navigate to the /<path>/Automic/PKI/Linux/x64 folder
1. Change user to root
2. Run ./setup install caller=<server name> veryverbose env=all
1. I used the server name to make it unique
3. echo $?   This should return 0
5. Navigate to the /<path>/Automic folder
1. sudo su - automic_svc
2. Run the following command (check the path statement)
3. tar -zxvf /<path>/AutomicAgents123/Agents/unix/linux/x64/ucxjlx6.tar.gz
4. Check your permissions.  Make them match the permissions in your old Automic and Automic/bin folders (Automic_112). 
1. If needed... Navigate to the /<path>/Automic/Agents/Unix/bin
1. The ucxjlx6.exe should have root permissions
2. The ucxjlx6.exe should have the S bit set
1. chmod 4755 ucxjlx6.exe
3. The ucxjlx6.log should have root permissions
5. Your ucxjlx6.ini file will need to be updated to match your previous settings for these elements
1. name=<server name>
2. system=AUTOMICD
3. license_Class=V
4. [TCP/IP] cp=<AE IP>:2217
5. port=2300
6. Restart the Automic Service
1. Navigate to the /<path>/Automic/bin (check path)
2. nohup ./ucxjlx6 1> ucxjlx6.log 2>&1 &
7. Check that the ucx process is running
1. ps -ef | grep ucx
8. Verify Agent connection in AWI client 0
9. Once you have done some testing you can delete the Automic_112 folder

------------------------------
Developer
State of Colorado
------------------------------