Troubleshooting¶
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: