Installing Capacity Agents on UNIX and Linux

Complete the procedure in this topic to run the Capacity Agent installation program from a UI-based wizard. The Capacity Agent application includes the system collectors and service daemon required to collect system metrics and is installed on each target computer. 

This procedure follows a custom installation, and choices are made so that all possible screens will be described.

Before you begin

  • You must have downloaded the UNIX and Linux version of the Capacity Agent application from the EPD website.
  • You must have prepared the target computers for the installation.
  • Complete the installation worksheet.
  • If applicable, stop any PATROL Agents installed on the target computers.
  • To run the installation wizard on a Ubuntu system, ensure that the libxtst6 package is installed by running the following command:
    dpkg -l | grep -i libxtst6 
    If the libxtst6 package is not installed, you can download it from  Ubuntu packages .
  • If you choose to run the installation as a non-root user, see Considerations for installing on Windows, UNIX and Linux.

To install the Capacity Agent

  1. Ensure that you are logged on as the root user, in order to run the installation.
  2. Extract the installation files to a temporary directory using:
    tar -xvf TSCO_Agent_<version>_<operatingSystem>.tar

    Note

    Ensure that the directory permissions are preserved during extraction. This avoids any folder permission related errors when you are installing from a read-only location.

  3. Navigate to the image subdirectory.
  4. Set the DISPLAY environmental variable to enable the installation program UI to launch.
    • If you are installing the product on a computer that has a local graphical console,  set the environment variable DISPLAY,to start the installer UI locally. On the installation machine:
      1. Type DISPLAY=localhost:0.0.
      2. Type export DISPLAY.
    • If you are installing on a computer that does not have a graphical console you can use, you need to set the environment variable to export DISPLAY to an X server on a different workstation. On the installation machine:
      1. Type DISPLAY=workstationName:0.0.
      2. Type export DISPLAY.
        On the workstation give access grants to every incoming X window. That is, if the workstation is a Linux machine, or running over a bash shell for Windows, type the command xhost +.
  5. Type ./setup.sh and press Enter to run the installation script.
  6. On the Welcome page, click Next.
  7. Review the license agreement, select I agree to the terms of the license agreement, and click Next.
  8. BMC TrueSight Capacity Optimization Agent is selected for installation. Click Next.
  9. Select the type of installation. When you are finished, click Next.
    • Typical (use default settings): Enables you to choose the installation directory, and then uses the default for all remaining options. Selecting this option brings you to the Configure BMC TueSight Capacity Optimization User page (Step 12) of wizard.
    • Custom (configure advanced features): Enables you to configure all options. Proceed to Step 10.
  10. Custom installation only: Specify an installation directory, or use the default directory displayed in the Destination Directory field.
  11. Custom installation only: Choose your desired security level. When you are finished, click Next.
    • Basic: Maintains network communication between the Gateway Server and Agents, and enables you to configure communication, account, collection, repository, and port options for the agents. The remainder of the procedure describes the screens you see if you choose this option.
    • Advanced: Disables network communication between the Gateway Server and Agents. This is useful if, for example, you want to use Initiating Secure Agent data collection. Choosing this option brings you to the final page of the wizard.
  12. Enter the name of the user account (install owner) that will access and use the agent, and then click Next.
    • For Typical installation, the wizard displays the Network Configuration page (Step 16).
    • For Advanced security level in the Custom installation, the wizard displays the page to configure the data repository and other options (Step 14).
  13. Custom installation only: Enter port numbers for the service daemon, Agent, and status reporting services and then click Next.
  14. Custom installation only: Configure the data repositories, install directory, and collect options as required. When you are finished, click Next.

    Select the required tab depending on the security level selected.


    • History Data Repository: The directory where you want to save the history data files.
    • Collect Data Repository: The directory where you want to save the collect data files. You can configure the location of this directory even if you disabled communication with Agent.
    • Service Daemon Installation Directory: The directory where you want to install the service daemon.
    • Enable collection of historical data: Collects historical data, used to create Investigate real-time charts.
    • Set Agent to start automatically: Starts Agent immediately upon finishing the installation procedure.
    • Create Default Link: Creates a default link, */usr/adm/best1_default, to point to the installation directory. You can configure this option even if you disabled communication with the Agent.
    • Maximum process command length to collect: Select the maximum length, in bytes, of the process command that the agent collects. You can configure this option even if you disabled communication with the Agent.
    • Configure Perform Service Daemon to run standalone: Runs the service daemon in standalone mode rather than through inetd or xinedt.
    • Collect Data Repository: The directory where you want to save the collect data files. You can configure the location of this directory even if you disabled communication with Agent.
    • Create Default Link: Creates a default link, */usr/adm/best1_default, to point to the installation directory. You can configure this option even if you disabled communication with the Agent.
    • Maximum process command length to collect: Select the maximum length, in bytes, of the process command that the agent collects. You can configure this option even if you disabled communication with the Agent.

  15. Custom installation only: On the Migration page, select the required option to configure PATROL to use BMC TrueSight Capacity Optimization Data Collector and click Next.
  16. On the Network Configuration page, select the network configuration option. The Capacity Agent can receive network communications on an IPV4 OR IPV6 network. Select one of the available options:
    • Try the IPV4 address if available and then IPV6 address [46] - Use the IPV4 address. If the IPV4 address is not available, use the IPV6 address.
    • Use IPV4 [4] - The default behavior is to use the IPV4 address. The use of 3rd party software does not allow use of the IPV6 address if the IPV4 address is not available.
    • Use IPV6 [6] - Use the IPV6 address.

    • Try the IPV6 address if available and then IPV4 [64] - Use the IPV6 address. If the IPV6 address is not available, use the IPV4 address.

  17. Click View Log for details and click Done to complete the installation process.

Where to go from here

You can perform post-installation configuration tasks listed in the following topics:

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

Comments