Installation on a single server on CE

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.

Only RHEL 8 Preliminary Tasks

Configuring the repository is Step 1

Go to the following page and complete the form to add Carbonio CE’s repository:

https://www.zextras.com/carbonio-community-edition/#discoverproduct

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.

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. Post-Installation tasks

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 chores

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.

The database creation process is the next phase.

Bootstrap Carbonio Files Databases in Step 8

In this stage, when we configure the database for Carbonio Files, we need the password DB_ADM_PWD that was established in the preceding phase for the carbonio_adm role. The database is bootstrapped first.

Then, as the zextras user, restart the primary mailbox process.

Installation Complete

Following the instructions in the section under “Access to the Web Interface,” Carbonio CE can now be used when the installation is complete.

The work of changing the password for the system user with administrative access is also strongly encouraged and is covered in the section Change Password of System User below.

Change the system user’s password

Enter these two commands while logged in as the zextras user to a shell terminal in order to modify the password that the zextras@mail.example.com user uses to access the Web. With the second, you can truly change the password whereas the first enables you to switch to the zextras user.

Make sure newpassword complies with sound security standards.

Users of zextras@mail.example.com and zextras

These two users may be distinguished clearly since they are meant to carry out various duties.

zextras

To do administrative actions via the command line, one must utilise the administrator’s unix account.

zextras@mail.example.com

This is the default administrator account that should be used to operate Carbonio CE via the web interface and access the Admin UI.

Management and troubleshooting for Arbonio CE

System tools like systemctl and journalctl, which the carbonio service smoothly connects with, make it possible to analyse the situation and look for potential issues more quickly.

Since the syntax is the same as that used by systemctl, you may use it to start, stop, or check the status of each Carbonio unit as well as to read the logs that each unit produces.

With the command below, you may get a list of all Carbonio-related units (and their state), then use only the unit you want to access to check, start, or stop it.

Installation on a single server