Upgrading the Capacity Agent

Where you are in the Upgrade process

To upgrade the Capacity Agent

1. Log in to the managed system where you want to upgrade the Capacity Agent.
   
   • (Windows) Log in as a user with administrator privileges.
   • (UNIX and Linux) Log in as a non-root user.
2. Extract the Capacity Agent installer files to a temporary directory.

1. 
   
   • (Windows) Extract  TSCO_Agent_ver11.500_MSwindows.zip
   • (UNIX and Linux) Run the following command:
     TSCO_Agent_ver<version_number>_<platform>_<architecture or image>.tar
     For example,
     • TSCO_Agent_ver11.5.00_Linux_x86-64.tar
     • TSCO_Agent_ver11.5.00_Solaris_SPARC.tar
2. (Optional) To modify values of the Agent installation properties, complete these steps:
   1. Navigate to the directory that contains the extracted files.
   2. Open the AgentSilentInstallOptions.txt file.
   3. Update values of the required parameters.
      
      Installation parameters

      
      

3. Run the following command to start the upgrade:

   • (Windows) <path_to_install.bat>\install.bat -DOPTIONS_FILE=<path_to_AgentSilentInstallOptions.txt>
     For example, C:\Users\Administrator\Downloads\installer\install.bat -DOPTIONS_FILE="C:\AgentSilentInstallOptions.txt"
   • (UNIX and Linux) ./install.sh -DOPTIONS_FILE=<path_to_AgentSilentInstallOptions.txt> 
     For example, ./install.sh -DOPTIONS_FILE=/installer/AgentSilentInstallOptions.txt

   A confirmation message is displayed indicating that the upgrade is completed.

4. (UNIX and Linux) Run the following command as a root user to configure the Agent:
   1. Change to the root user.
   2. Change to the installation directory and run the following command:
      ./b1config<version>.sh
      where version indicates the version of the installed Capacity Agent.
5. Verify the status of the upgraded Agent.

   • (Windows)
     
     1. At the command prompt, enter services.msc

   • 1. Check whether the BGS_SDService service is running.

   • Run this command to ensure that the agent daemon service (/etc/bgs/SD/bgssd.exe -d /etc/bgs/SD -s) is running as a non-root user:
     /usr/adm/best1_default/bgs/scripts/best1collect -n localhost -q
     The data collection is requested from the Gateway Server. The following example shows the result of running this command after upgrading an Agent on the clm-pun-015565 system:

     [root@clm-aus-ttmnwv Patrol3]# ps -ef | grep bgs
     root 21063 14807 0 06:39 pts/0 00:00:00 grep --color=auto bgs
     

     [perform@clm-pun-015565 Patrol3]$ /usr/adm/best1_default/bgs/scripts/best1collect -n localhost -q
     
     Warning /usr/adm/best1_default/bgs/scripts/best1collect: BEST1_HOME not set :
     guessing based on script directory
     
     best1collect on clm-pun-015565: requesting Update Status on localhost ... Wed Feb 12 06:43:46 2020
     
     Agent Query Request
     Starting(/usr/adm/best1_11.5.00/bgs/monitor/log/clm-pun-015565-bgsagent_6767.als)
     
     Collect Instance Node Started Started
     
     Name Name Name By On
     ------------ -------------- ---------- ---------- -----------------
     ------------ -------------- ---------- ---------- -----------------
     *Node: localhost has acknowledged Query request successfully.
     

     perform@clm-pun-015565 Patrol3]$ ps -ef | grep bgs
     
     perform 21204 1 0 06:43 ? 00:00:00 /usr/adm/best1_11.5.00/bgs/bin/bgsagent -b
     /usr/adm/best1_11.5.00 -a 6767 -d 6768 -u perform -i 127.0.0.1
     
     perform 21205 21204 0 06:43 ? 00:00:00 bgscollect -I noInstance -B
     /usr/adm/best1_11.5.00
     
     perform 21216 21111 0 06:44 pts/0 00:00:00 grep --color=auto bgs
     

Where to go from here

Now that you have successfully upgraded the Capacity Agent, you must complete the post-upgrade activities.