Troubleshooting¶

Permission denied error when saving Bacula configuration
HTTP error 500 and no interface page is loading
Error 1000 when you go to Volumes page
Time fields contain invalid date/time values
The job history list or the job files table is empty
The Bacularis job tables are loading slowly
Warning about legacy keyring on apt update command
Job file list does not show results
Searching by filename does not work in restore wizard
Where to find help?

Permission denied error when saving Bacula configuration¶

Error 1000: Internal error.
[Warning] file_put_contents(/etc/bacula/bacula-dir.conf): failed to open stream:
Permission denied (@line 56 in file
/var/www/bacularis/protected/Common/Modules/ConfigBacula.php).

The web server user of the Bacularis API requires read/write access to the Bacula configuration files. It requires manual administrator action to set proper permission to files. Bacularis does not solve this issue automatically.

Below you can find two hints, how this problem can be solved:

Hint 1: assign web server user to Bacula group

If your Bacula daemons use bacula user with group bacula, you can assign the web server user to bacula group, for example for apache user the comman can look as below:

usermod -a -G bacula apache

After running this command the web server (or PHP-FPM if used) needs to restarted (example for the Apache web server).

systemctl restart php-fpm
systemctl restart httpd

Hint 2: make sure that permissions for Bacula config files are correct

If you applied Hint 1, now you need to check if all Bacula configuration files have appropriate system group assigned. In many cases it is group bacula:

# ls -la /etc/bacula
drwxr-xr-x  3 root   bacula 4096 2022-02-05  .
drwxr-xr-x 86 root   root   4096 08-18 07:42 ..
-rw-rw----  1 bacula bacula 4100 03-25 06:24 bacula-dir.conf
-rw-rw----  1 root   bacula 1128 2022-01-16  bacula-fd.conf
-rw-rw----  1 bacula bacula 1607 2022-02-05  bacula-sd.conf
-rw-rw----  1 root   bacula  266 2022-01-16  bconsole.conf

Please note that the Bacula config directory should have permissions rwxr-xr-x that does allow to modify existing files by bacula user but does not allow creating new config files. To enable creating new files by user group you should set the directory permissions to rwxrwxr-x.

Bacula config file permissions are rw-rw---- that gives read/write access for the file owner/group.

HTTP error 500 and no interface page is loading¶

If after successful installation you experienced the HTTP error 500 and you are not able to load the web interface, please make sure that your PHP is at least in version 7.4 or greater. From Bacularis 2.1.0 minimal PHP version has been changed from 7.1 to 7.4.

CentOS 8 / CentOS Stream 8 / AlmaLinux 8 / Oracle Linux 8 / Rocky Linux 8

By default on these systems is installed PHP version 7.2. Please switch PHP to 7.4 or greater by the following command:

dnf module switch-to php:7.4

After that please refresh the Bacularis web page.

Error 1000 when you go to Volumes page¶

Error 1000 - Internal error. [Warning] strtotime(): It is not safe to rely on the system's timezone settings. You are *required* to use the date.timezone setting or the date_default_timezone_set() function. In case you used any of those methods and you are still getting this warning, you most likely misspelled the timezone identifier. We selected the timezone 'UTC' for now, but please set date.timezone to select your timezone. (@line 135 in file /var/www/bacularis/protected/API/Modules/VolumeManager.php).

To solve this error please set a timezone in the PHP configuration file. You can do it the php.ini file, for example:

date.timezone = "Europe/Warsaw"

To check your timezone, please look at the list of all timezones possible to set in the php.ini file.

Time fields contain invalid date/time values¶

Wrong timezone is set in the PHP configuration. To fix it, please update “date.timezone” option in the php.ini file, for example:

date.timezone = "Europe/Warsaw"

To check your timezone, please look at the list of all timezones possible to set in the php.ini file.

The job history list or the job files table is empty¶

The reason can be a try to load too many elements, for example 20,000 jobs. In this case please check the web server logs for the Bacularis API and the Bacularis Web to make sure, that it is because of exhausted PHP memory limit.

[Error] Allowed memory size of 125829120 bytes exhausted (tried to allocate 1167360 bytes) (@line 262 in file /var/www/bacularis/protected/API/Modules/BaculumAPIServer.php).

If it is this case, you can solve in in two ways:

setting lower elements limit in the Bacularis Web application settings (gearwheel icon on the top left side of page),

increasing memory limit for PHP by setting in php.ini file for example:

memory_limit = 256M

The Bacularis job tables are loading slowly¶

Default the number of jobs displayed in tables is set to 15000 jobs. There is possible to change this limit by setting lower value than 15000. It is recommended if older jobs are not so relevant to display in the job tables. Always there is possible to increase the limit back to 15000 or greater value.

To set the number of jobs displayed in tables, please go to the Bacularis Web application settings page (under black gear wheel icon at the top left side of the interface) and set lower value in the field Max. number of jobs visible in tables, for example 500.

Warning about legacy keyring on apt update command¶

Using apt-key to manage package keys is deprecated. From this reason while updating repositry database you can see a warning like this:

W: https://pkgs.bacularis.app/stable/ubuntu/dists/jammy/InRelease: Key is stored in legacy trusted.gpg keyring (/etc/apt/trusted.gpg), see the DEPRECATION section in apt-key(8) for details.

To migrate from apt-key to a new way of storing package keys in the gpg location, please follow on steps below:

Remove the Bacularis key from the APT key database

apt-key del '546E 19BB E5BD D219 644C 0851 E72D 44EC 5C3D BD51'

Add the Bacularis key to the gpg keys in /usr/share/keyrings

wget -qO- https://pkgs.bacularis.app/bacularis.pub | gpg --dearmor > /usr/share/keyrings/bacularis-archive-keyring.gpg

Edit the Bacularis repository file

vi /etc/apt/sources.list.d/bacularis.list

and to deb and deb-src lines the string in square bracket:

[signed-by=/usr/share/keyrings/bacularis-archive-keyring.gpg]

For example, for the Debian 11 Bullseye entries you need to change:

From:

deb https://pkgs.bacularis.app/stable/debian bullseye main
deb-src https://pkgs.bacularis.app/stable/debian bullseye main

To:

deb [signed-by=/usr/share/keyrings/bacularis-archive-keyring.gpg] https://pkgs.bacularis.app/stable/debian bullseye main
deb-src [signed-by=/usr/share/keyrings/bacularis-archive-keyring.gpg] https://pkgs.bacularis.app/stable/debian bullseye main

If in your Bacularis repository file you have architecture defined in the deb line like here (example for Ubuntu 18.04 Bionic):

deb [arch=amd64] https://pkgs.bacularis.app/stable/ubuntu bionic main
deb-src https://pkgs.bacularis.app/stable/ubuntu bionic main

the signed-by string needs to be added just after with a space character as separator:

deb [arch=amd64 signed-by=/usr/share/keyrings/bacularis-archive-keyring.gpg] https://pkgs.bacularis.app/stable/ubuntu bionic main
deb-src [signed-by=/usr/share/keyrings/bacularis-archive-keyring.gpg] https://pkgs.bacularis.app/stable/ubuntu bionic main

Job file list does not show results¶

This problem can mean that you use Bacula 9 or older. In Bacula 11 has been changed the Bacula table format and Filename property is no longer in separate SQL table but it is added to the File table. This change has an effect on Bacularis.

In this case in the Bacularis Web debug log you will see the following error:

Column not found: 1054 Unknown column 'File.Filename' in 'field list'

The solution is to upgrade Bacula to version 11 or greater.

Searching by filename does not work in restore wizard¶

This problem can mean that you use Bacula 9 or older. In Bacula 11 has been changed the Bacula table format and Filename property is no longer in separate SQL table but it is added to the File table. This change has an effect on Bacularis.

In this case in the Bacularis Web debug log you will see the following error:

Column not found: 1054 Unknown column 'File.Filename' in 'field list'

The solution is to upgrade Bacula to version 11 or greater.

Where to find help?¶

Mailing list¶

For getting help with installing and configuring Bacularis you can use the Bacularis Discussion Group at the address:

https://groups.google.com/g/bacularis

Alternatively you can use the Bacula-Users mailing list on SourceForge.net:

Registration to the list:

https://sourceforge.net/projects/bacula/lists/bacula-users

The mailing list archive:

https://sourceforge.net/p/bacula/mailman/bacula-users

The mailing list e-mail address:

Bug tracker¶

If you find a bug in Bacularis, you can report it to the Bacularis APP GitHub Project at:

https://github.com/bacularis/bacularis-app/issues