Tivoli Header

Administrator's Reference

UPDATE PATH (Change a Path)

Use this command to update a path definition.

Privilege Class

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

Syntax



When the destination is a drive

>>-UPDate PATH--source_name--destination_name------------------->
 
>--SRCType--=--+-DATAMover-+--DESTType--=--DRive---------------->
               '-SERVer----'
 
>--LIBRary--=--library_name--+------------------------+--------->
                             '-DEVice--=--device_name-'
 
>--+--------------------+--+------------------------------+----><
   '-ONLine--=--+-Yes-+-'  '-DIRectory--=--directory_name-'
                '-No--'
 
 

Syntax



When the destination is a library

>>-UPDate PATH--source_name--destination_name------------------->
 
>--SRCType--=--+-DATAMover-+--DESTType--=--LIBRary-------------->
               '-SERVer----'
 
>--+-------------------------------+--+--------------------+---><
   |                        (1)    |  '-ONLine--=--+-Yes-+-'
   +-DEVice--=--device_name--------+               '-No--'
   '-EXTERNALManager--=--path_name-'
 
 

Notes:

  1. For 349X libraries, you can specify 1 to 8 device names with separating commas and no intervening spaces.

Parameters

source_name (Required)
Specifies the name of source for the path. This parameter is required.

destination_name (Required)
Specifies the name of the destination. This parameter is required. The destination can be a drive, or a library.

SRCType (Required)
Specifies the type of the source. This parameter is required. Possible values are:

DATAMover
Specifies that a data mover is the source.

SERVer
Specifies that a server or a storage agent is the source.

DESTType (Required)
Specifies the type of the destination. This parameter is required. Possible values are:

Specifies that a disk is the destination. The only valid source type is DATAMOVER. That is, SERVER is not allowed as a source type when the destination type is DISK.

DRive
Specifies that a drive is the destination. When the destination is a drive, you must specify a library name.

LIBRary
Specifies that a library is the destination.

LIBRary
Specifies the name of the library to which the drive is assigned. This parameter is required if DESTTYPE=DRIVE. The library and its drives must already be defined to the Tivoli Storage Manager server. If the path is from a NAS data mover to a drive, the drive must be assigned to a library that has LIBTYPE=SCSI.

DEVIce
Specifies the name of the device as known to the source, or FILE if the device is a logical drive in a FILE library. For 349X libraries, you can specify 1 to 8 device names with separating commas and no intervening spaces.

The source uses the device name to access the drive or library. See Table 324 for examples.

Table 324. Examples of Device Names

Source to destination Example
Server to a drive (not a FILE drive) mt3
Server to a library lb4.1
Storage agent to a drive (not a FILE drive) mt3
Storage agent to a drive when the drive is a logical drive in a FILE library FILE
NAS data mover to a library mc0
NAS data mover to a drive rst0l
Note:
For information about the device name when the source is a storage agent, see the Tivoli Storage Manager Managed System for SAN Storage Agent User's Guide. For information about how to obtain names for devices that are connected to a NAS file server, consult the product information for the file server. For example, for a Network Appliance file server, connect to the file server using telnet and issue the SYSCONFIG command. Use this command to determine device names for drives:
sysconfig -t

Use this command to determine the device name for a library:

sysconfig -m

EXTERNALManager
Specifies the location of the external library manager where Tivoli Storage Manager can send media access requests. This parameter is required when the library name is an external library.

ONLine
Specifies whether the path is available for use. This parameter is optional. The default is YES. Possible values are:

Yes
Specifies that the path is available for use.

No
Specifies that the path is not available for use.

The source and the destination must both be available to use the path. For example, if the path from a data mover to a drive is online, but either the data mover or the drive is offline, you cannot use the path.

Attention: If the path to a library is offline, the server will not be able to access the library. If the server is halted and restarted while the path to the library is offline, the library will not be initialized. See Administrator's Guide for additional information.

DIRectory
Specifies the directory location for a storage agent to access the files in a FILE library. This parameter is optional. This parameter is only valid when all of the following conditions are true:

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

Task

Update a path from a data mover that is a NAS file server to the drive TAPEDRV2 that the data mover uses for backup and restore operations. In this example, the NAS data mover is NAS1, the library is NASLIB, and the device name for the drive is rst0l.

Command:
update path nas1 tapedrv2 srctype=datamover desttype=drive library=naslib device=rst0l

Related Commands

Table 325. Commands Related to UPDATE PATH

Command Description
DEFINE LIBRARY Defines an automated or manual library.
DEFINE PATH Defines a path from a source to a destination.
DELETE PATH Deletes a path from a source to a destination.
QUERY PATH Displays information about the path from a source to a destination.


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