Manually Reindex Solr Collections

Last updated
Save as PDF

For supported software information, click here.

When you perform an Analytics upgrade that upgrades the Solr version on existing nodes, collections (search indexes) created on the older Solr version can become incompatible with the newer Solr version. For a typical upgrade, you run the van_cluster_installer.py script from the Director node to perform this operation. With some older releases, certain deprecated features cannot be transitioned using the script.

In this case, you must migrate Solr collections manually from a search-type node in the Analytics cluster. This article describes how to identify symptoms of this condition and manually migrate the collections.

Identify a Solr Migration Issue

When existing Solr collections are incompatible with an upgraded version of Solr, you might observe the following:

The searchlogs collection appears to be stuck in the down state in the Director UI. To display this status:
1. Select Analytics > Admin > System Status > Status.
2. Select the Search Stats tab in the main pane.
The vsh dbstatus command on search-type nodes nodes displays errors related to the searchlogs collection.

In the following example, the vsh dbstatus command shows that the searchlogs collection is in the down state.
```
admin@Search# vsh dbstatus
```

Manually Migrate Solr Colections

To manually migrate Solr collections, perform the following procedure on any search-type node in the Analytics cluster.

Login to the shell on the Analytics node.
Start a shell with root permissions.
```
admin@Search$ sudo su
root@Search#
```

Issue the following commands to delete the existing aliases and searchlogs collection from the search node.

root@Search# cd /opt/versa/scripts/van-install 
root@Search# ./cluster_install.sh solr delete_alias alarmlogsRead
root@Search# ./cluster_install.sh solr delete_alias searchlogsWrite
root@Search# ./cluster_install.sh solr delete_alias searchlogsRead 
root@Search# ./cluster_install.sh solr delete_alias globallogsRead 
root@Search# ./cluster_install.sh solr delete_collection searchlogs

Recreate aliases and collections.

root@Search# /opt/versa/scripts/van-scripts/vandb-upgrade.py

Verify the Solr cluster status.

root@Search# cd /opt/versa/scripts/van-install 
root@Search# ./cluster_install.sh solr cluster_status

Perform Solr reindexing to rebuild the search indexes.

root@Search# python3 /opt/versa/scripts/van-maintenance/solr_reindexing.py

Verify Cluster Status

After reindexing completes, run the cluster_status command again to confirm that all collections are in the active state.

root@Search# ./cluster_install.sh solr cluster_status
root@Search# exit
admin@Search$

The searchlogs collection and other Solr collections should be restored and functional. The Solr cluster status should show all nodes and collections as healthy/active.

Supported Software Information

Releases 22.1.4 (Service Release dated 2025-06-27) and later support all content described in this article.