Before you upgrade Splunk IT Essentials Work

Before you upgrade IT Essentials Work (ITE Work) to the latest release, follow the steps in this topic. Splunk Cloud Platform customers have to work with Splunk Support to coordinate upgrades to ITE Work.

Check admin role inheritance

Make sure the Splunk admin role inherits from the itoa_admin role. The default settings for admin role inheritance for ITE Work are contained in authorize.conf. Problems can occur when these settings have been modified in a local version of the file.

Check KV store size limits

The limit of a single batch save to a KV store collection is 500 MB. Check the total amount of data that your entities contain, and, if necessary, increase the KV store size limit in $SPLUNK_HOME/etc/apps/SA-ITOA/local/limits.conf. This setting controls the maximum size, in megabytes (MB), of the results that are returned for a single query to a collection.

Prerequisites

• Only users with file system access, such as system administrators, can increase the KV store size limit.
• Review the steps in How to edit a configuration file in the Splunk Enterprise Admin Manual.

Never change or copy the configuration files in the default directory. The files in the default directory must remain intact and in their original location.

Steps

1. Open or create a local limits.conf file in $SPLUNK_HOME/etc/apps/SA-ITOA/local/.
2. Increase the max_size_per_result_mb value in the [kvstore] stanza:

   [kvstore]
   max_size_per_result_mb = [new value]
   

Review known issues and changes

Review the following topics before you upgrade ITE Work:

1. Compatible versions of the Splunk platform. See Splunk Enterprise system requirements.
2. Known issues with the latest release of IT Service Intelligence. See Known issues in Splunk IT Essentials Work in the Release Notes Manual.

Recommendations for upgrading IT Essentials Work

Upgrade both the Splunk platform and ITE Work in the same maintenance window. See the Splunk Enterprise system requirements to verify which versions of Splunk ITE Work and Splunk Enterprise are supported with each other.

1. Upgrade Splunk Enterprise to a compatible version.
2. Upgrade Splunk platform instances.
3. Upgrade Splunk ITE Work.
4. Review, upgrade, and deploy add-ons.

Upgrading ITE Work deployed on a search-head cluster is a multi-step process. See Upgrade IT Essentials Work in a search-head cluster environment in this manual.