Performing the Gateway Server installation on Windows
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 Microsoft Windows operating system.
The Perform Agent (agent) is automatically installed with the console, and is responsible for monitoring the health and collecting performance data of the server (console) machine itself.
The console collects data from agents, and must be installed to successfully use Gateway Server. A single instance of the console collects data from various agents.
If you install any BMC product (for example, TrueSight Infrastructure Management) on a virtual drive and later remove the drive, the installed application will not be usable.
All the applications that are installed after removing the drive will search for a common folder in previous application location. Because the applications cannot locate the folder, the installation fails.
During the installation, you can choose from the following installation types: Typical or Custom.
- Typical (use default settings): Enables you to choose the installation directory, and then uses the default for all remaining options.
- Custom (configure advanced features): Enables you to review and modify all installation options, including security level, communication protocol, and location of the BMC Perform Agent user account. For complete details about the custom options, refer to the Installation worksheet for Gateway Server and Capacity Agent on Windows
Before you begin
Before installing the console on Windows, ensure that you have:
- Reviewed the information in Considerations for installing.
- Downloaded the installation package as outlined in Downloading the installation files.
- Prepared the Windows host as described in Preparing a Windows host for installation.
- (Optional) Completed the Installation worksheet for Gateway Server and Capacity Agent on Windows.
An Investigate-only version of the Gateway Server is available on the EPD site. The installation procedure for the Investigate-only console is similar to the procedure outlined below.
To install the Gateway Server on Windows
- Extract the TSCO_GatewayServer_<version>_MSwindows.zip file to a temporary directory.
- Navigate to the image subdirectory and double-click the setup.exe file.
- On the Welcome page, click Next.
- Review the license agreement, select I agree to the terms of the license agreement, and click Next.
- BMC TrueSight Capacity Optimization Gateway Server module is selected for installation and click Next.
- 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, bringing you to the Network Configuration page (Step 13) of the wizard.
- Custom (configure advanced features): Enables you to configure all options, as described in the remainder (Steps 7 – 12) of this procedure.
- Custom installation only: Specify an installation directory, or use the default directory displayed in the Destination Directory field. Ensure that the directory you choose has enough available space. Click Next.
- Custom installation only: Choose your desired security level. When you are finished, click Next.
- Basic. Maintains network communication between the Gateway Server and Perform 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 Perform Agents. This is useful if, for example, you want to use Initiating Secure Agent data collection. Choosing this option brings you to the Network Configuration page (Step 10) of the wizard.
- Custom installation only: Configure the data collection options as required. When you are finished, click Next.
- Enable collection of historical data. Select to enable historical data collection, used to create Investigate real-time charts.
- Data Repository. Enter the path to the directory where you want to save the collected historical data.
- Set Perform Agent to start automatically. Select if you want Perform Agent to start immediately upon finishing the installation procedure.
- Service Daemon. Enter the port number to be used by the service daemon.
- Status Reporting. Enter the port number to be used for status reporting.
- Capacity Agent. Enter the port number to be used by Capacity Agent.
- General Manager. Enter the port number to be used by General Manager.
- Maximum process command length to collect. Select the maximum length, in bytes, of the process command that the agent collects.
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  - Use the IPV4 address. If the IPV4 address is not available, use the IPV6 address.
- Use IPV4  - 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  - Use the IPV6 address.
Try the IPV6 address if available and then IPV4  - Use the IPV6 address. If the IPV6 address is not available, use the IPV4 address.
- Review the information on the Installation Preview page and click Install.
- You will receive notification confirming that the installation process is complete. Click View Log for details and click Done to complete the installation process.
Visualizer ODBC file update
You must overwrite the Visualizer
odbca200.txt file with the file from the Perform Windows console (
Where to go from here
Following installation of the Gateway Server on Windows, you are ready to install the Capacity Agent on remote computers as described in Installing Capacity Agents on Windows.