Upgrading to a later 3.0.x maintenance release
This documentation does not apply to the most recent version of Splunk. Click here for the latest version.
Upgrading to a later 3.0.x maintenance release
These instructions apply when you update from any 3.0+ release to any 3.0.1 or higher release.
Depending on your installation method, you may have to perform one step to successfully upgrade from Splunk 3.0 to 3.0.1.
For rpm, pkg, and deb upgrades
If you rpm -u or use other native package upgrade options, your $SPLUNK_HOME/etc directory will be moved to etc.bak and replaced with the shipping etc. As a result you will not see your license file, users, inputs, etc.
- Create a backup of your
/etcdirectories:
-
cp -a $SPLUNK_HOME/etc/ $SPLUNK_HOME/etc.bak
-
- Upgrade Splunk using
rpm -Uon the Splunk rpm or pkg file.
- Restore your configuration to the upgraded installation by copying your backed up
/etcdirectories and files. Copy the following directories and files as indicated:
-
$SPLUNK_HOME/etc.bak/auth/*to$SPLUNK_HOME/etc/auth/ -
$SPLUNK_HOME/etc.bak/passwdto$SPLUNK_HOME/etc/ -
$SPLUNK_HOME/etc.bak/bundles/local/*to$SPLUNK_HOME/etc/bundles/local/ -
$SPLUNK_HOME/etc.bak/splunk.licenseto$SPLUNK_HOME/etc/splunk.license - For any bundles directories you have created in your existing installation, copy:
-
$SPLUNK_HOME/etc.bak/bundles/<your bundles>/to$SPLUNK_HOME/etc/bundles/
-
IMPORTANT: Copy these files and directories individually. Do not copy the entire $SPLUNK_HOME/etc.bak directory back to /etc. If you do so, the version number and other information will be incorrect.
Contact support with any questions.
For tar upgrades
For tar upgrades, it's not necessary to restore your configuration as with rpm/pkg/deb. However, Splunk recommends that you back up your /etc directories.
- Create a back up of your etc directories.
-
cp -a $SPLUNK_HOME/etc/ $SPLUNK_HOME/etc.bak
-
- Upgrade Splunk using
taron the Splunk tar file.
This documentation applies to the following versions of Splunk: 3.0.1 , 3.0.2 View the Article History for its revisions.