IMPORT NODE（匯入用戶端節點資訊）

使用這個指令，將用戶端節點定義從伺服器或循序式媒體匯入目標 IBM Spectrum Protect™ Server。

重要：如果指令會匯入管理者或節點，您必須考量鑑別方法。如果節點或管理者會接受 LDAP 目錄伺服器的鑑別，則 IBM Spectrum Protect Server 無法匯出或匯入它們的密碼。如果現行鑑別方法使用 LDAP 目錄伺服器，且該伺服器尚未將密碼同步化，您必須更新密碼。發出 IMPORT 指令之後，請發出 UPDATE ADMIN 或 UPDATE NODE 指令來設定密碼。

如果您在來源伺服器上指定網域，則該原則網域同時存在於目標伺服器上，則匯入的節點會關聯於目標伺服器上的相同原則網域。否則，匯入的節點和目標伺服器上的 STANDARD 原則網域關連。

已啟用保留保護的 IBM Spectrum Protect 伺服器不允許匯入作業。

限制：

若目標和來源伺服器版本不相容，作業可能無法運作。
不支援從 CENTERA 裝置類別匯入資料。不過，正在匯入的檔案可以儲存在 CENTERA 儲存裝置。
如果您使用 LDAP 目錄伺服器來鑑別密碼，必須將任何目標伺服器配置成使用 LDAP 密碼。如果目標伺服器未適當配置，一旦從接受 LDAP 目錄伺服器鑑別的節點匯入資料，那些資料將無法存取。若未配置目標伺服器，從 LDAP 節點匯入的資料仍可以送往該處。但是必須將目標伺服器配置成使用 LDAP，您才能存取匯入的資料。
若目標和來源伺服器版本不相容，作業可能無法運作。
您不能使用 CENTERA 裝置類別作為匯出指令的目標媒體，或作為匯入指令的來源媒體。
不支援將下列類型的用戶端資料漸進式匯出/匯入至另一個 IBM Spectrum Protect 伺服器：
- VMWare 備份，其中需要定期漸進式地將完整備份及增量備份傳送至另一個伺服器。
- 備份群組，其中需要定期漸進式地將完整備份及差異備份傳送至另一個伺服器。
- 要定期漸進式地傳送至另一個伺服器的 Windows 系統狀態資料。
透過匯出包含此資料的整個檔案空間，可支援將此資料完整匯出/匯入至目標上的新檔案系統。換言之，匯出作業不得使用 FILEDATA=ALLACTIVE、FROMDATE、TODATE 或 MERGEFILESPACES 選項。

在兩個伺服器之間漸進式傳送此類型資料的最佳做法是使用「節點抄寫」。

您可以使用 QUERY ACTLOG 指令來檢視匯入作業的狀態。您同樣可以從伺服器的主控台來檢視此一資訊。

此指令產生的背景處理程序可以用 CANCEL PROCESS 指令取消。若取消 IMPORT NODE 背景處理程序，仍已經匯入部分資料。如果要顯示背景處理程序的相關資訊，請使用 QUERY PROCESS 指令。

對於其用戶端支援 Unicode 的伺服器，您可以讓伺服器轉換您輸入的檔案空間名稱，或使用下列參數：

HEXFILESPACE
UNIFILESPACE

限制：在匯出、匯入和節點抄寫作業的期間，IBM Spectrum Protect 伺服器不會轉換字碼頁。如果伺服器在不同的語言環境中執行，資料庫或系統輸出中的部分資訊可能會無法讀取。可能會顯示無效的字元，例如，在管理者和用戶端節點的聯絡資訊，以及原則網域的說明。以伺服器字集來儲存以及包含延伸 ASCII 字元的任何欄位都可能會受到影響。如果要解決問題，在匯入或節點抄寫作業之後，請使用適當的 UPDATE 指令來更新欄位。這個伺服器限制不影響用戶端資料。匯出、匯入或抄寫的任何用戶端資料，都可以還原、擷取和恢復。

專用權類別

若要發出這個指令，您必須具有系統專用權。

語法


                .-*-------------.   
>>-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-'     

   .-MERGEfilespaces--=--No------.   
>--+-----------------------------+------------------------------>
   '-MERGEfilespaces--=--+-No--+-'   
                         '-Yes-'     

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

參數

node_name

指定您要匯入資訊的用戶端節點。此為選用參數。

使用逗號將多個名稱隔開，中間不留空格。您可以使用萬用字元來指定名稱。所有符合的節點均包含於列示中。

FILESpace

指定您要匯入資訊的檔案空間名稱。此為選用參數。預設值是所有的檔案空間。

使用逗號將多個名稱隔開，中間不留空格。您可以使用萬用字元來指定名稱。

重要：

指定存在於伺服器的節點定義是否應由同名的匯入物件置換。當遇到相同名稱時，會產生新檔案空間。不過，這個新名稱可能與用戶端節點上現存的名稱相同，而後者可能會有尚未備份至伺服器的檔案空間。
此參數只能指定於非 Unicode 檔案空間。如果要匯入包含 Unicode 和非 Unicode 的所有檔案空間，請使用 FILEDATA=ALL 參數，不要使用 FILESPACE 和 UNIFILESPACE 參數。

DOmains

指定當作匯出節點資訊來源的原則網域。這些網域必須包含在之前匯出的資料中。此為選用參數。預設值是所有已匯出的網域。

使用逗號將多個名稱隔開，中間不留空格。您可以使用萬用字元來指定名稱。

FILEData

指定可匯入給匯出媒體上所指定及發現的全部節點的檔案類型。此為選用參數。預設值為 NONE。

如果是從循序式媒體匯入，檔案資料所使用的裝置類別是由儲存區的裝置類別來決定。若它和這個指令所指定的裝置類別相同，則需要兩個磁碟機來匯入節點資訊。裝置類別的裝載限制至少必須設定為 2。

下面介紹作用中和非作用中備份檔副本。作用中的備份檔案副本，是仍存在於用戶端工作站的最新檔案備份。所有其他的備份檔副本均稱之為非作用中副本。該參數支援下列值：

ALl: 伺服器會匯入檔案的所有備份版本、所有保存檔，以及 IBM Spectrum Protect for Space Management 用戶端移轉的所有檔案。包含的檔案空間是 Unicode 和非 Unicode。
None: 只匯入節點定義。伺服器不會匯入任何檔案。
ARchive: 伺服器只匯入保存的檔案。
Backup: 伺服器只匯入備份版本，無論是作用中或非作用中。
BACKUPActive: 伺服器只匯入作用中的備份版本。這些作用中備份版本是在發出 IMPORT 指令時，IBM Spectrum Protect 資料庫中的作用中版本。
ALLActive: 伺服器會匯入檔案的所有作用中備份版本、所有保存檔，以及 IBM Spectrum Protect for Space Management 用戶端移轉的所有檔案。作用中備份版本是在發出 IMPORT 指令時，IBM Spectrum Protect 資料庫中的作用中版本。
SPacemanaged: 伺服器只會匯入 IBM Spectrum Protect for Space Management 用戶端所移轉的檔案。

Preview

指出是否要預覽匯入作業的結果，但不匯入資訊。 PREVIEW=YES 選項要求必須裝載匯出磁區。支援使用下列值：

No: 指定匯出節點資訊。
Yes: 指定您是否要預覽匯入作業的結果，而不需匯入檔案。資訊會回報給伺服器主控台和活動日誌。

此為選用參數。預設值為 NO。

DEVclass（必要）

指定讀取匯入資料的裝置類別。您不能指定 DISK、NAS 或 CENTERA 裝置類別。

在匯入執行時，若裝置類別的所有磁碟機都忙碌，伺服器將取消優先順序較低的作業（例如識別重複項目），以讓磁碟機可供使用。

Dates

指定是否要將檔案副本日期設為匯出檔案時的日期，或是將日期調整為匯入日期。

此參數支援下列值：

Absolute: 將檔案副本的日期設定為匯出檔案時指定的值。
Relative: 檔案副本日期調整為匯入日期。

預設值為 ABSOLUTE。

匯出後，若匯出媒體已經閒置一段時間（例如，放置在書架上 6 個月），那麼將資料匯入伺服器時，原始備份或保存日期可能足夠長，可以觸發檔案副本立即過期。將這個值指定為 RELATIVE，可以調整自匯出以來所經過的時間，使得檔案副本不會立即過期。

例如，假設匯出磁帶含有一個保存檔副本，此副本是在匯出作業前五天保存的。若媒體存放六個月後才匯入，根據預設值 (DATES=ABSOLUTE)，保存檔看起來像是已經插入六個月又五天，且根據檔案管理類別中指定的保留期值，可能會立即過期。指定 DATES=RELATIVE 可以在匯入期間將檔案的保存日期重新設定為五天前。 DATES=RELATIVE 參數調整檔案備份和保存日期中有關匯出作業後經歷過的時間。

VOLumenames（必要）

指定用於匯入作業的磁區。匯入磁區的次序必須與匯出磁區時的次序相同。該參數支援下列值：

volume_name: 指定磁區名稱。如果要指定多個磁區，請以逗號區隔名稱，而且中間不可以有空格。
FILE:file_name: 指定包含用來匯入資料的磁區清單的檔案名稱。在檔案內，每一個磁區名稱必須位在不同行。系統不處理以星號開頭的空白行和註解行。

在您指定與下列裝置類型相關聯的磁區時，請使用這些命名慣例：

此裝置方面	指定
磁帶	1 - 6 個英數字元。
檔案	任何完整的檔案名稱字串。例如，/imdata/mt1。任何完整的檔案名稱字串。例如，d:\program files\tivoli\tsm\data1.dsm。
REMOVABLEFILE	1 - 6 個英數字元。
SERVER	1 - 250 個英數字元。

Replacedefs

指定是否要置換目標伺服器上的定義。預設值為 NO。該參數支援下列值：

No: 不要置換物件。
Yes: 要置換物件。

HEXFILESpace

以 UTF-8 格式指定十六進位表示的檔案空間名稱。使用逗號將多個名稱隔開，中間不留空格。此為選用參數。

若要檢視十六進位表示的檔案空間名稱，您可以使用 QUERY FILESPACE 指令加上 FORMAT=DETAILED。

UNIFILESpace

指定伺服器已知的檔案空間已啟用 Unicode。伺服器會將您輸入的名稱從伺服器字碼頁轉換成 UTF-8 字碼頁，以尋找要匯入的檔案空間。轉換是否成功由名稱中的實際字元以及伺服器的字碼頁決定。使用逗號將多個名稱隔開，中間不留空格。可使用萬用字元來指定名稱。此為選用參數。

MERGEfilespaces

指定 IBM Spectrum Protect 是否要將用戶端檔案合併到目標伺服器上的現存檔案空間內（若存在），或者要由 IBM Spectrum Protect 建立新的檔案空間名稱。預設值為 NO。

有效值為：

Yes: 指定如果目標伺服器上有同名的檔案空間存在，則目標伺服器上的匯入資料要與現有的檔案空間合併。
No: 指定如果有同名的檔案空間存在，IBM Spectrum Protect 會在目標伺服器上為匯入的資料產生新的檔案空間名稱。

PROXynodeassoc

指定是否匯入 Proxy 節點關聯。此為選用參數。預設值為 NO。

範例：從磁帶匯入用戶端節點資訊

從伺服器，自磁帶磁區 TAPE01、TAPE02 和 TAPE03 匯入用戶端節點資訊。指定這些磁帶磁區將由指派給 MENU1 裝置類別的裝置進行讀取。

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

範例：從檔案中列出的磁帶匯入用戶端節點資訊

AIX 作業系統 Linux 作業系統從伺服器，從名稱為 TAPEVOL 的檔案中所列出的磁帶磁區，匯入用戶端節點資訊。

Windows 作業系統從伺服器上，從名稱為 TAPEVOL.DATA 的檔案中所列出的磁帶磁區，匯入用戶端節點資訊。

這個檔案包含下列這幾行：

TAPE01
TAPE02
TAPE03

指定這些磁帶磁區將由指派給 MENU1 裝置類別的裝置進行讀取。 AIX 作業系統

import node devclass=menu1 volumenames=file:tapevol

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

範例：匯入用戶端節點的作用中備份

在伺服器，從磁帶磁區 TAPE01 匯入用戶端節點 JOE 的檔案資料的作用中備份版本。檔案空間為 Unicode。

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

指令	說明
CANCEL PROCESS	取消背景伺服器處理程序。
COPY ACTIVEDATA	複製作用中備份資料。
EXPORT NODE	將用戶端節點資訊複製到外部媒體或直接複製到另一部伺服器。
IMPORT ADMIN	從外部媒體還原管理資訊。
IMPORT POLICY	從外部媒體還原原則資訊。
IMPORT SERVER	從外部媒體還原全部或部分伺服器。
QUERY ACTLOG	顯示伺服器活動日誌中的訊息。
QUERY PROCESS	顯示背景處理程序的相關資訊。

IMPORT NODE（匯入用戶端節點資訊）

專用權類別

語法

參數

範例：從磁帶匯入用戶端節點資訊

範例：從檔案中列出的磁帶匯入用戶端節點資訊

範例：匯入用戶端節點的作用中備份

相關指令