> CommCell Console > Backup and Restore Agents > Databases > SAP > SAP HANA > Parameters

XML Parameters for SAP HANA Client Configuration

The following table lists the supported SAP HANA client parameters.

Name

Description

Element

Parent Element

clientName

The name of the client.

entity

association

clientType

DISTRIBUTED_DATABASE_CLIENT

entity

association

clientDescription

A general description of the client.

client

clientProperties

clientName

The name of the client.

clientEntity

client

commCellName

The name of the CommCell.

clientEntity

client

hostName

The long name of the client, for example, client.domain.company.com.

clientEntity

client

cvdPort

The TCP port number for the Communications Service (CVD).

client

clientProperties

evmgrcPort

The TCP port number for the Client Manager Service (ClMgrS).

Applies to upgraded clients or clients from previous Commvault versions.

client

clientProperties

installDirectory

The directory where the base software and/or iDataAgent is installed.

client

clientProperties

path

The directory where the job results reside.

jobResulsDir

client

userName

The name of the user.

userAccount

jobResulsDir

clientGroupName

The name of the client computer group.

clientGroups

clientProperties

AltCachePartitionForQSnap

The location of the alternate cache partition used for QSnap.

clientProps

clientProperties

AutoUpdateLocation

clientProps

clientProperties

CDRLogFileLocation

The location of the ContinuousDataReplicator (CDR) log files.

clientProps

clientProperties

CenteraResourceFilename

The file name for the Centera resource.

clientProps

clientProperties

CipherType

The cipher to use for data encryption.

Valid values are:

  • 3-DES

  • AES (Rijndael)

  • Blowfish

  • GOST

  • Serpent

  • TwoFish

clientProps

clientProperties

DirectMediaAccessFlag

The storage option for the data encryption key.

Valid values are:

  • Regular, for Via Media Password

  • ViaPassPhrase, for Via Pass Phrase

  • None, for No Access

clientProps

clientProperties

EnableCollectDelegateInfo

Valid values are True/False.

clientProps

clientProperties

EnableContentIndexing

The option to enable content indexing.

Valid values are True/False.

clientProps

clientProperties

EnableEncryption

The option to enable data encryption.

Valid values are True/False.

clientProps

clientProperties

EnableSnapBackups

The option to enable snap backups.

Valid values are True/False.

clientProps

clientProperties

EncryptKeyLength

The key length to use with the cipher in the CipherType parameter.

Valid values are:

3-DES cipher

  • 192

    AES (Rijndael), Blowfish, Serpent, and TwoFish ciphers

  • 128

  • 256

clientProps

clientProperties

JobPriority

The option to set the job priority.

Valid values are 0 to 9.

clientProps

clientProperties

JobResultsDiskCapThreshold

The percentage of disk capacity that is reached before job results are pruned.

clientProps

clientProperties

JobResultsRetentionDays

The number of days to retain job results.

clientProps

clientProperties

JobResultsThresholdMB

The low space threshold in MB for the job results folder.

clientProps

clientProperties

OptimizeDataForSearch

The option to optimize data for searching.

Valid values are True/False.

clientProps

clientProperties

PathToExchangeMiningTool

The location of the Exchange Mining Tool.

clientProps

clientProperties

RestoreAccessFlag

The storage and accessibility of data encryption keys in the CommServe database.

Valid values are:

  • Regular, for storing keys scrambled in the CommServe database

  • WithPassPhase, for storing keys locked with a user-supplied pass-phrase in the CommServe database

    If you are using "WithPassPhase," the DirectMediaAccessFlag parameter must be set to "ViaPassPhrase."

clientProps

clientProperties

RetryCountOnNetworkError

The number of times the Job Manager checks for network connectivity. Use this parameter when the EnableRetryOnNetworkError parameter is set to "true."

clientProps

clientProperties

RetryFrequencyInSecOnNetworkError

The interval (in seconds) the Job Manager checks for network connectivity. Use this parameter when the EnableRetryOnNetworkError parameter is set to "true."

clientProps

clientProperties

WebServer

The settings related to the Web Server.

clientProps

clientProperties

cacheSource

The source of the cache.

Valid values are:

  • COMMSERVE

  • UPDATEAGENT

clientProps

clientProperties

activityType

The client activities.

Valid values are:

  • 1, for backup

  • 2, for restore

  • 4, for auxiliary copy

  • 8, for disaster recovery backup

  • 16, archive pruning

  • 32, for media recycle

  • 64, for synthetic full

  • 28, all activity

  • 256, for schedule

  • 1024, for offline content indexing

activityControlOptions

clientActivityControl

TimeZoneName

The time zone to use when the Enable after a Delay option is used with an activity. Use this parameter when the enableAfterADelay parameter is set to "true."

Sample values:

  • (UTC) Coordinated Universal Time

  • (UTC-05:00) Eastern Time (US & Canada)

dateTime

activityControlOptions

timeValue

The date and time to use when the Enable after a Delay option is used with an activity. Use this parameter when the enableAfterADelay parameter is set to "true."

Sample values:

  • 2013-12-11 09:22:32

  • 2014-01-01 17:22:32

dateTime

activityControlOptions

enableActivityType

The option to enable or disable an activity for a client.

Valid values are True/False.

activityControlOptions

clientActivityControl

enableAfterADelay

The option to enable an activity for a client on a date and time defined in the Enable Backup dialog box.

Valid values are True/False.

activityControlOptions

clientActivityControl

associationsOperationType

The operation to perform on the role, users, and user groups inside the <associations> block. The client, role, users, and user groups form a security association. To perform an operation on multiple security associations, add an <associations> block in the XML file for each security association: 

<associations>
   <properties>
     <role>
       <roleName></roleName>
     </role>
   </properties>
   <userOrGroup>
     <userName></userName>
   </userOrGroup>
   <userOrGroup>
     <userGroupName></userGroupName>
   </userOrGroup>
 </associations>

Valid values are:

  • ADD, to create a new security association between the client, the role, and users or user groups

  • OVERWRITE, to overwrite existing security associations with new security associations

  • DELETE, to delete one or more security associations

securityAssociations

clientProps

roleName

The name of the role operated on by the associationsOperationType parameter. The <associations> block must have exactly one role, for example: 

<associations>
   <properties>
     <role>
       <roleName>Role3</roleName>
     </role>
   </properties>
 ...
 ...
 </associations>

role

properties

userName

The name of the user operated on by the associationsOperationType parameter. To add multiple users to a security association, add the following elements in the XML file for each user: 

<userOrGroup>
   <userName></userName>
 </userOrGroup>

A mix of users and user groups can be a part of a security association, for example:

<userOrGroup>
   <userName>jdoe</userName>
 </userOrGroup>
 <userOrGroup>
   <userGroupName>support</userGroupName>
 </userOrGroup>

userOrGroup

associations

userGroupName

The name of the user group operated on by the associationsOperationType parameter. To add multiple user groups to a security association, add the following elements in the XML file for each user: 

<userOrGroup>
   <userGroupName></userGroupName>
 </userOrGroup>

A mix of user groups and users can be a part of a security association, for example:

<userOrGroup>
   <userName>jdoe</userName>
 </userOrGroup>
 <userOrGroup>
   <userGroupName>support</userGroupName>
 </userOrGroup>

userOrGroup

associations

externalGroupName

The name of the external user group operated on by the associationsOperationType parameter. Use this parameter with the providerDomainName parameter.

userOrGroup

associations

providerDomainName

The name of the domain that the external user group belongs to. Use this parameter with the externalGroupName parameter.

userOrGroup

associations

categoriesPermissionOperationType

The operation to perform on the client owner permissions in the permissionName parameter.

Valid values are:

  • ADD, to add a new permission to the client owner

  • OVERWRITE, to overwrite existing permissions

  • DELETE, to delete one or more permissions

categoryPermission

ownerAssociations

permissionName

The name of the client owner permission operated on by the categoriesPermissionOperationType parameter.

To work with multiple permissions, add the following elements in the XML file for each permission:

<categoriesPermissionList>
   <permissionName></permissionName>
</categoriesPermissionList>

For a list of valid values, see User Security Permissions and Permitted Actions.

categoriesPermissionList

categoryPermission

ownersOperationType

The operation to perform on the client owners in the userGroupName and userName parameters inside the <ownerAssociations> block.

Valid values are:

  • ADD, to add a new client owner to the client

  • OVERWRITE, to overwrite existing client owners

  • DELETE, to delete one or more client owners

ownerAssociations

securityAssociations

userGroupName

The name of the user group operated on by the ownersOperationType parameter. To add multiple user groups, add the following elements in the XML file for each user group: 

<owners>
   <userGroupName></userGroupName>
 </owners>

A mix of users and user groups can be added as client owners, for example:

<owners>
   <userName>jdoe</userName>
 </owners>
 <owners>
   <userGroupName>support</userGroupName>
 </owners>

owners

ownerAssociations

userName

The name of the client owner operated on by the ownersOperationType parameter. To add multiple client owners, add the following elements in the XML file for each client owner:

<owners>
<userName></userName>
</owners>

A mix of users and user groups can be added as client owners, for example:

<owners>
<userName>jdoe</userName>
</owners>
<owners>
<userGroupName>support</userGroupName>
</owners>

owners

ownerAssociations

cacheBufferSize

The option to set the cache buffer size.

deDuplicationProperties

clientProps

clientSideDeduplication

The option to enable Client Side Deduplication.

Valid values are:

  • USE_SPSETTINGS, to use storage policy settings

  • ON_CLIENT, to enable client side deduplication

  • OFF, to disable client side deduplication

deDuplicationProperties

clientProps

enableClientSideDiskCache

The option to enable a client side disk cache. Use this parameter when the clientSideDeduplication parameter is set to "ON_CLIENT."

Valid values are True/False.

deDuplicationProperties

clientProps

enableHighLatencyOptimization

The option to enable high latency optimization. Use this parameter when the enableClientSideDiskCache parameter is set to "true."

Valid values are True/False.

deDuplicationProperties

clientProps

enableVariableContentAlignment

The option to enable variable content alignment.

Valid values are True/False.

deDuplicationProperties

clientProps

maxCacheDb

The option to set the maximum size in megabytes for the cache database .

Use this parameter when the enableClientSideDiskCache parameter is set to "true."

Valid values are:

  • 1024

  • 2048

  • 4096

  • 8192

  • 16384

  • 32768

  • 65536

  • 131072

deDuplicationProperties

clientProps

performClientSideDeduplication

The option to enable or disable source side deduplication.

Valid values are True/False.

deDuplicationProperties

clientProps

dlpEnableClientKeys

The option to unlock files before backups are performed and to allow users to open locked files without entering a pass-key.

dlpPropertise

clientProps

dlpMinFileAgeMins

The age in minutes of a document (created or modified) before it is locked during a DLP scan.

dlpPropertise

clientProps

dlpRmNow

The option to erase the files listed in the val parameter in the dlpRmFilters element. This action is irreversible.

Valid values are True/False.

dlpRMProperties

dlpPropertise

dlpRmOfflineDays

The number of days a client must be offline before files are erased.

dlpRMProperties

dlpPropertise

enableRmDLP

The option to enable the Secure Erase feature of Data Loss Prevention (DLP).

Valid values are True/False.

dlpRMProperties

dlpPropertise

val

The path to the content that will be deleted when Secure Erase is activated.

dlpRmContent

dlpRMProperties

val

The paths or file extensions that should not be deleted when Secure Erase is activated, for example, *.exe.

dlpRmFilters

dlpRMProperties

dlpScanIntervalMins

The number of minutes the DLP scan waits between scans for new or unlocked content.

dlpPropertise

clientProps

dlpStolen

The option to mark the client as stolen.

Valid values are True/False.

dlpPropertise

clientProps

enableDLP

The option to enable Data Loss Prevention (DLP).

Valid values are True/False.

dlpPropertise

clientProps

val

The path to the content that should be locked when the DLP scan runs.

dlpContents

dlpPropertise

val

The paths or file extensions that should not be locked when the DLP scan runs, for example, *.dll.

dlpFilters

dlpPropertise

enableAccessControl

This option to enable access control.

Valid values are True/False.

clientProps

clientProperties

fileLevelAnalyticsLicense

Valid values are True/False.

clientProps

clientProperties

isWebServerInstalled

Indicates whether a web server is installed.

Valid values are True/False.

clientProps

clientProperties

overrideGlobalDesktopGuiProperties

Valid values are True/False.

clientProps

clientProperties

recallService

The complete address of the proxy service installed with the Web Console.

clientProps

clientProperties

SMTPAddressOfTheRMSSuperUser

The SMTP address of the RMS (Rights Management Services) super user.

rightManagementServiceProperties

clientProps

decryptRMSDocumentDuringContentIndexing

The option to decrypt an RMS (Rights Management Services) document during content indexing.

Valid values are True/False.

rightManagementServiceProperties

clientProps

userName

The name of the user.

rmsCredentials

rightManagementServiceProperties

smtpAddressOfRMSSuperUser

The SMTP address of the RMS (Rights Management Services) super user.

rightManagementServiceProperties

clientProps

enableOnlineSearch

The option to enable online searching.

Valid values are True/False.

spWebServerProperties

clientProps

spWebServerUserPassword

The user password for the SharePoint web server.

spWebServerProperties

clientProps

clientName

The name of the client.

webSearchServer

clientProps

hostName

The long name of the client, for example, client.domain.company.com.

webSearchServer

clientProps

webSearchServerForSuperSearch

The web server used for the search.

clientProps

clientProperties

webSearchServiceUrl

The URL for the web search.

clientProps

clientProperties

configureClusterClient

The option to enable the cluster group configuration.

Valid values are True/False.

clusterClientProperties

clientProperties

showAllAgents

The option to show all agents.

Valid values are True/False.

clusterClientProperties

clientProperties

sslEnabled

The option to enable SSL communication with the SAP HANA system.

Valid values are 1 and 0.

saphanaInstance

instanceProperties

sslprovider

The SSL provider name that is used by the SAP HANA system. Example, commoncrypto.

saphanaInstance

instanceProperties

ssltruststore

The name of the trust store that stores the CA signed certificates. Example, sapcli.pse.

saphanaInstance

instanceProperties
×

Loading...