Tivoli Header

Administrator's Reference

DEFINE DATAMOVER (Define a Data Mover)

Use this command to define a data mover. A data mover is a named device that accepts a request from Tivoli Storage Manager to transfer data and can be used to perform outboard copy operations. Please refer to the documentation on your device for guidance on specifying the parameters for this command.

Privilege Class

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

Syntax



DEFINE DATAMOVER type = NAS

>>-DEFine DATAMover--data_mover_name--Type--=--NAS-------------->
 
                          .-LLAddress--=--10000----.
>--HLAddress--=--address--+------------------------+------------>
                          '-LLAddress--=--tcp_port-'
 
>--USERid--=--userid--PASsword--=--password--------------------->
 
   .-ONLine--=--Yes-----.
>--+--------------------+--DATAFormat--=--NETAPPDump-----------><
   '-ONLine--=--+-Yes-+-'
                '-No--'
 
 

Syntax



DEFINE DATAMOVER type = SCSI

>>-DEFine DATAMover--data_mover_name--Type--=--SCSI------------->
 
>--WWN--=--world_wide_name--SERial--=--serial_number------------>
 
                            .-COPYThreads--=--1------.
>--DATAFormat--=--NONblock--+------------------------+---------->
                            '-COPYThreads--=--number-'
 
   .-ONLine--=--Yes-----.
>--+--------------------+--------------------------------------><
   '-ONLine--=--+-Yes-+-'
                '-No--'
 
 

Parameters

data_mover_name (Required)

NAS: Specifies the name of the data mover. This name must be the same as a node name that you previously registered using the REGISTER NODE TYPE=NAS command. The data that is backed up from this NAS data mover will be assigned to this node name in the server database. A maximum of 30 characters can be used to specify the name.

SCSI: Specifies a name that you want to assign to the data mover. The name is used in relating the data mover to disk or drives that the data mover can access in server-free data movement operations. A maximum of 30 characters can be used to specify the name.

Type (Required)
Specifies the type of data mover being used. The choices are:

NAS
Specifies that the type of data mover is a NAS file server.

SCSI
Specifies that the data mover is a SCSI device being defined that will be used for server-free data movement.

WWN (Required)
Specifies the Fibre Channel world wide name for the data mover device. The WWN must be 16 characters long. This parameter is required if the type of data mover is SCSI.

SERial (Required)
Specifies the serial number of the data mover. The serial number can be a maximum of 64 characters. This parameter is required if the type of data mover is SCSI.

HLAddress (Required)
Specifies either the numerical IP address or the domain name, which are used to access the NAS file server.
Note:
This parameter only applies to NAS data movers.

LLAddress
Specifies the TCP port number to access the NAS device for Network Data Management Protocol (NDMP) sessions. This parameter is optional. The default value is 10000.
Note:
This parameter only applies to NAS data movers.

USERid (Required)
Specifies the user ID for a user that is authorized to initiate an NDMP session with the NAS file server. For example, enter the administrative ID for a Network Appliance file server.
Note:
This parameter only applies to NAS data movers.

PASsword (Required)
Specifies the password for the user ID to log onto the NAS file server.
Note:
This parameter only applies to NAS data movers.

COPYThreads
Specifies the number of concurrent copy operations that the data mover can support. The default value is 1. Please refer to the documentation for your device to obtain the maximum value. The number must be greater than 0.
Note:
This parameter is used to govern how many copy commands can run concurrently on a server at any one time. If other programs or servers will be using the extended copy capabilities of the data mover device, you may want to specify fewer than the maximum number of concurrent copy commands supported by the device for this parameter.

ONLine
Specifies whether the data mover is available for use. This parameter is optional. The default is YES.

Yes
The default value. Specifies that the data mover is available for use.

No
Specifies that the data mover is not available for use.

Attention: If a library is controlled using a path from a NAS data mover to the library, and the NAS data mover is offline, the server will not be able to access the library. If the server is halted and restarted while the NAS data mover is offline, the library will not be initialized. This only applies to NAS data movers.

Note:
When the hardware is being maintained you can use the UPDATE DATAMOVER command to set the data mover off-line.

DATAFormat (Required)
Specifies the data format that is used by this data mover. The choices are:

NETAPPDump
NETAPPDUMP must be used for NAS devices.

NONblock
NONblock must be used for SCSI-type data movers.

Examples

Task

Define a data mover for the NAS node named NAS1. The numerical IP address for the data mover is 9.67.97.103, at port 10000.

Command:
define datamover nas1 type=nas hladdress=9.67.97.103 lladdress=10000 userid=root password=admin dataformat=netappdump

Task

Define a data mover for the node named NAS1. The domain name for the data mover is, NETAPP2.TUCSON.IBM.COM at port 10000.

Command:
define datamover nas1 type=nas hladdress=netapp2.tucson.ibm.com lladdress=10000 userid=root password=admin dataformat=netappdump

Task

Define a data mover for server-free data movement named SERVERFREE1 that can support 4 concurrent copies. The world wide name of the data mover is 20030060450d00e2. The serial number of the data mover is 14652.

Command:
define datamover serverfree1 type=scsi wwn=20030060450d00e2 serial=14652 dataformat=nonblock copythreads=4 online=yes

Related Commands

Table 47. Commands Related to DEFINE DATAMOVER

Command Description
DEFINE PATH Defines a path from a source to a destination.
DELETE DATAMOVER Deletes a data mover.
QUERY DATAMOVER Displays data mover definitions.
REGISTER NODE Defines a client to the server and sets options for that user.
UPDATE DATAMOVER Changes the definition for a data mover.


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