Data selection
Anything related to data selection can be addressed by strategy :
- Selection
- Filters
- Security (authentication) specific to a node
- Data rotation
- Allowing user to add elements
It is also possible to give the user the ability to add items to the selection in addition of those injected by the strategy.
Data selection
Key | Parameters | Control |
---|---|---|
Configuration.Node.Selection | include < path > [in set < set >] | exclude < path > [from set < set >] | include all {documents|desktops} [in set < set >] | Add/remove a node from selection |
Possible values for these keys are :
- include : to include a node to the selection
- exclude : to exclude a node to the selection
- < path > : node's path. If the path leads to a directory, it can end with the "\" caracter. Can also contain :
- * : to select/deselect entire paths, like "c:\users*\documents"
- all documents : to select/deselect the documents directory for all the users
- all desktops : to select/deselect the desktop directory for all the users
Data filtering
Key | Parameters | Control |
---|---|---|
Configuration.Node.Filters | [at < path >] include < filter > | [at < path >} exclude < filter > | Allows you to force the inclusion or exclusion of certain files, file types or directories. Filters are applied to the specified node, otherwise to the entire selection. |
Possible values for these keys are :
- < path > : optional parameter. Node's path.
- include : to include data matching the filter
- exclude : to exclude data matching the filter
- < filter > : data to filter. Can be an extension (.extension), a file name or a path (c:\users or c:\users\\cookies)
Security
Key | Parameters | Control |
---|---|---|
Configuration.Node.Security | [at < path >] authenticate with login < login > and password < password > | Lets you specify authentication on a node or on the entire selection |
The parameters have the following roles and values :
- path : optional parameter. Path node requiring specific authentication. Authentication applies on the node itself if it is specified, otherwise to the entire selection.
- login : ID to be used for authentication
- password : password associated to the ID
Data rotation
Key | Parameters | Control |
---|---|---|
Configuration.Node.Rotation | [at < path >] after < period > {days|weeks} keep {every < value > {hours|days|weeks}|none} | Specify a retention policy on a node or on the entire selection |
The parameters have the following roles and values :
- path : optional parameter. Path node requiring a specific retention. The retention policy applies on the specified node, otherwise to the entire selection.
- period : numeric value associated with unity (days or weeks) to specify when to filter the data versions
- value : numeric value associated with unity (hours, days or weeks) to define the new periods during which maintain maximum data versions.
Possibility of adding items by user
By default, the user can not intervene within the selection if the selection itself, filters, retention policies and authentication are injected with a strategy. The key below allows the user to add items in addition to the one injected by the strategy.
Key | Control |
---|---|
Configuration.Node.Selection.MergeUser | Allows the user to add nodes to the selection |
Configuration.Node.Filters.MergeUser | Allows the user to add filters to the selection |
Configuration.Node.Security.MergeUser | Allows the user to add IDs to the selection |
Configuration.Node.Rotation.MergeUser | Allows the user to add rotation rules to the selection |
Possible values for these keys are :
- true to allow adding items
- false to deny adding items (default)
Example
You want to backup user profiles on workstations. However, you want to exclude the browser cookies and the administrator profile.
File types "avi", "mkv" and "mp3" should not be saved.
Backup hystory should be kept for a week.
Users can add additional directories to the selection.
Here is what to do:
- Select users profiles
- Exclude the administrator profile
- Exclude the cookies directory
- Exclude avi, mkv and mp3 files
- Keep the file history for 7 days
- Allow users to add nodes in the selection
- Allow users to add filters on their selection
Resulting strategy:
Configuration.Node.Selection: include "C:\users\"
Configuration.Node.Filters: exclude "C:\Users\Administrator"
Configuration.Node.Filters: exclude "C:\Users\*\Cookies"
Configuration.Node.Filters: exclude "*.avi"
Configuration.Node.Filters: exclude "*.mkv"
Configuration.Node.Filters: exclude "*.mp3"
Configuration.Node.Rotation: at "C:\users\" after 7 days keep none
Configuration.Node.Selection.MergeUser: true
Configuration.Node.Selection.Filters: true
Example
You wish to backup the "Documents" and "Desktop" folders for every user on a Windows PC.
You will therefore have to :
- Select the user profiles
- Include the Documents folder
- Include the Desktop folder
Resulting strategy:
Configuration.Node.Selection: include "C:\users\"
Configuration.Node.Filters: include "C:\Users\*\Documents\"
Configuration.Node.Filters: include "C:\Users\*\Desktop\"