About the mastersettings.cfg file

Ops Center Protector User Guide

Version
7.7.x
Audience
anonymous
Part Number
MK-99PRT002-08
ft:lastEdition
2023-10-26

mastersettings.cfg is an XML file that contains information indicating which Ops Center Protector files are to be zipped up (exported) or deleted prior to a restore (imported). This file is located in the following directory:

$Protector_HOME$\db\config

The mastersettings.cfg file can contain information as described in the following table.

Table. Configuration settings
Item Name Description
Path

The path to be backed up. The path specified is relative to the $Protector_HOME directory.

Depth

The depth, defined as a value, within the path to be backed up:

-1 (default) backs up all files in all subdirectories.

1 backs up only the files in the path.

2 backs up all files in the path and within subdirectories of the path (but not the subdirectories themselves).

Export Mask

Controls which files in the path are backed up. Can contain the following entries:

(If no export mask is specified then all files will be matched and exported).

NameMask A file name mask such as *.cfg.

MatchAction Indicates how to process matching files:

Either CopyFile or IgnoreFile

NonMatchAction Indicates how to process non-matching files:

Either CopyFile or IgnoreFile

Import Mask

Controls what is cleared from the path prior to a restore. Can contain the following entries:

(If no import mask is specified then all files will be matched and deleted prior to the restore unless the option --preclear false is specified at the command line).

NameMask A file name mask such as *.cfg.

MatchAction Indicates how to process matching files:

Either DeleteFile or IgnoreFile

NonMatchAction Indicates how to process non-matching files:

Either DeleteFile or IgnoreFile

Examples

The following XML tells mastersettings to export all files in and below the main Ops Center Protector configuration directory:

<item name="Entry" argtype="list" >
    <item name="Path" argtype="single" >
        <value type="string" >db/config</value>
    </item>
    <item name="Depth" argtype="single" >
        <value type="int32" >2</value>
    </item>
</item>

The following XML tells mastersettings not to export any files from the intelligentstoragemanager events directory, but to delete all events from that directory prior to a restore. This will ensure that all events that are logged prior to an import are deleted, because they will not be relevant after the master settings have been restored.

<item name="Entry" argtype="list" >
    <item name="Path" argtype="single" >
         <value type="string" >db/intelligentstoragemanager/events</value>
    </item>
    <item name="Export Mask" argtype="list" >
        <item name="MatchAction" argtype="single" >
            <value type="string" >IgnoreFile</value>
        </item>
    </item>
    <item name="Import Mask" argtype="list" >
        <item name="MatchAction" argtype="single" >
            <value type="string" >DeleteFile</value>
        </item>
    </item>
</item>