Tivoli Storage Manager for Windows: Administrator's Reference

DEFINE DRIVEMAPPING (Define Drive Mapping)

Use this command to define a drive mapping that allows a client system to send data directly to a device on a storage area network (SAN) through the storage agent. The storage agent uses the drive mapping to perform LAN-free data transfer. You must first define the drive to the server and then define a drive mapping for each |storage agent using LAN-free data transfer. For additional information, see Administrator's Guide and TSM Managed System for SAN Storage Agent User's Guide.

Note:
|Defining drive mapping with the DEFINE DRIVEMAPPING command is |equivalent to defining a path from the storage agent to the drive with the |DEFINE PATH command. The DEFINE PATH command is intended to replace the |DEFINE DRIVEMAPPING command. |

Privilege Class

To issue this command, you must have system privilege or unrestricted storage privilege.

Syntax

>>-DEFine DRIVEMapping--storage_agent_name--library_name--drive_name-->
 
                               .-ONLINE--=--Yes-----.
>--DEVIce--=--+-device_name-+--+--------------------+----------->
              '-FILE--------'  '-ONLINE--=--+-Yes-+-'
                                            '-No--'
 
   .-DIRectory--=--current_directory_name-.
>--+--------------------------------------+--------------------><
   '-DIRectory--=----directory_name-------'
 
 

Parameters

storage_agent_name (Required)
Specifies the name of the storage agent. Before issuing this command, define the storage agent as a server using the DEFINE SERVER command.
Note:
The name used for the storage agent must match the name that was defined when the storage agent was installed.

library_name (Required)
Specifies the name of the library to which the drive is defined. This parameter is required for all drives, including stand-alone drives.
Note:
This command only applies to shared SCSI, 349X, and FILE libraries. For a FILE library, disk storage must be shared by means of Tivoli SANergy Version 2.2.

drive_name (Required)
Specifies the drive name being mapped to the storage agent.

DEVIce (Required)
Specifies the device name used to access the drive from the storage agent. The name the storage agent uses must be specified here. For a FILE device, the device name is FILE.
Note:
The device name must follow the protocol of the platform on which the storage agent resides.

ONLine
Specifies the drive availability for the storage agent. The default is YES.

Yes
Specifies that the drive is available for use.

No
Specifies that the drive is not available for use.

|DIRectory
|Specifies the directory location of the files used by the storage agent |which is sharing access. It is only valid for drives in FILE |libraries. This parameter is optional.

|The directory name identifies the location where the storage agent reads |and writes the files that represent storage volumes for the FILE device class |that is associated with the FILE library. The default value for |DIRECTORY is the directory of the server at the time the command is issued, |unless the DSMSERV_DIR environment variable has been set. In most |cases, the default value for DIRECTORY will not be useful because the |directory location can vary among systems accessing the same data on the |SAN.

|Use a naming convention that allows you to associate the directory with a |particular physical drive. This can help ensure that your configuration |is valid for sharing the FILE library between the server and storage |agent. If the storage agent is on a Windows NT or Windows 2000 system, |use a universal naming convention (UNC) name.

|Note:
Tivoli Storage Manager does not create shares or permissions, or mount the |target file system. You must perform these actions before starting the |storage agent. |

|For information about the DSMSERV_DIR variable, refer to Quick |Start.

Examples

Tasks

Let storage agent SA1 access TAPEDRIVE3 on the SAN. The tape drive is in the shared library, SHARELIB. The device name is mt1.0.0.1. Specify that the drive will be online.

Command:
define drivemapping sa1 sharelib tapedrive3 
device=mt1.0.0.1 online=yes

A FILE device, FILE11, is defined to library FILE1 on the TSM server. Let storage agent SA1 access FILE11 whose data on the TSM server resides in e:\tsmdata\server1. On the storage agent, this data appears in directory d:\tsmdata\server1.

Command:
define drivemapping sa1 file1 file11 device=file online=yes dir="d:\tsmdata\server1"

Related Commands

Table 66. Commands Related to DEFINE DRIVEMAPPING

Command Description
DEFINE DEVCLASS Defines a device class.
DEFINE DRIVE Assigns a drive to a library.
DEFINE LIBRARY Defines an automated or manual library.
DELETE DRIVEMAPPING Deletes the drive name that was mapped to the storage agent for direct storage and retrieval of data.
DEFINE SERVER Defines a server for server-to-server communications.
QUERY DRIVE Displays information about drives.
QUERY DRIVEMAPPING Displays the device name mapping that was created with the DEFINE DRIVEMAPPING command.
QUERY LIBRARY Displays information about one or more libraries.
UPDATE DRIVE Changes the attributes of a drive.
UPDATE DRIVEMAPPING Updates the drive name that was mapped to the storage agent allowing for direct storage and retrieval of data.


[ Top of Page | Previous Page | Next Page | Table of Contents | Index ]