Components Description and Installation#

Please review carefully this sections before attempting to install Carbonio on a Single-Server or on a Multi-Node infrastructure.

Carbonio is made of Components#

A Carbonio infrastructure is created with the installation of some Components.

A Component is a Carbonio functionality that is considered atomic and consists of one or more packages.

The modular nature of Carbonio

As we will see, it’s possible to install a single Component on a dedicated node or group multiple Components according to affinity rules.

Although this is not a suggested or supported scenario, it would be technically possible to install almost all Carbonio Components on a single virtual machine.

The possibility of installation by Components allows you to design architectures that precisely correspond to the requirements and purposes of your infrastructure.

The Components of Carbonio#

This is the list of Components that make up a Carbonio installation.

Note

Postgres, Grafana, Zookeper, and Kafka are third-party software that are installed from their respective official repositories.

Mesh & Directory

Packages:

  • service-discover-server

  • carbonio-directory-server

  • carbonio-user-management

  • carbonio-message-broker

  • carbonio-storages

Mesh & Directory
Database

Packages:

  • postgresql

  • carbonio-message-dispatcher-db

  • carbonio-ws-collaboration-db

  • carbonio-files-db

  • carbonio-mailbox-db

  • carbonio-docs-connector-db

  • carbonio-notification-push-db

Database
Mesh

Packages:

  • service-discover-server

  • carbonio-user-management

Mesh
Proxy

Packages:

  • carbonio-proxy

  • carbonio-webui

  • carbonio-files-ui

  • carbonio-tasks-ui

  • carbonio-ws-collaboration-ui

  • carbonio-search-ui

  • carbonio-avdb-updater

  • service-discover-agent

  • carbonio-catalog

  • carbonio-chats-ui DEPRECATED

Proxy
MTA AV/AS

Packages:

  • carbonio-mta

  • service-discover-agent

MTA AV/AS
Mailstore & Provisioning

Packages:

  • carbonio-advanced

  • service-discover-agent

Mailstore & Provisioning
Files

Packages:

  • carbonio-files

  • service-discover-agent

Files
Docs & Editor

Packages:

  • carbonio-docs-connector

  • carbonio-docs-editor

  • service-discover-agent

Docs & Editor
Preview

Packages:

  • carbonio-preview

  • service-discover-agent

Preview
Tasks

Packages:

  • carbonio-tasks

  • service-discover-agent

Tasks
Chats

Packages:

  • carbonio-message-dispatcher

  • carbonio-ws-collaboration

  • service-discover-agent

  • carbonio-push-connector

  • carbonio-notification-push

Chats
Video Server & Video Recording

Packages:

  • carbonio-videoserver-advanced

  • carbonio-videorecorder

  • service-discover-agent

Video Server & Video Recording
Monitoring

Packages:

  • carbonio-prometheus

  • grafana

  • service-discover-agent

Monitoring
Event Streaming

Packages:

  • ZooKeeper

  • Apache Kafka

Event Streaming
Directory Replica

Packages:

  • carbonio-directory-server

  • service-discover-agent

Directory Replica
Video Server DEPRECATED

Packages:

  • carbonio-videoserver

  • carbonio-videoserver-recorder

  • service-discover-agent

How to install Components#

Before presenting each Component and the tasks necessary for their correct installation, please review these important remarks:

  • While the overall procedure is the same for both Ubuntu and RHEL 8, the actual commands and file paths may differ on the two operating system, so pay attention that you execute the correct command on the correct files and operating system. The commands that differ are separated as follows. Click the Ubuntu or RHEL tab according to the Operating System on which you are installing Carbonio.

    # <command to be executed on Ubuntu systems>
    
    #  <command to be executed on Red Hat systems>
    
  • All the commands that are mentioned in this installation procedure must be executed as the root user

  • In case you experience some issues during the installation, please refer to Section CLI Commands, in which you can find helpful commands

  • When the installation process has successfully finished, you can access Carbonio's GUI using a browser: directions can be found in Section Access to the Web Interface

  • You must start with the installation of the Mesh & Directory Component, followed by the Database Component. Then you can proceed with the other infrastructure Components and finally with all other Components.