This is an archive version of the document. To get the most up-to-date information, see the current version.

Configuring Plug-in on Linux Machines

In this article

    To configure Veeam Plug-in, you can use OracleRMANConfigTool. The tool configures Oracle RMAN integration settings and creates the VeeamPluginforOracleRMAN/veeam_config.xml file which is stored in the installation folder of the plug-in.

    If you change the plug-in configuration with OracleRMANConfigTool, changes will be recorded in the log file: /tmp/Veeam_plugin_logs/<user>/OracleRMANConfigTool.log. Note that if you change the veeam_config.xml file manually, it will not be recorded in logs.

    To configure Veeam Plug-in for Oracle RMAN, do the following:

    1. Log in to the Oracle server with an account which is a member of the DBA group.
    2. Launch the configuration wizard:

    OracleRMANConfigTool --wizard

    1. Specify the DNS name or IP address of the Veeam Backup & Replication server.

    Enter backup server name or IP address: 172.24.164.68

    1. Specify the port which will be used to communicate with the Veeam Backup & Replication server. Default port: 10006.

    Enter backup server port number: 10006

    1. Specify credentials to authenticate against the Veeam Backup & Replication server. Note that the account must have access permissions on the required Veeam backup repository. Otherwise, the repository will not be listed as available. To learn how to grant access rights on Veeam backup repositories, see Granting Permissions on Repositories.

    Enter username: serv17\administrator

    Enter password for serv17\username:

    Configuring Plug-in on Linux Machines Important!

    To work with backups created by Veeam Plug-in, you can use only the account used for creating the backup. If you want to use another account, assign the following roles to the required account:

    • To restore from the backup using another account, assign Veeam Backup Administrator or Veeam Restore Operator roles to the required account.
    • To continue the backup chain using another account, assign Veeam Backup Administrator or Veeam Backup Operator roles to the required account.

    For details on assigning Veeam Backup & Replication roles, see the Roles and Users section of the Veeam Backup & Replication User Guide.

    1. Select the backup repository where you want to store the backups. In the wizard dialog, enter the number of the repository from the list of available repositories. If you want to add several repositories, enter the required numbers separated by blank spaces.

    If you want to use the Oracle RMAN Backup Duplexing functionality, you can select up to four repositories. The copies of backups will be sent to all selected repositories. Note that Oracle Database Standard Edition does not allow using more than one RMAN channel. Thus, if you use Standard Edition, you can select only one repository.

    Available repositories are:

    1. serv10_repo

    2. serv02_repo

    Enter up to 4 Repository numbers as RMAN disk devices for RMAN copy processing. Use blanks as separators: 2

    Enter number of data streams (From 1 to 254) that run in parallel for each backup repository (RMAN Plugin DEVICE PARALLELISM VALUE). Channel count per device: 4

    1. Specify the number of parallel data streams for each backup repository. Note that Oracle Database Standard Edition does not allow using more than one RMAN channel. Thus, if you use Standard Edition, you can select only one data stream.

    Enter number of data streams (From 1 to 254) that run in parallel for each backup repository (RMAN Plugin DEVICE PARALLELISM VALUE).

    Channel count per device: 4

    1. At the last step of the plug-in wizard, you can export configuration files (the Veeam Plug-in configuration file and RMAN configuration file). You can import these configuration files to other servers to apply the same settings.

    Configuration Tool Parameters

    If you want to change a specific parameter, you can run OracleRMANConfigTool with the required parameter from the table:

    Parameter

    Description

    --help

    Shows the list of parameters of the plug-in configuration tool.

    --show-config

    Shows configuration parameters.

    --wizard

    Starts the wizard to configure the plug-in settings.

    --set-credentials <"serv\username"> <"password">

    Specifies credentials to connect to the Veeam backup server.

    --set-host <hostname>

    Specifies the host of the Veeam backup server.

    --set-repositories

    Launches the repository selection dialogue.

    --set-parallelism <number_of_channels>

    Configures RMAN parallelism settings.

    --map-backup

    Maps the imported backups.