Using Veeam Configuration Database Connection Utility in Veeam Backup & Replication for Linux

The utility is located on the backup server in the following directory: /opt/veeam/dbconfig. To use the utility, you must have root permissions on the local machine.

To manage connection settings for Veeam Backup & Replication, check prerequisites and perform the following steps:

1. Generate Answer File.
2. Edit Answer File.
3. Run the Utility.

Limitations and Considerations

Before you configure database connection settings, consider the following:

• Do not connect Veeam Backup & Replication to the database which is being used by another Veeam Backup & Replication. In that case, Veeam Backup & Replication will not be able to utilize the encrypted data stored in this database.
• Both local and remote PostgreSQL instances are supported. If a database with the specified name does not exist on the selected PostgreSQL instance, it will be created anew.
• The configuration database connection utility supports only connection to configuration databases of the current version.
• If the database requires a schema upgrade or all saved passwords must be entered again, you must allow these operations in the answer file. Otherwise, the utility stops with an error. See the ACCEPT_DATABASE_SCHEMA_UPGRADE and ACCEPT_STORED_PASSWORDS_LOSS parameters.

Step 1. Generate Answer File

To generate the answer file, do the following:

1. Log in to the host management console.
2. Click Remote Access Configuration.
3. Click Enter Shell.
4. Run the following command to generate the answer file. In the generate parameter, specify the path where the answer file will be saved.

After you run the command, the answer file will be generated with default preferences in the path you specified.

Step 2. Edit Answer File

Edit the generated answer file and specify the necessary parameter values. Remove the optional parameters that you do not use.

Answer File Parameters

Step 3. Run Utility.

To run the utility, do the following:

1. Log in to the host management console.
2. Click Remote Access Configuration.
3. Click Enter Shell.
4. Run the following command. In the file parameter, specify the path to the answer file.

The utility checks the database, applies the connection settings and starts the Veeam Backup & Replication services. You do not need to start the services manually.

The utility writes the log to /var/lib/veeam/VeeamBackupLogFolder/Utils/Util.VeeamBackupConfiguration.Reconfiguration.log.

Specifying Parameters at Runtime

You can specify answer file parameters when you run the utility in the following ways:

• Use the property argument. Specify the argument once for each parameter. For example: /property:SQLSERVER_DATABASE=VeeamBackup.
• Use an environment variable named VEEAM_<parameter name>. For example: VEEAM_SQLSERVER_DATABASE.

If you specify the same parameter in more than one place, the utility uses the value in the following order:

1. The property argument.
2. A non-empty value in the answer file.
3. The environment variable.

If you do not specify a parameter anywhere, the utility uses the default value of the parameter. If the parameter has no default value, the utility returns an error.

The utility does not write secured parameter values, such as passwords, to the log.