Performing the Gateway Server installation on Linux

Complete the procedure in this topic to run the installation program for the Gateway Server from a wizard-based UI. The procedure includes steps for a typical and custom installation on a computer running the Linux operating system. 


The Capacity Agent is automatically installed with the Gateway, and is responsible for monitoring the health and collecting performance data of the server computer itself.

The Gateway Server collects data from Capacity Agents. A single instance of the Gateway Server collects data from various Capacity Agents.

Before you begin

Before you install the Gateway Server on Linux, ensure that you complete the following tasks:

To install the Gateway Server

  1. Extract the installation files to a temporary directory using:
    tar -xvf TSCO_GatewayServer_<version>_Linux.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.

  2. Navigate to the image subdirectory.
  3. 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 computer:
      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 computer:
      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 computer, or running over a bash shell for Windows, type the command xhost +.
  4. Run setup.sh.
  5. On the Welcome page, click Next.
  6. Review the license agreement, select I agree to the terms of the license agreement, and click Next.
  7. BMC TrueSight Capacity Optimization Gateway Server is selected for installation. Click Next.
  8. Select the type of installation and 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 11) of the wizard.
    • Custom (configure advanced features): Enables you to configure all options, as described in the remainder (Steps 9 – 16) of this procedure.
  9. Custom installation only: Specify an installation directory, or use the default directory displayed in the Destination Directory field.
  10. Custom installation only: Choose your required security level and click Next.
    • Basic. Maintains network communication between the Gateway Server and TrueSight Capacity Optimization 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 Capacity Agents. This option is useful for example, if you want to use Initiating Secure Agent data collection. Choosing this option brings you to the final page of the wizard.
  11. Enter the name of the user account (install owner) that will access and use the console, 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 13).
  12. Custom installation only: Enter port numbers for the service daemon, Capacity Optimization Agent, Status Reporting, and Gateway Manager and then click Next.
  13. Custom installation only: Configure the data repositories, install directory, and collect options as required and then 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 disable communication with TrueSight Capacity Optimization 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 TrueSight Capacity Optimization Agent to start automatically. Starts Capacity 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 disable communication with Capacity 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 disable communication with TrueSight Capacity Optimization 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 disable communication with TrueSight Capacity Optimization 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 disable communication with Capacity 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 disable communication with TrueSight Capacity Optimization Agent.

  14. 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.
     
  15. Custom installation only: Configure the options for UNIX Populate, and then click Next.
    • Configure UNIX Populate. Enables you to configure and populate the Solaris Oracle database.
    • Oracle Client home directory. Available only if Configure UNIX Populate is selected, the directory where Oracle Client is installed.
  16. On the Network Configuration page, select the network configuration option. The Gateway Server 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. Review the information on the Installation Preview page and click Install.
  18. You will receive notification confirming that the installation process is complete. Click View Log for details and click Done to complete the installation process.

Where to go from here

After you have installed the Gateway Server on Linux, you are ready to install the Agent on remote computers as described in Installing Capacity Agents on UNIX and Linux.

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

Comments