Install Splunk IT Service Intelligence on a single instance
Install Splunk IT Service Intelligence (ITSI) on an on-premises search head. In a single-instance deployment, a single Splunk Enterprise instance serves as both search head and indexer. Splunk Cloud Platform customers must work with Support to coordinate access to the ITSI search head.
Install ITSI by extracting the ITSI installation package. ITSI doesn't support installation using the app manager in Splunk Web or using the
splunk install app command at the command line.
For information about what and where to install in various types of distributed environments, see Where to install IT Service Intelligence in a distributed environment.
- Review the Splunk platform requirements for IT Service Intelligence. See Splunk Enterprise system requirements.
- Your Splunk ITSI instance must include the default
adminuser. Deleting or renaming this user breaks ITSI installation and operation.
- Log in to splunk.com with your Splunk.com ID.
- Download the latest Splunk IT Service Intelligence product from Splunkbase.
- Stop your Splunk platform deployment. For example:
cd $SPLUNK_HOME/bin ./splunk stop
- 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 to perform the extraction.
- Start your Splunk platform deployment. For example:
cd $SPLUNK_HOME/bin ./splunk start
Install required Java components
Using 32-bit JRE/JDK on ITSI version 4.3.x or later might cause the Rules Engine to fail with unclear errors in the search.log. If this occurs, perform the workaround described in ITSI-4663.
IT Service Intelligence requires Java 8.x - 11.x to run anomaly detection and notable event management features. You can install Java prior to or after installing ITSI but before you start running ITSI.
Install Java on all search heads running ITSI. On RHEL and Ubuntu Linux, you can install the vendor packages
java-1.8.0-openjdk on RHEL Linux and
openjdk-8-jdk on Ubuntu Linux. Alternatively, you can download and install the latest version of Oracle Java 8-11 (JRE or JDK).
JAVA_HOME environment variable is set correctly to the base of the Java installation, or the
java executable (or
java.exe in Windows) can be found using the
PATH environment variable, no additional action is required. This is typically the case if you install the vendor Java packages in Linux or OS X.
If you install Java to a custom location, for example, when you install Oracle Java directly from Oracle's website, and neither
JAVA_HOME is set to the Java installation, you must add the bin bath of the JDK in
$HOME/.bashrc. Perform the following steps:
- Change to your home directory.
- Open the .bashrc file.
- Add the following line to the file. Replace the JDK directory with the name of your java installation directory.
export PATH=/usr/java/<JDK Directory>/bin:$PATH
- Save the file and exit.
- Use the source command to force Linux to reload the .bashrc file which normally is read only when you log in each time.
If you want to set the
PATH for all users, you need to log in as root in the bash shell and perform the above steps on the .profile file in the etc directory and not the .bashrc file in the home directory.
(Optional) Install required Predictive Analytics add-ons
If you plan to use the ITSI Predictive Analytics capabilities, install the Splunk Machine Learning Toolkit (MLTK) and the Python for Scientific computing add-on. These add-ons are only required if you plan to use Predictive Analytics to predict service health scores. For more information, see Set up Predictive Analytics in ITSI.
- Install the Python for Scientific Computing add-on version 1.3 or later for your operating system from Splunkbase:
- Install the latest version of the Splunk MLTK. Follow the steps in Install the Splunk Machine Learning Toolkit in the MLTK User Guide.
- Give the MLTK app Global permissions:
- In ITSI, click App: IT Service Intelligence > Manage Apps.
- In the filter bar, enter
Splunk Machine Learning Toolkit.
- Click Permissions.
- Ensure that All apps is selected.
- Click Save.
About the ITSI installation package
The ITSI installation package places the following directories in
To use CIM-based data models with ITSI, you must manually install
Python 3 migration with ITSI
Where to install IT Service Intelligence in a distributed environment
This documentation applies to the following versions of Splunk® IT Service Intelligence: 4.4.0, 4.4.1, 4.4.2, 4.4.3, 4.4.4, 4.4.5, 4.7.0, 4.7.1, 4.7.2, 4.7.3, 4.7.4, 4.9.0, 4.9.1, 4.9.2, 4.9.3, 4.9.4, 4.9.5, 4.9.6