File Level Backup and Restore - OS Agent
Storware Backup & Recovery allows you to protect server on file level using OS Agents. This feature is available for Linux and Windows machines.
You need to open 15900 port on Storware Backup & Recovery Node:
firewall-cmd --add-port=15900/tcp --permanent
- 1.Install the OS Agent.rpm -ivh sbr-osagent-x.x.x-x.el8.x86_64.rpm
osaccommand with register parameter on a machine where you installed OS Agent.osac -r <login> https://<host>:15900 [password]where:
login- default is
hostis an IP address or hostname to the Storware Backup & Recovery Node
passwordis a password of the admin user. This could be omitted but You will be prompted to type the password
- 3.Start sbr-osagent service.systemctl start sbr-osagent
- 1.Double click on the .msi file to install the OS Agent.
- 2.Provide necessary information when prompted:
Node addressis IP address or host name to the Storware Backup & Recovery Node
Login- default is
Passwordis password of admin user.
To define a Backup SLA, You need to provide rules:
- include (mandatory)
- exclude (optional)
The Agent process files by include rules and then by exclude rules. The Agent scan filesystem using include rules. If any file is matched, it will be processed by exclude rules, if exists. When exclude rules match file, it will be omitted, if not it will be backed up.
The rule is defined by:
- Directory pattern
- File name patterns - this could have multiple values
Directory patternshould provide a path to the filesystem. You could also set Recursive attribute. When this attribute is set, scanning will be recursive and follow deeper with directory structure. If not only files and folders (without content) will be matched. For Windows, You should use \ character as a folder delimiter. For Linux, You should use / character.
File name patternshould provide a pattern to match the file on the filesystem. This could be any file when * is provided or part of the name like extension *.pdf. Additional matching patterns are provided below. When multiple patterns are provided, if any is matched then next will not be checked. Patterns can be separated by commas.
All rules could be used as include or exclude rule. All characters provided for Windows are case insensitive, for Linux are case sensitive.
For better matching You could provide some more accurate patterns:
* - any of character
? - only one or zero characters
** - recursive (only for directory pattern)
To better understand how it works, check the examples:
/home/*/Desktop(for Linux) - this will backup any users desktop directory, where * match all names
/home/?oo/Desktop(for Linux) - this will backup users directory when first letter of name is any character and rest name should ends with oo (foo, goo, etc.)
/**/logs(for Linux) - this will backup logs catalog that exists anywhere in the path. This means path should start from C:\ or / then any folder or subfolder (**) and next folder should be named logs
We also could mix all patterns:
C:\**\?ogs\**\a?c(for Windows) or
/**/?ogs/**/a?b(for Linux) - this means path should start from C:\ or / then any folder or subfolder (*) and next folder name should start with any character and rest should be ogs (logs, dogs, etc.) then any folder or subfolder (*) and next folder name should start with letter a then could exists only one character and ends with c letter (abc, ac, etc.)
*.txt- only txt files
.*- hidden files for Linux
a?c- file that start with letter a then could exists one character then b letter (ac, abc, eg.)
OS Agent can be archived by clicking button “Archive” on the agent instances list or in the agent details view. Archived agents can't be backed up any more. The only available actions for archived agents are “Restore”, “Download” and “Delete”. Agent can not be unarchived.
- symlinks are not supported