How to Set Up a Standalone Solr Environment

  • KM03640449
  • 18-May-2020
  • 18-May-2020

Summary

Procedure to setup the Solr Environment for UCMDB.

Question

  1. Download Apache Solr 6.2.1 (or a later version) from http://archive.apache.org/dist/lucene/solr/, and then extract the package to a local folder.
  2. Create and configure the Solr home. To do this, follow these steps:

    1. Create a directory that will be the Solr home.
    2. Copy the solr.xml file under the <UCMDB_Server_Home>\search\solr_dp folder to the Solr home.
    3. Create the following folder structure in the Solr home:

      configsets\ucmdb_configs\conf

    4. Copy the following files from the <UCMDB_Server_Home>\search\solr_dp\configsets\ucmdb_configs\conf folder to the <Solr_home>\configsets\ucmdb_configs\conf folder:

      • mappings.txt
      • protwords.txt
      • schema.xml
      • solrconfig.xml
      • stopwords.txt
      • stopwords_en.txt
      • synonyms.txt
  3. Start Solr.

    To do this, go to the <Solr_install_dir>\bin directory in a command prompt, and then run the following command:

    solr start -s <Solr_home>

    Note  

    • <Solr_install_dir> is the directory where the Solr package is extracted. <Solr_home> is the full path to the Solr home you created in Step 2.a.
    • To check if Solr is started, go to http://localhost:8983/solr, which is the URL for Solr dashboard.
    • To stop Solr, run the solr stop -all command in the same directory.
  4. Add the following settings into <UCMDB_Server_Home>\conf\settings.override.properties.

    cmdb.search.solr.standalone=true

    cmdb.search.solr.standalone.url=http://localhost:8983/solr

    Note The value for cmdb.search.solr.standalone.url should be the URL verified in Step 3.

  5. Increase Solr memory size.

    By default Solr allocates only 512MB RAM. You might need to increase this setting, depending on the server’s RAM and other processes that run on the same server.

    To increase Solr memory size,

    1. Open the following file using a text editor:

      Windows: <UCMDB_install_dir>\solr\bin\solr.in.cmd

      Linux: <UCMDB_install_dir>/solr/bin/solr.in.sh

    2. Locate the following setting and increase the setting to a desired value:

      • Windows:

        set SOLR_JAVA_MEM=-Xms512m -Xmx2048m

        where Xms is the initial amount, Xmx is the total amount of memory allocated.

      • Linux:

        SOLR_JAVA_MEM="-Xms512m -Xmx2048m"
    3. Save the file.
  6. Restart the UCMDB Server.