IBM Tivoli Storage Manager, Version 7.1

IMPORT ADMIN (Import administrator information)

Use this command to import administrator and authority definitions for one or more administrators from export media to the Tivoli® Storage Manager server.

Important: For commands that import administrators or nodes, you must consider the method of authentication. The Tivoli Storage Manager server cannot export or import passwords for nodes or administrators that are authenticating with LDAP directory servers. If the current authentication method uses an LDAP directory server and the password is not already synchronized by that server, you must update the password. After issuing the IMPORT command, set the password by issuing the UPDATE ADMIN or UPDATE NODE command.

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.

Limitation: The Tivoli Storage Manager server does not convert code pages during export, import, and node replication operations. If servers are running in different locales, some information in databases or system output might become unreadable. Invalid characters might be displayed, for example, in the contact information for the administrator and client nodes, and in descriptions of policy domains. Any field that is stored in the server character set and that includes extended ASCII characters can be affected. To resolve the issue after the import or node replication operation, update the fields with the appropriate UPDATE commands. This server limitation does not affect client data. Any client data that was exported, imported, or replicated can be restored, retrieved, and recalled.

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

Restriction:

If target and source server levels are not compatible, the operation might not work. See the Administrator's Guide for server compatibility requirements.
If the administrator definition that is being imported includes analyst authority, the administrator definition is imported but not the analyst authority. Analyst authority is not valid for servers at V6.1 or later.
Importing data from a CENTERA device class is not supported. However, files that are being imported can be stored on a CENTERA storage device.

Privilege class

To issue this command, you must have system privilege.

Syntax


                 .-*--------------.  .-Preview--=--No------.   
>>-IMport Admin--+----------------+--+---------------------+---->
                 | .-,----------. |  '-Preview--=--+-No--+-'   
                 | V            | |                '-Yes-'     
                 '---admin_name-+-'                            

>--DEVclass--=--device_class_name------------------------------->

                    .-,-----------.      
                    V             |      
>--VOLumename--=--+---volume_name-+--+-------------------------->
                  '-FILE:--file_name-'   

   .-Replacedefs--=--No------.   
>--+-------------------------+---------------------------------><
   '-Replacedefs--=--+-No--+-'   
                     '-Yes-'

Parameters

admin_name

Specifies the administrators 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.

Preview

Specifies whether you want to preview the results of the import operation, without importing administrator information. This parameter is optional. The following parameters values are supported:

No: Specifies that the information is to be imported.
Yes: Specifies that the operation is previewed but not completed. Information about the number and types of objects that are imported, together with the number of bytes transferred, are reported to the server console and the activity log.

The default value is NO. If you specify YES for the value, you must mount the export volumes.

DEVclass (Required)

Specifies the device class from which import data is to be read.

You cannot specify the DISK, NAS, or CENTERA device classes.

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

VOLumename (Required)

Specifies the volumes to be used for the import operation. Volumes must be imported in the same order as they were exported. The following parameter values are supported:

volume_name: Specifies the volume name. To specify multiple volumes, separate names with commas and no intervening spaces.
FILE:file_name: Specifies the name of a file that contains a list of volumes that are 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 you specify volumes that are associated with the following device types:

For this device	Specify
Tape	1 – 6 alphanumeric characters.
FILE	Any fully qualified file name string. For example: /imdata/mt1. d:\program files\tivoli\tsm\data1.dsm.
REMOVABLEFILE	1–6 alphanumeric characters.
SERVER	1–250 alphanumeric characters.

Replacedefs

Specifies whether to replace administrator definitions on the target server. The following parameter values are supported:

No: Specifies that definitions are not to be replaced.
Yes: Specifies that definitions are to be replaced.

The default value is NO.

Example: Import administrator information from specific tape volumes

From the server, import the information for all defined administrators from tape volumes TAPE01, TAPE02, and TAPE03. Specify that these tape volumes be read by a device that is assigned to the MENU1 device class. Issue the command:

import admin devclass=menu1
volumenames=tape01,tape02,tape03

Example: Import administrator information from tape volumes listed in a file

From the server, import the information for all defined administrators from tape volumes that are listed in the following file:

TAPEVOL
TAPEVOL.DATA

This file contains these lines:

TAPE01
TAPE02
TAPE03

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

import admin devclass=menu1 volumenames=file:tapevol

import admin devclass=menu1 volumenames=file:tapevol.data

Related commands

Table 1. Commands related to IMPORT ADMIN
Command	Description
CANCEL PROCESS	Cancels a background server process.
EXPORT ADMIN	Copies administrative information to external media or directly to another server.
IMPORT NODE	Restores client node 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.

Feedback