Skip to content

Commit

Permalink
[MNT-24204] Update procedure for communication with Solr for ACS 23.x (
Browse files Browse the repository at this point in the history
…#1586)

* [MNT-24204] Update procedure for communicating with Solr

* [MNT-24204] Minor fix
  • Loading branch information
mbujak-hyland authored Oct 10, 2024
1 parent 94ffb99 commit 043ce8d
Showing 1 changed file with 15 additions and 8 deletions.
23 changes: 15 additions & 8 deletions content-services/latest/install/zip/tomcat.md
Original file line number Diff line number Diff line change
Expand Up @@ -64,15 +64,21 @@ The installation directory for Tomcat is represented as `<TOMCAT_HOME>`.

2. Copy the files `alfresco.xml` and `share.xml` from the distribution zip `/web-server/conf/Catalina/localhost` to `<TOMCAT_HOME>/conf/Catalina/localhost` (or hostname).

7. Configure mutual TLS for Solr communication.
7. Configure Content Services for Solr communication by performing one of 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. Its sole purpose is to handle the communication with Solr.
1. Open the `<TOMCAT_HOME>/conf/server.xml` file.
2. Add the following Connector:
2. Add the following connector:
```xml
<Connector port="8443" protocol="HTTP/1.1"
Expand All @@ -84,14 +90,15 @@ The installation directory for Tomcat is represented as `<TOMCAT_HOME>`.
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.

Expand Down

0 comments on commit 043ce8d

Please sign in to comment.