Close
Alfresco Search and Insight Engine

Migrate Search Services

Use this information to migrate from Search Services to Search and Insight Engine using the distribution zip or docker compose, including how to migrate Search and Insight Engine to Search Services.

Note: You can only migrate to Search Services using the distribution zip.

Migrate with zip

You can migrate from Alfresco Content Services 6.1 with Search Services 1.3 to Alfresco Content Services with Search and Insight Engine 1.1. You can also migrate from Alfresco Content Services 5.x with Search Services to Alfresco Content Services 6.1 with Search and Insight Engine 1.1.

Migrate Content Services 6.1 with Search Services 1.3

Use this information to migrate from Search Services 1.3 to Search and Insight Engine 1.1 using a distribution zip.

Note: A reindex is not required when you migrate from Search Services 1.3 to Search and Insight Engine 1.1.

  1. Stop Search Services.

     ./solr/bin/solr stop
    
  2. Backup or move the existing alfresco-search-services folder to a preferred location. For example, alfresco-search-services-1.3.

  3. Browse to Hyland Community.

  4. Download and unzip the Search and Insight Engine distribution zip file to a preferred location:

     alfresco-insight-engine-distribution-1.1.x.zip
    

    By default, the contents are decompressed in a folder at ./alfresco-insight-engine. The folder extracts into the same location as the zip file.

  5. Your indexes for Solr are in another location, use the following commands to point Solr to the right location:

    Unix like systems

     ./solr/bin/solr start -a -p <port> "-Dcreate.alfresco.defaults=alfresco,archive"
     -Dsolr.content.dir="/alfresco-search-services-1.3/contentstore"
     -Dsolr.model.dir="/alfresco-search-services-1.3/solrhome/alfrescoModels"
     -Ddata.dir.root="/alfresco-search-services-1.3/solrhome/"
    

    Microsoft Windows

     solr start -a -p <port> "-Dcreate.alfresco.defaults=alfresco,archive"
     -Dsolr.content.dir="alfresco-search-services-1.3\contentstore"
     -Dsolr.model.dir="alfresco-search-services-1.3\solrhome\alfrescoModels"
     -Ddata.dir.root="alfresco-search-services-1.3\solrhome\"
    

    Note: At this stage you have migrated. If you want to migrate using an external location, continue with the following steps.

  6. Copy the contentstore from the backup alfresco-search-services-1.3 to a preferred location, for example alf_data.

  7. Copy the cores: alfresco, archive and the models alfrescoModels from alfresco-search-services-1.3/solrhome.

  8. Your directory structure will look like the following:

     alf_data/contentstore
     alf_data/solrhome
     alf_data/solrhome/alfresco
     alf_data/solrhome/archive
     alf_data/solrhome/alfrescoModels
    
  9. (Optional) If you have changed the alfresco-search-services/solr.in.sh or alfresco-search-services/solr.in.cmd file, you must restore it from your backup.

  10. Start Search and Insight Engine.

    If the content store and indexes for Solr are in another location, use the following commands to point Solr to the right location:

    Unix like systems

    ```bash ./solr/bin/solr start -a -p "-Dcreate.alfresco.defaults=alfresco,archive" -Dsolr.content.dir="/your-preferred-location/contentstore" -Dsolr.model.dir="/your-preferred-location/solrhome/alfrescoModels" -Ddata.dir.root="/your-preferred-location/solrhome/"

    Microsoft Windows

    solr start -a -p "-Dcreate.alfresco.defaults=alfresco,archive" -Dsolr.content.dir="your-preferred-location\contentstore" -Dsolr.model.dir="your-preferred-location\solrhome\alfrescoModels" -Ddata.dir.root="your-preferred-location\solrhome\"

    Note: To check what version of Search Services or Search and Insight Engine you have installed go to http://localhost:8983/solr/.

Migrate Content Services 5.x with Search Services 1.3 or below

There are two steps to migrating your installation from Alfresco Content Services 5.x with Search Services to Alfresco Content Services 6.1 with Search and Insight Engine. First you need to upgrade to Alfresco Content Services 6.1 with Search Services, and then migrate Search Services to Search and Insight Engine.

Note: You can’t upgrade Alfresco Content Services 5.x using Docker Compose.

  1. Upgrade from Alfresco Content Services 5.x to Alfresco Content Services 6.1, for more see [Migrate Solr 4 to Solr 6]/search-services/latest/upgrade/migrate/).

    Note: You can’t do this using Docker Compose.

  2. Migrate from Search Services to Search and Insight Engine see Migrating Content Services 6.1 with Search Services 1.3 or below.

Migrate using Docker Compose

If you already have Alfresco Content Services 6.1 with Search Services 1.3 or below installed, you can migrate to Search and Insight Engine 1.1. Due to the limited capabilities of Docker Compose, this migration method is recommended for development and test environments only.

Note: A reindex is not required when you migrate from Search Services to Search and Insight Engine 1.1.

Use this information to migrate from Search Services to Search and Insight Engine using Docker Compose.

  1. Insert the following container information into your docker-compose.yml file and save it.

         solr6:
             #image: alfresco/alfresco-search-services:1.3.x
             image: quay.io/alfresco/insight-engine:1.1.x
             mem_limit: 2500m
             environment:
                 #Solr needs to know how to register itself with Alfresco
                     - SOLR_ALFRESCO_HOST=alfresco
                     - SOLR_ALFRESCO_PORT=8080
                 #Alfresco needs to know how to call solr
                     - SOLR_SOLR_HOST=solr6
                     - SOLR_SOLR_PORT=8983
                 #Create the default alfresco and archive cores
                     - SOLR_CREATE_ALFRESCO_DEFAULTS=alfresco,archive
                     - "SOLR_JAVA_MEM=-Xms2g -Xmx2g"
             ports:
                 - 8083:8983 #Browser port
    
  2. Use the following command to run the file and upgrade your Alfresco Content Services 6.1 installation:

     docker-compose up
    

Edit this page

Suggest an edit on GitHub
This website uses cookies in order to offer you the most relevant information. Please accept cookies for optimal performance. This documentation is subject to the Documentation Notice.