Splunk® IT Service Intelligence

Install and Upgrade Manual

Acrobat logo Download manual as PDF

Splunk IT Service Intelligence version 4.5.x will no longer be supported as of April 29, 2022. See the Splunk Software Support Policy for details. For information about upgrading to a supported version, see Before you upgrade IT Service Intelligence.
This documentation does not apply to the most recent version of ITSI. Click here for the latest version.
Acrobat logo Download topic as PDF

Upgrade IT Service Intelligence on a single instance

ITSI version 4.5.0 is a cloud-only release and is not available on-premises.

This topic describes how to upgrade Splunk IT Service Intelligence (ITSI) on an on-premises search head from version 4.2.x or later to the latest release. Splunk Cloud customers work with Splunk Support to coordinate upgrades to IT Service Intelligence.

Before upgrading

Before you upgrade ITSI, you must perform all prerequisite steps specified in Before you upgrade IT Service Intelligence.

If upgrading to the Python 3 release of Splunk (version 8.0.x), you must upgrade IT Service Intelligence and all other apps before upgrading Splunk Enterprise. For more information, see Python 3 migration with ITSI.

Step 1. Install the latest version of ITSI

On a single-instance deployment, a single Splunk Enterprise instance serves as both the search head and indexer.

You must upgrade ITSI by extracting the ITSI installation package. ITSI does not support installation using the app manager in Splunk Web or using the splunk install app command at the command line.

  1. Log in to splunk.com with your Splunk.com ID.
  2. Download the latest Splunk IT Service Intelligence product. The ITSI installation package includes the vmware_ta_itsi parent directory which contains components you need to deploy VMware data collection for SAI. If you don't want to deploy VMware data collection, remove the directory from the ITSI package before you upgrade ITSI. If you want to install the components in the vmware_ta_itsi parent directory, see Install VMware data collection add-ons and dependencies in the Install and Upgrade Splunk App for Infrastructure guide.
  3. Stop your Splunk platform instance:
    cd $SPLUNK_HOME/bin
    ./splunk stop
  4. Extract the ITSI installation package into $SPLUNK_HOME/etc/apps. For example:
    tar -xvf splunk-it-service-intelligence_<latest_version>.spl -C $SPLUNK_HOME/etc/apps

    On Windows, rename the file extension from .spl to .tgz first and use a third-party utility like 7-Zip to perform the extraction.

  5. Start your Splunk software.
    cd $SPLUNK_HOME/bin
    ./splunk start

The first time you start Splunk Enterprise after installing the new files, a migration script runs to migrate existing ITSI knowledge objects to the new version. To check migration related logs, run the following Splunk search:

index="_internal" source= "*itsi_upgrade.log*"

Step 2. Upgrade Indexers

You must place the SA-IndexCreation add-on on all indexers. For non-clustered distributed environments, copy SA-IndexCreation to $SPLUNK_HOME/etc/apps/ on individual indexers. Indexers must be running a compatible version of Splunk Enterprise. If you upgrade your indexers, verify whether you must also upgrade your search heads. For information, see Splunk Enterprise version compatibility.

If you want to collect VMware vCenter Server data with SAI, install the components in the vmware_ta_itsi parent directory. For more information about what to install on the indexers, see Install VMware data collection add-ons and dependencies in the Install and Upgrade Splunk App for Infrastructure guide.

If you have an indexer cluster, use the configuration bundle method to replicate SA-IndexCreation across all peer nodes. On the master node, place a copy of SA-IndexCreation in $SPLUNK_HOME/etc/master-apps/. For information about updating peers in an indexer cluster, see Manage app deployment across all peers in the Splunk Enterprise Managing Indexers and Clusters of Indexers manual.

Step 3. Validate the upgrade

The Splunk IT Service Intelligence upgrade process is now complete. Objects disabled during the upgrade process are automatically reenabled.

  1. In Splunk Web, click Help > About to verify that the upgrade was successful.
  2. Clear the browser cache of the browser you use to access Splunk Web. If you do not clear the browser cache, some pages might fail to load.

After upgrading

Perform the following steps after upgrading IT Service Intelligence.

  1. If there is a problem with the new version, see Troubleshoot an upgrade of IT Service Intelligence.
  2. See the Version-specific upgrade notes for ITSI for the version you upgraded to.
Last modified on 28 October, 2020
Steps to address the Apache Log4j vulnerabilities in ITSI or IT Essentials Work
Upgrade IT Service Intelligence in a search head cluster environment

This documentation applies to the following versions of Splunk® IT Service Intelligence: 4.5.0 Cloud only, 4.5.1 Cloud only

Was this documentation topic helpful?

You must be logged into splunk.com in order to post comments. Log in now.

Please try to keep this discussion focused on the content covered in this documentation topic. If you have a more general question about Splunk functionality or are experiencing a difficulty with Splunk, consider posting a question to Splunkbase Answers.

0 out of 1000 Characters