Performing a Complete Search Index Rebuild

After extended use -- usually on the order of several years, Ubersmith's Solr Search Engine index may become corrupted. This corruption can manifest itself as incorrect search results, or errors when trying to work in the Support Manager, specifically, linking tickets.

The Docker volume that stores Ubersmith's search index is named 'ubersmith_search'. To completely clear this index away in the event of corruption, the volume needs to be deleted. Unfortunately, the volume can't be deleted while it's in use, so Ubersmith must be shut down.

Note that the following command will cause Ubersmith to become unavailable.

cd /usr/local/ubersmith
docker-compose rm -sf

Once Ubersmith is shut down, we can delete the volume:

docker volume rm ubersmith_search

With the volume deleted, bring Ubersmith back online:

cd /usr/local/ubersmith
./ubersmith_start.sh

The 'ubersmith_search' docker volume will be automatically recreated.

With Ubersmith back online, go to

Settings -> Search Engine

in the Ubersmith UI. Clicking 'reindex all' will index all the search documents, however it may make more sense to have the system index the most critical/useful documents first (clients, devices, services, tickets) by kicking off their reindex processes individually. Then, once those tasks are finished, the remaining search documents can be indexed.