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.
Please go to Section System Troubleshooting for useful commands if you run into any problems throughout the installation process.
Installing and configuring the PostgreSQL database is required prior to beginning the installation of Carbonio CE.
Step 1: Repository Configuration In order to add Carbonio CE’s repository, go to the following page and fill in the form: https://www.zextras.com/carbonio-community-edition/#discoverproduct You will receive an e-mail containing: the URL of the repository the GPG key of the repository Follow the instructions in the e-mail to add these data to your system. 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. After the successful package installation, you can check that all Carbonio CE services are running, by using If any service is in failed status, restart it. Probably one of the Carbonio Monitoring exporters will not correctly start, so you will need to run
Step 4: Set up the firewall
Only the ports indicated in the Firewall Ports portion of the Requirement, i.e., those that must be accessible from the Internet, need to be opened.
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. In a few simple steps, the primary database may be setup.
We begin by creating a strong password for the administrator account of PostgreSQL.
Give a password of your choosing, which will be saved in the $DB_ADM_PWD variable and used during the entire process. It’s vital to note that the user (root) at the current terminal is the only one who can access the password. It is locked out and will be erased after you log out. However, keep in mind that you will need it for the following step. You may also manually remove it using the proper command.
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.
Following the instructions in the section under “Access to the Web Interface,” Carbonio CE can now be used when the installation is complete.
Change the Global Admin’s password immediately, as described in the section titled Manage Global Administrators.