You are here

Setting up repository server cluster

Follow these steps to set up a repository cluster.
By default, all Enterprise servers connected to the same database will form a repository cluster.

Follow these steps for each server in the cluster:

  1. Install and configure the repository server. See the install documentation for deploying Alfresco Content Services (alfresco.war). In addition, ensure that:

    • The content store is available to all members in the cluster.
    • Each cluster member must be set up to access the same database, using the same database properties as in alfresco-global.properties.
    • Deploy a Solr indexing server for use across the cluster and configure the properties of each cluster member to utilize this Solr server.
  2. Ensure that port number 5701 (the default clustering port) is accessible on each repository server by all the other repository servers in the cluster.
  3. Specify a wildcard (for example, 10.50.*.*) or exact (for example, 192.168.1.100) IP address of the network interface for clustering to use.

    The advantage of using a wildcard IP address is that the configuration can be used on multiple servers without local changes. The java property name to use is alfresco.cluster.interface (optional).

  4. (Optional) Set the following java property to activate Hazelcast’s own JMX reporting:

    hazelcast.jmx=true
  5. Open the alfresco-global.properties file.
    1. Set the following repository properties.

      dir.root=<ALFRESCO_HOME>/alf_data
      dir.remote=/nfs/or/samba/share/common/for/all/nodes
      dir.contentstore=${dir.remote}/contentstore
      dir.contentstore.deleted=${dir.remote}/contentstore.deleted
      dir.cachedcontent=${dir.remote}/cachedcontent
    2. Set the following Search properties for mutual TLS (i.e. https).

      index.subsystem.name=solr6
      dir.keystore=${dir.root}/keystore (Specifies the path to the keystore file)
      solr.secureComms=https
      solr.port.ssl=8983                (Specifies the Solr load balancer SSL port)
      solr.host=172.31.50.59            (Specifies the Solr load balancer IP address or hostname)
    3. Set the following Search properties if you're not using mutual TLS (i.e. http)

      index.subsystem.name=solr6
      solr.port=8983             (Specifies the Solr load balancer port)
      solr.secureComms=none      (For HTTP transport between Alfresco and Solr)
      solr.host=172.31.50.59     (Specifies the Solr load balancer IP address or hostname)

Sending feedback to the Alfresco documentation team

You don't appear to have JavaScript enabled in your browser. With JavaScript enabled, you can provide feedback to us using our simple form. Here are some instructions on how to enable JavaScript in your web browser.