You are here

Installing and configuring Search Services without mutual TLS

Use this information to install Alfresco Search Services on the same machine as Alfresco Content Services without mutual TLS.
Mutual TLS is used for authentication between the Repository and Search Services. Without mutual TLS, internal APIs on both sides will be exposed without any form of authentication, giving full access to the repository data. In such a setup, you need to make sure that external access to these APIs is blocked, for example, with a front-end reverse proxy. See Adding a reverse proxy for more.
This task assumes that you have:
  • Installed Alfresco Content Services 6.0.1. See Installing using distribution zip.
  • Set the following properties in the alfresco-global.properties file:
    index.subsystem.name=solr6
    solr.secureComms=none
    solr.port=8983
Important: Alfresco strongly recommends that you use firewalls and other infrastructure means to ensure that the Search Services server is not accessible from anything other than trusted hosts and/or users, and only on the ports needed for Search Services.
  1. Browse to the Alfresco Support Portal and download alfresco-search-services-1.2.x.zip.
  2. Extract the Search Services distribution to a preferred location.

    By default, the contents of alfresco-search-services-1.2.x.zip are decompressed in a root folder as /alfresco-search-services. See Search Services directory structure for more details.

  3. Update the alfresco-search-services/solrhome/conf/shared.properties file.

    • If you use several languages across your organization, you must enable cross-language search support in all fields, by adding the following:
      alfresco.cross.locale.datatype.0={http://www.alfresco.org/model/dictionary/1.0}text
      alfresco.cross.locale.datatype.1={http://www.alfresco.org/model/dictionary/1.0}content
      alfresco.cross.locale.datatype.2={http://www.alfresco.org/model/dictionary/1.0}mltext 
  4. (Optional) If you want to install Search Services on a separate machine, check the following before starting Search Services:
    1. Set the values of environment variables, such as SOLR_SOLR_HOST and SOLR_SOLR_PORT, in the alfresco-search-services/solr.in.sh file (Linux-based platform) or alfresco-search-services/solr.in.cmd file (Windows-based platform).
    2. Set the values of environment variables, such as SOLR_ALFRESCO_HOST and SOLR_ALFRESCO_PORT, in the alfresco-search-services/solr.in.sh file (Linux-based platform) or alfresco-search-services/solr.in.cmd file (Windows-based platform).

      See Search Services externalized configuration.

  5. (Optional) Update the alfresco-search-services/solrhome/conf/shared.properties file.

    • Suggestion is disabled by default for Search Services. If you want to enable suggestion, add the following:
      alfresco.suggestable.property.0={http://www.alfresco.org/model/content/1.0}name
      alfresco.suggestable.property.1={http://www.alfresco.org/model/content/1.0}title 
      alfresco.suggestable.property.2={http://www.alfresco.org/model/content/1.0}description 
      alfresco.suggestable.property.3={http://www.alfresco.org/model/content/1.0}content

    Note: The spell check functionality does not work with Search Services as suggestion is disabled for scalability purpose.
  6. To start Search Services with all the default settings, use the following command:

    ./solr/bin/solr start -a "-Dcreate.alfresco.defaults=alfresco,archive"

    This command automatically creates the alfresco and the archive cores.

    The command line parameter, -a passes additional JVM parameters, for example, system properties using -D.

    Note: The -Dcreate.alfresco.defaults=alfresco,archive command automatically creates the alfresco and archive cores. Therefore, you should only start Search Services with -Dcreate.alfresco.defaults=alfresco,archive the first time you are running Search Services.
    Note: You should run this application as a dedicated user. For example, you can create a Solr user.
    Note: To ensure that Search Services connects using IPv6 protocol instead of IPv4, add -Djava.net.preferIPv6Addresses=true to the startup parameters.

    Once Search Services is up and running, you should see a message like:

    Waiting up to 180 seconds to see Solr running on port 8983 [\]  
    Started Solr server on port 8983 (pid=24289). Happy searching!
    To stop the currently running Search Services instance, use:
    ./solr/bin/solr stop

    The logs are stored in the alfresco-search-services/logs/solr.log file, by default. This can be configured in solr.in.sh.

    You have successfully created an alfresco core and an archive core. To verify, in a browser, navigate to the Solr URL, http://localhost:8983/solr. In the Solr Admin UI, select the core selector drop-down list and verify that both the alfresco and archive cores are present in the list.

    Allow a few minutes for Search Services to start indexing.

  7. Go to Admin Console > Repository Services > Search Service and verify that:
    1. You see the Solr 6 option in the Search Service In Use list.
    2. Under Main (Workspace) Store Tracking Status, the Approx Transactions to Index is 0.

Sending feedback to the Alfresco documentation team

You don't appear to have JavaScript enabled in your browser. With JavaScript enabled, you can provide feedback to us using our simple form. Here are some instructions on how to enable JavaScript in your web browser.