Preview#

Install Packages#

Warning

In case you install this Role on a Node which already features the Mesh and Directory Role, make sure you do not install the service-discover-agent package.

# apt install carbonio-preview-ce service-discover-agent
# dnf install carbonio-preview-ce service-discover-agent

Bootstrap Carbonio#

Launch the Carbonio bootstrap process

# carbonio-bootstrap

During the process, you need to provide these values, which you can retrieve from the first Mesh and Directory node.

  • Ldap master host is the FQDN of the first Mesh and Directory node, (example: ldap-mstr.example.com)

  • Ldap Admin password is obtained from the first Mesh and Directory node (ldap-admin-password)

Join Carbonio Mesh#

Carbonio Mesh will install as an agent, that connects and communicates with the server. The configuration for the agent is created by launching command

# service-discover setup-wizard

This command will:

  • ask for the IP address and netmask of the current Node

  • ask for the Carbonio Mesh secret, which is stored in file /var/lib/service-discover/password on the Directory Leader Node (i.e., the node on which the Mesh server is installed)

    In case the password is lost or the credential file becomes corrupted and unusable, you can reset them using the procedure detailed in section Carbonio Mesh Credentials.

Pending setups#

To complete Carbonio Mesh installation, run

# pending-setups -a

Hint

The secret is stored in file /var/lib/service-discover/password, which is accessible only by the root user.

The command will ask for the password stored in the /var/lib/service-discover/password on the Directory Leader Node (i.e., the node on which the Mesh server is installed).

Configure Memcached#

To allow Carbonio Preview to operate correctly, you need to edit file /etc/carbonio/preview/config.ini and search for variables nginx_lookup_servers_full_path_urls and memcached_server_full_path_urls, which are one after the other, towards the end of the file.

1nginx_lookup_server_full_path_urls = https://172.16.0.13:7072
2memcached_server_full_path_urls = 172.16.0.12:11211

Make sure that:

  • in line 1, protocol is https and the IP address is the address of the Mailstore & Provisioning Node, which is 172.16.0.13

    • also specify the port used by Preview, 7072

  • in line 2, the IP (172.16.0.12) of the Proxy Node is written, to allow access to Memcached

    • also specify the port used by Memcached, 11211

  • in case you have multiple Mailstore & Provisioning or Proxy Nodes, add all of them as a comma-separated list, for example:

    nginx_lookup_server_full_path_urls = https://172.16.0.13:7072,https://172.16.0.23:7072
    memcached_server_full_path_urls = 172.16.0.12:11211,172.16.0.22:11211