List and Query

Bacula Enterprise Only

This solution is only available for Bacula Enterprise. For subscription inquiries, please reach out to sales@baculasystems.com.

It is possible to list IRIS instances or databases using the Bconsole .ls command or through a .query command.

Any Fileset parameter can be employed in the plugin="" value to filter the results, similar to how the backup operates.

Below are several examples:

List instances:

List example: instances

.ls plugin="iris: instance=IRIS" client=127.0.0.1-fd path=/instance
Connecting to Client 127.0.0.1-fd at 127.0.0.1:9102
-rw-r-----   1 nobody   nobody                 1050 2025-02-25 18:19:57  /@iris/IRIS/instance.json
2000 OK estimate files=1 bytes=1,050

Query instances:

Query example: list all instances

.query plugin="iris: instance=IRIS" client=127.0.0.1-fd parameter="instance"
instance=IRIS
name=IRIS
up=true
status=running
version=2025.1

List available databases:

Query example: list available databases

.query plugin="iris: instance=IRIS" client=127.0.0.1-fd parameter="database-available"
database=USER
instance=IRIS
path=/usr/irissys/mgr/USER
included=true
readOnly=false

List databases currently included in IRIS backups:

Query example: list included databases

.query plugin="iris: instance=IRIS" client=127.0.0.1-fd parameter="database-included"

Add or remove a database from the IRIS backup list:

Query example: add database

.query plugin="iris: instance=IRIS" client=127.0.0.1-fd parameter="database-add:APPDB"

Query example: remove database

.query plugin="iris: instance=IRIS" client=127.0.0.1-fd parameter="database-remove:APPDB"

Freeze and thaw (useful for external snapshot workflows):

Query example: freeze/thaw

.query plugin="iris: instance=IRIS freeze_timeout=60" client=127.0.0.1-fd parameter="freeze"
.query plugin="iris: instance=IRIS" client=127.0.0.1-fd parameter="thaw"