Backup and Recovery
Backup and Recovery 7.1
Backup and Recovery 7.1
  • Storware Backup & Recovery documentation
    • Table of Contents
  • Changelog
  • Overview
    • Main Features
    • Storware Backup and Recovery concepts
      • Support Matrix
      • Architecture
      • Components
      • Backup types
      • Typical Scenarios
    • Licensing
    • Product Life Cycle
  • Deployment
    • Component requirements
    • Supported platforms requirements
    • Sizing Guide
      • Small
      • Medium
      • Large
    • Installation
      • ISO-based installation
      • Quick Installation using all-in-one script
      • Installation using Ansible playbook
      • Installation with RPMs
      • Deployment in Microsoft Azure
      • Virtual Appliance
        • RHV/oVirt/OLVM Virtual Appliance
        • Citrix Hypervisor | XCP-ng Virtual Appliance
        • VMware Virtual Appliance
        • Nutanix Acropolis Hypervisor (AHV)
    • Initial Configuration
    • Backup Destinations
      • File System
        • Synthetic File System
          • XFS
          • DD Boost
        • isoLayer (Synthetic)
        • File system
          • Virtual Data Optimizer (VDO)
        • Catalogic Software vStor
      • Deduplication Appliances
        • Dell EMC Data Domain
        • Huawei OceanProtect
        • HPE StoreOnce
        • Exagrid
        • Neverfail HybriStor
      • Object Storage
        • Alibaba Cloud OSS
        • AWS S3 or S3-compatible
        • Ceph Rados Gateway
        • Cloudian S3
        • Wasabi
        • Google Cloud Storage
        • IBM Cloud Object Storage
        • Microsoft Azure Blob Storage
        • Nutanix Objects
        • OpenStack SWIFT
        • Oracle Cloud Infrastructure Object Storage
        • Scality RING
      • Enterprise Backup Providers
        • Dell EMC Avamar
        • Dell EMC Networker
        • IBM Spectrum Protect
        • Micro Focus Data Protector
        • Veritas NetBackup
        • Rubrik Managed Volumes
      • Tape Pools
    • High Availability
      • 2 Node Cluster
      • 3 Node Cluster
    • Common tasks
      • Staging space configuration
      • Enabling HTTPS connectivity for nodes
      • LVM setup on Storware Backup & Recovery Node for disk attachment backup mode
      • Full versions of libvirt/qemu packages installation
      • SSH public key authentication
      • Enabling HTTP(S) Proxy for Storware Backup & Recovery
  • Protecting Virtual Environments
    • Virtual Machines
      • VMware vSphere/ESXi
      • Microsoft Hyper-V
      • Azure Stack HCI
      • Nutanix Acropolis Hypervisor (AHV)
      • Red Hat Openshift Virtualization
      • Red Hat Virtualization
      • oVirt
      • Oracle Linux Virtualization Manager
      • Oracle VM
      • Proxmox VE
      • KVM/Xen
      • OpenStack
      • OpenNebula
      • Virtuozzo
      • Verge
      • Citrix Hypervisor (XenServer)
      • XCP-ng
      • Huawei FusionCompute
      • HPE SimpliVity
      • SC//Platform
    • Cloud
      • Amazon EC2
      • GCP GCE
      • Azure Cloud
    • Containers
      • Kubernetes
      • Red Hat OpenShift
      • Proxmox VE
    • Backup & Restore
    • v2v migration
  • Protecting Microsoft 365
    • Microsoft 365 organization management
      • Configure Microsoft 365 access
      • Add Microsoft 365 organization manually
      • Add Microsoft 365 organization using the Setup Assistant
      • Account auto-synchronization
    • Backup & Restore
    • Suppoted Sharepoint templates, and limitations
  • File Level Backup and Restore - OS Agent
  • Protecting Applications
    • Applications
      • MSSQL
      • MySQL/MariaDB
      • PostgreSQL
      • DB2
      • Oracle
      • Relax and Recover - ReaR
      • Git
      • oVirt/RHV/OLVM
      • Kubernetes/OpenShift etcd
    • Backup & Restore
  • Protecting Storage Providers
    • Storage Providers
      • Ceph RBD
      • Nutanix Files
      • Nutanix Volume Groups
    • Backup & Restore
  • Administration
    • Dashboard
    • Virtual Environments
      • Instances
        • Backup on-demand
        • Restore on-demand
        • Snapshot Management
      • Virtualization Providers
      • Backup SLAs
        • Policies
        • Schedules
      • Snapshot SLAs
        • Policies
        • Schedules
      • Recovery Plans
        • Policies
        • Schedules
      • Mounted Backups (File-level Restore)
    • Storage
      • Instances
        • Backup on-demand
        • Restore on-demand
      • Infrastructure
      • Backup SLAs
        • Policies
        • Schedules
      • Snapshot SLAs
        • Policies
        • Schedules
      • Mounted Backups (File-level Restore)
    • Cloud
      • Instances
      • Service Providers
      • Backup SLAs
        • Policies
        • Schedules
      • Download
    • Applications
      • Instances
      • Execution Configurations
      • Backup SLAs
    • Endpoints
      • Environment
      • Administrators
      • Endpoints Server Management
        • Dashboard
        • Packages
        • Organizations
      • Endpoints Administrator
        • Dashboard
        • Users
          • Local users
          • LDAP users
        • Devices
          • Devices list view
          • Device status
        • Backup SLA
          • Create a Backup SLA
            • GENERAL
            • WINDOWS
            • MAC OS (technical preview)
            • EMAIL CLIENTS
          • Backup SLA management
          • Backup SLA removal
        • Restore Jobs
        • Client Deployments
    • Reporting
      • Virtual Environments
      • Storage
      • Microsoft 365
      • Applications
      • Notifications
      • Audit Log
    • Nodes
      • Instances
      • Node Configurations
    • Access Management
      • Users
      • Groups
      • Roles
      • OS Credentials
    • Settings
      • Global Settings
      • Internal DB Backup
      • Notification Rules
      • Mailing Lists
      • Endpoints Global Settings
    • Upgrade
    • CLI Reference
    • CLI v2 Reference
  • Integration
  • Integration Plugins
    • Red Hat Virtualization UI Plugin
    • oVirt UI Plugin
    • Oracle Linux Virtualization Manager UI Plugin
    • OpenStack UI Plugin
  • Troubleshooting
    • Enable DEBUG mode in Storware Backup and Recovery
    • Collecting logs
    • External log targets
    • Disaster Recovery
  • Known software issues and limitations
  • Glossary
Powered by GitBook
On this page
  • Prerequisites
  • Installation and registering the Agent
  • Linux
  • Windows
  • Define Backup SLAs
  • Additional pattern matchings
  • Examples for directories
  • Example for files
  • Backup using VSS (Windows only)
  • Archiving the OS Agent
  • Limitations

File Level Backup and Restore - OS Agent

PreviousSuppoted Sharepoint templates, and limitationsNextProtecting Applications

Storware Backup & Recovery allows you to protect server on file level using OS Agents. This feature is available for Linux and Windows machines.

Prerequisites

Before starting, you need to install OS Agent service on a machine you want to protect. You can download the latest OS Agent installer from Storware Repository ( or ).

You need to open 15900 port on Storware Backup & Recovery Node:

firewall-cmd --add-port=15900/tcp --permanent
firewall-cmd --complete-reload

Supported windows platform:

  • Windows 10

  • Windows Server 2016+

Installation and registering the Agent

Linux

  1. Install the OS Agent.

    rpm -ivh sbr-osagent-x.x.x-x.el8.x86_64.rpm
  2. Run osac command with register parameter on a machine where you installed OS Agent.

    osac -r <login> https://<host>:15900 [password]

    where:

    • login - default is admin

    • host is an IP address or hostname to the Storware Backup & Recovery Node

    • password is 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

Windows

  1. Double click on the .msi file to install the OS Agent.

  2. Provide necessary information when prompted:

    • Node address is IP address or host name to the Storware Backup & Recovery Node

    • Login - default is admin

    • Password is password of admin user.

Define Backup SLAs

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 pattern should 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 pattern should 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.

Additional pattern matchings

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:

Examples for directories

C:\Users\*\Desktop (for Windows) /home/*/Desktop (for Linux) - this will backup any users desktop directory, where * match all names

C:\Users\?oo\Desktop (for Windows) /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.)

C:\**\logs (for Windows) /**/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.)

Example for files

*.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.)

Backup using VSS (Windows only)

For Windows, the OS Agent can create a backup using a filesystem snapshot. Before the backup begins, a disk snapshot is created. The OS Agent uses this snapshot to read all files and releases it once the backup is complete.

If some problems occur while making a snapshot, the user could choose how the Agent should behave:

  • Fail backup - the backup task is immediately finished and fails the task.

  • Use a regular copy - the backup is switched to a regular file copy and continue.

  • Use a regular copy with a warning - the backup is switched to a regular file copy and continues. A warning will be displayed when the task is completed.

This setting can be changed in Agents -> Backup Policies -> edit policy -> Backup process tab.

Archiving the OS Agent

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.

Limitations

  • If the backup destination is configured on Data Domain, it is recommended to use local disk as staging space.

  • Symlinks are not supported.

  • Up to five million protected objects per OS agent instace

Windows
Linux