Administrator's Reference

IMPORT NODE (Import Client Node Information)

Use the IMPORT NODE command to import client node definitions from the ADSM server to sequential media. Client node definitions include information such as:

• User ID, password, and contact information
• Name of the policy domain to which the client belongs
• File compression status
• Whether the user has the authority to delete backed up or archive files from data storage
• Whether the client node ID is locked from server access

Optionally, the IMPORT NODE command imports node data information such as:

• File space definitions
• Access authorization information pertaining to the file spaces imported.
• Backed up, archived, and space-managed files

The IMPORT NODE command allows node information to be copied to another server. In order to copy ADSM data and then restore it to a new server, the sequential device must be supported on both platforms.

You can use the QUERY ACTLOG command to view the actual status information indicating the size and the success or failure of the import operation. You can also view this information from the server console.

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

Privilege Class

To issue this command, you must have system privilege.

Syntax

>>-IMport Node---+------------------+--------------------------->
                 |  .-,----------.  |
                 |  V            |  |
                 '----nodename---+--'
 
>---+-----------------------------------------+----------------->
    |            .-,----------------------.   |
    |            V                        |   |
    '-FILESpace=-----+---------------+----+---'
                     '-filespacename-'
 
>---+------------------------------------+---------------------->
    |          .-,-------------------.   |
    |          V                     |   |
    '-DOmains=-----+------------+----+---'
                   '-domainname-'
 
    .-FILEData--=--None--------------.  .-Preview--=--No-------.
>---+--------------------------------+--+----------------------+>
    '-FILEData--=--+-ALl----------+--'  '-Preview--=--+-No--+--'
                   +-None---------+                   '-Yes-'
                   +-ARchive------+
                   +-Backup-------+
                   +-BACKUPActive-+
                   +-ALLActive----+
                   '-SPacemanaged-'
 
                            .-Dates--=--Absolute------.
>----DEVclass=devclassname--+-------------------------+--------->
                            '-Dates--=--+-Absolute-+--'
                                        '-Relative-'
 
                        .-,--------.
                        V          |
>----VOLumenames--=--+---volname---+--+------------------------->
                     '-FILE:filename--'
 
    .-Replacedefs--=--No-------.
>---+--------------------------+-------------------------------><
    '-Replacedefs--=--+-No--+--'
                      '-Yes-'
 

Parameters

nodename

Specifies the name of a client node for which you want to import client node information. This parameter is optional.

You can specify a list of node names for which node information is to be imported. The items in the list are separated by commas, with no intervening spaces. You can use pattern-matching expressions to specify names. All matching nodes are included in the list. If you do not specify a value for this parameter, information related to all nodes is imported.

FILESpace=filespacename

Specifies the name of a file space for which you want import file space information. This parameter is optional.

You can specify a list of file space names for which data information is to be imported. The items in the list are separated by commas, with no intervening spaces. You can use a pattern-matching expression to specify a name. All matching names are included in the list. If you do not specify a value for this parameter, information related to all files space names is imported.

Note:

Existing file spaces are not replaced. New file spaces are created when identical names are encountered.

DOmains=domainname

Specifies the names of the policy domains to which nodes must be assigned in order for node information to be imported. This parameter is optional.

You can specify a list of policy domains from which node information is to be imported. The items in the list are separated by commas, with no intervening spaces. You can use a pattern-matching expression to specify a name. If you do not specify a value for this parameter, node information related to all domains is imported.

FILEData=type

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, then two drives are needed to import the node information. The mount limit value for the device class needs to be set to 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. Possible values are:

ALl

Specifies that ADSM imports all backup versions of files, all archived files, and all files migrated from a user's local file system.

None

Specifies that no files are to be imported; only node definitions are to be imported.

ARchive

Specifies that only archived files are to be imported.

Backup

Specifies that only backup versions, whether active or inactive, are to be imported.

BACKUPActive

Specifies that only active backup versions are to be imported.

ALLActive

Specifies that ADSM imports all active backup versions of files, all archived files, and all files migrated from a user's local file system.

SPacemanaged

Specifies that only files that have been migrated from a user's local file system (space-managed files) are to be imported.

Preview=value

Specifies whether you want to preview the results of the import operation, without actually importing information. For the import commands, the PREVIEW=YES option will require that all export volumes be mounted to generate the preview statistics. 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 actually importing files. Information on the number and types of objects imported, together with the number of bytes transferred are reported to the server console and the activity log.

DEVclass=devclassname

Specifies the device class from which import data is to be read. You cannot specify the DISK device class. This parameter is required.

If the mount limit for the device class specified has already been reached (all drives are busy) when the import runs, ADSM automatically cancels lower priority operations, such as reclamation, to make a mount point available for the import operation.

Dates=value

Specifies whether the recorded backup or archive dates for client node file copies are set to the values specified when the files were exported (Absolute), or are adjusted relative 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 roll-off 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 rolled off.

For example, assume that an export tape contains an archive file copy that was archived 5 days prior to the export operation. If the export media is 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 roll-off depending upon 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, even though the actual file was archived six months and 5 days ago. 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

Specifies the date for file copies are set to the values specified when the files were exported.

Relative

Specifies the date for file copies are adjusted to the date of import.

VOLumenames=volumespec

Specifies the volumes that are to be used for the import operation. Volumes must be imported in the same order as they were exported. This parameter is required.

Use the following naming conventions when specifying volumes for each device type.

FILE

Specify any supported file name, directory, or fully qualified directory, for example /exadata/mt1.

OPTICAL, WORM, WORM12, or WORM14

Specify 1-32 alphanumeric characters.

SERVER

Specify 1-250 alphanumeric characters.

3570, 3590, 4MM, 8MM, CARTRIDGE, DLT, DTF, GENERICTAPE, or QIC

Specify 1-6 alphanumeric characters.

Possible values are:

volname

Specifies the names of one or more volumes used for the imported data. You can specify more than one volume by separating each volume with a comma, with no intervening spaces.

For example, to use volumes TAPE01, TAPE02, TAPE03, specify the following:

VOLUMENAMES=TAPE01,TAPE02,TAPE03

FILE:filename

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 lines and comments lines that begin with an asterisk are ignored.

For example, to use volumes TAPE01, TAPE02, and TAPE03, create a file named TAPEVOL that contains these lines:

TAPE01
TAPE02
TAPE03

You can then specify the volumes for the command as follows:

VOLUMENAMES=FILE:TAPEVOL

Replacedefs=value

Specifies whether node definitions that exist on the server should be replaced by imported objects having the same name. Existing file spaces are not replaced. New file spaces are created when identical file space names are encountered. The default value is NO. Possible values are:

No

Specifies that objects are not to be replaced by imported objects.

Yes

Specifies that objects are to be replaced by the imported objects.

Examples

Task

From a server, import the node definitions and active backup data for all nodes defined in the STANDARD policy domain to tape volume VOL04. Specify that this tape volume be read by a device assigned to the DEPT device class.

The number and type of objects imported are reported to the server console and in the activity log.

Command:

import node domains=standard filedata=backupactive devclass=dept volumenames=vol04

Related Commands

Table 105. 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	Searches for and displays messages from the server activity log.
QUERY PROCESS	Displays information about one or all background server processes.