Use this information to upgrade from Search Services 2.x to Search Enterprise 3.1.

Note: A full re-index is required when you upgrade from Search Services 2.x to Search Enterprise 3.1 because the search engine is switching from Solr to Elasticsearch. If it is necessary for you to have a backup of the old SOLR index, then it must be copied elsewhere before you re-index.

Search Enterprise 3.1 is compatible with Alfresco Content Services 7.1 and above, which means you need to upgrade to this version before applying the following steps.

Configure Subsystem in Repository

Before upgrading you must activate and configure the Search Services subsystem in Content Services, for more see Subsystem.

Install Elasticsearch connector

The Elasticsearch connector can be installed using JAR files, Docker compose, or Helm, for more see Install.

Once everything is up and running, use the Elasticsearch connector Re-indexing application to populate the Elasticsearch index. This operation may take a while, depending on the number of documents in your repository and on the indexing options selected (metadata, content and path). While the re-indexing process is progressing, the documents will gradually be available for searching.

When the Re-indexing application has finished, the new and updated documents will be uploaded to the Elasticsearch index by the Elasticsearch connector service using ActiveMQ messages.

Replicate an existing Content Services 7.1 deployment

Your current Content Services stack can continue to run while you are indexing the repository to Elasticsearch. This means you can continue to use the ‘old’ service until the process completes. It’s recommended you create a read replica of the database so the indexing process won’t affect service performance.

1. Create a read-only Replica for your database.

2. Configure Alfresco Repository Search Subsystem to use elasticsearch and switch database configuration to the read-only replica database.

3. Install the Elasticsearch server.

4. Install Elasticsearch connector.

5. Once everything is up and running, use the Elasticsearch connector Re-indexing application to populate the Elasticsearch index. This operation may take a while, depending on the number of documents in your Repository and on the indexing options selected (metadata, content and path).

6. Test the replicated environment is working as expected in terms of searching and indexing operations.

7. Switch the existing production environment to the replicated environment by using the original database and removing the previous Search Services components based on SOLR.

Note: You may need to use the Elasticsearch Re-indexing application to update to the 3.1 changes. After that, new and updated documents will be uploaded to the Elasticsearch index by the Elasticsearch connector service using ActiveMQ messages.

Zero downtime upgrade

You can upgrade from Search Services 2.x without experiencing any downtime, to Search Enterprise 3.1.1 when you are using Content Services 7.2 and above.

1. Start an Elasticsearch 3.1.1 instance, for more see Overview.

   Currently your installation is using Solr.

   

2. Start a mirrored environment by replicating the content repository and Content Services.

   You create a mirrored environment because the upgrade will not impact the primary environment. Use the Elasticsearch instance you created as the content repository for the mirrored environment. Once you have mirrored the environment do not change the content repository and only use it in read-only mode. If you do not need to preserve the content repository then you only need to mirror Content Services.

   

3. Create an Elasticsearch index by executing a search query on the mirrored environment.

   Verify the index is created and its metadata correctly reflects your data model.

   Note: The index is not created when you mirrored the content repository and Content Services.

4. Populate the index with existing data.

   The index is populated and is based on the replicated database and is achieved by starting re-indexing on the mirrored environment. For more see re-indexing.

   Note: A window displays that states the primary database does not reflect the up to date index.

   

5. Shutdown the mirrored environment.

   You are left with an Elasticsearch server with a populated index.

   Note: The index is not yet in sync with the primary environment.

   

6. Keep your index up to date with changes made through Content Services.

   To do this start live indexing on the primary environment. For more see live-indexing.

   Note: Even after starting live indexing there is still a gap from when you took a snapshot to when you started live indexing.

   

7. Start re-indexing on the Solr environment.

   To close the gap in the Elasticsearch index start re-indexing on the Solr environment.

   Note: Live indexing keeps the Elasticsearch environment index up to date.

   

8. Switch to Elasticsearch.

   To switch to Elasticsearch access the Admin Console at runtime. Once you have done this you still have both Search Services and Search Enterprise running but Content Services is using Elasticsearch.

   Note: If you experience any issues you can still revert back to using Solr.

   

9. Shutdown Search Services.

   Confirm your new environment is working as expected and remove all the Solr based search services.