Proxy

Proxy#

Install Packages#

Warning

In case you install this Role on a Node which does not feature the Mesh & Directory Role, make sure the service-discover-agent package is installed as well.

# apt install carbonio-proxy carbonio-catalog \
 carbonio-files-public-folder-ui carbonio-webui \
 carbonio-tasks-ui carbonio-files-ui \
 carbonio-ws-collaboration-ui carbonio-avdb-updater

# apt install carbonio-proxy carbonio-catalog \
 carbonio-files-public-folder-ui carbonio-webui \
 carbonio-tasks-ui carbonio-files-ui \
 carbonio-ws-collaboration-ui carbonio-avdb-updater

# dnf install carbonio-proxy carbonio-catalog \
 carbonio-files-public-folder-ui carbonio-webui \
 carbonio-tasks-ui carbonio-files-ui \
 carbonio-ws-collaboration-ui carbonio-avdb-updater

# dnf install carbonio-proxy carbonio-catalog \
 carbonio-files-public-folder-ui carbonio-webui \
 carbonio-tasks-ui carbonio-files-ui \
 carbonio-ws-collaboration-ui carbonio-avdb-updater

Note

The Legacy carbonio-chats-ui package is no longer needed, as the legacy Chats module has been superseded bye the new Work Stream Collaboration (Chats) Role.

Bootstrap Carbonio#

Execute:

# carbonio-bootstrap

The bootstrap command will execute a number of tasks and will set up the node. At the end, you will be prompted with a menu and, if you already configured all, you only need to click y for confirmation.

On RHEL 9 only, restart the node to ensure that Carbonio service management come under the control of systemd:

# reboot

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

  • Ldap master host is the FQDN of the first Mesh & 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).

Enable Memcached#

To enable Memcached access, use these two commands

  1. Common to Ubuntu and RHEL

    zextras$ carbonio prov ms $(zmhostname) zimbraMemcachedBindAddress $(hostname -i)

  2. Different on RHEL 9

    As the zextras user

    zextras$ zmmemcachedctl restart

    As the zextras user

    zextras$ zmmemcachedctl restart

    As the zextras user

    zextras$ zmmemcachedctl restart

    As the root user

    # systemctl restart carbonio-memcached.service

Warning

Since Memcached does not support authentication, make sure that the Memcached port (11211) is accessible only from internal, trusted networks.

Contents