B SRV Fbint Guide
B SRV Fbint Guide
Version 6.2
SC27-2828-01
Version 6.2
SC27-2828-01
Note: Before using this information and the product it supports, read the information in Notices on page 63.
This edition applies to Version 6.1 of Tivoli Storage Manager FastBack (product number 5724-U93) and to Version 6.2 of Tivoli Storage Manager (product numbers 5608-E01, 5608-E02, 5608-E03, 5608-E07, 5608-E12) and to all subsequent releases and modifications until otherwise indicated in new editions or technical newsletters. This edition replaces SC27-2828-00. Copyright IBM Corporation 2010. US Government Users Restricted Rights Use, duplication or disclosure restricted by GSA ADP Schedule Contract with IBM Corp.
Contents
Preface . . . . . . . . . . . . . . . v
Who should read this guide . . . Publications . . . . . . . . Support information . . . . . . Getting technical training . . . Searching knowledge bases . . Contacting IBM Software Support . v . v . v . . . . . . vi . . . . . . vi . . . . . viii . . . . . . . . . . . . . . . Installing FastBack Reporting on the FastBack server . . . . . . . . . . . . . . Starting the FastBack Manager user interface . . . 18 . 19
| |
Updates for Tivoli Storage Manager and Tivoli Storage Manager FastBack . . . xi Chapter 1. Integration overview . . . . 1
. 2 . 3 . 3 . 4
Goals for integrating the products . . . . . . Policy integration for Tivoli Storage Manager and Tivoli Storage Manager FastBack. . . . . . . Tivoli Storage Manager backup-archive client integration . . . . . . . . . . . . . . Options for restoring data in the integrated environment . . . . . . . . . . . . .
Appendix A. Integrating IBM Tivoli Storage Manager and IBM Tivoli Storage Manager FastBack using command interfaces . . . . . . . . . 25 Appendix B. Server commands for Tivoli Storage Manager FastBack . . . 29
DEFINE SCHEDULE (Define a client backup or archive schedule) - FastBack . . . . . . . . . 30 UPDATE SCHEDULE (Update a client schedule) FastBack . . . . . . . . . . . . . . . 33
| | | | | | |
17 17 18
iii
iv
IBM Tivoli Storage Manager: Integration Guide for Tivoli Storage Manager FastBack
Preface
This publication provides instructions for a user to install, configure, and use IBM Tivoli Storage Manager and IBM Tivoli Storage Manager FastBack in an integrated environment. The integration of Tivoli Storage Manager and Tivoli Storage Manager FastBack provides a cost-effective solution for short-term data recovery and long-term data retention requirements.
Publications
Tivoli Storage Manager publications and other related publications are available online. You can search all publications for Tivoli Storage Manager and Tivoli Storage Manager FastBack and download PDFs from the following locations: Tivoli Storage Manager Information Center http://publib.boulder.ibm.com/infocenter/tsminfo/v6r2 Tivoli Storage Manager FastBack Information Center http://publib.boulder.ibm.com/infocenter/tsmfbinf/v6 IBM Publications Center http://www.ibm.com/shop/publications/order/ You can also order some related publications from the IBM Publications Center Web site. The Web site provides information for ordering publications from countries other than the United States. In the United States, you can order publications by calling 800-879-2755.
Support information
You can find support information for IBM products from various sources. Start at the IBM Support Portal: http://www.ibm.com/support/entry/portal/. You can select the products that you are interested in, and search for a wide variety of relevant information.
| | | | | | | | | | |
| | | |
vi
IBM Tivoli Storage Manager: Integration Guide for Tivoli Storage Manager FastBack
developerworks/wikis/display/tivolistoragemanager.
Preface
vii
| | | | | |
Tip: You can also pick a product first, from the main support portal site, and then click in the Notifications section to create or update your subscription for that product.
viii
IBM Tivoli Storage Manager: Integration Guide for Tivoli Storage Manager FastBack
| |
Preface
ix
IBM Tivoli Storage Manager: Integration Guide for Tivoli Storage Manager FastBack
| | | | | | | | | | | | | | | | | | | |
Updates for Tivoli Storage Manager and Tivoli Storage Manager FastBack
The following updates for the Tivoli Storage Manager and Tivoli Storage Manager FastBack integration are available. Tivoli Storage Manager backup-archive client for Linux support Support for the Linux backup-archive client and the FastBack integration is available with Tivoli Storage Manager client interim fix 6.1.3.1. You can install a Linux backup-archive client on a dedicated proxy system to backup or archive data from a Linux FastBack client. Tivoli Storage Manager backup-archive client command updates for Linux support Updates are available for the backup-archive client commands that are associated with the integration. Linux support is now documented. For more information, see Appendix C, Backup-archive client commands for Tivoli Storage Manager FastBack, on page 37. Administration Center support on HP-UX systems In Tivoli Storage Manager Version 6.2, the Administration Center cannot be installed on an HP-UX system, but it can be used to manage HP-UX servers. For Administration Center system requirements, see the following Web site: http://www.ibm.com/support/docview.wss?uid=swg21410467..
xi
xii
IBM Tivoli Storage Manager: Integration Guide for Tivoli Storage Manager FastBack
FastBack environment
FastBack server Rochester *
Tivoli Storage Manager backuparchive client (proxy node)
FastBack server
Data movement for backup and archive Data movement for restore
* The backup-archive client that is the proxy node can also be installed on a
FastBack Disaster Recovery Hub server or a dedicated proxy system.
Administration Center
Central interface for an administrator to manage the integrated environment. Figure 1. Data flow in the integrated environment
IBM Tivoli Storage Manager: Integration Guide for Tivoli Storage Manager FastBack
the FastBack Manager user interface to work with any FastBack server in your environment. You can also use wizards, notebooks, and portlets available in the Administration Center to set up policies for protecting Tivoli Storage Manager FastBack data.
Policy integration for Tivoli Storage Manager and Tivoli Storage Manager FastBack
Manage policy integration for data through a central interface by using the Administration Center. A wizard that helps you create FastBack policy schedules is available in the Administration Center. Before launching the wizard to integrate Tivoli Storage Manager and Tivoli Storage Manager FastBack policies, you must define a Tivoli Storage Manager policy domain and management classes for data backed up from a FastBack server. Running the wizard accomplishes the following tasks: v Selects the Tivoli Storage Manager server that is used as the backup and archive location for Tivoli Storage Manager FastBack data. v Identifies a backup-archive client as the proxy node to back up or archive Tivoli Storage Manager FastBack data to the Tivoli Storage Manager server and selects a Tivoli Storage Manager policy domain for managing schedules. v Selects or creates new client groups, jobs, and policies for managing Tivoli Storage Manager FastBack data. v Configures a Tivoli Storage Manager schedule and selects a retention policy for Tivoli Storage Manager FastBack snapshots.
See Determining where to install the backup-archive client that is the proxy node on page 7 for information about installation planning.
Restore through the command line, the GUI, or the Web GUI
Data restored from the Tivoli Storage Manager server Data restored through the proxy node
Figure 2. Restoring FastBack data from the Tivoli Storage Manager server
IBM Tivoli Storage Manager: Integration Guide for Tivoli Storage Manager FastBack
http://www.ibm.com/support/docview.wss?uid=swg21052223
IBM Tivoli Storage Manager: Integration Guide for Tivoli Storage Manager FastBack
Determining where to install the backup-archive client that is the proxy node
A backup-archive client installed as a proxy node performs backup or archive operations for data that is stored as snapshots in the FastBack Repository. Data is moved from the repository to the Tivoli Storage Manager server by the Tivoli Storage Manager backup-archive client for long-term storage. You can use one of three configurations to deploy the Tivoli Storage Manager backup-archive client that is the proxy node. Depending on your environment, the client can be deployed on the same system as the FastBack server, on the FastBack Disaster Recovery Hub server, or on a dedicated proxy system. | | | | | | | | | If you are installing the backup-archive client on a dedicated proxy system, you can install a Windows or Linux backup-archive client. A dedicated proxy system containing a Windows backup-archive client requires that you are backing up or archiving data from a Windows FastBack client. A dedicated proxy system with a Linux backup-archive client requires that you are backing up or archiving data from a Linux FastBack client. Currently, the Linux backup-archive client that backs up and archives data to the Tivoli Storage Manager is only supported on a dedicated proxy machine. You cannot install a Linux backup-archive client on a FastBack server or FastBack Disaster Recovery Hub server. Based on the size of your environment and retention support you need, select a location for the backup-archive client that best suits your configuration. The following planning sections provide information about the benefits and considerations for each set-up.
FastBack Environment
Data server Jane
(protected server)
FastBack client
Tivoli Storage Manager backup-archive client installed on the same system as the FastBack server
Data movement through FastBack Data movement through backup-archive client
FastBack server
Benefits of installing the backup-archive client on the same system as the FastBack server include: v Elimination of costs involved with maintaining a FastBack Disaster Recovery Hub server. v Creates a long-term tape-based copy of the data at a disaster recovery site, without having to implement an additional system at that site. v Better workload balancing for a large environment. If your configuration includes a FastBack Disaster Recovery Hub server and it receives many snapshots from many FastBack servers, it might not be physically capable of keeping up with backup windows to send data to the Tivoli Storage Manager server. You can offload some of the backup operations to a backup-archive client on a FastBack server. v Faster backups. Because the backup-archive client has direct access to the FastBack repository, data is moved more quickly. Things to consider when installing the backup-archive client on the same system as the FastBack server include: v More time is needed for backups or archives to the Tivoli Storage Manager server. Because operations from the backup-archive client are file-based, it could take more time to back up or archive data sent over a wide area network (WAN). v For a large environment, the configuration is more complex. A backup-archive client is needed on each FastBack server that moves data to the Tivoli Storage Manager server. If you have a large environment with remote offices, significant time and resources might be needed for installation and maintenance.
IBM Tivoli Storage Manager: Integration Guide for Tivoli Storage Manager FastBack
Planning for backups or archives from a FastBack Disaster Recovery Hub server
You can install a Windows Tivoli Storage Manager backup-archive client on the FastBack Disaster Recovery Hub server if you are only protecting snapshots that are replicated from a FastBack server. This configuration is supported for Windows environments. In this configuration, as seen in the following figure, data moves from the FastBack client on the protected server, Jane, to the FastBack server repository and is then replicated to the FastBack Disaster Recovery Hub server, Rochester, by the backup-archive client. The Tivoli Storage Manager backup-archive client that is installed on Rochester backs up or archives data to the Tivoli Storage Manager server, Thornfield. The Tivoli Storage Manager backup-archive client can only back up data from the FastBack server if it is replicated to the FastBack Disaster Recovery Hub server.
Tivoli Storage Manager backup-archive client installed on a FastBack Disaster Recovery (DR) Hub Server
Data movement through FastBack Data movement through backup-archive client
FastBack Environment
Data server Jane
(protected server)
FastBack client
Tivoli Storage Manager storage pool
Data Center
Tivoli Storage Manager server
FastBack server
FastBack Repository
Installed utilities Tivoli Storage Manager backuparchive client (proxy node) FastBack Mount FastBack Administrative CLI interface
Figure 4. Backup-archive client that is installed on the FastBack Disaster Recovery Hub server
The benefits of installing the backup-archive client on the same system as the FastBack Disaster Recovery Hub server include: v Less time is needed to complete backup and archive operations. Because a FastBack Disaster Recovery Hub server is often located at a data center that also includes the Tivoli Storage Manager server, data that is backed up or archived can move over a local area network (LAN), which enables faster network communication.
Chapter 2. Planning for the integration
v An additional level of disaster recovery is provided when duplicate sets of block-level snapshots are retained on the FastBack Disaster Recovery Hub server. v The configuration is simpler. Only one backup-archive client is required to be installed on a FastBack Disaster Recovery Hub server to move data to the Tivoli Storage Manager server. If you choose the FastBack server system as the location for the backup-archive client installation, you must install a client on each FastBack server that is sending data to the Tivoli Storage Manager server. v For large environments, there is a better balancing of the workload. If you have many FastBack servers replicating snapshot data to the Tivoli Storage Manager server, you can balance the workload by installing a backup-archive client on a FastBack Disaster Recovery Hub server in addition to one or more FastBack servers. This can help backup and archive operations complete more efficiently. v Potential savings on network time and resources. It takes less time to replicate block snapshot data over a wide area network (WAN) than it does for full file-based backups. Things to consider when installing the backup-archive client on the same system as the FastBack Disaster Recovery Hub server include: v Greater investment in storage and maintenance costs for a FastBack Disaster Recovery Hub server. v Potential for longer backup times. Because data is first replicated to the FastBack Disaster Recovery Hub server and then backed up to the Tivoli Storage Manager server, the environment might be impacted by longer backup times. v Only data that is replicated to the FastBack Disaster Recovery Hub server can be backed up to the Tivoli Storage Manager server. Any FastBack data that is not replicated to the FastBack Disaster Recovery Hub server is not backed up to the Tivoli Storage Manager server unless a backup-archive client is also installed on the FastBack server.
10
IBM Tivoli Storage Manager: Integration Guide for Tivoli Storage Manager FastBack
FastBack server
Benefits of installing the backup-archive client on a dedicated proxy system include: v Better workload balancing for a large environment. If you have many backup-archive client nodes on FastBack or FastBack Disaster Recovery Hub servers replicating snapshot data to the server, you can balance your workload by installing a backup-archive client on a dedicated proxy system. v Simpler configuration. Only one backup-archive client is required to be installed on a dedicated proxy system to move data to the Tivoli Storage Manager server. If you choose the FastBack server system as the location for the backup-archive client installation, you must install a client on each FastBack server that is sending data to the Tivoli Storage Manager server. Things to consider when installing the backup-archive client on the same system as the FastBack server include: v Greater investment in storage and maintenance costs to maintain a dedicated proxy system. v Potential for longer backup times. Because snapshots are mounted on a dedicated proxy system from a remote FastBack repository, the environment might be impacted by longer backup times.
11
Planning policy
Before integrating policies for Tivoli Storage Manager and Tivoli Storage Manager FastBack, you must set up a Tivoli Storage Manager policy domain and management classes for Tivoli Storage Manager FastBack data. When you set up policy schedules for backing up or archiving data to the Tivoli Storage Manager server, you choose a Tivoli Storage Manager policy domain to manage the data. The management class in the policy domain determines the length of time that data is retained by the Tivoli Storage Manager server. You can use the default STANDARD policy domain or create a new one. One policy domain must be used for all data that is moved from one FastBack server. Tivoli Storage Manager FastBack policies that are defined for snapshot data from the FastBack client on the protected data server can be configured from the FastBack Manager user interface or through the Administration Center wizard. Policies that are defined for data retention in Tivoli Storage Manager are configured through the Tivoli Storage Manager Administration Center or the command-line interface. The following examples show how you might set up retention for FastBack data: Example 1 v Take snapshots once every four hours and retain them in the FastBack server repository for three months. v Copy the snapshots to a FastBack Disaster Recovery Hub server once a day. v Back up the data to the Tivoli Storage Manager server once a week and retain for three years. Example 2 v Take snapshots once every hour and retain them in the FastBack server repository for six weeks. v Copy the snapshots to a FastBack Disaster Recovery Hub server once a day. v Back up the data to the Tivoli Storage Manager server once a day and retain for one year.
12
IBM Tivoli Storage Manager: Integration Guide for Tivoli Storage Manager FastBack
13
5. Configure the FastBack server after the FastBack clients have been connected. For installation steps, see the Tivoli Storage Manager FastBack Installation and User's Guide. 6. Optional: If you want to launch the FastBack Manager user interface from the Administration Center, install, and configure FastBack Reporting on the FastBack server. For complete steps, see the Tivoli Storage Manager FastBack Installation and User's Guide. 7. Install the Tivoli Storage Manager backup-archive client that is the proxy node for backup and archive operations to the Tivoli Storage Manager server. For more information, see Installing and configuring the backup-archive client that is the proxy node on page 16. 8. Optional: Install a backup-archive client on each protected server to restore data directly from the Tivoli Storage Manager server. For more information, see Options for restoring data in the integrated environment on page 4.
14
IBM Tivoli Storage Manager: Integration Guide for Tivoli Storage Manager FastBack
Administration Center contacts the FastBack server to obtain a list of domains. This list of domains is used to define administrator credentials for a FastBack server. Each FastBack server connection must be a unique name. The Administration Center uses the server name as the connection name. If two FastBack servers have the same name, a server connection for the second server cannot be added. Each server connection can be used by one or more Tivoli Integrated Portal users. After a connection is added, you can log on to the Administration Center using your Tivoli Integrated Portal user ID and password and work with the FastBack servers that are defined. Use the Add FastBack Server Connection wizard in the Administration Center to add connections for FastBack servers. 1. In the navigation tree, click FastBack Servers. 2. Select a server from the list and then click Select Action Add Server Connection to start the wizard. See the help panels in the wizard for details about each task.
If you want to include a specific FastBack policy in a Tivoli Storage Manager schedule and the policy does not appear, rename it to remove any unsupported characters. Create a policy schedule by completing the following steps: 1. From the Administration Center navigation tree, expand FastBack Servers. 2. Select the FastBack server that you want to create a policy schedule for. 3. Click Select Action Create a FastBack Policy Schedule to start the wizard. See the help panels in the wizard for details about each task.
15
Installing and configuring the backup-archive client that is the proxy node
Install a backup-archive client on a FastBack server, a FastBack Disaster Recovery Hub server, or a dedicated proxy system. This backup-archive client is the proxy node that backs up or archives FastBack data to the Tivoli Storage Manager
Installing and configuring the backup-archive client on the same system as the FastBack server
Complete the steps to install a Windows backup-archive client as a proxy node on the same system as the FastBack server. Repeat this process for each FastBack server in your environment. 1. Choose a name and password for the Tivoli Storage Manager client that is the proxy node that backs up or archives data from the FastBack server. It is a best practice to use the host name of the FastBack server system as the proxy node name. Write down the name and password for later use. 2. Define the FastBack server to the Administration Center by adding a connection for the server. See Adding FastBack server connections to the Administration Center on page 14. 3. Run the Create a FastBack Policy Schedule wizard from the Administration Center. See Creating policy schedules for FastBack data on page 15. 4. Install the Tivoli Storage Manager backup-archive client on the FastBack server. For installation instructions, see the Tivoli Storage Manager Backup-Archive Clients Installation and User's Guide. 5. Verify that the utilities FastBack Mount and the FastBack Administrative Command Line Interface are installed on the same system as the backup-archive client. 6. You must configure the backup-archive client before it can back up or archive FastBack volumes: a. Issue the set password command to provide the backup-archive client with the necessary credentials and allow access to the FastBack repository. Repeat this step for each FastBack repository in the configuration that the backup-archive client connects to. b. Configure the client scheduler to back up or archive data to the Tivoli Storage Manager server. For information on the set password and configuring the client scheduler, see the Tivoli Storage Manager Backup-Archive Clients Installation and User's Guide. 7. Verify that backup or archive operations to the Tivoli Storage Manager are completing successfully by issuing the QUERY EVENT or QUERY SCHEDULE command.
16
IBM Tivoli Storage Manager: Integration Guide for Tivoli Storage Manager FastBack
Installing and configuring the backup-archive client on the FastBack Disaster Recovery Hub server
Complete the steps to install a Windows backup-archive client as the proxy node on the FastBack Disaster Recovery Hub server. 1. Choose a name and password for the Tivoli Storage Manager backup-archive client that is the proxy node and will back up or archive data from the FastBack Disaster Recovery Hub server. You do not need to select the same name as a FastBack server because the backup-archive client that is installed with the FastBack Disaster Recovery Hub server might potentially be backing up or archiving data from more than one server. Write down the node name and password for later use. 2. Define the FastBack server to the Administration Center by adding a connection for the server. If you have more than one FastBack server in your configuration, repeat this step for each server. See Adding FastBack server connections to the Administration Center on page 14. 3. Run the Create a FastBack Policy Schedule wizard from the Administration Center. See Creating policy schedules for FastBack data on page 15 4. Install the Tivoli Storage Manager backup-archive client on the FastBack Disaster Recovery Hub server. For installation instructions, see the Backup-Archive Installation and User's Guide. 5. Verify that the utilities FastBack Mount and the FastBack Administrative Command Line Interface are installed on the same system as the backup-archive client. 6. You must configure the backup-archive client before it can back up or archive FastBack volumes: a. Issue the set password command to provide the backup-archive client with the necessary credentials and allow access to the FastBack repository. Repeat this step for each FastBack repository in the configuration that the backup-archive client connects to. b. Configure the client scheduler to back up or archive data to the Tivoli Storage Manager server. For information on the set password and configuring the client scheduler, see the Tivoli Storage Manager Backup-Archive Clients Installation and User's Guide. 7. Verify that backup or archive operations to the Tivoli Storage Manager are completing successfully by issuing the QUERY EVENT or QUERY SCHEDULE command.
17
| | | | | | | | |
4. Install the Tivoli Storage Manager backup-archive client on the dedicated proxy system. For installation instructions, see the Tivoli Storage Manager Backup-Archive Clients Installation and User's Guide. 5. 6.
Linux Install FastBack Mount and the FastBack Administrative Command Line Interface on the FastBack server.
Configure Cygwin on the FastBack server system. For details and complete configuration steps, see the Linux Tivoli Storage Manager FastBack Configuration Field Guide, which is available at: http://www.ibm.com/software/ sysmgmt/products/support/Field_Guides.html.
Linux
Windows Install FastBack Mount and the FastBack Administrative Command Line Interface on the same system as the backup-archive client. 8. You must configure the backup-archive client before it can back up or archive FastBack volumes: a. Issue the set password command to provide the backup-archive client with the necessary credentials and allow access to the FastBack repository. Repeat this step for each FastBack repository in the configuration that the backup-archive client connects to. b. Configure the client scheduler to back up or archive data to the Tivoli Storage Manager server.
7.
For information on the set password and configuring the client scheduler, see the Tivoli Storage Manager Backup-Archive Clients Installation and User's Guide. 9. Verify that backup or archive operations to the Tivoli Storage Manager are completing successfully by issuing the QUERY EVENT or QUERY SCHEDULE command.
Optional: Install FastBack Reporting and launch the FastBack Manager user interface
You can launch the FastBack Manager user interface from the Administration Center to manage a FastBack server. An installation of FastBack Reporting is required on each server from which you want to launch the user interface.
18
IBM Tivoli Storage Manager: Integration Guide for Tivoli Storage Manager FastBack
19
20
IBM Tivoli Storage Manager: Integration Guide for Tivoli Storage Manager FastBack
21
22
IBM Tivoli Storage Manager: Integration Guide for Tivoli Storage Manager FastBack
23
24
IBM Tivoli Storage Manager: Integration Guide for Tivoli Storage Manager FastBack
Appendix A. Integrating IBM Tivoli Storage Manager and IBM Tivoli Storage Manager FastBack using command interfaces
If you do not use the Tivoli Storage Manager Administration Center, you can set up an integrated environment for Tivoli Storage Manager and Tivoli Storage Manager FastBack from the command lines of each product. The example integration procedure in this topic is based on the environment in following figure:
FastBack Environment
FastBack client
FastBack client
Data Center
Creating an integrated environment involves multiple installations. You can find detailed installation procedures in these sources: v Tivoli Storage Manager server: For installation and configuration steps, see the Tivoli Storage Manager Installation Guide . v Tivoli Storage Manager backup-archive client: For installation and configuration steps, see Tivoli Storage Manager for Windows Backup-Archive Clients Installation and User's Guide or Tivoli Storage Manager for UNIX and Linux Backup-Archive Clients Installation and User's Guide.
Copyright IBM Corp. 2010
25
v Tivoli Storage Manager FastBack server, FastBack Disaster Recovery Hub server, and FastBack client: Tivoli Storage Manager FastBack Installation and User's Guide Complete the steps in the following sample procedure to install and configure an integrated environment for Tivoli Storage Manager and Tivoli Storage Manager FastBack. 1. Install and configure the Tivoli Storage Manager server and media libraries. 2. Install and configure the Tivoli Storage Manager FastBack server. 3. Optional: Install and configure a Tivoli Storage Manager FastBack Disaster Recovery Hub server. For example, install and configure a server named "Rochester." 4. Install and configure the Tivoli Storage Manager FastBack client on each server to be protected. 5. Install and configure a Tivoli Storage Manager backup-archive client on the FastBack server, the FastBack Disaster Recovery Hub server, or a dedicated proxy system. In this example, the backup-archive client is installed as a proxy client on the FastBack Disaster Recovery Hub. To decide which configuration is best for your environment, see Determining where to install the backup-archive client that is the proxy node on page 7. 6. Optional: Install and configure the Tivoli Storage Manager backup-archive clients on any server to be protected so that users can run restore and retrieve operations from those servers. In this example, backup-archive clients are installed on server Jane and Helen. 7. From the FastBack Manager user interface, configure the FastBack server to take snapshots by defining client groups, job schedules, and policies. Select the Configuration tab, navigate to the panel you want, and specify settings for each object. a. Right click Client Groups and select New Client group. b. Right click Job Schedules and select New Job Schedule. c. Right click Policies and New Policy. See the Tivoli Storage Manager FastBack Installation and User's Guide for details about creating these objects. 8. From the Tivoli Storage Manager server, define a storage pool, a policy domain, a policy set, a management class, and one or more copy groups. Set the retention period for backups and archives. | | | | | | | | | |
define stgpool fastbackstg define domain fastbackdomain backretention=30 archretention=365 define policyset fastbackdomain fastbackpolicy define mgmtclass fastbackdomain fastbackpolicy fastbackclass define copygroup fastbackdomain fastbackpolicy fastbackclass type=backup destination=fastbackstg retonly=365
9. Register the backup-archive client node that was installed in step 5. Use the Windows computer name as the node name, for example, Rochester.
register node rochester password
| | |
10. Register all FastBack clients whose data is backed up in the FastBack repository and that you want backed up to the Tivoli Storage Manager server. Grant proxy authority for them to the FastBack proxy node Rochester. Use the Windows computer names as the node names, for example, Jane.
26
IBM Tivoli Storage Manager: Integration Guide for Tivoli Storage Manager FastBack
11. From the Tivoli Storage Manager client, run the SET PASSWORD command to store the credentials of the Tivoli Storage Manager FastBack repositories where the Tivoli Storage Manager client connects. Run the SET PASSWORD command once for each repository to which the Tivoli Storage Manager client is expected to connect. The type of credentials required is based on the configuration: v Tivoli Storage Manager client on a FastBack Server v Tivoli Storage Manager client on a FastBack Hub v Tivoli Storage Manager client on a dedicated proxy system See Set Password (for protecting FastBack data) on page 45 for details about using this command. 12. Create a client schedule on the Tivoli Storage Manager server to back up or archive the Tivoli Storage Manager FastBack files, or issue the BACKUP FASTBACK or ARCHIVE FASTBACK command from the Tivoli Storage Manager client command line. v Create the client schedule on the Tivoli Storage Manager server: a. From the Tivoli Storage Manager server, define schedules to back up or archive Tivoli Storage Manager FastBack files and associate the schedule with one or more node names. Here is an example of a backup schedule: | | | | | |
define schedule standard datasrv_back description=daily backup dataservers F: G: action=backup subaction=fastback options='-fbpolicyname=fbclientpol -backmc=fastbackclass -fbbranch=rochester -fbclientname=jane,helen' starttime=00:00:00
b. Associate the schedule with the proxy node Rochester. For example:
define association fastbackdomain datasrv_back rochester
c. From the proxy node, start the scheduler daemon, or start the client in schedule mode. v Issue a command from the Tivoli Storage Manager client command line: Issue the BACKUP FASTBACK or ARCHIVE FASTBACK command from the client command line. Here is an example of a BACKUP FASTBACK command:
dsmc backup fastback -fbpolicyname=fbclientpol -fbclientname=jane,helen -fbreposlocation= \\myFBServer.company.com\FB_REP_OF_9d6ec80\ -fbserver=edward
Appendix A. Integrating IBM Tivoli Storage Manager and IBM Tivoli Storage Manager FastBack using command interfaces
27
28
IBM Tivoli Storage Manager: Integration Guide for Tivoli Storage Manager FastBack
29
Privilege class
To define a client schedule, you must have system privilege, unrestricted policy privilege, or restricted policy privilege for the policy domain to which the schedule belongs.
Syntax
DEFine SCHedule domain_name schedule_name
Archive Backup
SUBACTion =
FASTBack
OPTions =
option_string
STARTDate = STARTDate =
current_date date
Parameters
domain_name (Required) Specifies the name of the policy domain to which this schedule belongs. schedule_name (Required) Specifies the name of the schedule to be defined. You can specify up to 30 characters for the name. DESCription Specifies a description of the schedule. This parameter is optional. You can specify up to 255 characters. Enclose the description in quotation marks if it contains any blank characters. ACTion (Required) Specifies the operation that occurs when this schedule runs. Possible values are: Archive Specifies an archive operation.
30
IBM Tivoli Storage Manager: Integration Guide for Tivoli Storage Manager FastBack
Backup Specifies a back up operation. SUBACTion (Required) Specifies that the Tivoli Storage Manager FastBack client operation that is identified by the ACTION parameter is to be scheduled. OPTions (Required) Specifies the client options to be included when the schedule is processed. See Tivoli Storage Manager client command options on page 49 for descriptions of the options that are valid with an ARCHIVE or BACKUP Tivoli Storage Manager FastBack operation. When you define a scheduler service by using the DSMCUTIL command or the wizard in the backup-archive client GUI, specify an options file for the scheduler service to use. You cannot override the options in that options file by issuing the scheduled command. You must modify the options in your scheduler service. If the option string contains multiple options or options with embedded spaces, surround the entire option string with one pair of single quotes. Individual options that contain spaces should be enclosed in double quotes. A leading minus sign is required in front of the option. Errors can occur if the option string contains spaces that are not quoted correctly. The following example shows how to specify a client option. To specify -fbpolicyname="policy 0,policy 1", -fbserver=bronte and -backmc=my_tsm_mgmtclass, enter:
options='-fbpolicyname="policy 0,policy 1" -fbserver=bronte -backmc=my_tsm_mgmtclass'
Tip: For Windows clients running in batch mode, if the use of double quotes is necessary, use interactive mode or operating system escape characters. STARTDate Specifies the date for the beginning of the window in which the schedule is first processed. This parameter is optional. The default is the current date. Use this parameter with the STARTTIME parameter to specify when the initial startup window of the schedule starts. You can specify the date using one of the values below:
Value MM/DD/YYYY TODAY Description A specific date The current date Example 09/15/1998 TODAY
TODAY +3 or +3. TODAY+days or The current date plus days +days specified. The maximum number of days you can specify is 9999.
You can also use the following parameters with the DEFINE SCHEDULE command. v PRIORITY v STARTTIME v DURATION v DURUNITS v PERIOD
Appendix B. Server commands for Tivoli Storage Manager FastBack
31
32
IBM Tivoli Storage Manager: Integration Guide for Tivoli Storage Manager FastBack
Privilege class
To update a client schedule, you must have system privilege, unrestricted policy privilege, or restricted policy privilege for the policy domain to which the schedule belongs.
Syntax
(1) UPDate SCHedule domain_name schedule_name
DESCription =
description
ACTion =
Archive Backup
SUBACTion =
"" FASTBack
OPTions =
option_string
Notes: 1 You must specify at least one optional parameter on this command.
Parameters
domain_name (Required) Specifies the name of the policy domain to which this schedule belongs. schedule_name (Required) Specifies the name of the schedule to be updated. DESCription Specifies a description of the schedule. This parameter is optional. You can specify up to 255 characters for the description. Enclose the description in quotation marks if it contains blank characters. To remove a previously defined description, specify a null string ("") for this value. ACTion Specifies the operation that occurs when this schedule runs. Possible values are: Archive Specifies an archive operation. Backup Specifies a back up operation.
Appendix B. Server commands for Tivoli Storage Manager FastBack
33
SUBACTion Specifies that the type of operation identified by the ACTION parameter is to be scheduled. The parameter is optional. "" Specifies that a previous setting is to be deleted. FASTBack Specifies that a Tivoli Storage Manager FastBack client operation that is identified by the ACTION parameter is to be scheduled. OPTions (Required) Specifies the client options to be included when the schedule is processed. See Tivoli Storage Manager client command options on page 49 for descriptions of the options that are valid with an ARCHIVE or BACKUP Tivoli Storage Manager FastBack operation. When you define a scheduler service by using the DSMCUTIL command or the wizard in the backup-archive client GUI, specify an options file for the scheduler service to use. You cannot override the options in that options file by issuing the scheduled command. You must modify the options in your scheduler service. If the option string contains multiple options or options with embedded spaces, surround the entire option string with one pair of single quotes. Individual options that contain spaces should be enclosed in double quotes. A leading minus sign is required in front of the option. Errors can occur if the option string contains spaces that are not quoted correctly. The following example shows how to specify a client option. To specify -fbpolicyname="policy 0,policy 1", -fbserver=bronte and -backmc=my_tsm_mgmtclass, enter:
options='-fbpolicyname="policy 0,policy 1" -fbserver=bronte -backmc=my_tsm_mgmtclass'
Tip: For Windows clients running in batch mode, if the use of double quotes is necessary, use interactive mode or operating system escape characters. STARTDate Specifies the date for the beginning of the window in which the schedule is first processed. This parameter is optional. The default is the current date. Use this parameter with the STARTTIME parameter to specify when the initial startup window of the schedule starts. You can specify the date using one of the values below:
Value MM/DD/YYYY TODAY Description A specific date The current date Example 09/15/1998 TODAY
TODAY+days or The current date plus days TODAY +3 or +3. +days specified. The maximum number of days you can specify is 9999.
You can also use the following parameters with the UPDATE SCHEDULE command. v PRIORITY v STARTTIME v DURATION
34
IBM Tivoli Storage Manager: Integration Guide for Tivoli Storage Manager FastBack
v v v v v
35
36
IBM Tivoli Storage Manager: Integration Guide for Tivoli Storage Manager FastBack
Archive FastBack
Linux Windows
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: v All clients and volumes associated with a FastBack policy or a list of FastBack policies. v All volumes associated with a specific FastBack client or a list of FastBack clients for a given FastBack policy. v A specific volume or volumes associated with a FastBack client for a given FastBack policy.
Supported Clients
Linux
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.
Windows
Syntax
, name FBServer = name
37
| | |
FBClientname =
, name FBVolumename =
, name
| |
FBReposlocation =
name
FBBranch =
name
ARCHMc =
name
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | Important: 1. At least one FBpolicyName is always required. 2. You can specify up to 10 values for FBPolicyName, if no values are specified for both FBClientName and FBVolumeName. 3. When you specify a FBClientName value, there must be only one value for FBPolicyName. 4. You can specify up to 10 values for FBClientName if only one PolicyName is specified, and no values for FBVolumeName are specified. 5. When you specify the FBVolumeName option, you can have only one FBPolicy, and only one FBCLientName specified. 6. You can specify multiple FBVolumeNames if condition 5 is satisfied. 7. You must always specify the FBReposLocation option for Linux.
Parameters
Table 1. Archive FastBack command: Related options Option fbpolicyname Fbpolicyname on page 53 fbserver Fbserver on page 57 fbclientname Fbclientname on page 51 fbvolumename Fbvolumename on page 59 Where to use Command line and scheduler.
fbreposlocation Command line and scheduler. Fbreposlocation on page 55 fbbranch Fbbranch on page 50 Command line and scheduler.
Examples
Linux
Command line: The Tivoli Storage Manager backup-archive client is installed on a Linux
38
IBM Tivoli Storage Manager: Integration Guide for Tivoli Storage Manager FastBack
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | |
Windows Linux 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
Windows
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.
Appendix C. Backup-archive client commands for Tivoli Storage Manager FastBack
39
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | |
Windows Windows Windows
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
Backup FastBack
Linux Windows
Use the backup fastback command to back up 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.
40
IBM Tivoli Storage Manager: Integration Guide for Tivoli Storage Manager FastBack
| | | | | | | | | | | | | | | | | | | | | | | | |
Windows 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. Linux 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.
Tivoli Storage Manager FastBack options are supported for the incremental backup of the latest snapshots, depending on the option specified: v All clients and volumes associated with a Tivoli Storage Manager FastBack policy or a list of Tivoli Storage Manager FastBack policies. v All volumes associated with a specific FastBack client or a list of FastBack clients for a given Tivoli Storage Manager FastBack policy. v A specific volume or volumes associated with a FastBack client for a given Tivoli Storage Manager FastBack policy.
Supported Clients
Linux This command is valid for Linux x86/x86_64 clients that are configured as Tivoli Storage Manager FastBack dedicated proxies.
This command 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.
Windows Linux
Syntax
, BACKUP FASTBack FBPolicyname = name FBServer = name
| |
FBClientname =
, name FBVolumename =
, name
| |
FBReposlocation =
| | | | | | | Important: 1. At least one FBpolicyName is always required. 2. You can specify up to 10 values for FBPolicyName, if no values are specified for both FBClientName and FBVolumeName. 3. When you specify a FBClientName value, there must be only one value for FBPolicyName.
41
| | | | | | | | | |
4. You can specify up to 10 values for FBClientName if only one PolicyName is specified, and no values for FBVolumeName are specified. 5. When you specify the FBVolumeName option, you can have only one FBPolicy, and only one FBCLientName specified. 6. You can specify multiple FBVolumeNames if condition 5 is satisfied. 7. You must specify the FBReposLocation option.
Windows
Syntax
, BACKUP FASTBack FBPolicyname = name FBServer = name
| |
FBClientname =
, name FBVolumename =
, name
| |
FBReposlocation =
name
FBBranch =
name
BACKMc =
name
| | | | | | | | | | | | | | | | | | | | | | | | | Important: 1. At least one FBpolicyName is always required. 2. You can specify up to 10 values for FBPolicyName, if no values are specified for both FBClientName and FBVolumeName. 3. When you specify a FBClientName value, there must be only one value for FBPolicyName. 4. You can specify up to 10 values for FBClientName if only one PolicyName is specified, and no values for FBVolumeName are specified. 5. When you specify the FBVolumeName option, you can have only one FBPolicy, and only one FBCLientName specified. 6. You can specify multiple FBVolumeNames if condition 5 is satisfied.
Table 2. Backup FastBack command: Related options Option fbpolicyname Fbpolicyname on page 53 fbserver Fbserver on page 57 fbclientname Fbclientname on page 51 fbvolumename Fbvolumename on page 59 Where to use Command line and scheduler.
42
IBM Tivoli Storage Manager: Integration Guide for Tivoli Storage Manager FastBack
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | |
Table 2. Backup FastBack command: Related options (continued) Option Where to use
fbreposlocation Command line and scheduler. Fbreposlocation on page 55 fbbranch Fbbranch on page 50 Command line and scheduler.
Examples
Linux
Command line: The Tivoli Storage Manager backup-archive client is installed on a Linux proxy client machine. Use this command to back up all FastBack volumes for all Linux FastBack clients that are defined for FastBack policy1:
dsmc backup fastback -fbpolicyname=Policy1 -fbserver=myfbserver -fbreposlocation=myfbserver@WORKGROUP
The repository location is required. If you do not provide the repository location, the command will fail. The FastBack server name, -myfbserver, is the short host name of the FastBack server where the repository is located.
Linux
Command line: The repository, rep_server1, is located on a FastBack disaster hub, myFbDrHub
dsmc backup fastback -fbpolicyname="Policy 1" -fbserver=myFbDrHub -fbreposlocation=\\myFbDrHub\rep_server1
The FastBack server name, -myFbDrHub, is the short host name of the FastBack disaster recovery hub server where the repository is located. The -fbreposlocation option specifies the location of the repository. The repository location is required. If you do not provide the repository location, the command fails. The FBServer option should point to the short host name of the FastBack DR hub in this case.
Linux
Command line: Back up all volumes protected by FastBack policy named policy1 from the FastBack server named basil:
dsmc backup fastback -Fbpolicyname=policy1 -FBServer=basil -BACKMC="my_tsm_mgmt_class" -fbreposlocation=basil@WORKGROUP
Windows
Command line: The Tivoli Storage Manager is installed on a FastBack server. Use this command to back up all Tivoli Storage Manager FastBack volumes for all Windows FastBack clients that are defined for Tivoli Storage Manager FastBack policy1:
dsmc backup fastback -fbpolicyname=Policy1 -fbserver=myfbserver
43
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | |
Windows Windows Windows Windows
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 back up all FastBack volumes for all FastBack clients that are found in the policy named Policy 1:
dsmc backup fastback -fbpolicyname="Policy 1" -fbserver=myFbServer -fbbranch=branch1
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 whose FastBack branch is specified using the FBBranch option Command line: The Tivoli Storage Manager client is installed on a dedicated proxy machine with FastBack administrative command line and FastBack mount. The Tivoli Storage Manager client is connecting to a FastBack server repository. Use this command to back up all FastBack volumes for all FastBack clients that are found in the policy named Policy 1:
dsmc backup 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 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 back up all FastBack volumes for all FastBack clients that are found in the policy named Policy 1:
dsmc backup 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: Back up all volumes protected by FastBack policy named policy1 from the FastBack server named basil, and apply the management class "my_tsm_mgmt_class" to the backed up volumes:
dsmc backup fastback -Fbpolicyname=policy1 -FBServer=basil -BACKMC=my_tsm_mgmt_class
44
IBM Tivoli Storage Manager: Integration Guide for Tivoli Storage Manager FastBack
The set password command changes the Tivoli Storage Manager password for your workstation. If you omit the old and new passwords when you enter the set password command, you are prompted once for the old password and twice for the new password.
Linux You must be an authorized user or system administrator to use this command.
A password is not case sensitive, and it can be as many as 63 characters. Valid characters are: a-z 09 + . _ & | | | Any letter, a through z, upper or lower-case Any number, 0 through 9 Plus Period Underscore Hyphen Ampersand
Supported Clients
Linux
This option is valid for Linux x86/x86_64 clients. This command is valid for all Windows clients
Windows
Syntax
SET Password oldpw newpw TYPE=FASTBack otherserver otheruserid otherpassword
Parameters
| | | | oldpw Specifies the current password for your workstation. newpw Specifies the new password for your workstation. otherserver Specifies the file server host name. This variable refers to the fbservername value. It is either the short host name of the FastBack server or the short host name of the FastBack DR Hub. The file server host name must be the short local-host name.
45
otheruserid Specifies the user ID to be used for the entity named by the otherserver parameter. The otheruserid refers to the FastBack credentials. It can be specified as a FastBack administrator ID or domain:networkuserid format depending on the Tivoli Storage Manager client configuration being used. otherpassword Specifies the password to be used for the entity named by the otherserver parameter. The password matches the FastBack user ID specified with the otheruserid parameter. It is either a network password or a FastBack administrator ID password, depending on the Tivoli Storage Manager client configuration being used. | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | |
Windows Linux
Type=FastBack Use the TYPE=FastBack parameter to store the Tivoli Storage Manager FastBack credentials. The credentials are required for mounting and demounting the FastBack volumes to back up or archive to the Tivoli Storage Manager server. Important: You must define the user credentials that are required to mount and demount FastBack volumes from a repository to the Tivoli Storage Manager client before you enter the Tivoli Storage Manager FastBack subcommand. The SET PASSWORD command specifies the user credentials. The Linux Tivoli Storage Manager backup-archive client is installed on a dedicated proxy workstation. It can be configured to connect to multiple network share repositories. Follow these steps for each of the network share repositories where the Tivoli Storage Manager client is connected: 1. Configure the repository for remote network access from FastBack Manager. See the Tivoli Storage Manager FastBack Installation and User's Guide for details. This step establishes a domain name, a network share user ID, and a network share password to connect remotely to the repository. 2. On the Tivoli Storage Manager client workstation, manually enter the following command:
dsmc set password type=fastback FBServer domain:networkaccessuserid networkaccesspassword
FBServer in the previous example represents the short host name of the FastBack server whose repository is being backed up. Networkaccessuserid is the user ID on the Tivoli Storage Manager client workstation that has read access to the network share repository. Domain is the domain name of the user ID. Networkaccesspassword is the password of the network access user ID. Type=FastBack Use this parameter to store the Tivoli Storage Manager FastBack credentials that are required for mounting and demounting the FastBack volumes to back up or archive to the Tivoli Storage Manager server. Important: You must define the user credentials that are required to mount and unmount FastBack volumes from a repository to the Tivoli Storage Manager client before you enter the Tivoli Storage Manager FastBack subcommand. The SET PASSWORD command specifies the user credentials. Here is a brief description of the various configurations and credentials that you need:
46
IBM Tivoli Storage Manager: Integration Guide for Tivoli Storage Manager FastBack
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | |
v If the Tivoli Storage Manager client is installed on the FastBack server workstation, the client attempts to connect to a local repository. You must manually define the Tivoli Storage Manager FastBack administrator user ID and the corresponding password using this command:
dsmc set password -type=fastback fbserver fbadminuserid fbadminpass
The FBServer in the previous example represents the short host name of the FastBack server whose repository is being backed up. This name is also the short host name of the Tivoli Storage Manager client workstation because the FastBack server and the Tivoli Storage Manager client are installed on the same workstation. v If the Tivoli Storage Manager client is installed on the Tivoli Storage Manager FastBack DR Hub workstation, the Tivoli Storage Manager client attempts to connect to a local repository. You must manually define the Tivoli Storage Manager FastBack administrator user ID and the corresponding password by using this command:
dsmc set password -type=fastback fbserver fbadminuserid fbadminpass
If the Tivoli Storage Manager client scheduler is used to run Tivoli Storage Manager server schedules that are set up using the Administration Center, fbserver is the name of the Tivoli Storage Manager FastBack server as specified by that schedule. You must run the previous command for each FastBack server that has a schedule running on this client. If the client is not being run by the scheduler, fbserver is the short host name of the Tivoli Storage Manager FastBack DR Hub workstation. This name is also the short host name of the Tivoli Storage Manager client workstation because the FastBack DR Hub and the Tivoli Storage Manager client are installed on the same workstation. In this case, you only have to run the SET PASSWORD command a single time. v If the Tivoli Storage Manager client is installed on a dedicated proxy workstation with FastBack shell and FastBack mount, but not the FastBack server or the Tivoli Storage Manager FastBack DR Hub, a Tivoli Storage Manager dedicated client proxy workstation can connect to multiple network share repositories. Follow these steps for each network share repository where the Tivoli Storage Manager client is connected: 1. Configure the repository for remote network access from FastBack Manager. See the Tivoli Storage Manager FastBack Installation and User's Guide for details. This step establishes a domain name, a network share user ID, and a network share password to connect remotely to the repository. 2. On the Tivoli Storage Manager client workstation, manually enter the following command:
dsmc set password type=fastback fbserver domain:networkaccessuserid networkaccesspassword
The fbserver option specifies the short host name of the FastBack server workstation. For a FastBack DR Hub, the fbserver option specifies the short name of the workstation where the DR Hub is installed. Networkaccessuserid is the user ID on the Tivoli Storage Manager client workstation that has read access to the network share repository. Domain is the domain name of the user ID. Networkaccesspassword is the password of the network access user ID.
47
| | |
These credentials are retrieved based on the short host name that you specify with the fbserver option. Therefore, the fbserver value mentioned in this command should match the -fbserver option value.
Examples
The following examples use the set password command. Task Set up a user ID and password for the FastBack server myFastBackServer. Use the -fbserver option in the archive fastback and backup fastback commands for the server name. Command: dsmc set password -type=fastback myfastbackserver myUserId "pa$sword" Important: v The dsmc set password -type=fastback command must be repeated on a dedicated client proxy workstation once for each FastBack repository where the Tivoli Storage Manager is expected to connect. v For network share repositories, the dsmc set password -type=fastback command should be in this format: dsmc set password -type=fastback myFBServer domainName:userId password. | | | | | | | | | | | | v For a FastBack server or a Tivoli Storage Manager FastBack DR Hub, the user ID and password specified must have Tivoli Storage Manager FastBack administrator privileges. You must issue the dsmc set password -type=fastback command once for each FastBack Server branch repository on the FastBack DR Hub work machine that the Tivoli Storage Manager client is expected to connect to. The Tivoli Storage Manager client is running on a Tivoli Storage Manager FastBack DR Hub machine and is connecting to a branch repository for a FastBack Server whose short name is "myFbServer". "admin" is a Tivoli Storage Manager FastBack administrator user ID for the Tivoli Storage Manager, and myAdminPass is the corresponding password.
dsmc set password -type=fastback myfbserver admin myadminpass
The Tivoli Storage Manager client is running on a dedicated proxy machine and is connecting to a FastBack server repository whose short hostname is "myfbserver". The user ID is the network user ID that has read/write access to the repository share. DOMAIN is the domain to which the user ID belongs. mynetworkpass is the corresponding password for the user ID.
dsmc set password -type=fastback myfbserver DOMAIN:USERID mynetworkpass
The Tivoli Storage Manager client is running on a dedicated proxy machine and is connecting to a repository on a DR Hub machine whose short hostname is "myfbdrhub". The user ID is the network user ID that has read/write access to the repository share. DOMAIN is the domain to which the user ID belongs. mynetworkpass is the corresponding password for the user ID. Do not use this configuration to run client schedules that are set up from the Administration Center.
dsmc set password -type=fastback myfbdrhub DOMAIN:USERID mynetworkpass
You must issue the following command to run client schedules that are set up from Administration Center.
dsmc set password -type=fastback myfbserver DOMAIN:USERID mynetworkpass
48
IBM Tivoli Storage Manager: Integration Guide for Tivoli Storage Manager FastBack
where myfbserver is the short host name of the server used in the -fbserver option in the Administration Center schedules. The SET PASSWORD command must be repeated once for each FastBack server whose repository the Tivoli Storage Manager client will connect to.
Archmc
Use the archmc option with the archive command to specify the available management class for your policy domain to which you want to bind your archived files and directories. When you archive a file, you can override the assigned management class using the archmc option on the archive command or by using the Web client. Overriding the management class using the Web client is equivalent to using the archmc option on the archive command. If you do not use the archmc option, the server binds archived directories to the default management class. If the default management class has no archive copy group, the server binds archived directories to the management class with the shortest retention period.
Linux Windows
Supported Clients
This option is valid for all UNIX and Linux clients. The Tivoli Storage Manager client API does not support this option.
Linux Windows This option is valid for all Windows clients. The Tivoli Storage Manager client API does not support this option.
Syntax
ARCHMc = managementclass
Parameters
managementclass Specifies an available management class in the active policy set of your policy domain. This management class overrides the default management class and any include statements for the files and directories you are archiving.
Examples
Command line:
Linux
49
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | |
Backmc
Linux Windows
The backmc option specifies the Tivoli Storage Manager management class to apply to the backup fastback command for retention purposes. Use the backmc option with the backup fastback command.
Supported Clients
Linux
This option is valid for Linux x86/x86_64 clients. This option is valid for all Windows clients.
Windows
Options File
None. You can specify this option only on the command line or on the scheduler.
Syntax
BACKMc= management_class_name
Parameters
management_class_name Specifies the management class name.
Examples
Command line: dsmc backup fastback -fbpolicyname=policy1 -fbserver=server1 -backmc=ret2yrs
Fbbranch
Linux Windows
Use the fbbranch option with the backup fastback or archive fastback commands. The fbbranch option specifies the branch ID of the remote FastBack server to back up or archive. The fbbranch option is only required when the a backup-archive client is installed on a FastBack DR Hub or when a dedicated proxy is connecting to a replicated DR Hub repository. Do not specify the fbbranch option when the backup-archive client is installed on the FastBack server.
Supported Clients
Linux
This option is valid for Linux x86/x86_64 clients. This option is valid for all Windows clients.
Windows
50
IBM Tivoli Storage Manager: Integration Guide for Tivoli Storage Manager FastBack
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | |
Options File
Linux None. You can specify this option only on the command line. The server can also define or override this option. Windows None. You can specify this option only on the command line. The server can also define or override this option.
Syntax
FBBranch= branch_ID
Parameters
branch_ID Specifies the FastBack server branch ID. The value is part of the disaster recovery configuration of the FastBack server.
Examples
Command line: -FBBranch=oracle On a Tivoli Storage Manager backup-archive client that is installed on a FastBack DR Hub:
dsmc backup fastback -fbpolicyname=policy1 -fbserver=myFbServer -fbbranch=oracle
Command line: On a Tivoli Storage Manager backup-archive client that is connecting to a repository on a remote FastBack DR Hub:
dsmc backup fastback -fbpolicyname=policy1 -fbserver=server1 -Fbreposlocation=\\myDrHub.company.com\REP -fbbranch=oracle
If the fbbranch option is specified on a Tivoli Storage Manager client workstation that is installed on a FastBack server, the fbbranch option is ignored.
Fbclientname
Linux Windows
Use the fbclientname option with the backup fastback or archive fastback commands. The fbclientname option is the name of one or more comma-separated FastBack clients to back up or archive from the backup proxy. The values for the fbclientname option are invalid if more than one policy is specified in the fbpolicyname option. You cannot include spaces in the fbclientname option values. If you do not specify any values for the fbvolumename option, all the volumes from all the FastBack clients in the policy that is specified are backed up. If you specify multiple FastBack clients in the fbclientname option, you cannot specify values for the fbvolumename option.
Appendix C. Backup-archive client commands for Tivoli Storage Manager FastBack
51
| | | | | | | | |
Supported Clients
Linux
This option is valid for Linux x86/x86_64 clients. This option is valid for all Windows clients.
Windows
Options File
Linux
None. You can specify this option only on the command line.
None. You can specify this option only on the command line. The server can also define or override this option.
Windows
Syntax
, (1) FBClientname client_name
Parameters
client_name Specifies the name of one or more FastBack clients. You can specify up to 10 FastBack client names. Important: When specifying the archive fastback or backup fastback command: 1. At least one FBpolicyName is always required. 2. You can specify up to 10 values for FBPolicyName, if no values are specified for both FBClientName and FBVolumeName. 3. When you specify a FBClientName value, there must be only one value for FBPolicyName. 4. You can specify up to 10 values for FBClientName if only one PolicyName is specified, and no values for FBVolumeName are specified. 5. When you specify the FBVolumeName option, you can have only one FBPolicy, and only one FBCLientName specified. 6. You can specify multiple FBVolumeNames if condition 5 is satisfied. 7. You must always specify the FBReposLocation option for Linux.
Examples
Linux
Command line:
dsmc backup fastback -fbpolicyname=Policy1 -fbclientname=fbclient1,fbclient2 -fbserver=myFbServer -fbreposlocation=/mnt/FBLocation
Backs up all volumes for FastBack clients fbclient1 and fbclient2 that are found in policy Policy1.
52
IBM Tivoli Storage Manager: Integration Guide for Tivoli Storage Manager FastBack
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | |
Windows
Command line:
dsmc backup fastback -fbpolicyname=Policy1 -fbclientname=fbclient1,fbclient2 -fbserver=myFbServer -fbreposlocation=\\myFbServer.company.com\REP
Backs up all volumes for FastBack clients fbclient1 and fbclient2 that are found in policy Policy1.
Windows
Command line:
dsmc backup fastback -fbpolicyname=Policy1 -fbclientname=fbclient1 -fbvolume=c:,f: -fbserver=myFbServer -fbreposlocation=\\myFbServer.company.com\REP
Backs up volumes C: and F: for FastBack client fbclient1 found in policy Policy1.
Windows
Command line:
dsmc backup fastback -fbpolicyname=Policy1 -fbclientname=fbWindowsClient,fbLinuxClient -fbserver=myFbServer -fbreposlocation=\\myFbServer.company.com\REP
Backs up all volumes for FastBack client fbWindowsClient found in policy Policy1. The volumes for Linux FastBack client fbLinuxClient will not be backed up from the Windows Tivoli Storage Manager backup-archive client. To back up or archive volumes from a Linux FastBack client, use the Linux Tivoli Storage Manager backup-archive client.
Fbpolicyname
Linux Windows
Use the fbpolicyname option with the backup fastback or archive fastback commands. The fbpolicyname option is the name of one or more comma-separated Tivoli Storage Manager FastBack policies that you want to back up or archive from the backup proxy. You must specify at least one policy name. Specify multiple policy names using a comma-delimited list of policies. There is no default value. If one or more FB policy names contain spaces, you must specify them within quotation marks. Here is an example: "FB Policy NAME1, FBPolicy Name 2". If you do not specify any values for the fbclientname and fbvolumename options, all the volumes from all the FastBack clients in the policies that are specified are backed up. If you specify multiple policies in the fbpolicyname option, you cannot specify values for the fbclientname and fbvolumename options. 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 backup-archive client.
Windows
53
| | | | | | | | | | | | | | |
Linux 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 backup-archive client.
At least one snapshot should exist in the Tivoli Storage Manager FastBack repository for the FastBack policies being archived or backed up prior to issuing the dsmc command
Supported Clients
Linux
This option is valid for Linux x86/x86_64 clients. This option is valid for all Windows clients.
Windows
Options File
Linux
None. You can specify this option only on the command line.
Windows None. You can specify this option only on the command line. The server can also define or override this option.
Syntax
, (1) FBPolicyname policy_name
Parameters
policy_name Specifies the name of the FastBack policies. You can specify up to 10 FastBack policy names. Important: When specifying the archive fastback or backup fastback command: 1. At least one FBpolicyName is always required. 2. You can specify up to 10 values for FBPolicyName, if no values are specified for both FBClientName and FBVolumeName. 3. When you specify a FBClientName value, there must be only one value for FBPolicyName. 4. You can specify up to 10 values for FBClientName if only one PolicyName is specified, and no values for FBVolumeName are specified. 5. When you specify the FBVolumeName option, you can have only one FBPolicy, and only one FBCLientName specified. You must specify exactly one FBClientName. It cannot be omitted. 6. You can specify multiple FBVolumeNames if condition 5 is satisfied. 7. You must always specify the FBReposLocation option for Linux.
54
IBM Tivoli Storage Manager: Integration Guide for Tivoli Storage Manager FastBack
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | |
Examples
Command line:
dsmc backup fastback -fbpolicyname=Policy1,Policy2,Policy3 -fbserver=myFbServer -fbreposlocation=\\myFbServer.company.com\REP
Backs up all volumes for all FastBack clients found in policies Policy1, Policy2 and Policy3. To specify policies with spaces, enclose them in double quotation marks, for example:
-fbpolicyname="Policy 1,Policy2,Policy3"
Fbreposlocation
Linux Windows
Use the fbreposlocation option with the backup fastback or archive fastback commands. The fbreposlocation option specifies the location of the Tivoli Storage Manager FastBack repository for the Tivoli Storage Manager backup-archive client proxy to connect to issue Tivoli Storage Manager FastBack shell commands necessary to mount appropriate snapshots.
Linux
Linux It you specify the fbreposlocation option for a snapshot on the FastBack server, use the server_name@WORKGROUP format. Linux There are two ways to specify the FastBack repository location on the FastBack DR Hub.
v Specify the complete repository location via the option -fbreposlocation=\\ DR_Hub\rep_server. When using this format, "DR_Hub" is the FastBack DR Hub machine name and "rep_server" is the name of the replicated FastBack server repository on the DR Hub. v Specify the repository location using a combination of the -fbreposlocation and -fbbranch options. When using this format, specify the DR Hub repository the location via the option -fbreposlocation=DR_Hub@WORKGROUP, and specify the name of the replicated FastBack server repository on the DR Hub using the -fbranch option.
Windows On Windows systems, you do not need to specify the fbreposlocation option when the Tivoli Storage Manager backup-archive client is installed on a DR Hub server or a FastBack server workstation. When the Tivoli Storage Manager backup-archive client is installed on a dedicated client proxy, the repository location fbreposlocation option is required. Windows If you specify the fbreposlocation option for a FastBack DR Hub, specify only the base directory of the DR Hub repository with this option. Then use the fbbranch option to indicate the Branch ID of the server to back up. If you specify the fbreposlocation option for the FastBack server, use the format \\<fbserver>\REP. In this case, do not use the fbbranch option.
55
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | |
Linux If you use the format -fbr=\\<fbserver>\REP, specify two backslashes before <fbserver> and one backslash before REP when using the backup-archive client in interactive mode. If you are using this format as a Linux command dsmc backup fastback -fbr=\\\\<fbserver>\\REP, you must specify four backslashes before <fbserver> and two backslashes before REP. This is because the Linux shell interprets a backslash as an escape character; the first backslash is treated as an escape character for the following backslash.
Supported Clients
Linux
This option is valid for Linux x86/x86_64 clients. This option is valid for all Windows clients.
Windows
Options File
None. You can specify this option only on the command line. The server can also define or override this option.
Syntax
FBReposlocation repository_location
Parameters
repository_location Specifies the Tivoli Storage Manager FastBack repository location.
Examples
Linux
Command line:
dsmc backup fastback -fbpolicyname=Policy1 -fbclientname=fbclient1,fbclient2 -fbserver=myFbDrHub -fbreposlocation=\\myFbDrHub\rep_myFbServer
Note: Because Linux is supported only as a dedicated proxy configuration, a repository location is always required on Linux.
Linux
Command line:
dsmc backup fastback -fbpolicyname=Policy1 -fbclientname=fbclient1,fbclient2 -fbserver=myFbDrHub -fbreposlocation=myFbDrHub -fbbranch=rep_myFbServer
Note: Because Linux is supported only as a dedicated proxy configuration, a repository location is always required on Linux.
Windows
Command line: The fbreposlocation option is only required on a dedicated proxy machine. If the fbreposlocation option is specified on a machine where a FastBack server or FastBack DR Hub is installed, it is ignored. Use this command when the Tivoli Storage Manager dedicated proxy client is connecting to a remote Tivoli Storage Manager FastBack server repository:
dsmc backup fastback -fbpolicyname="Policy 1" -fbserver=myFbServer -fbreposlocation=\\myFbServer.company.com\REP
56
IBM Tivoli Storage Manager: Integration Guide for Tivoli Storage Manager FastBack
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | |
Windows
A repository location is required. myFbServer is the short host name of the machine where the FastBack server is installed. Command line: Use this command when the Tivoli Storage Manager dedicated proxy client is connecting to a remote repository on a Tivoli Storage Manager FastBack disaster recovery hub:
dsmc backup fastback -fbpolicyname="Policy 1" -fbserver=myFbServer -fbreposlocation=\\myfbdrhub.company.com\REP -fbbranch=aFbServerBranch
A repository location is required. The myFbServer parameter specifies the short host name of the Tivoli Storage Manager FastBack Server whose FastBack branch is specified using the FBBranch option. The fbbranch option specifies the branch ID of a FastBack server on the disaster recovery hub.
Fbserver
Linux Windows
Use the fbserver option with the backup fastback or archive fastback commands. The fbserver option specifies the short host name of the Tivoli Storage Manager FastBack server workstation that owns the repository specified by the fbreposlocation option. For a DR Hub, the fbserver option specifies the short name of the FastBack server workstation whose branch repository the Tivoli Storage Manager backup-archive client is connecting to. The fbserver option is a key to retrieving the necessary user credentials required to connect to the FastBack server repository or the DR Hub server repository for mount processing.
Supported Clients
Linux
This option is valid for Linux x86/x86_64 clients. This option is valid for all Windows clients.
Windows
Options File
Linux
None. You can specify this option only on the command line.
Windows None. You can specify this option only on the command line. The server can also define or override this option.
Syntax
-FBServer server_name
57
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | |
Parameters
server_name Specifies the short hostname of the machine on which a FastBack server is installed.
Examples
Linux
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 repository location is required. If you do not provide the repository location, the command will fail. The FastBack server name, -myfbserver, is the short host name of the FastBack server where the repository is located.
Linux
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 FastBack server name, -myFbDrHub is the short host name of the FastBack disaster recovery hub server where the repository is located The -fbreposlocation 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.
Linux
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
Windows
Command line: The Tivoli Storage Manager backup-archive client is running on a FastBack server machine whose short name is "myFbServer":
dsmc archive fastback -fbpolicyname=Policy1 -fbserver=myFbServer
Windows
Command line: The Tivoli Storage Manager backup-archive client is running on a Tivoli Storage Manager FastBack DR Hub machine and is connecting to a FastBack Server branch repository branch1. The short host name of the FastBack server is "myFbServer":
dsmc archive fastback -fbpolicyname=Policy1 -fbserver=myFbServer -fbbranch=branch1
58
IBM Tivoli Storage Manager: Integration Guide for Tivoli Storage Manager FastBack
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | |
Windows
Command line: The Tivoli Storage Manager backup-archive client is running on a dedicated proxy machine and is connecting to a remote FastBack server repository. The FastBack server is installed on a machine whose short name is "myFbServerMachine":
dsmc archive fastback -fbpolicyname=Policy1 -fbserver=myFbServerMachine -fbreposlocation=\\myFbServerMachine.company.com\Rep
Windows
Command line: The Tivoli Storage Manager backup-archive client is running on a dedicated proxy machine and is connecting to a remote Tivoli Storage Manager FastBack repository on a FastBack DR Hub. The FastBack Server with branch id "branch1" is installed on a machine whose short name is "myFbServer".
dsmc backup fastback -fbpolicyname=Policy1 -fbserver=myFbServer -fbreposlocation=\\myDrHubMachine.company.com\Rep -fbbranch=branch1
Fbvolumename
Linux Windows
Use the fbvolumename option with the backup fastback or archive fastback commands. The fbvolumename option is the name of one or more comma-separated Tivoli Storage Manager FastBack volumes to back up or archive from the backup proxy. Values for the fbvolumename option are not valid if more than one FastBack client is specified in the fbclientname option. If you specify multiple FastBack clients in the fbclientname option, you cannot specify values for the fbvolumename option.
Supported Clients
Linux
This option is valid for Linux x86/x86_64 clients. This option is valid for all Windows clients.
Windows
Options File
Linux
None. You can specify this option only on the command line.
Windows None. You can specify this option only on the command line. The server can also define or override this option.
Syntax
, (1) FBVolumename volume_name
59
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | |
Parameters
volume_name Specifies the name of the Tivoli Storage Manager FastBack volumes. You can specify up to 10 FastBack volume names. Important: When specifying the archive fastback or backup fastback command: 1. At least one FBpolicyName is always required. 2. You can specify up to 10 values for FBPolicyName, if no values are specified for both FBClientName and FBVolumeName. 3. When you specify a FBClientName value, there must be only one value for FBPolicyName. 4. You can specify up to 10 values for FBClientName if only one PolicyName is specified, and no values for FBVolumeName are specified. 5. When you specify the FBVolumeName option, you can have only one FBPolicy, and only one FBCLientName specified. You must specify exactly one FBClientName. It cannot be omitted. 6. You can specify multiple FBVolumeNames if condition 5 is satisfied. 7.
Linux
Examples
Linux
Command line:
dsmc backup fastback -fbpolicyname=Policy1 -fbclientname=client1 -fbvolumename=data1,data2 -fbserver=myFbDrHub -fbreposlocation=\\myFbDrHub\rep_server1
Backs up volumes data1 and data2 from FastBack client client1 found in policy Policy1.
Windows
Command line:
dsmc backup fastback -fbpolicyname=Policy1 -fbclientname=client1 -fbvolumename=c:,f: -fbserver=myFbServer -fbreposlocation=\\myFbServer.company.com\REP
Backs up volumes c: and f: from FastBack client Client1, found in policy Policy1.
Windows
Command line:
dsmc archive fastback -fbpolicyname=Policy1 -fbclientname=client1 -fbvolumename=c:,f: -fbserver=myFbServer -fbreposlocation=\\myFbServer.company.com\REP
Archives volumes C: and F: from FastBack client Client1, found in policy Policy1.
60
IBM Tivoli Storage Manager: Integration Guide for Tivoli Storage Manager FastBack
Accessibility features
The following list includes the major accessibility features in Tivoli Storage Manager: v Keyboard-only operation v Interfaces that are commonly used by screen readers v Keys that are discernible by touch but do not activate just by touching them v Industry-standard devices for ports and connectors v The attachment of alternative input and output devices v User documentation provided in HTML and PDF format. Descriptive text is provided for all documentation images. The Tivoli Storage Manager Information Center, and its related publications, are accessibility-enabled.
Keyboard navigation
Windows The Tivoli Storage Manager for Windows Console follows Microsoft conventions for all keyboard navigation and access. Drag and Drop support is managed using the Microsoft Windows Accessibility option known as MouseKeys. For more information about MouseKeys and other Windows accessibility options, please refer to the Windows Online Help (keyword: MouseKeys). Linux Tivoli Storage Manager follows Linux operating-system conventions for keyboard navigation and access.
Vendor software
Tivoli Storage Manager includes certain vendor software that is not covered under the IBM license agreement. IBM makes no representation about the accessibility features of these products. Contact the vendor for the accessibility information about its products.
61
62
IBM Tivoli Storage Manager: Integration Guide for Tivoli Storage Manager FastBack
Notices
This information was developed for products and services offered in the U.S.A. IBM may not offer the products, services, or features discussed in this document in other countries. Consult your local IBM representative for information on the products and services currently available in your area. Any reference to an IBM product, program, or service is not intended to state or imply that only that IBM product, program, or service may be used. Any functionally equivalent product, program, or service that does not infringe any IBM intellectual property right may be used instead. However, it is the user's responsibility to evaluate and verify the operation of any non-IBM product, program, or service. IBM may have patents or pending patent applications covering subject matter described in this document. The furnishing of this document does not grant you any license to these patents. You can send license inquiries, in writing, to: IBM Director of Licensing IBM Corporation North Castle Drive Armonk, NY 10504-1785 U.S.A. For license inquiries regarding double-byte character set (DBCS) information, contact the IBM Intellectual Property Department in your country or send inquiries, in writing, to: Intellectual Property Licensing Legal and Intellectual Property Law IBM Japan Ltd 1623-14, Shimotsuruma, Yamato-shi Kanagawa 242-8502 Japan The following paragraph does not apply to the United Kingdom or any other country where such provisions are inconsistent with local law: INTERNATIONAL BUSINESS MACHINES CORPORATION PROVIDES THIS PUBLICATION AS IS WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESS OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF NON-INFRINGEMENT, MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE. Some states do not allow disclaimer of express or implied warranties in certain transactions, therefore, this statement may not apply to you. This information could include technical inaccuracies or typographical errors. Changes are periodically made to the information herein; these changes will be incorporated in new editions of the publication. IBM may make improvements and/or changes in the product(s) and/or the program(s) described in this publication at any time without notice. Any references in this information to non-IBM Web sites are provided for convenience only and do not in any manner serve as an endorsement of those Web sites. The materials at those Web sites are not part of the materials for this IBM product and use of those Web sites is at your own risk.
Copyright IBM Corp. 2010
63
IBM may use or distribute any of the information you supply in any way it believes appropriate without incurring any obligation to you. Licensees of this program who wish to have information about it for the purpose of enabling: (i) the exchange of information between independently created programs and other programs (including this one) and (ii) the mutual use of the information which has been exchanged, should contact: IBM Corporation 2Z4A/101 11400 Burnet Road Austin, TX 78758 U.S.A. Such information may be available, subject to appropriate terms and conditions, including in some cases, payment of a fee. The licensed program described in this information and all licensed material available for it are provided by IBM under terms of the IBM Customer Agreement, IBM International Program License Agreement, or any equivalent agreement between us. Information concerning non-IBM products was obtained from the suppliers of those products, their published announcements or other publicly available sources. IBM has not tested those products and cannot confirm the accuracy of performance, compatibility or any other claims related to non-IBM products. Questions on the capabilities of non-IBM products should be addressed to the suppliers of those products. This information contains examples of data and reports used in daily business operations. To illustrate them as completely as possible, the examples include the names of individuals, companies, brands, and products. All of these names are fictitious and any similarity to the names and addresses used by an actual business enterprise is entirely coincidental. If you are viewing this information in softcopy, the photographs and color illustrations may not appear.
Trademarks
IBM, the IBM logo, and ibm.com are trademarks or registered trademarks of International Business Machines Corporation in the United States, other countries, or both. If these and other IBM trademarked terms are marked on their first occurrence in this information with a trademark symbol ( or ), these symbols indicate U.S. registered or common law trademarks owned by IBM at the time this information was published. Such trademarks may also be registered or common law trademarks in other countries. A current list of IBM trademarks is available on the Web at "Copyright and trademark information" at http://www.ibm.com/legal/ copytrade.shtml. Adobe is either a registered trademark or trademark of Adobe Systems Incorporated in the United States, other countries, or both. Intel and Itanium are trademarks or registered trademarks of Intel Corporation or its subsidiaries in the United States and other countries.
64
IBM Tivoli Storage Manager: Integration Guide for Tivoli Storage Manager FastBack
Java and all Java-based trademarks are trademarks of Sun Microsystems, Inc. in the United States, other countries, or both. Linux is a registered trademark of Linus Torvalds in the United States, other countries, or both. Microsoft, Windows, Windows NT, and the Windows logo are trademarks of Microsoft Corporation in the United States, other countries, or both. UNIX is a registered trademark of The Open Group in the United States and other countries. Other company, product, or service names may be trademarks or service marks of others.
Notices
65
66
IBM Tivoli Storage Manager: Integration Guide for Tivoli Storage Manager FastBack
Printed in USA
SC27-2828-01