Upgrade SOLR in ColdFusion

Important

We recommend that you back up the following files:

  • schema.xml
  • solr.war
  • solr.xml
  • managed-schema.xml
  • start.ini

Pre-requisite

Download the zip file from the link provided in this doc and unzip the files. You'll then copy these files to their respective locations.

How to upgrade SOLR

To upgrade to SOLR 8.11.3, follow the steps below:

  1. Copy schema.xml to [SOLR_HOME]/template/conf

  2. Copy solr.war to [JETTY_HOME]/webapps

  3. Copy solr.xml to [JETTY_HOME]/solr

  4. Copy managed-schema.xml to [JETTY_HOME]/solr

  5. Edit the start.ini file in [JETTY_HOME] and add the following flags:

    • -Dsolr.disable.shardsWhitelist=true
    • -Dsolr.http1=true
  6. Restart Jetty.

After upgrading SOLR, you have the following options.

If you don’t want to re-index

Follow the steps below:

  1. Go to the location of each collection and open the file managed-schema.xml in [COLLECTION_NAME]/conf.

  2. Replace all occurrences of <filter class="solr.StandardFilterFactory"/> with an empty string.

    Note:

    The filter StandardFilterFactory is no longer operational in SOLR.

  3. Restart Jetty.

If you want to re-index

Follow the steps below:

  1. Delete all existing collections using one of the following ways:

    1. Via the ColdFusion Administrator.
    2. Delete the collections by manually deleting the collection directories present at [JETTY_HOME]/multicore/collections.
    3. Use the cfcollection tag to delete the collections programmatically. For more information, see cfcollection tag.
  2. Restart Jetty.

  3. Recreate the collections using ColdFusion Administrator or your CFML application.

  4. Re-index the data using ColdFusion Administrator or your CFML application.

Document revision history

Upgraded SOLR to v8.11.3. View the following tech note for more information:

Get help faster and easier

New user?