Unsupported content This version of the documentation is no longer supported. However, the documentation is available for your convenience. You will not be able to leave comments.

Upgrading Integration Service on Solaris or Linux

You can read the S81pronto file under /etc/rc3.d/ to find the location of the installation directory for an already installed Integration Service on the Solaris or Linux computer.

Before you begin

  • If the Integration Service cell KB has any customizations, ensure that your existing customized KB is merged with the new 10.0.00 version.
  • Ensure that you have root permissions for the computer on which you want to upgrade the Integration Service.
  • Ensure that the computer on which you are upgrading the Integration Service adheres to the hardware, operating system, platform, and software requirements listed in System-requirements-and-product-compatibility.
  • Ensure that you have access to the Infrastructure Management files that you have downloaded (in binary mode) from the BMC Electronic Product Download site or from the Central Monitoring Administration.
  • Ensure that you use the binary mode when you are moving files from one system to another.

  • Ensure that the /tmp/agentlist file is present. If it is not present, then create the file and add an entry for the installed Integration Service. For example, if you have two Integration Services installed at /opt/bmc/TSIMAgent and /data1/bmc/TSIMAgent on ports 12124 and 12125 respectively, add the following two entries in the agentlist file:
    BMC TrueSight Agent 10.0 build 231209006(12124);/opt/bmc/TSIMAgent

    BMC TrueSight Agent 9.0 build 231209006(12125;/data1/bmc/BPPMAgent

To upgrade a Integration Service on Solaris or Linux

  1. Access one of the following locations and download the Integration Service installation program:
    • DVD — Insert the installation DVD. In the <installLocation>\<OperatingSystem> directory, open the TSIMServer\Windows folder.
    • BMC Software EPD website—For more information about downloading the installation program from the BMC Software EPD website, see Downloading-the-installation-files.
    • Central Monitoring Administration Console—For more information about downloading the installation program from the Central Monitoring Administration console, see Downloading-Integration-Service-software.
  2. Apply executable rights to all the installation files by running the following command:chmod -R 777 installationDirectoryFolderName installationDirectoryFolderName is the name of the folder that contains all the installation files.
  3. Run one of the following commands to set the DISPLAY environment to enable the installation program UI to launch:
    • export DISPLAY=targetHostName:0.0
    • setenv DISPLAY targetHostName:0.0
    targetHostName is the name of the computer on which you want to display the installation program UI.
  4. On a command line, run the following command as an administrator:
    ./install.sh
  5. On the Welcome page, click Next.
  6. On the License Agreement page, select I agree to the terms of the license agreement, and click Next.

    The preinstallation check utility verifies whether the computer meets the requirements for installing the Integration Service. If the preinstallation check fails, the errors or warnings are listed in the Notification page. In that case, ensure that you correct the issues, and restart the installation process.
  7. On the Existing Installed Instances Detected page, select Maintain or update the instance of this application selected below.
  8. Select the Integration Service instance to upgrade, and click Next.
  9. On the Upgrade Confirmation page, click Yes, and click Next.
    The installer automatically checks for the upgrade requirements. If it finds any errors, it displays them on a separate window. You can quit the upgrade process at this point, correct the indicated discrepancies, and then rerun the upgrade.

  10. On the Configuring KB Migration Path page, if you have already migrated customized KB definitions to the new standard 10.0.00 KB, select Yes, and browse to the path of the customized KB directory.
    The directory path must follow this hierarchy structure for each cell KB to be migrated:
    /topLevelDirectory/mergedKB/server/etc/cellName, where /server/etc/cellName is the standard subdirectory.

    Note

    If you do have KBs to migrate but have not done so yet, you can stop the upgrade process and perform the migration steps, executing the KB migration wizard as described in Migrating the configuration of cells. After you successfully migrate the KB to version 10.0.00, you can continue with this procedure.

    During the upgrade, the installer copies the KBs in the /mergedKB/server/etc/ directory and overwrites them in the default installationDirectory/pw/server/etc/cellName directory.

  11. On the Installation Preview window, click Install.
    When the upgrade is complete, the upgrade automatically starts the Integration Service processes.
  12. On the Installation Summary window, click View Log to display the installation/upgrade log.
  13. Click Done.The Integration Service is upgraded.
  14. If you are installing on the AIX platform and using DB2 Database monitors, see Finishing the upgrade process on the AIX platform.

 

Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*