Docker: Upgrading from 25.0.1 to 25.0.3 throws error missing "PgCommon.pm" #903

New issue

Open

opened 2026-03-04 11:16:55 -05:00 by deekerman · 1 comment

deekerman commented

2026-03-04 11:16:55 -05:00

Owner

Originally created by @ecerichter on GitHub (May 3, 2025).

Description

Trying to upgrade from CloudBeaver:25.0.1 to CloudBeaver:25.0.3 gives the following error:

`
03-05-2025 13:41:21.294 [main] INFO o.j.d.e.p.b.JDBCDatabasePostgresBackupHandler - Command started: pg_dump cloudbeaver --host xxx.xxx.xxx.xxx --port 5432 --blobs --verbose --file /opt/cloudbeaver/workspace/backup/cloudbeaver_backup_version_cb22.zip --schema cb
03-05-2025 13:41:23.093 [main] ERROR o.j.d.e.p.b.JDBCDatabasePostgresBackupHandler - Postgres backup failed with output: Can't locate PgCommon.pm in @INC (you may need to install the PgCommon module) (@INC entries checked: /etc/perl /usr/local/lib/x86_64-linux-gnu/perl/5.38.2 /usr/local/share/perl/5.38.2 /usr/lib/x86_64-linux-gnu/perl5/5.38 /usr/share/perl5 /usr/lib/x86_64-linux-gnu/perl-base /usr/lib/x86_64-linux-gnu/perl/5.38 /usr/share/perl/5.38 /usr/local/lib/site_perl) at /usr/bin/pg_dump line 22.
BEGIN failed--compilation aborted at /usr/bin/pg_dump line 22.

03-05-2025 13:41:23.093 [main] ERROR o.j.d.e.p.b.JDBCDatabasePostgresBackupHandler - Create backup is failed: Postgres backup failed
03-05-2025 13:41:23.093 [main] WARN o.j.d.m.sql.schema.SQLSchemaManager - CB_CE migration has been rolled back
03-05-2025 13:41:23.096 [main] ERROR io.cloudbeaver.server.CBApplication - Error initializing database
org.jkiss.dbeaver.DBException: Error updating management database schema
at io.cloudbeaver.service.security.db.CBDatabase.initialize(CBDatabase.java:164)
at io.cloudbeaver.service.security.EmbeddedSecurityControllerFactory.createAndInitDatabaseInstance(EmbeddedSecurityControllerFactory.java:84)
...
`

I'm using a external postgresql database for CloudBeaver metadata.
How can I solve this issue?

Steps to reproduce

No response

Expected/Desired Behavior

Backup executed without errors...

CloudBeaver Version

25.0.3

Additional context

I've helped myself by creating a "hotfix" of the image with the following Dockerfile:

FROM dbeaver/cloudbeaver:25.0.3
RUN apt-get update -y
RUN apt-get install -y postgresql-common postgresql-client

and a build

docker build -t cloudbeaver:25.0.3.1 .

Originally created by @ecerichter on GitHub (May 3, 2025). ### Description Trying to upgrade from CloudBeaver:25.0.1 to CloudBeaver:25.0.3 gives the following error: ` 03-05-2025 13:41:21.294 [main] INFO o.j.d.e.p.b.JDBCDatabasePostgresBackupHandler - Command started: pg_dump cloudbeaver --host xxx.xxx.xxx.xxx --port 5432 --blobs --verbose --file /opt/cloudbeaver/workspace/backup/cloudbeaver_backup_version_cb22.zip --schema cb 03-05-2025 13:41:23.093 [main] ERROR o.j.d.e.p.b.JDBCDatabasePostgresBackupHandler - Postgres backup failed with output: Can't locate PgCommon.pm in @INC (you may need to install the PgCommon module) (@INC entries checked: /etc/perl /usr/local/lib/x86_64-linux-gnu/perl/5.38.2 /usr/local/share/perl/5.38.2 /usr/lib/x86_64-linux-gnu/perl5/5.38 /usr/share/perl5 /usr/lib/x86_64-linux-gnu/perl-base /usr/lib/x86_64-linux-gnu/perl/5.38 /usr/share/perl/5.38 /usr/local/lib/site_perl) at /usr/bin/pg_dump line 22. BEGIN failed--compilation aborted at /usr/bin/pg_dump line 22. 03-05-2025 13:41:23.093 [main] ERROR o.j.d.e.p.b.JDBCDatabasePostgresBackupHandler - Create backup is failed: Postgres backup failed 03-05-2025 13:41:23.093 [main] WARN o.j.d.m.sql.schema.SQLSchemaManager - CB_CE migration has been rolled back 03-05-2025 13:41:23.096 [main] ERROR io.cloudbeaver.server.CBApplication - Error initializing database org.jkiss.dbeaver.DBException: Error updating management database schema at io.cloudbeaver.service.security.db.CBDatabase.initialize(CBDatabase.java:164) at io.cloudbeaver.service.security.EmbeddedSecurityControllerFactory.createAndInitDatabaseInstance(EmbeddedSecurityControllerFactory.java:84) ... ` I'm using a external postgresql database for CloudBeaver metadata. How can I solve this issue? ### Steps to reproduce _No response_ ### Expected/Desired Behavior Backup executed without errors... ### CloudBeaver Version 25.0.3 ### Additional context I've helped myself by creating a "hotfix" of the image with the following Dockerfile: `FROM dbeaver/cloudbeaver:25.0.3` `RUN apt-get update -y` `RUN apt-get install -y postgresql-common postgresql-client` and a build `docker build -t cloudbeaver:25.0.3.1 .`

deekerman added the

deployment

documentation

x:postgresql

labels

2026-03-04 11:16:55 -05:00

deekerman commented

2026-03-04 11:17:06 -05:00

Author

Owner

@dariamarutkina commented on GitHub (May 5, 2025):

Hello, @ecerichter!
Thanks for the report. We will update the documentation soon.
Alternatively, you can disable backups of the database.
backupEnabled: "${CLOUDBEAVER_DB_BACKUP_ENABLED:false}"
https://github.com/dbeaver/cloudbeaver/wiki/Server-configuration

Thank you for using CloudBeaver! 🦫

@dariamarutkina commented on GitHub (May 5, 2025): Hello, @ecerichter! Thanks for the report. We will update the documentation soon. Alternatively, you can disable backups of the database. `backupEnabled: "${CLOUDBEAVER_DB_BACKUP_ENABLED:false}"` https://github.com/dbeaver/cloudbeaver/wiki/Server-configuration Thank you for using CloudBeaver! 🦫