Tivoli Storage Manager for Windows: Administrator's Reference

UPDATE DRIVEMAPPING (Update Drive Mapping)

Use this command to update the device name mapping or the availability of a device shared between the server and a specified storage agent. For additional information, see Administrator's Guide and TSM Managed System for SAN Storage Agent User's Guide.

Privilege Class

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

Syntax

>>-UPDate DRIVEMapping--storage_agent_name--library_name--drive_name-->
 
>--+----------------------------+--+--------------------+------->
   '-DEVIce--=--+-device_name-+-'  '-ONLINE--=--+-Yes-+-'
                '-FILE--------'                 '-No--'
 
>--+----------------------------------+------------------------><
   '-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 that will be mapped to the storage agent.

DEVIce
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, use a device name of 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.

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

Examples

Task

Inform the server that TAPEDRIVE3 will be updated for the storage agent, SA1. The tape drive is in the shared library, SHARELIB, and the device name is mt1.0.0.1. Specify that the drive will be offline.

Command:
update drivemapping sa1 sharelib tapedrive3 
device=mt1.0.0.1 online=no

Task

Change the directory by which storage agent SA1 accesses data in file library FILE1 because SA1 uses d:\tsm to access the same directory that the server accesses by directory e:\tsm. This directory has a mount limit of 4.

Command:
 update drivemapping sa1 file1 file11 directory=d:\tsm 
 update drivemapping sa1 file2 file12 directory=d:\tsm
 update drivemapping sa1 file3 file13 directory=d:\tsm
 update drivemapping sa1 file4 file14 directory=d:\tsm

Related Commands

Table 320. Commands Related to UPDATE DRIVEMAPPING

Command Description
DEFINE DRIVE Assigns a drive to a library.
DEFINE DRIVEMAPPING Defines the drive name that will be mapped to the storage agent allowing for direct storage and retrieval of data.
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.
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 DEVCLASS Changes the attributes of a device class.
UPDATE DRIVE Changes the attributes of a drive.


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