This topic describes how to upgrade the Gateway Server. The procedure assumes that you have already obtained the appropriate installation package, and that you have reviewed the information in Preparing to upgrade the Gateway Server and components.
This procedure follows a custom installation, and choices are made so that all possible screens are described.
Agent, which includes the system collectors and service daemon, is automatically upgraded with the Gateway Server.
- When you upgrade the product, the install wizard follows the path of the original installation. For example, if a typical installation was used for the original, Typical is chosen by default during the upgrade.
- Any custom parameters configured during the original installation are retained during the upgrade.
- You cannot change the installation directory during an upgrade. Therefore, the wizard page containing the option for the installation directory does not appear.
- If you are upgrading on a computer that has BMC PATROL products installed on it, you must stop BMC PATROL Agent before upgrading the Gateway Server.
To upgrade the Gateway Server
- Ensure that you are logged on as the root user. If you choose to run the installation wizard as a non-root user, see Considerations for installing on Windows, UNIX and Linux.
- Extract the installation files to a temporary directory by using
tar -xvf bpa_<component>_<version>_<operatingSystem>.tar
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.
- Navigate to the image subdirectory.
- Set the DISPLAY environmental variable to install the software through the GUI interface using:
- If you are upgrading remotely, export the display to your local computer using:
- Type ./setup.sh and press Enter to run the installation script.
- On the Welcome page, click Next.
- Review the license agreement, select I agree to the terms of the license agreement, and click Next.
Gateway Server is the selected component for installation.
- Click Next.
- The installation type used during the original installation is selected by default. Click Next.
- If the original installation was Typical, you are brought to the page where you can verify or modify the Gateway Server User name, and then to the final page of the wizard where you can review the information on the Installation Preview page and click Install to begin the installation.
- If the original installation was Custom, continue with the remainder of this procedure.
- Choose your desired security level. When you are finished, click Next.
- If the original security level was Basic, you can review and modify the communication settings between the Gateway Server and Agents, as well as the account, collection, repository, and port options for the Agents. The steps that follow describe the procedure you must perform if this option is selected.
- If the original security level was Advanced, network communication between the Gateway Server and Perform Agents is disabled. This option takes you to the page where you can configure your migration settings, from there to the page where you can configure the UNIX Populate options, and then to the final page of the wizard. Continue with this procedure from the migrate options.
- Verify or modify the name of the user account (install owner) that will access and use the console, and then click Next.
- Verify or modify the port numbers for the service daemon, Perform Agent, status reporting, and Gateway Services and then click Next.
- Verify or modify the data repositories, install directory, and collect options as required. When you are finished, click Next.
- History Data Repository. The directory where the history data files are saved.
- Collect Data Repository. The directory where the collect data files are saved.
- Service Daemon Installation Directory. The directory the service daemon is installed.
- Enable collection of historical data. Collects historical data for Investigate real-time charts.
- Set Perform Agent to start automatically. Starts Perform Agent immediately upon finishing the installation procedure.
- Create Default Link. Creates a default link, */usr/adm/best1_default, to point to the installation directory.
- Maximum process command length to collect. Reflects the maximum length, in bytes, of the process command you want the agent to collect. Verify that this parameter is correct, as it might reset to the original default (2048) during upgrade.
- Configure Perform Service Daemon to run standalone. The service daemon will run in standalone mode rather than through inetd or xinedt.
- Choose your migration options for upgrade and then click Next.
- Verify or modify 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.
- Review the information on the Installation Preview page and click Install.
You will receive a notification confirming that the installation process is complete. Click View Log for details and click Done to complete the installation process.
If you have upgraded from version 10.3 to 10.5, ensure that the General Manager services for version 10.3 are not running. If they are running, stop the General Manager services for 10.3.