Tivoli Storage Manager for Windows: Administrator's Reference

|UPDATE PATH (Change a Path)

| | |

|

|Use this command to update a path between a source and a |destination.

|Privilege Class

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

|Syntax


|
|

When the destination is adrive

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

>>-UPDate PATH--source_name--destination_name------------------->
 
>--SRCType--=--DATAMover--DESTType--=--LIBRary------------------>
 
>--+------------------------+--+--------------------+----------><
   '-DEVice--=--device_name-'  '-ONLine--=--+-Yes-+-'
                                            '-No--'
 
 

|Parameters |

|source_name (Required)
|Specifies the name of the source. |

|destination_name (Required)
|Specifies the name of the destination. The destination is either a |drive or a library.

|SRCType (Required)
|Specifies the type of the source. Possible values are: |

|DATAMover
|Specifies that a data mover is the source.

|SERVer
|Specifies that a storage agent is the source. |

|DESTType (Required)
|Specifies the type of the destination. Possible values are: |

|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. If the DESTTYPE is DRIVE, this parameter is |required.

|DEVIce
|Specifies the name of the device as known to the source. The |source uses the device name to access the drive or library. This |parameter is optional.

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

|Table 326. Examples of Device Names

Source to destination Example
Storage agent to a drive (not a FILE drive) mt3
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
|

|ONLine
|Specifies whether the path is available for use. This parameter is |optional. 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, |and 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 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

|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 327. Commands Related to UPDATE PATH

Command Description
DEFINE DATAMOVER Defines a data mover to the Tivoli Storage Manager server.
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.
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.
UPDATE DATAMOVER Changes the definition for a data mover.


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