Performing the Gateway Server upgrade on Linux
Complete the procedure in this topic to upgrade the Gateway Server by running the installation wizard from a wizard-based UI. The procedure includes steps for a typical and custom installation on a computer running either the Linux operating system.
The Capacity Agent, which includes the system collectors and service daemon, is automatically upgraded with the Gateway Server.
Before you begin
- You must have downloaded the installation files from the EPD website.
- If you cannot run the installation program as the root user, see Considerations for installing on Windows, UNIX and Linux.
- When you upgrade the product, the installation 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.
- Because you cannot change the installation directory during an upgrade, this option does not appear in the installation wizard during an upgrade.
To upgrade the Gateway Server on 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 Capacity 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, Capacity 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 Capacity 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.
- 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.
Select Migrate configuration files to migrate the configuration files located in $BEST1_HOME/local/setup, during the upgrade.
When you upgrade Gateway Server on a Linux computer, you have the option to migrate your Manager runs from the earlier version to the upgraded version. If you plan on migrating your Manager runs, do not select Uninstall existing version on the Configure Gateway Server Migration page of the installation wizard. For more details, see Manager run migration after console upgrade.
- Select Uninstall existing version to remove the current version of Gateway Server before installing the upgrade.
- Select Configure PATROL to use new version of Perform Data Collector if you have BMC PATROL installed on the computer and you want it to use the upgraded system collectors. If you select this option, you will need to enter the directory where Patrol Agent is installed (PATROL_HOME).
- Select Configure PATROL to use the existing version of Perform Data Collector if you have BMC PATROL installed on the computer and you do not want it to use the upgraded system collectors. For example, if you have an earlier version of PATROL that you want to continue using, you can upgrade Capacity Agent only and continue to use PATROL with the earlier version collectors.
- Select Do not configure PATROL to use Perform Data Collector if you have BMC PATROL installed on the computer and you do not want to modify the existing configuration.
- Enter the path to the directory where Capacity Agent is installed in PATROL Agent Home Directory if you previously selected the option, Configure PATROL to use new version of Perform Data Collector.
- 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 or 10.5 to 10.7, ensure that the General Manager services for version 10.3 or 10.5 are not running. If they are running, stop the General Manager services for 10.3 or 10.5.