This page contains numerous instructions and suggestions for difficulties that may emerge during the normal operation of Carbonio CE and are connected to any third-party software installed.
Verify nginx configuration.
The nginx configuration is distributed among several files, so if an issue occurs while it is operating, it may take some time to identify the cause of the problem.
There are two primary reasons why nginx may not operate properly or start:
PostgreSQL Database Issues
In rare situations, a database may become inaccessible, as indicated by a notice in the log file, such as: The database called core cannot be accessed, resulting in SQL operations failing. This type of error occurs when a database has the incorrect owner. On Carbonio CE, the name of the user who owns one of the databases specified in Table 3 must match the database’s name.
When the owner of any of these databases is incorrect, you can remedy the mistake by performing as the postgres user the command.
After you issued the command, you can confirm that the database has the right owner by using command.
Carbonio Mesh
The dedicated page Troubleshooting Carbonio Mesh contains troubleshooting information for Carbonio Mesh.
Let us encrypt useful commands.
There are several commands that might be beneficial when working with Let’s Encrypt certificates.
Check Status.
This command returns a variety of helpful information about the current certificate, such as how many days it is still valid.
Manual Renew
This command renews certificates issued by Let’s Encrypt’s certbot Timer.
The certbot timer does a check of the presently installed certificates twice a day (every 12 hours). To see the status of the certbot timer, execute the command
You may check the timer’s log using command.
This proves handy. If the result of the previous command returns the status as different from Active: active, as in the following example:
To start an inactive timer, use the command carbonio-certbot.service. Systemd Unit
This is the service that actually performs all of the actions necessary to renew the certificates deployed on the Carbonio CE infrastructure. It is triggered by the certbot timer
You may inspect the log files using
An example output of this command is:
CertBot Log File
The activities performed by certbot are recorded in the file /var/log/carbonio/letsencrypt/letsencrypt.log. To view it, execute one of the following commands: Less, More, Tail, Cat
System Troubleshooting
The carbonio service interfaces easily with other system tools such as systemctl and journalctl, allowing for faster analysis of the situation and detection of any issues that may develop.
The syntax is the standard used by systemctl, thus you may use this command to start or stop all carbonio units.
To verify the status of all carbonio services, use the command.
More details about each unit you can operate
If any service has failed, restart it. To access logs from all units, ensure that the nginx Carbonio Monitoring exporter is running.