Upgrade and downgrade Splunk DB Connect

How to upgrade Splunk DB Connect

Throughout the life of DB Connect we have had to adapt to changes in architecture and functionality, so we have implemented migration logic to make these updates transparent to Customers. However, for simplicity and to reduce the time spent on maintenance and implementation of migrations, in some cases it is not possible to migrate from one version to another. We recommend reviewing the table described below to help with the upgrade process.

Upgrade paths to version 4.x.x

Please review the following table carefully to choose the right migration path for your case. Not shown are some of the versions that have actually introduced major disruptive changes, those versions are: 3.10.0 and 3.14.0

Current version	First upgrade	Second upgrade	Latest available	Release notes
2.x.x	3.9.0	3.18.0	4.x.x	3.9.0 3.18.0
3.x.x	3.18.0	4.x.x		3.18.0

Downgrade from DB Connect version 3.14.0 or higher to DB Connect version 3.13.0 or lower

Due to changes related to encryption algorithm introduced in 3.14.0, if you need to downgrade to a version prior to 3.14.0 you will need to follow these steps:

1. Open $SPLUNK_HOME/etc/apps/splunk_app_db_connect/local/dbx-migration.conf in edit mode.
2. Go to the [encryption] stanza and change downgrade from NONE to PENDING.
3. Restart Splunk DB Connect.

Upgrade from DB Connect version 3.13.0 or lower to DB Connect version 3.14.0 or higher if you've previously downgraded Splunk DB Connect

1. Open $SPLUNK_HOME/etc/apps/splunk_app_db_connect/local/dbx-migration.conf in edit mode.
2. Go to the [encryption] stanza and change upgrade from DONE to PENDING.
3. Restart Splunk DB Connect.

Note: For more useful information, you can refer to $SPLUNK_HOME/etc/apps/splunk_app_db_connect/README/dbx-migration.conf.spec.