test

Sun Java System Application Server 9.1 高可用性管理指南

使用 hadbm 管理指令

使用 hadbm 指令行公用程式可管理 HADB 網域、其資料庫實例和節點。hadbm 公用程式 (也稱為管理用戶端) 將管理請求傳送至做為管理伺服器的指定管理代理程式，其具有存取儲存庫中的資料庫配置的權限。

本小節說明 hadbm 指令行公用程式，包括以下主題：

指令語法

hadbm 公用程式位於 HADB_install_dir /bin 目錄中。hadbm 指令的一般語法為：

hadbm subcommand  
[-short-option [option-value]] 
[--long-option [option-value]] 
[operands]

子指令識別要執行的作業。子指令是區分大小寫的。大部分的子指令都有一個運算元 (通常是 dbname)。

這些選項修改 hadbm 如何執行子指令。選項須大小寫相符。每個選項均具有長形式和短形式。短形式之前為一個破折號 (-)，長形式之前為兩個破折號 (--)。除必須存在以打開某項功能的布林選項之外，大多數選項均需要引數值。選項不是成功執行指令所必需的。

如果子指令需要資料庫名稱，但未指定，hadbm 將使用預設資料庫 hadb。

範例 3–1 hadbm 指令範例

以下說明 status 子指令：

hadbm status --nodes

安全性選項

出於安全原因，所有 hadbm 指令均需要管理員密碼。使用 --adminpassword 選項可在建立資料庫或網域時設定密碼。然後，在該資料庫或網域上執行作業時必須指定該密碼。

出於進階安全性考量，可使用 --adminpasswordfile 選項指定包含密碼的檔案，而不是在指令行輸入密碼。使用以下行在密碼檔案中定義密碼：

HADBM_ADMINPASSWORD=password

使用密碼替代 password。該檔案中的任何其他內容均被忽略。

如果同時指定了 --adminpassword 和 --adminpasswordfile 選項，則 --adminpassword 具有優先權。如果需要密碼，但未在指令中指定，hadbm 會提示您需要密碼。

備註 –

僅可以在建立資料庫或網域時設定管理員密碼，而且以後無法變更。

除管理員密碼外，HADB 還需要資料庫密碼以執行修改資料庫模式的作業。使用以下指令時必須同時使用這兩個密碼：hadbm create、hadbm addnodes 和 hadbm refragment 。

可使用 --dbpassword 選項在指令行指定資料庫密碼。與管理員密碼類似，您還可以將密碼輸入檔案，並使用 --dbpasswordfile 選項指定檔案位置。使用以下行在密碼檔案中設定密碼：

HADBM_DBPASSWORD=password

為了測試或試用，可以使用 --no-adminauthentication 選項在建立資料庫或網域時關閉密碼認證。如需更多資訊，請參閱建立資料庫和建立管理網域

下表概括了 hadbm 安全性指令行選項。

表 3–4 hadbm 安全性選項

選項 (短形式) 

說明 

--adminpassword=password

-w 

指定資料庫或網域的管理員密碼。如果在建立資料庫或網域時使用此選項，必須在每次使用 hadbm 在資料庫或網域上作業時提供此密碼。 

使用此選項或 --adminpasswordfile，但不同時使用。 

--adminpasswordfile=filepath

-W 

指定包含資料庫或網域管理員密碼的檔案。如果在建立資料庫或網域時使用此選項，必須在每次使用 hadbm 在資料庫或網域上作業時提供此密碼。 

使用此選項或 --adminpassword，但不同時使用。 

--no-adminauthentication 

-U 

建立資料庫或網域時使用此選項指定無需管理員密碼。出於安全性原因，請勿在生產部署中使用此選項。 

--dbpassword= password

-p 

指定資料庫密碼。如果在建立資料庫時使用此選項，則每次使用 hadbm 指令在資料庫上作業時均必須提供該密碼。建立 HADB 系統使用者密碼。至少 8 個字元。使用此選項或 --dbpasswordfile，但不同時使用。

--dbpasswordfile= filepath

-P 

指定包含 HADB 系統使用者密碼的檔案。使用此選項或 --dbpassword，但不同時使用。

一般選項

一般指令選項可與任何 hadbm 子指令配合使用。所有選項均為布林選項 (預設值為 false)。下表說明 hadbm 一般指令選項。

表 3–5 hadbm 一般選項

選項 (短形式) 

說明 

--quiet 

-q 

不出現訊息執行子指令，無任何說明訊息。 

--help 

-? 

顯示此指令的簡要說明和所有受支援的子指令。無需子指令。 

--version 

-V 

顯示 hadbm 指令的版本詳細資訊。無需子指令。

--yes 

-y 

在非互動模式下執行子指令。 

--force 

-f 

非互動執行指令，且在符合指令的發佈條件時不丟出錯誤。 

--echo 

-e 

顯示子指令、所有選項及其使用者定義的值或預設值，然後執行該子指令。 

--agent=URL

-m 

管理代理程式的 URL。URL 為：hostlist:port，其中 hostlist 為逗號分隔的主機名稱或 IP 位址清單，port 為管理代理程式作業時所在的連接埠號。

預設為 localhost:1862。 

備註：此選項對於 hadbm addnodes 無效。

環境變數

為方便起見，可以設定環境變數而非指定指令選項。下表說明對應 hadbm 指令選項的環境變數。

表 3–6 HADB 選項與環境變數

長形式 

短形式 

預設 

環境變數 

--adminpassword 

-w 

無 

$HADBM_ADMINPASSWORD 

--agent 

--m 

localhost:1862 

$HADBM_AGENT 

--datadevices 

-a 

1

$HADBM_DATADEVICES 

dbname 

無 

hadb

$HADBM_DB 

--dbpassword 

-p 

無 

$HADBM_DBPASSWORD 

--dbpasswordfile 

-P 

無 

$HADBM_DBPASSWORDFILE 

--devicepath 

-d 

Solaris 和 Linux：/var/opt/SUNWhadb

Windows：C:\Sun\AppServer \SUNWhadb\vers，其中 vers 為 HADB 版本編號。

$HADBM_DEVICEPATH 

--devicesize 

-z 

無 

$HADBM_DEVICESIZE 

--echo 

-e 

False 

$HADBM_ECHO 

--fast 

-F 

False 

$HADBM_FAST 

--force 

-f 

False 

$HADBM_FORCE 

--help 

-? 

False 

$HADBM_HELP 

--historypath 

-t 

Solaris 和 Linux：/var/opt/SUNWhadb

Windows：REPLACEDIR (在執行階段由實際 URL 替代)。 

$HADBM_HISTORYPATH 

--hosts 

-H 

無 

$HADBM_HOSTS 

--interactive 

-i 

True 

$HADBM_INTERACTIVE 

--no-refragment 

-r 

False 

$HADBM_NOREFRAGMENT 

--portbase 

-b 

15200 

$HADBM_PORTBASE 

--quiet 

-q 

False 

$HADBM_QUIET 

--repair 

-R 

True 

$HADBM_REPAIR 

--rolling 

-g 

True 

$HADBM_ROLLING 

--saveto 

-o 

無 

$HADBM_SAVETO 

--set 

-S 

無 

$HADBM_SET 

--spares 

-s 

0 

$HADBM_SPARES 

--startlevel 

-l 

normal 

$HADBM_STARTLEVEL 

--version 

-V 

False 

$HADBM_VERSION 

--yes 

-y 

False 

$HADBM_YES