Tivoli Storage Manager for Windows: Administrator's Reference

IMPORT NODE (Import Client Node Information)

|Use this command to import client node definitions from sequential |media to a target Tivoli Storage Manager server. The imported nodes are |associated with the same policy domain as they were on the source server, if |you specify the domain and if that policy domain exists on the target |server. Otherwise, imported nodes are associated with the STANDARD |policy domain on the target server.

You can use the QUERY ACTLOG command to view the status of the import operation. You can also view this information from the server console.

This command generates a background process that can be cancelled with the CANCEL PROCESS command. If an IMPORT NODE background process is cancelled, some of the data may already be imported. To display information on background processes, use the QUERY PROCESS command.

For a server that has clients with support for Unicode, you may need to have the server convert the file space name that you enter, or use the:

Privilege Class

To issue this command, you must have system privilege.

Syntax

                .-*-------------.
>>-IMport Node--+---------------+------------------------------->
                |.-,---------.  |
                |V           |  |
                '--node_name-+--'
 
>--+--------------------------------+--------------------------->
   |            .-,---------------. |
   |            V                 | |
   '-FILESpace=---file_space_name-+-'
 
>--+------------------------------------+----------------------->
   |                .-,---------------. |
   |                V                 | |
   '-HEXFILESpace-=---file_space_name-+-'
 
>--+------------------------------------+----------------------->
   |                .-,---------------. |
   |                V                 | |
   '-UNIFILESpace-=---file_space_name-+-'
 
>--+--------------------------+--------------------------------->
   |          .-,-----------. |
   |          V             | |
   '-DOmains=---domain_name-+-'
 
   .-FILEData--=--None-------------.  .-Preview--=--No------.
>--+-------------------------------+--+---------------------+--->
   '-FILEData--=--+-ALl----------+-'  '-Preview--=--+-No--+-'
                  +-None---------+                  '-Yes-'
                  +-ARchive------+
                  +-Backup-------+
                  +-BACKUPActive-+
                  +-ALLActive----+
                  '-SPacemanaged-'
 
                               .-Dates--=--Absolute-----.
>--DEVclass=device_class_name--+------------------------+------->
                               '-Dates--=--+-Absolute-+-'
                                           '-Relative-'
 
                     .-,-----------.
                     V             |
>--VOLumenames--=--+---volume_name-+-+-------------------------->
                   '-FILE:file_name--'
 
   .-Replacedefs--=--No------.
>--+-------------------------+---------------------------------><
   '-Replacedefs--=--+-No--+-'
                     '-Yes-'
 
 

Parameters

node_name
Specifies the client nodes for which you want to import information. This parameter is optional.

Separate multiple names with commas and no intervening spaces. You can use wildcard characters to specify names. All matching nodes are included in the list.

FILESpace
Specifies file space names for which you want to import information. This parameter is optional. The default is all file spaces.

Separate multiple names with commas and no intervening spaces. You can use wildcard characters to specify names.

Note:
Existing file spaces are not replaced. New file spaces are created when identical names are encountered. However, this new name may match an existing name on the client node, which may have file spaces not yet backed up to the server.

DOmains
|Specifies the policy domains from which to import node |information. These domains must have been included in the data that was |exported. This parameter is optional. The default is all domains |that were exported.

|Separate multiple names with commas and no intervening spaces. You |can use wildcard characters to specify a name.

FILEData
Specifies the type of files that should be imported for all nodes specified and found on the export media. This parameter is optional. The default value is NONE.

The device class used by the file data is determined by the device class for the storage pool. If it is the same device class specified in this command, two drives are needed to import the node information. The mount limit for the device class must be at least 2.

The following descriptions mention active and inactive backup file copies. An active backup file copy is the most recent backup copy for a file that still exists on the client workstation. All other backup file copies are called inactive copies. The values are:

ALl
The server imports all backup versions of files, all archived files, and all space-managed files.

None
Only node definitions are imported. The server does not import any files.

ARchive
The server imports only archived files.

Backup
The server imports only backup versions, whether active or inactive.

BACKUPActive
The server imports only active backup versions.

ALLActive
The server imports all active backup versions of files, all archived files, and all space-managed files.

SPacemanaged
The server imports only space-managed files.

Preview
Specifies whether to preview the results of the import operation, without importing information. The PREVIEW=YES option requires that you mount the export volumes. This parameter is optional. The default value is NO. Possible values are:

No
Specifies that the node information is to be imported.

Yes
Specifies that you want to preview the results of the import operation, without importing files. Information is reported to the server console and the activity log.

DEVclass (Required)
Specifies the device class from which import data is to be read. |You cannot specify the DISK device class or a device class with a |device type of NAS.

If all drives for the device class are busy when the import runs, the server cancels lower priority operations, such as reclamation, to make a drive available.

Dates
Specifies whether the date of the file copies are as specified when the files were exported (ABSOLUTE), or are adjusted to the date of import (RELATIVE). The default value is ABSOLUTE.

If the export media has been idle for some time after export (sitting on a shelf for six months, for example), the original backup or archive dates may be old enough to trigger immediate expiration of file copies when the data is imported into a server. The RELATIVE specification for this value will adjust for time elapsed since export so that the file copies are not immediately expired.

For example, assume that an export tape contains an archive file copy that was archived 5 days before the export operation. If the media are saved for 6 months and then imported, the archive file will appear to have been inserted six months and 5 days ago by default (DATES=ABSOLUTE) and may be subject to immediate expiration depending on the retention value that is specified in the file's management class. Specifying DATES=RELATIVE will result in resetting the archive date for the file to 5 days ago during import. The DATES=RELATIVE parameter thus adjusts file backup and archive dates for the time that has elapsed since the export operation occurred.

Possible values are:

Absolute
The dates for file copies are set to the values specified when the files were exported.

Relative
The dates for file copies are adjusted to the date of import.

VOLumenames (Required)
Specifies the volumes to be used for the import operation. Volumes must be imported in the same order as they were exported. The values are:

volume_name
Specifies the volume name. To specify multiple volumes, separate the names with commas and no intervening spaces.

FILE:file_name
Specifies the name of a file that contains a list of volumes used for the imported data. In the file, each volume name must be on a separate line. Blank and comment lines that begin with an asterisk are ignored.

Use these naming conventions when specifying volumes associated with the following device types:

For this device Specify
Tape 1 - 6 alphanumeric characters.
FILE Any fully qualified file name string. For example, d:\program files\tivoli\tsm\data1.dsm.
OPTICAL 1-32 alphanumeric characters.
REMOVABLEFILE 1-6 alphanumeric characters.
SERVER 1-250 alphanumeric characters.

Replacedefs
Specifies whether to replace definitions on the target server. The default value is NO. The values are:

No
Objects are not to be replaced.

Yes
Objects are to be replaced.

HEXFILESpace
Specifies the hexadecimal representation of the file space names in UTF-8 format. Separate multiple names with commas and no intervening spaces. This parameter is optional.

To view the hexadecimal representation of a file space name, you can use the QUERY FILESPACE command with FORMAT=DETAILED.

UNIFILESpace
Specifies the file spaces that are known to the server to be Unicode enabled. The server converts the names you enter from the server code page to the UTF-8 code page to find the file spaces to import. The success of the conversion depends on the actual characters in the name and the server's code page. Separate multiple names with commas and no intervening spaces. This parameter is optional.

Examples

Task 1

From the server, import client node information from tape volumes TAPE01, TAPE02, and TAPE03. Specify that these tape volumes be read by a device assigned to the MENU1 device class.

Command:
import node devclass=menu1 volumenames=tape01,tape02,tape03

Task 2

From the server, import client node information from tape volumes listed in a file named TAPEVOL.DATA. This file contains these lines:

TAPE01
TAPE02
TAPE03

Specify that these tape volumes be read by a device assigned to the MENU1 device class.

Command:
import node devclass=menu1 volumenames=file:tapevol.data

Task 3

From the server, import the active backup versions of file data for client node JOE to tape volume TAPE01. The file space is Unicode.

Command:
import node joe unifilespace=\\joe\c$ filedata=backupactive devclass=menu1 volumenames=tape01

Related Commands

Table 144. Commands Related to IMPORT NODE

Command Description
CANCEL PROCESS Cancels a background server process.
EXPORT NODE Copies client node information to external media.
IMPORT ADMIN Restores administrative information from external media.
IMPORT POLICY Restores policy information from external media.
IMPORT SERVER Restores all or part of the server from external media.
QUERY ACTLOG Displays messages from the server activity log.
QUERY PROCESS Displays information about background processes.


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