Upgrade to version 1.0.1 of the Content Pack for Third-party APM

If you have installed a previous version of the Content Pack for Third-party APM, you can upgrade to the latest version of the content pack to get access to new product features and enhancements.

Upgrading to the latest version of the content pack is a manual process that requires downtime for content pack functionality during the upgrade.

Review the following high-level steps before you upgrade:

1. Upgrade the Splunk App for Content Packs.
2. Upgrade the Content Pack for Third-party APM.
3. Review and reapply prior customizations to the upgraded content pack objects.
4. Re-enable previously active content pack objects.

Prerequisites

Review the following prerequisites before upgrading the content pack:

Create a full backup of your ITSI environment

You can choose to create a full backup of your ITSI environment in the event you need to revert the upgrade. For more information, see Overview of backing up and restoring ITSI KV store data in the Administration Manual.

Review and identify all customized or enabled content pack objects

Upgrading the content pack will both overwrite and disable any objects from the previous version of the content pack that exists in your ITSI environment. Before you upgrade, you have to identify all customized and enabled components.

ITSI uses the name of the object to detect existing objects. For example, the name of the correlation search. Review the release notes for the content pack to see which ITSI objects are in the content pack, and identify any objects that you've enabled, as well as any objects that you've modified and customized. In the remaining upgrade steps, you can refer back to this list of objects for further action.

Clone customized objects from the original content pack

Cloning a customized object from the original content pack allows you to save the modified object under a new name, which ensures that your changes aren't lost after the upgrade. Keep the cloned objects disabled. They exist only to allow you to perform a manual review of the updated content pack objects with your customizations to determine what changes to incorporate after the upgrade.

Upgrade the Splunk App for Content Packs

Perform the following steps to upgrade to the latest version of the Splunk App for Content Packs:

1. Check which version of Splunk App for Content Packs is compatible with your ITSI version. See the Deployment requirements for the content pack.
2. Download the latest version of the Splunk App for Content Packs from Splunkbase.
3. Follow the installation instructions for the content pack app. See Install the Splunk App for Content Packs.
4. Restart Splunk. See Restart Splunk Enterprise from Splunk Web in the Splunk Enterprise Admin Manual.

Upgrade the Content Pack for Third-party APM

Perform the following steps to upgrade to the latest version of the Content Pack for Third-party APM:

1. Remove the savedsearches.conf file from the $SPLUNK_HOME/etc/shcluster/apps/DA-ITSI-CP-thirdparty-apm/default/ directory on *nix based systems or %SPLUNK_HOME%\etc\shcluster\apps\DA-ITSI-CP-thirdparty-apm\default\ directory on Windows systems.
   The savedsearches.conf file from the previous version of the Content Pack for Third-party APM is redundant.
2. Perform the followiing steps to replace the existing ITSI objects from the current version of the content pack with the new ITSI objects from the latest version of the content pack:
   1. From the ITSI main menu, click Configuration > Data Integrations.
   2. Click Add structure to your data.
   3. Select the 3rd Party APM content pack.
   4. Review what's included in the content pack and then click Proceed.
   5. Under Choose which objects to install select the following:
      1. Uncheck Service analyzers (1) from Net New (1). You will install the service analyzer later in the upgrade process.
      2. Select Add all 26 objects from Already Installed (26).
   6. Under Choose a conflict resolution rule for the objects you install, select Replace existing (existing conflicts are overwritten).
      
   7. Select Install selected.
3. Install the service analyzer which is a new addition in this version of the content pack:
   1. From the ITSI main menu, click Configuration > Data Integrations.
   2. Click Add structure to your data.
   3. Select the 3rd Party APM content pack.
   4. Review what's included in the content pack and then click Proceed.
   5. Under Choose which objects to install, select Service Analyzer from Net New (1).
   6. Under Choose a conflict resolution rule for the objects you install, select Install as new (no content is overwritten).
      
   7. Select Install selected.

Review and reapply prior customizations to the upgraded content pack objects

Based on any prior customizations to the content pack objects that you identified you may need to reapply those customizations to the upgraded objects. Review modifications from the cloned objects, as well as the release notes to reapply customizations as necessary. When your prior customizations are integrated into the latest version of the content pack objects, you can remove any cloned objects.

Re-enable previously active content pack objects

After the upgrade, all previously enabled content pack objects are disabled, so you must enable the correct objects again to restore content pack functionality. Based on the content pack objects that were enabled before the upgrade, as well as any new functionality you want to begin using with the upgraded content pack version, evaluate and enable the appropriate objects.