Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

[MNT-24204] Update procedure for communication with Solr for ACS 23.x #1586

Merged
merged 2 commits into from
Oct 10, 2024
Merged

[MNT-24204] Update procedure for communication with Solr for ACS 23.x #1586

Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
a1a242a
[MNT-24204] Update procedure for communicating with Solr
mbujak-hyland Oct 9, 2024
d204173
[MNT-24204] Minor fix
mbujak-hyland Oct 9, 2024
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
23 changes: 15 additions & 8 deletions content-services/latest/install/zip/tomcat.md
View file
Open in desktop
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