Work Stream Collaboration (Chats)#
The Work Stream Collaboration (Chats) Role adds the chat functionality to Carbonio CE.
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 postgresql-client carbonio-message-dispatcher \
carbonio-ws-collaboration-ce service-discover-agent
# dnf install carbonio-message-dispatcher \
carbonio-ws-collaboration-ce service-discover-agent
Install PostgreSQL repository
# dnf -y install https://download.postgresql.org/pub/repos/yum/reporpms/EL-8-x86_64/pgdg-redhat-repo-latest.noarch.rpm
Install PostgreSQL client
# dnf -y install postgresql16
# dnf install carbonio-message-broker \
carbonio-message-dispatcher carbonio-ws-collaboration-ce \
service-discover-agent
Install PostgreSQL repository
# dnf -y install https://download.postgresql.org/pub/repos/yum/reporpms/EL-9-x86_64/pgdg-redhat-repo-latest.noarch.rpm
Install PostgreSQL client
# dnf -y install postgresql16
Bootstrap Carbonio CE#
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 CE 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 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).
Dispatcher DB Migration#
Initialise the message dispatcher
# PGPASSWORD=$DB_ADM_PWD carbonio-message-dispatcher-migration \
carbonio_adm 127.78.0.10 20000
Restart the service
# systemctl restart carbonio-message-dispatcher
Enable the Work Stream Collaboration (Chats) UI#
The Work Stream Collaboration (Chats) role is disabled by default, you can enable it either from
the Carbonio Admin Panel or from the command line by running as the zextras
user the command
zextras$ carbonio prov mc default carbonioFeatureChatsEnabled TRUE
This command enables the chat for the default
COS, but you can
enable it only on selected COSes.
Restart the service
# systemctl restart carbonio-ws-collaboration
Status Check#
After the installation, you can check the status of Work Stream Collaboration (Chats) and all its dependencies by running command
# curl -v http://127.78.0.4:10000/health | jq