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.
   

   • (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
3. (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

      
      

      Parameter name	Description
      installLocation	Retain the following default installation directory path or type a new path: (Windows) C:\Program Files\BMC Software\Patrol3 (Linux) /opt/bmc/Patrol3 Examples:  (Windows) installLocation=C:\Program Files\BMC Software\Patrol3 (Linux) installLocation=/opt/bmc/Patrol3
      INSTALL_BPA_AGENT	Retain the default selection to install the Capacity Agent. Example: INSTALL_BPA_AGENT=true
      (UNIX and Linux) BPA_USER	Type the user name for installing the Capacity Agent. It is recommended to install as a non-root user. Default value: perform (root user) or any current non-root user Example: BPA_USER=Sam
      (Windows) PERFORM_AGENT_START_WINDOWS	Specify whether you want to start the Capacity Agent after installing the Gateway Server. Default value: True Example: PERFORM_AGENT_START_WINDOWS=True
      (UNIX and Linux) PERFORM_AGENT_START_UNIX	Specify whether you want to start the Capacity Agent after installing the Gateway Server. Default value: True Example: PERFORM_AGENT_START_UNIX=True
      PERFORM_AGENT_ENABLE_HISTORY	Specify whether you want to enable the collection of historical data. Default value: True Example: PERFORM_AGENT_ENABLE_HISTORY=True
      PERFORM_AGENT_HISTORY_REPOSITORY	Type a directory to store the collected historical data. Default value: (Windows) C:\Program Files\BMC Software\Patrol3\BEST1\<version_number>\History (UNIX and Linux) /opt/bmc/Patrol3/perform/history Example: PERFORM_AGENT_HISTORY_REPOSITORY=C:\Program Files\BMC Software\Patrol3\BEST1\11.5.00\History
      (UNIX and Linux) PERFORM_AGENT_COLLECT_REPOSITORY	Type a directory path to store the data collected daily. Default value: /opt/bmc/Patrol3/perform/collect Example: PERFORM_AGENT_COLLECT_REPOSITORY=/opt/bmc/Patrol3/perform/collect
      (Windows)  PERFORM_AGENT_MIGRATION	Specify whether you want to migrate old configuration files of Capacity Agents. Default value: True Example: PERFORM_AGENT_MIGRATION=True
      PERFORM_AGENT_PORT	Type the port number to be used by the Capacity Agent. Default value: 6767 Example: PERFORM_AGENT_PORT=6767
      PERFORM_INVESTIGATE_PORT	Type the port number to be used by the Investigate. Default value: 6768 Example: PERFORM_INVESTIGATE_PORT=6768
      PERFORM_AGENT_SERVICE_PORT	Type the port number to be used by the Agent service. Default value: 10128 Example: PERFORM_AGENT_SERVICE_PORT=10128
      (UNIX and  Linux) PERFORM_CREATE_DEFAULT_LINK	Specify whether you want to create a default link. Default value: True Example: PERFORM_CREATE_DEFAULT_LINK=True
      PERFORM_PROCESS_LENGTH	Type the process command length that the Agent must collect. Default value: 2048 Other possible values are 4096, 8192, 16384, and 32768 Example: PERFORM_PROCESS_LENGTH=2048
      PERFORM_SECURITY_CONFIGURATION_TYPE	Type Basic or Advanced security level that you want to use for communication between the Gateway Server and the Application Server. Use Advanced when a direct network connection does not exist between the Agent and the Gateway Server. Default value: BASIC Example: PERFORM_SECURITY_CONFIGURATION_TYPE=BASIC
      (UNIX and Linux) PERFORM_UNIX_MIGRATION	Specify whether you want to upgrade the existing version of the Capacity Agent if detected. Default value: True Example: PERFORM_UNIX_MIGRATION=True
      (UNIX and Linux) PERFORM_UNIX_UNINSTALL	Specify whether you want to uninstall the existing version of the Capacity Agent if detected. Default value: False Example: PERFORM_UNIX_UNINSTALL=False

4. 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.

5. (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.
6. Verify the status of the upgraded Agent:
   
   • (Windows)
     
     1. At the command prompt, enter services.msc
        
     2. Check whether the BGS_SDService service is running.
   • (UNIX and Linux)
     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:
     ps -ef | grep bgs

Where to go from here

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