Getting Data In

How to rename an index?

Justin_Grant
Contributor

Can we rename indexes in Splunk? If so, how?

Tags (1)
1 Solution

Simeon
Splunk Employee
Splunk Employee

As there are implications with searches and filter settings, I would not recommend doing this. Instead, I would create a new index with a similar name.

If you absolutely must rename an index, you could do so as follows (in 4.1.4 or earlier):

  1. Create a new index with the name you want (manually in the indexes.conf file or GUI)

  2. Stop Splunk

  3. Move the $SPLUNK_DB/<old_index> directory to $SPLUNK_DB/<new_index>

  4. Start Splunk

You will see that Splunk will create a new index in the old index location and use the old index with the new naming convention. After you confirm functionality, you can just delete the old index from Splunk and the system (even though it will be empty).

View solution in original post

sloshburch
Splunk Employee
Splunk Employee

This might be another approach:

You would need to run this on your indexer and deployment server to change the inputs.conf.

Update files:
grep -Ril oldIndexName ${SPLUNK_HOME} | xargs -I{} perl -pi -e "s/oldIndexName/newIndexName/g" {}

Then change folder names (I don't have a good auto-way yet):
find ${SPLUNK_HOME} -depth -name oldIndexName

0 Karma

Simeon
Splunk Employee
Splunk Employee

As there are implications with searches and filter settings, I would not recommend doing this. Instead, I would create a new index with a similar name.

If you absolutely must rename an index, you could do so as follows (in 4.1.4 or earlier):

  1. Create a new index with the name you want (manually in the indexes.conf file or GUI)

  2. Stop Splunk

  3. Move the $SPLUNK_DB/<old_index> directory to $SPLUNK_DB/<new_index>

  4. Start Splunk

You will see that Splunk will create a new index in the old index location and use the old index with the new naming convention. After you confirm functionality, you can just delete the old index from Splunk and the system (even though it will be empty).

sloshburch
Splunk Employee
Splunk Employee

TIP: Remember to update any references of the old index to the new index (inputs.conf from your forwarders).

0 Karma
Career Survey
First 500 qualified respondents will receive a $20 gift card! Tell us about your professional Splunk journey.

Can’t make it to .conf25? Join us online!

Get Updates on the Splunk Community!

Can’t Make It to Boston? Stream .conf25 and Learn with Haya Husain

Boston may be buzzing this September with Splunk University and .conf25, but you don’t have to pack a bag to ...

Splunk Lantern’s Guide to The Most Popular .conf25 Sessions

Splunk Lantern is a Splunk customer success center that provides advice from Splunk experts on valuable data ...

Unlock What’s Next: The Splunk Cloud Platform at .conf25

In just a few days, Boston will be buzzing as the Splunk team and thousands of community members come together ...