Installation and setup overview

This topic provides an overview of how to install and set up Splunk DB Connect.

To deploy Splunk DB Connect on either a single instance of Splunk Enterprise or on a search head in a distributed deployment, you must have:

• Splunk Enterprise 6.6.0 or later, running on a supported operating system.
• One of the following supported Java environments:
  • Java Platform, Java Runtime Environment (JRE) 8 from Java Platform, Standard Edition.
  • Java Platform, Open Java Development Kit (OpenJDK) 8 from the OpenJava Project.
• A supported database running locally or elsewhere on your network.

Once the prerequisites are in place, you can start the DB Connect installation process:

1. Download and install the DB Connect add-on.
2. Install a JDBC driver for your database. See Install database drivers.
3. After installing DB Connect and restarting Splunk Enterprise, launch DB Connect.
4. Create a database identity and set up a database connection.
5. Create a new database input and use it as a data input in a Splunk Enterprise search.

For distributed deployments, there are further instructions for deploying the distributed deployment.

Deploy DB Connect to Splunk Cloud

If you want to deploy DB Connect to Splunk Cloud, contact Splunk Support for guidance and assistance. You cannot deploy DB Connect yourself because you cannot configure network access to databases on your Splunk Cloud instance. See Install an add-on in Splunk Cloud for details.

Upgrade an existing DB Connect deployment

Click the Update button and follow the wizard to upgrade your DB Connect using Splunk web, or you can download the package and install the DB Connect.

There are some known limitations on upgrading DB Connect on certain circumstances, please review the following list before upgrading.

1. If you are running DB Connect on Windows platform and want to upgrade to the higher version. You need to:
   1. On the Splunk Web home page, click Apps > Manage Apps.
   2. On the Apps page, navigate to Splunk DB Connect, and click Disable.
   3. Upgrade DB Connect and restart Splunk platform.
   4. On the Splunk Web home page, click Apps > Manage Apps.
   5. On the Apps page, navigate to Splunk DB Connect, and click Enable.
2. If you are using DB Connect (version prior to 3.0.0) and want to upgrade to DB Connect 3, see Migrate DB Connect deployment to DB Connect 3.
3. If you want to migrate DB Connect in Splunk Cloud, contact Splunk Support. Do not upgrade from previous versions yourself because you cannot migrate configuration files on your Splunk Cloud instance.