匯入和匯出 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

確認訊息

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

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

  正在使用的資料由 <user name> 於 <mm/dd/yyyy> 匯出。 匯入操作將修改您的拓樸資料庫，您確定要這樣做嗎？[是/否]

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

• 資料衝突 – 以下訊息要求您決定如何處理衝突的資料。

  實體 <entity name> 已存在於您的拓樸階層結構中，您要將其取代嗎？ [取代(r)/取代全部(a)/忽略(i)/忽略全部(g)/停止(s)]

  此訊息的回應值包括以下選項：

  r

  用新值取代衝突的資料

  a

  用新值取代所有衝突的資料

  i

  不更新衝突的資料

  g

  忽略所有衝突，並且不作任何變更

  s

  停止匯入操作

匯入指令的輸出訊息

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

匯入：完成。

原因:

成功。

描述:

操作成功完成。

filename： 無此文件。

原因:

檔案不存在。

描述:

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

匯入： 無法開啟 filename。

原因:

許可權拒絕。

描述:

檔案無法開啟以供讀取。

匯入： 不支援檔案格式。

原因:

格式錯誤。

描述:

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

匯入：檔案過時（xx 天）。

原因:

資料過時。

描述:

您使用的資料已過時。

匯入：認證失敗。

原因:

認證失敗。

描述:

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

匯入：錯誤的參數檔。

原因:

參數檔錯誤。

描述:

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

匯入：非法的參數 - < para>。

請使用 -h 選項來取得用法。

原因:

非法的參數。

描述:

已將非法的參數傳入匯入操作。請使用 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"

匯出註解

呼叫匯出指令後，會要求您輸入註解。提示符號為 >。按 Return 鍵可斷行。按兩下 Return 鍵可結束註解。

範例 19–3 CLI 匯出註解

> export -p domain=ALL mode=append <return>
請為匯出輸入註解：
> Comment text line 1 <Return>
> Comment text line 2 <Return>
> <Return>
<
狀態 = 正常
訊息 = 完成。
>

匯出指令的輸出訊息

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

匯出：完成。

原因:

成功。

描述:

操作成功完成。

匯出：無法開啟 file。

原因:

檔案不存在。

描述:

參數檔不存在。

filename：許可權拒絕。

原因:

檔案錯誤。

描述:

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

匯出：不支援檔案格式。

原因:

格式錯誤。

描述:

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

匯出：領域 < domainname> 不存在

原因:

物件錯誤。

描述:

您要匯出的領域不存在。

匯出：錯誤的參數檔。

原因:

參數檔錯誤。

描述:

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

匯出：目前使用者與上一位不同。

原因:

使用者衝突。

描述:

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

匯出：資料過時。

原因:

資料太舊。

描述:

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

匯出：非法的參數 - < para>。

請使用 -h 選項來取得用法。

原因:

非法的參數。

描述:

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