Splunk® ITSI Module for Application Performance Monitoring

Install and Configure the Splunk ITSI Module for Application Performance Monitoring

Acrobat logo Download manual as PDF


The Splunk® ITSI Module for Application Performance Monitoring will reach its End of Life on February 26, 2021.
Acrobat logo Download topic as PDF

Install the ITSI APM Module

Prerequisite

Install the supported add-ons that collect APM data for the ITSI APM Module

Steps

  1. Install the Splunk ITSI Module for Application Performance Monitoring on every Splunk search head that has ITSI installed. Follow the instructions that match your ITSI deployment:
  2. Create a new service using the ITSI APM Module service template. See Create a service from a service template in ITSI in the Service Insights manual.

Install on Splunk Cloud

To install the Splunk ITSI Module for Application Performance Monitoring, on Splunk Cloud, follow the instructions in Install apps in your Splunk Cloud deployment. If your Splunk Cloud deployment does not support self-service app installation, file a ticket on the Splunk Support Portal for assistance.

Install on a single on-premises search head

You can install the Splunk ITSI Module for Application Performance Monitoring on a single Splunk platform instance or single search head.

  1. Download the DA-ITSI-APM-<number>.tgz installation package.
  2. Stop the Splunk platform.
    cd $SPLUNK_HOME/bin
    ./splunk stop
    
  3. Extract the package into $SPLUNK_HOME/etc/apps.
    tar -xvf DA-ITSI-APM-<number>.tgz -C $SPLUNK_HOME/etc/apps
    
  4. Start the Splunk platform.
    cd $SPLUNK_HOME/bin
    ./splunk start
    

Install to multiple on-premises search heads

  1. Copy the install package to all search heads.
    scp DA-ITSI-APM-<number>.tgz username@remotehost.com:$SPLUNK_HOME/etc/apps
    
  2. On each search head, untar the install package.
    tar -xvf DA-ITSI-APM-<number>.tgz
    
  3. Restart each search head.
    cd $SPLUNK_HOME/bin
    ./splunk restart
    

Install on a search head cluster

  1. Install the Splunk ITSI Module for Application Performance Monitoring on the deployer in the shcluster/apps directory.
    1. Create a temporary directory for unzipping the data.
    2. Move the DA-ITSI-APM-<number>.tgz file to this directory.
    3. Extract the installation file.
    4. Copy all files included in the installation package from the temp location to $SPLUNK_HOME/etc/shcluster/apps/. For example:
      mkdir /tmp/itsi
      mv DA-ITSI-APM-<number>.tgz /tmp/itsi
      cd /tmp/itsi
      tar -xvf DA-ITSI-APM-<number>.tgz
      cp -R * $SPLUNK_HOME/etc/shcluster/apps/
      
  2. Push the configuration bundle from the deployer to search head cluster members.

    Do not deploy a bundle from any instance other than the deployer. Running the apply shcluster-bundle command on a non-deployer instance, such as a cluster member, deletes all existing apps and user generated content on all search head cluster members.

    1. On the deployer, under $SPLUNK_HOME/etc/shcluster/apps, create a subdirectory auth_itsi/local.
      cd $SPLUNK_HOME/etc/shcluster/apps
      mkdir auth_itsi/local
      
    2. Copy the authentication.conf file from $SPLUNK_HOME/etc/system/local/ to $SPLUNK_HOME/etc/shcluster/apps/auth_itsi/local.
      cd $SPLUNK_HOME/etc/system/local/
      cp authentication.conf $SPLUNK_HOME/etc/shcluster/apps/auth_itsi/local
      
    3. Run the splunk apply shcluster-bundle command on the deployer.
      splunk apply shcluster-bundle -target <URI>:<management_port> -auth <username>:<password>
      


      The -target parameter is required. It specifies the URI and management port for any member of the cluster. For example: https://10.0.1.14:8089. Though you specify a single cluster member, the deployer pushes the URI and management port to all members.
      The -auth parameter specifies credentials for the deployer instance. This pushes everything contained in the shcluster/ directory, including the ITSI app, all SAs, and the LDAP configuration, from the deployer to each search head cluster member.

Last modified on 30 April, 2021
PREVIOUS
Install the supported add-ons that collect APM data for the ITSI APM Module
  NEXT
KPIs and thresholds for the ITSI APM Module

This documentation applies to the following versions of Splunk® ITSI Module for Application Performance Monitoring: 1.0.0


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