Upgrade the Enterprise Manager

In a CA APM minimal installation, you can reinstall or upgrade the Enterprise Manager and Database only. In a CA APM complete installation, you install or upgrade the Enterprise Manager, WebView, APM Database, and Command Center. Upgrading Enterprise Manager enables you to retain your configurations. During the upgrade, the Introscope Installer replaces the Introscope program files, but leaves all user data and log files intact. The Installer upgrades all the configuration files and startup scripts, and performs the upgrade tasks. Obsolete files are moved to <EM_Home>/backup/<iscXx>.
apmdevops106
In a CA APM minimal installation, you can reinstall or upgrade the Enterprise Manager and Database only. In a CA APM complete installation, you install or upgrade the Enterprise Manager, WebView, APM Database, and Command Center. Upgrading Enterprise Manager enables you to retain your configurations. During the upgrade, the Introscope Installer replaces the Introscope program files, but leaves all user data and log files intact. The Installer upgrades all the configuration files and startup scripts, and performs the upgrade tasks. Obsolete files are moved to
<EM_Home>/backup/<iscXx>
.
Ensure that you have backed up your data before you begin.
3
Install Enterprise Manager as a New Installation or Upgrade
Install the current Enterprise Manager on a new computer or reuse an existing Enterprise Manager computer.
Follow these steps:
  1. Verify that all computers, virtual machines, and other components meet or exceed the recommended requirements. For more information, see Support and Compatibility.
  2. Follow the instructions for the procedure that you want to perform:
    • Install the new Enterprise Manager on a new computer. For complete installation steps, see Install the Enterprise Manager.
    • Upgrade the Enterprise Manager from the older version and reuse the existing Enterprise Manager installation folder. For more information, see Run the Enterprise Manager Upgrade.
      The following steps are specific to the upgrade of the Enterprise Manager.
Run the Enterprise Manager Upgrade
Upgrade CA APM to the current release. The following steps are specific to the upgrade only.
The Installer upgrades the Enterprise Manager only in the directory that you specified for the upgrade. Run the upgrade once for each Enterprise Manager in a cluster in a different location from the existing installation. For example, if you have two Collectors in a cluster, run the upgrade three times. First, run the upgrade on the Manager of Managers (MOM). Next, run the upgrade once each on each Collector.
Follow these steps:
  1. Start the Introscope Installer, and proceed through the
    Introduction
    and
    CA End User License Agreement
    windows. For more information about the Installer, see Launch the Installer.
  2. In the
    Choose Install Set
    window, select one of the following options, and click
    Next
    :
    • Complete Installation:
      Installs or upgrades the Enterprise Manager, WebView, APM Database, and Command Center.
    • Minimal Installation:
      Installs or upgrades only the Enterprise Manager and the APM Database.
  3. Select the individual components to install or upgrade.
    During APM Command Center-only installation or upgrade, when you point the installation to an existing
    <EM_HOME>
    directory, you lose the
    <EM_HOME>
    content. Do not point to the existing
    <EM_HOME>
    directory when creating install logs and scripts.
  4. In the
    Choose Install Folder
    screen, specify the Enterprise Manager directory that you want to upgrade.
    When you specify a directory containing an existing instance of Introscope, the Installer offers to upgrade it:
    Select
    Upgrade Existing Installation,
    and click
    Next
    .
  5. If the following information applies to your installation, the Installer gives you the option to rename the Introscope home directory:
    • The installation does not include the APM Database.
    • The installation includes the APM Database, which is installed in a directory separate from the Enterprise Manager installation directory.
    Rename the directory, or click
    Browse
    to specify an existing directory.
    The Installer creates a directory.
    To continue, click
    Next
    .
  6. (Windows only) If the Enterprise Manager or WebView are configured to run as Windows services, rename the service and display names.
    Rename, or accept old names, and click
    Next
    .
Specify Monitoring Options During Upgrade
Select all the components, extensions, and environments to monitor by default during CA APM installation. You do not need to configure the components, extensions, and environments individually post installation.
Follow these steps:
  1. On the
    Select Monitoring Options
    screen, select the components or extensions that you want to enable.
  2. Click
    Next
    to continue.
  3. On the
    Select SOA Monitoring Options
    screen, select the environments to monitor.
  4. Click
    Next
    to continue.
Confirm the Upgrade
Review the information and, if it is correct, proceed with the upgrade.
Follow these steps:
  1. Introscope displays a message dialog to ensure that the following actions are done:
    1. Introscope is shut down
    2. All Introscope services are stopped
    3. No Introscope files or folders are in use by any running process
  2. Confirm that Introscope and its related services and files are shut down and stopped, and then click
    Proceed With Upgrade
    .
    The files are installed.
  3. On the
    Enable Backup
    screen, accept the default selection.
    By default, the
    Enable Backup
    option is selected.
    If you accept the default option, the Installer backs up the existing instance of the CA APM before the upgrade starts. If the upgrade fails, the Installer creates a provision to roll back to the previous working instance of CA APM. A log detailing the configurations that migrated during the upgrade generates.
    Create a CA APM backup. If the upgrade fails, you must have a backup to roll back to the previous CA APM version or to see the configuration changes.
  4. When the upgrade installation completes, the
    Install Complete
    window opens.
  5. Clear the WebView and Enterprise Manager cache.
  6. Click
    Done
    to complete the installation.
Troubleshooting Steps
Troubleshoot the installation if you encounter any upgrade issues.
Follow these steps:
  1. Review the
    schema.log
    and
    install.log
    files for errors.
    Default directories:
    • (Linux/Solaris):
      /database
    • (Windows):
      C:\Program Files\CA APM\Introscope<version>\install\schematools.log
  2. Ensure that the Enterprise Managers and RTTM and Discovery are running correctly (
    Services
    Tab).
Integrate with AO Platform
You can connect to the CA Agile Operations Platform. The CA Agile Operations Platform provides common data lake services and CA Data Studio (Powered by Kibana). When CA APM connects to the CA Agile Operations Platform, you can view agent transaction trace information in the following APM Team Center views:
  • Business Transaction Viewer
  • Browser Agent Waterfall chart
See the Integrate with AO Platform page for detailed procedure to integrate your CA APM and CA AO Platform.