Application-Aware Settings (Server Mode)

In this article

    This section describes application-aware settings of the backup job.

    General Settings

    Parent Tag

    Parameter

    Description

    Applications

    Parent tag that encapsulates information about application-aware settings.

     

    Enabled

    Parameter describes if application-aware processing is enabled. Possible values:

    • True — application-aware processing is enabled.
    • False — application-aware processing is not enabled.

     

    ProcessTransaction
    Logs

    Parameter describes how transaction logs must be processed. Possible values:

    • True — transaction logs are processed with the Veeam Agent for Microsoft Windows backup job.
    • False — transaction logs are processed with a third-party tool. Veeam Agent for Microsoft Windows performs copy-only backup.

     

    Microsoft SQL Server Settings

    Parent Tag

    Parameter

    Description

    Sql

    Parent tag that encapsulates information about transaction logs settings for Microsoft SQL Server.

     

    Mode

    Parameter describes how Veeam Agent for Microsoft Windows processes transaction logs for Microsoft SQL Server. Possible values:

    • 0 — Veeam Agent for Microsoft Windows does not truncate transaction logs.
    • 1 — Veeam Agent for Microsoft Windows truncates transaction logs.
    • 3 — Veeam Agent for Microsoft Windows periodically backs up transaction logs. During the job session, Veeam Agent for Microsoft Windows also truncates transaction logs.

    NOTE! If you do not specify the Mode parameter but set the Enabled parameter in the Backup tag to True, transaction log backup will be enabled.

    Backup

    This tag is used only if you set the Mode parameter to 3 (Veeam Agent for Microsoft Windows periodically backs up transaction logs).

    Parent tag encapsulating information about transaction logs backup settings for Microsoft SQL Server.

     

    Enabled

    This parameter is used only if you set the Mode parameter to 3 (Veeam Agent for Microsoft Windows periodically backs up transaction logs).

    Parameter specifies if Veeam Agent for Microsoft Windows must back up transaction logs. Possible values:

    • True — Veeam Agent for Microsoft Windows backs up transaction logs.
    • False — Veeam Agent for Microsoft Windows does not back up transaction logs.

    NOTE! If you do not specify the Enabled parameter but set the Mode parameter to 3, transaction log backup will be enabled.

     

    BackupMinutes

    This parameter is used only if you set the Mode parameter to 3 (Veeam Agent for Microsoft Windows periodically backs up transaction logs).

    Periodicity with which Veeam Agent for Microsoft Windows must back up transaction logs (in minutes). By default, Veeam Agent for Microsoft Windows backs up transaction logs every 15 minutes.

     

    Expirable

    This parameter is used only if you set the Mode parameter to 3 (Veeam Agent for Microsoft Windows periodically backs up transaction logs).

    Retention policy settings for backed up transaction logs. Possible values:

    • True — transaction log backups are removed from the backup target after N days. Together with this parameter, you must specify retention policy settings in the ExpireDays parameter.
    • False — transaction log backups are removed from the backup target together with the parent backup (when the parent backup becomes outdated and is removed from the primary backup chain).

     

    ExpireDays

    This parameter is used only if you set the Mode parameter to 3 (Veeam Agent for Microsoft Windows periodically backs up transaction logs) and set the Expirable parameter to True (delete transaction log backups after N days).

    Retention policy settings for transaction log backups (in days). By default, Veeam Agent for Microsoft Windows removes from the backup target transaction log backups that are older than 15 days.

    Credentials

    This tag is used only if you want to use impersonation and connect to the Microsoft SQL Server under the database administrator account.

    Parent tag that encapsulates information about credentials of a database administrator account.

     

    UserName

    This parameter is used only if you want to use impersonation and connect to the Microsoft SQL Server under the database administrator account.

    User name of the database administrator account. The user name is specified as a text string encoded in the Base64 format.

     

    Password

    This parameter is used only if you want to use impersonation and connect to the Microsoft SQL Server under the database administrator account.

    Password of the database administrator account. The password is encrypted. For more information, see Encryption of User Credentials.

     

    Oracle Settings

    Parent Tag

    Parameter

    Description

    Oracle

    Parent tag that encapsulates information about transaction logs settings for Oracle.

     

    Mode

    Parameter describes how Veeam Agent for Microsoft Windows processes transaction logs for Oracle. Possible values:

    • 0 — Veeam Agent for Microsoft Windows does not truncate transaction logs.
    • 1 — Veeam Agent for Microsoft Windows truncates transaction logs that are older than N hours. If you set the Mode parameter to 1, you must specify the LifetimeHours parameter.
    • 2 — Veeam Agent for Microsoft Windows truncates transaction logs whose size is over N GB. If you set the Mode parameter to 2, you must specify the SizeGB parameter.

     

    AccountType

    This parameter is used only if you want Veeam Agent for Microsoft Windows to connect to an Oracle database under a specific account.

    Type of account you want to use. Possible values:

    • 0 — Oracle account
    • 1 — Microsoft Windows account

    Together with the AccountType parameter, you must specify UserName and Password parameters in the Credentials tag.

     

    LifetimeHours

    This parameter is used if you set the Oracle parameter to 1 (Veeam Agent for Microsoft Windows truncates transaction logs that are older than N hour).

    Age of transaction logs that must be truncated (in hours). By default, Veeam Agent for Microsoft Windows truncates transaction logs that are older than 24 hours.

     

    SizeGB

    This parameter is used if you set the Oracle parameter to 2 (Veeam Agent for Microsoft Windows truncates transaction logs whose size is over N GB).

    Size of transaction logs that must be truncated (in GB). By default, Veeam Agent for Microsoft Windows truncates transaction logs whose size is over 10 GB.

    Backup

    Parent tag that encapsulates information about transaction logs backup settings for Oracle.

     

    Enabled

    Parameter specifies if Veeam Agent for Microsoft Windows must back up transaction logs. Possible values:

    • True — Veeam Agent for Microsoft Windows backs up transaction logs.
    • False — Veeam Agent for Microsoft Windows does not back up transaction logs.

     

    BackupMinutes

    Periodicity with which Veeam Agent for Microsoft Windows must back up transaction logs (in minutes). By default, Veeam Agent for Microsoft Windows backs up transaction logs every 15 minutes.

     

    Expirable

    Retention policy settings for backed up transaction logs. Possible values:

    • True — transaction log backups are removed from the backup target after N days. Together with this parameter, you must specify retention policy settings in the ExpireDays parameter.
    • False — transaction log backups are removed from the backup target together with the parent backup (when the parent backup becomes outdated and is removed from the primary backup chain).

     

    ExpireDays

    This parameter is used only if you set the Expirable parameter to True (delete transaction log backups after N days).

    Retention policy settings for transaction log backups (in days). By default, Veeam Agent for Microsoft Windows removes transaction log backups that are older than 15 days from the backup target.

    Credentials

    This tag is used only if you want Veeam Agent for Microsoft Windows to connect to an Oracle database under a specific account.

    Parent tag that encapsulates information about credentials of the account used to connect to the Oracle database.

     

    UserName

    This parameter is used only if you want Veeam Agent for Microsoft Windows to connect to an Oracle database under a specific account.

    User name of the account under which Veeam Agent for Microsoft Windows must connect to the Oracle database. The user name is specified as a text string encoded in the Base64 format.

     

    Password

    This parameter is used only if you want Veeam Agent for Microsoft Windows to connect to an Oracle database under a specific account.

    Password of the account under which Veeam Agent for Microsoft Windows must connect to the Oracle database. The password is encrypted. For more information, see Encryption of User Credentials.

     

    Microsoft SharePoint Settings

    Parent Tag

    Parameter

    Description

    SharePoint

    Parent tag that encapsulates information about settings for Microsoft SharePoint Server.

    Credentials

    Parent tag that encapsulates information about credentials of the account used to connect to Microsoft SharePoint Server.

     

    UserName

    User name of the account used to connect to Microsoft SharePoint Server. The user name is specified as a text string encoded in the Base64 format.

     

    Password

    Password of the account used to connect to Microsoft SharePoint Server. The password is encrypted. For more information, see Encryption of User Credentials.

     

    Custom Script Settings

    Parent Tag

    Parameter

    Description

    Script

    Parent tag that encapsulates information about custom script settings.

     

    Mode

    Parameter describes if Veeam Agent for Microsoft Windows must run custom scripts and how it must process script execution results. Possible values:

    • 0 — script execution is disabled.
    • 1 — Veeam Agent for Microsoft Windows runs scripts and ignores script failures.
    • 2 — Veeam Agent for Microsoft Windows requires that scripts are executed successfully.

    If you set the Mode parameter to 1 or 2, you must specify the PreFreezePath and/or PostThawPath parameters.

     

    PreFreezePath

    This parameter is used if you set the Mode parameter to 1 or 2 (run a pre-freeze script).

    Path to a pre-freeze script, for example: C:\scripts\pre-freeze.cmd.

     

    PostThawPath

    This parameter is used if you set the Mode parameter to 1 or 2 (run a post-thaw script).

    Path to a post-thaw script, for example: C:\scripts\pre-freeze.cmd.

    Credentials

    This tag is used only if you need to run custom scripts under a specific account, for example, an account that has Administrator permissions.

    Parent tag that encapsulates information about credentials of the account used to run custom scripts.

     

    UserName

    This parameter is used only if you need to run custom scripts under a specific account.

    User name of the account under which custom scripts must be run. The user name is specified as a text string encoded in the Base64 format.

     

    Password

    This parameter is used only if you need to run custom scripts under a specific account.

    Password of the account under which custom scripts must be run. The password is encrypted. For more information, see Encryption of User Credentials.

     

    File Indexing

    Parent Tag

    Parameter

    Description

    Indexing

    Parent tag that encapsulates information about file indexing settings.

     

    Type

    Indexing mode. Possible values:

    • 1 — Veeam Agent for Microsoft Windows indexes all files and folders included in the backup scope.
    • 2 — Veeam Agent for Microsoft Windows indexes the content of folders included in the indexing scope.
    • 3 — Veeam Agent for Microsoft Windows does not index the content of folders excluded from the indexing scope.

     

    Enabled

    Parameter specifies if Veeam Agent for Microsoft Windows must index files and folders. Possible values:

    • True — Veeam Agent for Microsoft Windows indexes files and folders.
    • False — Veeam Agent for Microsoft Windows does not index files and folders.

    IncludedFolders

    This tag is used only if the Indexing parameter is set to 1 (Veeam Agent for Microsoft Windows indexes the content of folders included in the indexing scope).

    Parent tag that encapsulates information about folders included in the indexing scope.

     

    String value

    This parameter is used only if the Indexing parameter is set to 1 (Veeam Agent for Microsoft Windows indexes the content of folders included in the indexing scope).

    Paths to folders whose content must be indexed, for example, C:\Documents.

    ExcludedFolders

    This tag is used only if the Indexing parameter is set to 2 (Veeam Agent for Microsoft Windows does not index the content of folders excluded from the indexing scope).

    Parent tag that encapsulates information about folders excluded from the indexing scope.

     

    String value

    This parameter is used only if the Indexing parameter is set to 2 (Veeam Agent for Microsoft Windows does not index the content of folders excluded from the indexing scope).

    Paths to folders whose content must not be indexed, for example, %TEMP%, %ProgramFiles%. You can use system environmental variables in this parameter.

    Example 1

    You want the backup job to back up Microsoft SQL Server transaction logs every 15 minutes and retain transaction log backups in the backup target for 20 days. The input XML file will contain the following parameters:

    <ExecutionResult>
    <JobInfo ConfigId="f5bb9cd2-9b7d-4bb3-9c72-435cec24420c" JobName="Backup Job">
       <GuestInfo>
         <Applications ProcessTransactionLogs="True">
           <Sql Mode="3">
             <Backup Enabled="True" ExpireDays="20" BackupMinutes="15" Expirable="True"/>
           </Sql>
       </GuestInfo>
     </JobInfo>
    </ExecutionResult>

    Example 2

    You want the backup job to index files in D:\Folder1 and D:\Folder2 folders. The input XML file will contain the following parameters:

    <ExecutionResult>
    <JobInfo ConfigId="f5bb9cd2-9b7d-4bb3-9c72-435cec24420c" JobName="Backup Job">
       <GuestInfo>
         <Indexing Type="2">
           <IncludedFolders>
             <String value="D:\Folder1"/>
             <String value="D:\Folder2"/>
           </IncludedFolders>
          </Indexing>
       </GuestInfo>
     </JobInfo>
    </ExecutionResult>

    Example 3

    You want the backup job to run pre-freeze.cmd and post-thaw.cmd scripts, and want to ignore script errors. The input XML file will contain the following parameters:

    <ExecutionResult>
    <JobInfo ConfigId="f5bb9cd2-9b7d-4bb3-9c72-435cec24420c" JobName="Backup Job">
       <GuestInfo>
         <Applications ProcessTransactionLogs="True" Enabled="True">
           <Script Mode="1" PostThawPath="C:\scripts\post-thaw.cmd" PreFreezePath="C:\scripts\pre-freeze.cmd"/>
         </Applications>
       </GuestInfo>
     </JobInfo>
    </ExecutionResult>