Archive FastBack

Use the archive fastback command to archive Tivoli® Storage Manager FastBack volumes specified by the fbpolicyname, fbclientname and fbvolumename options for long-term retention.

Before using this command, configure the client to back up and archive Tivoli Storage Manager FastBack data. Also, before you issue this command, at least one snapshot should exist in the Tivoli Storage Manager FastBack repository for the Tivoli Storage Manager FastBack policy being archived or backed up.

If a policy specification contains both Windows and Linux FastBack clients, only the Windows volumes will be backed up or archived to Tivoli Storage Manager by the Windows Tivoli Storage Manager client.

If a policy specification contains both Windows and Linux FastBack clients, only the Linux volumes will be backed up or archived to Tivoli Storage Manager by the Linux Tivoli Storage Manager client.

You can use Tivoli Storage Manager FastBack options to archive the latest snapshots of the following volumes:

All clients and volumes associated with a FastBack policy or a list of FastBack policies.
All volumes associated with a specific FastBack client or a list of FastBack clients for a given FastBack policy.
A specific volume or volumes associated with a FastBack client for a given FastBack policy.

Supported Clients

Linux operating systems This option is valid for Linux x86_64 clients.

Windows operating systems This option is valid for all Windows clients that are configured as Tivoli Storage Manager FastBack dedicated proxies. This command is also valid for Windows clients that are installed on a Tivoli Storage Manager FastBack server workstation, or a Tivoli Storage Manager FastBack Disaster Recovery (DR) Hub.

Syntax


                                      .-,----.   
                                      V      |   
>>-ARCHIVE FASTBack--FBPolicyname--=----name-+------------------>

>--FBServer--=--name--+---------------------------+------------->
                      |                  .-,----. |   
                      |                  V      | |   
                      '-FBClientname--=----name-+-'   

>--+---------------------------+-------------------------------->
   |                  .-,----. |   
   |                  V      | |   
   '-FBVolumename--=----name-+-'   

>--+--------------------------+--+-------------------+---------->
   '-FBReposlocation--=--name-'  '-FBBranch--=--name-'   

>--+-----------------+-----------------------------------------><
   '-ARCHMc--=--name-'

Important:

At least one FBpolicyName is always required.
You can specify up to 10 values for FBPolicyName, if no values are specified for both FBClientName and FBVolumeName.
When you specify a FBClientName value, there must be only one value for FBPolicyName.
You can specify up to 10 values for FBClientName if only one PolicyName is specified, and no values for FBVolumeName are specified.
When you specify the FBVolumeName option, you can have only one FBPolicy, and only one FBCLientName specified.
You can specify multiple FBVolumeNames if condition 5 is satisfied.
You must always specify the FBReposLocation option for Linux.

Parameters

Table 1. Archive FastBack command: Related options
Option	Where to use
fbpolicyname	Command line and scheduler.
fbserver	Command line and scheduler.
fbclientname	Command line and scheduler.
fbvolumename	Command line and scheduler.
fbreposlocation	Command line and scheduler.
fbbranch	Command line and scheduler.
archmc	Command line and scheduler.

Examples

Command line:

The Tivoli Storage Manager backup-archive client is installed on a Linux proxy client machine. Use this command to archive all FastBack volumes for all Linux FastBack clients that are defined for FastBack policy1:

dsmc archive fastback -fbpolicyname=Policy1 
  -fbserver=myfbserver -fbreposlocation=myfbserver@WORKGROUP

The FastBack server name, -myFbDrHub is the short host name of the FastBack disaster recovery hub server where the repository is located.

The -fbreposlocation parameter specifies the location of the repository. The repository location is required. If you do not provide the repository location, the command fails.

FBServer should point to the short host name of the FastBack DR hub in this case.

Command line:

The repository, rep_server1, is located on a FastBack disaster hub, myFbDrHub

dsmc archive fastback -fbpolicyname="Policy 1" 
  -fbserver=myFbDrHub -fbreposlocation=\\myFbDrHub\rep_server1

The repository location is required. If you do not provide the repository location, the command fails.

The FastBack server name, -myFbDrHub, is the short host name of the FastBack disaster recovery hub where the repository is located.

FBServer should point to the short host name of the FastBack DR hub in this case.

Command line:

Archive all volumes protected by FastBack policy named policy1 from the FastBack server named basil:

dsmc archive fastback -Fbpolicyname=policy1  
  -FBServer=basil -ARCHMC="my_tsm_mgmt_class" 
  -fbreposlocation=basil@WORKGROUP

Command line:

The Tivoli Storage Manager is installed on a FastBack server. Use this command to archive all FastBack volumes for all Windows FastBack clients that are defined for FastBack policy1:

dsmc archive fastback -fbpolicyname=Policy1 
  -fbserver=myfbserver

The repository location is not required. If you provide the repository location, it is ignored.

The FastBack server name, -myfbserver, is the short host name of the FastBack server where the client is running.

Command line:

The Tivoli Storage Manager is installed on a FastBack disaster recovery hub. Use this command to archive all FastBack volumes for all FastBack clients that are found in the policy named Policy 1:

dsmc archive fastback -fbpolicyname="Policy 1" 
  -fbserver=myFbServer -fbbranch=branch1

The repository location is not required. If you provide the repository location, it is ignored.

The parameter myFbServer specifies the short host name of the FastBack Server whose FastBack branch is specified using the FBBranch option

Command line:

The Tivoli Storage Manager client is installed on a dedicated proxy machine with Tivoli Storage Manager FastBack administrative command line and FastBack mount. The Tivoli Storage Manager client is connecting to a FastBack server repository. Use this command to archive all FastBack volumes for all FastBack clients that are found in the policy named Policy 1:

dsmc archive fastback -fbpolicyname="Policy 1" -fbserver=myFbServer 
  -fbreposlocation=\\myFbServer.company.com\REP

The repository location is required.

The short host name of the machine where the FastBack server is installed is myFbServer.

Command line:

The Tivoli Storage Manager client is installed on a dedicated proxy machine with Tivoli Storage Manager FastBack administrative command line and FastBack mount. The Tivoli Storage Manager client is connecting to a remote branch repository on a FastBack disaster recovery hub. Use this command to archive all FastBack volumes for all FastBack clients that are found in the policy named Policy 1:

dsmc archive fastback -fbpolicyname="Policy 1" -fbserver=myFbServer 
  -fbreposlocation=\\myfbdrhub.company.com\REP
  -fbbranch=aFbServerBranch

The repository location is required.

The myFbServer value specified with the -fbserver option is the short host name of the FastBack Server whose FastBack branch is specified using the FBBranch option.

The fbbranch option specifies the branch ID of the FastBack server on the disaster recovery hub.

Command line:

Archive all volumes protected by FastBack policy named policy1 from the FastBack server named basil, and apply management class "my_tsm_mgmt_class" to the archived volumes.

dsmc archive fastback -Fbpolicyname=policy1  
  -FBServer=basil -ARCHMC=”my_tsm_mgmt_class”