Start and Stop the Solr Search Engine

You can start and stop the Solr Search Engine by using the command line scripts or through a Windows Service.

Security best practices

Since the Search Engine uses Tomcat as the web server, be sure to follow the following best practices (see also the Apache documentation for information on Tomcat security best practices).

  • On Windows operating systems, you need to create a user account that has been granted the Log on as a service right and has Full Control permissions to the search engine installation directory (default: C:\Program Files (x86)\HPE\ServiceManagerx.xx\SearchEngine). Further, make sure the HPE KM Search Engine - Master or HPE KM Search Engine - Slave service is set to run as this user.
  • On Unix systems, follow these steps:
    1. Install the Search Engine as root.
    2. Create a user to run the Search Engine. Suppose the user is SearchEngineUser.
    3. Run the following command to change the owner of the Search Engine installation directory:

      sudo chown -R SearchEngineUser Search_Engine_install_directory
    4. Run the following command to start the Search Engine:

      sudo -u SearchEngineUser Search_Engine_install_directory/startup.sh

For more information about the startup.sh script and running the Search Engine as a Windows service, see Start and stop the Search Engine using scripts and Start and stop the Search Engine as a Windows service.

Start and stop the Search Engine using scripts

Run the following executable scripts in the Solr Search Engine installation folder to start and stop the Search Engine.

Search engine startup scripts
Name Purpose
startup.cmd

Starts the master Solr Search Engine server on a Windows system.

Starts the KMCrawler that has been installed separately.

startup.cmd slave Starts the slave Solr Search Engine server on a Windows system.
startup.sh Starts the master Solr Search Engine server on a UNIX system.
startup.sh slave Starts the slave Solr Search Engine server on a UNIX system.
Search engine shutdown scripts
Name Purpose
shutdown.cmd
  • Shuts down the master Solr Search Engine server on a Window system.
  • Shuts down the KMCrawler if it was installed separately.
shutdown.cmd slave Shuts down the slave Solr Search Engine server on a Windows system.
shutdown.sh
  • Shuts down the master Solr Search Engine server on a UNIX system.
  • Shuts down the KMCrawler if it was installed separately.
shutdown.sh slave Shuts down the slave Solr Search Engine server on a UNIX system.

Start and stop the Search Engine as a Windows service

You can register and install the Search Engine as a Windows service, and then start and stop the Solr Search Engine as a Windows service.