Install and configure search

Telligent Community

Telligent Community
Find product documentation to help you install, configure, and administer Telligent Community. Discuss and collaborate with other users as you create an external-facing customer community.

Telligent Community 7

Install and configure search

Telligent Community 7

 Telligent Community 7.0 requires Solr 3.6. Whether you are doing a clean install or an upgrade, you must install this version.

 

  1. Install Java on the search server. Remember that if you are using 64-bit Tomcat, you will need to use 64-bit Java.

    1. Test whether Java is already installed by viewing http://java.com/en/download/help/testvm.xml on the search server. In Telligent Community, search requires at least version 6 update 13. If your installation meets this requirement, skip to the Install Tomcat step below.
      • If you're using a 64-bit operating system, you must view this test page in a 64-bit browser (such as Internet Explorer 64-bit edition which comes pre-installed on all 64-bit versions of Windows).
    2. Download the latest version of java from Java.com
  2. Install Tomcat. Remember that if you are using 64-bit Tomcat, you need to match it with 64-bit Java.

    1. Download version 6 or 7 of the Tomcat Windows Service Installer from Apache.
    2. Open the installer and follow it through, taking note of the following:
      1. In the Choose Components window, ensure you have selected the the Tomcat > Service and Tomcat > Native options.

      2. In the Choose Install Location window, make a note of the installation directory - this will be needed in the next step. 


    3. Update Tomcat to support UTF8 characters:
      1. Open the /conf/server.xml file in the installation directory you selected in step b.B.
      2. Find the appropriate <Connector /> element in the server.xml file, and add the attribute URIEncoding="UTF-8"
        <Server ...>
        <Service ...>
        <Connector port="8080"... URIEncoding="UTF-8"/>
        ...
        </Connector>
        </Service>
        </Server>
    4. Test that Tomcat is installed correctly by navigating to http://localhost:8080/.

  3. Install Solr.
    Note
    : If you want to run multiple Telligent communities from the same search server, follow the instructions at Host multiple Telligent Community communities on multiple Solr instances instead.

    1. Copy the Solr folder in the /Search/ directory of the Telligent Community install files to the root directory of Apache Tomcat.
    2. Copy the solr.war file in this folder to the /webapps directory of Apache Tomcat.
    3. Navigate to the Solr administration page (http://localhost:8080/solr/admin) to verify that the installation was successful. Note: If you have any issues with search, see troubleshoot search errors

    Note: Solr runs very well as it's configured out of the box. But if you have a medium- to large-sized community, you should increase the memory allocated to the Java virtual machine (JVM). The default allocated memory is 64MB. You should consider giving it 512MB or more. 
    To increase the memory for the JVM:
    1. Right-click the Tomcat Manager in the system tray and select Configure.
    2. Select the Java tab.
    3. Set the Maximum memory pool size (in MB) that you want to allocate to the JVM.

    Connect Web site to search

    Important: Solr should never be accessible to the public. Ensure that neither the Tomcat home page nor the Solr home page is publicly accessible. If this endpoint is accessible, work with your IT department or read  Securing Solr on Tomcat for more details on blocking this endpoint from the public.

    1. Ensure that all Web servers can access the Solr home page by opening to the Solr home page on each server ( e.g., http://servername:8080/solr/ ).
    2. Configure Telligent Community to use your Solr URL:
      1. Download the following communityserver_override.config file.
      2. Place this file in the root of your Web site directory.
      3. Find the following section in the communityserver_override.config file and replace the value for the value element with the URL to your Solr instance.

        <Override xpath="/CommunityServer/Search/Solr"
        mode="change"
        name="host"
        value="http://yourserver:XXXX/PathToSolr"
        />

      Note: This URL is case-sensitive.

    Note: If you have any issues with search, see troubleshoot search errors.

    Enable attachment indexing

    On the server that is running the Telligent Job Scheduler, install either the Windows search service or indexing service depending on your operating system.

    • Window Server 2008 / Windows Server 2008 R2 - Install the Windows search service
      1. Open the Server Manager: Navigate to Start > Run > ServerManager.msc.
      2. In the Services tab, click Roles in the left pane and select Add Roles from the Roles Summary window. Alternatively, you can click the Action menu option and select Add Roles.
      3. Continue with wizard and select the File Services check box. Click Next.
      4. If not already checked, select the Windows Search Service check box and click NextNote: If either Windows Search Service or Indexing Service (under the Windows Server 2003 File Services) was already checked, you can cancel the installation; one of the necessary services is already installed.



        In the next option window, Select Volumes to Index for Windows Search Service. You do not need to select a volume. Click Next.
      5. Click Install
    • Windows Server 2003 / Windows Server 2003 R2 - Install the Indexing Service
      1. Navigate to the Windows Control Panel and select Add/Remove Programs.
      2. Select Add/Remove Windows Components from the left pane of the Add/Remove window.
      3. If not already checked, select the Indexing Service check box and click Next to install. Note: If the check box was already checked, this indicates the service is already installed - so you can cancel the installation. 
    • Windows Vista / Windows 7 - Ensure the Windows search service is installed
      1. Navigate to the Control Panel, click Programs, and then click Turn Windows features on or off.
      2. If not already checked, select the Windows Search check box and click OK. NoteIf the check box was already checked, you can cancel the installation; the service is already installed.

          

    Install additional IFilters to index additional attachment types

    By default, Windows includes IFilters to extract textual content from uploaded files (such as media gallery files, blog post attachments and forum post attachments). However additional IFilters may be installed to index content from additional file types. Telligent recommends that you install the following additional IFilters:

    Comments
    • Explanation of the "xpath="/CommunityServer/Search/Solr" setting in the override file would be helpful.  It would also be good to know how to test that the "value" setting of that override.

    • Xpath is a mechanism of selecting nodes in an XML document.  This will basically match the Solr node in the communityserver.config file and then replace the "value" attribute with what you specify - in this case your Solr endpoint.  The testing would be to perform a search on your site - You want to either see search results or "no results found" and not something like "unable to contact search" - this means your solr install is working and configured correctly.

      If you look in communityserver.config, you'll see an XML structure like this:

      The XPath expression /CommunityServer/Search/Solr says to start at the top of the XML document and traverse the tree looking for children in that particular order, then select the node(s) that match.