Upgrading the Capacity Agent

Where you are in the Upgrade process

1Preparing for TrueSight Capacity Optimization upgrade
2Upgrade Remedy Single Sign-On
3Upgrade TrueSight Presentation Server
4Upgrade TrueSight Capacity Optimization Application Server and ETL Engine
5Upgrade TrueSight Capacity Optimization Gateway Server
6Upgrade TrueSight Capacity Optimization Capacity Agent (You are here)
7Complete the post-upgrade activities

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.

    • (WindowsExtract  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 nameDescription

      Retain the following default installation directory path or type a new path:

      • (Windows) C:\Program Files\BMC Software\Patrol3
      • (Linux/opt/bmc/Patrol3


      • (Windows) installLocation=C:\Program Files\BMC Software\Patrol3
      • (Linux) installLocation=/opt/bmc/Patrol3
      INSTALL_BPA_AGENTRetain the default selection to install the Capacity Agent.
      Example: INSTALL_BPA_AGENT=true
      (UNIX and Linux)
      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
      (UNIX and Linux)
      Specify whether you want to start the Capacity Agent after installing the Gateway Server.
      Default value: True
      PERFORM_AGENT_ENABLE_HISTORY Specify whether you want to enable the collection of historical data.
      Default value: 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

      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

      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
      PERFORM_AGENT_SERVICE_PORT Type the port number to be used by the Agent service.
      Default value: 10128
      (UNIX and  Linux) PERFORM_CREATE_DEFAULT_LINK Specify whether you want to create a default link.
      Default value: 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
      (UNIX and Linux)
      Specify whether you want to upgrade the existing version of the Capacity Agent if detected.
      Default value: True
      (UNIX and Linux) PERFORM_UNIX_UNINSTALLSpecify whether you want to uninstall the existing version of the Capacity Agent if detected.
      Default value: 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 LinuxRun 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:
      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.

Was this page helpful? Yes No Submitting... Thank you