匯入和匯出 CLI 介面

您可以使用以下指令從 CLI 呼叫匯入和匯出公用程式：

# /opt/SUNWsymon/sbin/es-cli
> login
Host: servername
Login: username
Password: password
Login successful!
> export parameter
> import parameter

請參閱匯入指令參數和匯出指令參數以得知關於適當指令參數的資訊。

拓樸匯入公用程式

import 指令可從檔案為指定網域擷取先前匯出的拓樸資料。

匯入指令參數

import 指令具有以下參數：

domain

domain 參數的值為要匯入的拓樸所屬網域的名稱。如果未指定網域，將匯入所有網域。

domainmode

domainmode 參數的值決定是否從匯入的拓樸建立新的網域。如果值為 follow，則將群組和網域拓樸匯入目前拓樸，並可建立新的網域。若值為 ignore (略過)，就僅會將群組和實體匯入到指定目標網域。

filename

filename 參數的值為應該從中擷取拓樸資訊的檔案之名稱。

nodemode

nodemode 參數的值決定是否以匯入的拓樸取代現有的拓樸。如果 nodemode 參數的值為 replace，則將以匯入的值取代衝突的資料。如果 nodemode 參數的值為 ignore (略過)，則不更新衝突的資料。

指令行中的外顯指定將置換參數檔中的相同指定。例如，若指令行中指定 mode=ignore，而且在參數檔中指定 mode=follow，則會使用 mode=ignore。

範例 19–1 從檔案匯入拓樸資料

在以下範例中，從檔案 /home/examples/snapshot 中匯入先前匯出的拓樸。根據需要建立新的網域，並以匯入的拓樸取代衝突的資料。

> import filename=/home/examples/snapshot domainmode=follow \
nodemode=replace

確認訊息

在操作完成前或資料發生衝突時，匯入公用程式會提示您回答以下項目：

• 確認警告訊息 – 以下訊息要求您確認匯入操作。

  The data being used is exported by <user name> on <mm/dd/yyyy>. The import operation will modify your topology database, are you sure you want to do this? [Yes/No]

  輸入 y 表示「是」，或輸入 n 表示「否」。

匯入指令的輸出訊息

本節說明可能會作為匯入指令結果出現的訊息。

匯入：Results 1/1

State=Success

Message=The topology data is successfully imported.

原因：

成功。

說明：

作業成功完成。

filename：No such file.

原因：

檔案不存在。

說明：

指定的檔案不存在。指令行可能使用了兩個檔案：一個提供匯入資料來源的資料檔，以及一個提供參數清單的參數檔。

import: Cannot open filename.

原因：

許可權遭拒。

說明：

檔案無法開啟以供讀取。

import: File format is not supported.

原因：

格式錯誤。

說明：

來源檔不是匯出資料所用的有效資料庫檔案。

import: File out-of-date (xx days).

原因：

資料過時。

說明：

您使用的資料已過時。

import: Authentication failed.

原因：

驗證失敗。

說明：

目前使用者沒有在拓樸階層結構中建立物件的權限。

import: Wrong parameter file.

原因：

參數檔錯誤。

說明：

參數檔應為 name = value 組的清單。如果格式不正確，應用程式將產生錯誤訊息，並停止作業。

import: illegal parameter - <para>.

Use -h option to get usage.

原因：

非法的參數。

說明：

已將非法的參數傳入匯入操作。請使用 import -h 檢視可用的選項和參數。

拓樸匯出公用程式

export 指令可將一個網域或所有網域的拓樸資料儲存到一個檔案中。

匯出指令參數

export 指令可接受以下參數：

comment

comment 參數的值為要包含在檔案中的附註。

domain

domain 參數的值為要匯出的拓樸所屬網域的名稱。如果未指定網域，將匯出所有網域。

filename

filename 參數的值為應該將拓樸資訊匯出至其中的檔案之名稱。

mode

mode 參數的值決定如何將拓樸資訊加入檔案。如果值為 append，則資料會附加到檔案內容中。如果值為 overwrite，則將以新的資料取代檔案先前的內容。

validity

validity 參數的值為資料有效的時間長度（以天計）。以下值為有效性參數的合法值：

• Unlimited

• 7

• 15

• 30

• 90

範例 19–2 將預設網域拓樸匯出到檔案

在以下範例中，將 Default Domain 儲存到名為 snapshot 的檔案中。snapshot 的原始內容將被新的資料覆寫。假設新資料的有效期不受限制。註解指定此資料用於系統測試群組。

> export filename=/home/examples/snapshot \
domain="Default Domain" mode=overwrite validity=Unlimited \
comment="System Test Group"

匯出指令的輸出訊息

以下清單顯示可能會作為匯出指令結果出現的訊息。

Export: Results 1/1

State=Success

Message=The topology data is successfully exported.

原因：

成功。

說明：

作業成功完成。

export: Cannot open file.

原因：

檔案不存在。

說明：

參數檔不存在。

filename: Permission denied.

原因：

檔案錯誤。

說明：

無法建立或開啟檔案以供寫入。

export: File format not supported.

原因：

格式錯誤。

說明：

當將匯出資料附加到無效的匯出資料檔時，會發生錯誤。

export: The domain <domainname > does not exist

原因：

物件錯誤。

說明：

您要匯出的網域不存在。

export: Wrong parameter file.

原因：

參數檔錯誤。

說明：

參數檔包含 name = value 組的清單。如果檔案格式不正確，應用程式將通知您，並停止作業。

export: The current user is different from the last one.

原因：

使用者衝突。

說明：

當您嘗試將資料覆寫或附加到他人建立的現有資料檔時，會發生錯誤。您無法修改或覆寫其他使用者建立的匯出資料。

export: Data is out-of-date.

原因：

資料太舊。

說明：

您使用的匯出檔案已過時。只有當您以附加模式匯出資料時，才會出現此訊息。

export: illegal parameter - <para>.

Please use -h option to get usage.

原因：

非法的參數。

說明：

已將非法的參數傳入匯出操作。