Installation on a single server
Each stage of the installation process on RHEL 8 or Ubuntu 20.04 is broken down into optional and preliminary setup procedures. Make sure you have access to the command line because it will be used to run commands during Carbonio CE’s installation and configuration
Following a successful installation, you may use a browser to view Carbonio CE’s GUI by following the instructions in Section view to the Web Interface.
The PostgreSQL database needs to be installed and configured before we can start the Carbonio CE installation.
Step 1: Configuring the repository
Go to the following page and complete the form to add Carbonio CE’s repository:
You will get an email that includes:
- the repository’s web address
- the repository’s GPG key
To add this data to your system, follow the instructions in the email.
Repository and Channels
The following are important information concerning the packages repository Carbonio CE and its content. Please read them carefully, as they might save you some time in case of installation or upgrade problems and help you to provide more precise bug reports.
The repository hosts simultaneously packages of two channels:
Release Candidate (RC). Packages in this channel are made available as soon as they are built by Zextras development and tested by the QA team. While they are stable, they are not suitable for a use in a production environment, because they might still contain some bug, new functionalities that have not yet reached a production-level quality, or some broken dependencies might be introduced.
Usually these problems are fixed within days or even hours, so in case just try again before you report some problem.
Use this channel and its packages for testing (or demo) installations only.
RELEASE. This channel contains only packages that are stable and suitable for a production environment.
I want to help testing things, which channel should I use?
I need to install Carbonio in a production environment which channel should I use?
How will we be informed about new RC packages?
There will be no notification, because RC channel is updated continuously.
How will we be informed about a potential new release incoming?
A red message on the homepage of the documentation site will notify you of the release of a new stable version. You may also be informed through other means of communication such as email and social media.
Could there be bugs in the packages downloaded from the RC channel?
Yes, RC versions have a risk of containing bugs (which in some cases could lead to data loss). If you find a bug in an RC package we kindly ask you to report it on the appropriate community page. We will try to resolve it as quickly as possible.
Step 2: Setting Hostname
Carbonio CE needs a valid FQDN as hostname and a valid entry in the /etc/hosts file. To configure them, execute these two commands. First, set the hostname
then update /etc/hosts with IP and hostname
You can also simply get the current IP and hostname and save them:
Step 3: System Upgrade and Package Installation
After configuring the repositories, the installation of Carbonio CE requires to run a few commands.
We start by updating and upgrading the system.
Next, we install all packages needed for Carbonio CE.
Step 4: Configure Firewall
You need to open only the ports that must be accessible form the Internet, i.e., those that are listed in the Requirement’s Firewall Ports section.
Step 5: Carbonio Bootstrap CE
Utilise the following command to setup and run Carbonio CE after all packages have been installed.
Press Y to apply the configuration before completing the startup. Click Enter to continue, and the procedure will run until it is finished.
setup and configuration Mesh
The different Carbonio CE components will be configured and set up in the following phases.
Setup of Carbonio Mesh in Step 6
To enable connectivity between Carbonio CE and its components, Carbonio Mesh is necessary. Commands are used to interactively generate the configuration.
This instruction will:
- the IP address and the netmask
- In order to install, administer, and use the administrative GUI, you must have the Carbonio Mesh secret. For additional details, go to Section Carbonio Mesh Administration Interface.
- MESH_SECRET will be used to refer to this password throughout the manual.
You can regenerate Carbonio Mesh Secret in the event that the password is forgotten or the credential file is damaged and rendered useless.
- Keep the setup in the file cluster-credentials.tar.gpg at /etc/zextras/service-discover
Run to complete the installation of Carbonio Mesh.
Step 7: Create the Carbonio CE Main DB Role and Database
To store and keep track of all the items it needs to handle, Carbonio CE uses several databases. If you are running Carbonio CE on RHEL 8, please first configure Postgres in accordance with the instructions before configuring the primary database, which may be done in two phases.
Making a role with administrative privileges and a related password is the first step.
You’ll need it for the rest of the process and may need it in the future, so make sure to update the password with a strong one of your choosing and keep it safely (ideally using a password manager). DB_ADM_PWD will be used to identify this password.