Migrate bundles to new application directory structure

Starting with version 3.3, Splunk's custom bundle directory structure and terminology have both changed. The existing directory structure and nomenclature will be supported in 3.3, but a switch to the new structure will be enforced in a future release. For detailed information about the new applications directory structure, refer to the documentation about configuration files.

Splunk provides a script for migrating your existing bundles directories to the new structure. This script is not run automatically, and can be run on a per-bundle/application basis. You must restart Splunk after you run the script, each time you run it.

Things to consider

You must restart Splunk for changes to take effect.
Some custom bundles may not work after migration; in particular, bundles that contain conf files or scripts that refer to hard-coded paths might break, since migration moves files around. Consider using relative paths for flexibility.

Run the migration script

To run the script and migrate all your bundles to the new application directory structure, from $SPLUNK_HOME, run:

./splunk migrate bundle [-name value]

To migrate a single bundle to the new structure, add -name [name of the bundle]. For example:
./splunk migrate bundle -name local ./splunk migrate bundle -name code ./splunk migrate bundle

Previous: Migrate your Windows saved searches to 3.3.x | Next: Getting Help

Comments

No comments have been submitted.