From a1a242ae32d921fcd72755950a8a7c3a79b5937e Mon Sep 17 00:00:00 2001 From: Monika Bujak Date: Wed, 9 Oct 2024 12:28:25 +0200 Subject: [PATCH 1/2] [MNT-24204] Update procedure for communicating with Solr --- content-services/latest/install/zip/tomcat.md | 23 ++++++++++++------- 1 file changed, 15 insertions(+), 8 deletions(-) diff --git a/content-services/latest/install/zip/tomcat.md b/content-services/latest/install/zip/tomcat.md index 63d35f300d..6f24e4a3dd 100644 --- a/content-services/latest/install/zip/tomcat.md +++ b/content-services/latest/install/zip/tomcat.md @@ -64,15 +64,21 @@ The installation directory for Tomcat is represented as ``. 2. Copy the files `alfresco.xml` and `share.xml` from the distribution zip `/web-server/conf/Catalina/localhost` to `/conf/Catalina/localhost` (or hostname). -7. Configure mutual TLS for Solr communication. +7. Configure Content Services for Solr communication by performing one fo the following: - The communication with Solr is encrypted and authenticated via mutual TLS. For this connection, you need an additional Connector. + * Install with mutual TLS, where the communication with Solr is encrypted and authenticated via mutual TLS. - > **Note:** This Connector isn't used by end users. Its sole purpose is to handle the communication with Solr. + * Install without mutual TLS using HTTP with a secret word in the request header. + + > **Note:** For more information on installing with or without mutual TLS, see [Install Alfresco Search Services]({%link search-services/latest/install/options.md %}). + +8. When installing with mutual TLS, perform the following steps to configure the Tomcat connector: + + > **Note:** This connector isn't used by end users and its only purpose is to handle the communication with Solr. 1. Open the `/conf/server.xml` file. - 2. Add the following Connector: + 2. Add the following connector: ```xml `. truststorePass="password" truststoreType="JCEKS" clientAuth="want" sslProtocol="TLS" /> ``` + When configuring the Tomcat connector, consider the following: - > **Note:** The keystore and truststore file locations in the above example will be created later, when you install and configure Alfresco Search Services. + * The keystore and truststore file locations in the above example will be created later, when you install and configure Alfresco Search Services. - > **Note:** If you're using a different keystore or truststore type other than the default, `JCEKS`, you must change the value in the properties file. + * If you're using a different keystore or truststore type other than the default, `JCEKS`, you must change the value in the properties file. - > **Note:** In Tomcat versions prior to 9 it was possible to use `org.apache.coyote.http11.Http11Protocol` as the protocol value, but now it has been removed. If you are using configuration from an old instance using a Tomcat version before 9, you need to update the connector protocol value. + * In Tomcat versions prior to 9 it was possible to use `org.apache.coyote.http11.Http11Protocol` as the protocol value, but now it has been removed. If you are using configuration from an old instance using a Tomcat version before 9, you need to update the connector protocol value. -8. Save the `server.xml` file. +9. Save the `server.xml` file. > **Important:** Remember to review and update the Connector details in `server.xml`, including the keystore and truststore file locations, after installing and configuring Alfresco Search Services. From d2041732af7afc6836404757d450f7ac04c8e71b Mon Sep 17 00:00:00 2001 From: Monika Bujak Date: Wed, 9 Oct 2024 13:25:29 +0200 Subject: [PATCH 2/2] [MNT-24204] Minor fix --- content-services/latest/install/zip/tomcat.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/content-services/latest/install/zip/tomcat.md b/content-services/latest/install/zip/tomcat.md index 6f24e4a3dd..f9b0f9a3e7 100644 --- a/content-services/latest/install/zip/tomcat.md +++ b/content-services/latest/install/zip/tomcat.md @@ -64,7 +64,7 @@ The installation directory for Tomcat is represented as ``. 2. Copy the files `alfresco.xml` and `share.xml` from the distribution zip `/web-server/conf/Catalina/localhost` to `/conf/Catalina/localhost` (or hostname). -7. Configure Content Services for Solr communication by performing one fo the following: +7. Configure Content Services for Solr communication by performing one of the following: * Install with mutual TLS, where the communication with Solr is encrypted and authenticated via mutual TLS. @@ -74,7 +74,7 @@ The installation directory for Tomcat is represented as ``. 8. When installing with mutual TLS, perform the following steps to configure the Tomcat connector: - > **Note:** This connector isn't used by end users and its only purpose is to handle the communication with Solr. + > **Note:** This connector isn't used by end users. Its sole purpose is to handle the communication with Solr. 1. Open the `/conf/server.xml` file.