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 9.6.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/BPPMAgent and /data1/bmc/BPPMAgent on ports 12124 and 12125 respectively, add the following two entries in the agentlist file:
    BMC Proactive Agent 9.0 build 231209006(12124);/opt/bmc/BPPMAgent

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

To upgrade a Integration Service on Solaris or Linux

  1. Failed to execute the [excerpt-include] macro. Cause: [Error number 2 in 0: No wiki with id [confluencePage:page] could be found]. Click on this message for details.
  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. Failed to execute the [excerpt-include] macro. Cause: [Error number 2 in 0: No wiki with id [confluencePage:page] could be found]. Click on this message for details.
  5. Failed to execute the [excerpt-include] macro. Cause: [Error number 2 in 0: No wiki with id [confluencePage:page] could be found]. Click on this message for details.
  6. Failed to execute the [excerpt-include] macro. Cause: [Error number 2 in 0: No wiki with id [confluencePage:page] could be found]. Click on this message for details.
  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 9.6.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 9.6.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*