Telligent Enterprise 4.0 ships with and requires Solr version 3.6. However, if you currently have a Solr 1.3 site and wish to upgrade to Telligent Enterprise 4.0, you will need to upgrade from Solr 1.3 to Solr 1.4. When you perform this upgrade, a full search reindex is required.

During this upgrade/reindex process, search functionality will not be available on your site.

For very large communities or communities that cannot afford the time to allow content reindexing, the fastest way to upgrade search with minimal downtime is to perform the following procedure:

  1. Create a backup copy of your production environment and restore it to a staging environment.

  2. Note the current time. This time will be used to reindex new content in the production environment after the upgrade is complete.

  3. Upgrade your community to Telligent Enterprise 4.0

  4. Update your search to Solr version 1.4 in the staging environment.

  5. Reindex your community and copy the search index from staging to production after production has been updated to Solr 1.4.

  6. When production is running the latest version of Telligent Enterprise and Solr 1.4, reindex content that was not present in the backup by executing the following SQL script on the production database:

    DECLARE @cutoff DATETIME
    SET @cutoff = '02-01-2010' --Reindex content newer than this date
    UPDATE cs_Users set IsIndexed = 0 -- Quick, reindex all 
    UPDATE cs_Groups set IsIndexed = 0 -- Quick, reindex all 
    UPDATE cs_Posts set IsIndexed = 0 WHERE PostDate > @cutoff
    UPDATE cs_Wiki_Pages set IsIndexed = 0 WHERE LastModifiedUtcDate > @cutoff
    UPDATE cs_Sections set IsIndexed = 0 -- Quick, reindex all 
    UPDATE cs_Wiki_Wikis set IsIndexed = 0 -- Quick, reindex all 
    UPDATE cs_ContentFragmentPages set IsIndexed = 0 WHERE IsCustom = 1 -- Quick, reindex all

 In this document, when [Tomcat Dir] is mentioned, it refers to your Tomcat installation folder. Typically, this is C:\Program Files (x86)\Apache Software Foundation\Tomcat 6.0 or C:\Program Files\Apache Software Foundation\Tomcat 6.0.

Back up the current Solr 1.3 index

The search index for Telligent Enterprise 2.0 is not compatible with Telligent Enterprise 3.0; however, it is backed up in case you need to roll back your database and/or reference any customizations.

To back up the current index:

  1. Create a folder to store your backup (e.g., C:\solr1.3_backup).

  2. Locate the current Solr instance (for example, [Tomcat dir]/solr/data) and copy the entire index folder to your backup folder.

  3. Delete the /solr folder.

  4. Locate the current solr.war file (for example,  [Tomcat dir]/webapps/) and copy it to your backup folder.

Complete one of the following installation procedures, depending upon your installation needs:

Install Solr 1.4 (typical installation)

After backing up your existing data, the process of installing Solr 1.4 is just like a new installation with the exception of  the following preparatory steps:

  1. Undeploy Solr 1.3:
    1. Open the Tomcat main page at http://servername:8080.
    2. Click Administration > Tomcat Manager.
    3. Locate /solr in the Applications table.
    4. Click the Undeploy link, which is located in the farthest-left column.
    5. Answer the confirmation dialog box.
    6. Solr is now undeployed. All traces of solr prior to undeploying it in Tomcat manager are removed. (The undeploy action will work even if all files were already removed.)

  2. Merge any custom Solr schema (that is, schema.xml) or configuration changes (that is, solrconfig.xml). Note that this is not a typical requirement.

  3. Install Solr.

  4. Reindex all content.

  5. Optional: Delete the backup folder after your new Solr instance is running successfully.

Install Solr 1.3 and Solr 1.4 side by side (atypical installation)

This kind of installation is desirable only if you have one server already hosting Solr 1.3 for a pre-Telligent Enterprise 2.5 community and will be using this same server for a Telligent Enterprise  2.5 or higher (that is, Solr 1.4) community. The following instructions do not alter the existing Solr 1.3 instance(s); they only instruct you to create one new Solr 1.4 instance.

  1. Locate the search files in your unzipped Telligent Enterprise 4.0 download package under the Search directory.

  2. Stop the Tomcat service using the Tomcat tray icon or using the Service Manager (Start > Run > Services.msc - look for "Apache Tomcat").

  3. From your extracted download, rename the solr folder to solr1_4.  

  4. From your extracted download, rename solr.war to solr1_4.war and copy solr1_4.war. 

  5. Make a new text file in [Tomcat install dir]\conf\Catalina\localhost called solr1_4.xml with the following code fragment:

    An example path: C:\Program Files\Apache Software Foundation\Tomcat 6.0\conf\Catalina\localhost\solr1_4.xml

    The Catalina\localhost directory might not exist, so you might need to create it. 

    <Context docBase="webapps/solr1_4.war"debug="0" crossContext="true" >
       <Environment name="solr/home" type="java.lang.String"
     value="solr1_4" override="true" />
    </Context>      

  6. Follow the standard search installation steps and use the solr1_4 folder and solr1_4.war file in place of solr folder and solr.war file, respectively.

  7. Start Tomcat.

  8. Confirm the installation by navigating to your localhost directory, for example http://localhost:8080/solr1_4. (Your URL and/or port may be different.)