test

Sun Java System Application Server Enterprise Edition 8.1 2005Q2 高可用性管理指南

使用 HADB 管理代理程式

管理代理程式 ma 在 HADB 主機上執行管理指令。管理代理程式還可在 HADB 節點管理程序失敗時將其重新啟動，從而確保 HADB 節點管理程序的可用性。

管理代理程式指令語法

管理代理程式 ma 指令的語法是：

ma [common-options] 
[ service-options] 
config-file

其中：

表 3–1 管理代理程式共用選項

選項 

說明 

預設 

--define name=value-D

指定特性名稱的值，其中，特性為配置檔案中定義的特性之一。此選項可重複多次。

無 

--help-? 

顯示說明資訊。 

False 

--javahome path-j

使用位於 path 的 Java Runtime Environment (1.4 或更高版本)。

無 

--systemroot path-y

作業系統根的路徑，通常在 %SystemRoot% 中設定。 

無 

--version-V 

顯示版本資訊。 

False 

管理代理程式指令語法說明將管理代理程式做為 Windows 服務啟動的選項。-i、-r 和 -s 選項互斥，亦即一次只能使用其中一個。

在 Windows 中，在配置檔案或指令行指定特性值路徑時，使用雙引號 (") 替換包含空格的檔案路徑。使用雙引號和反斜線替換冒號 (:) 磁碟分隔符號和反斜線 (\) 目錄分隔符號，如下所示："\: 和 "\\。

表 3–2 管理代理程式服務選項 (僅適用於 Windows)

選項 

說明 

預設 

--install-i 

將代理程式安裝做為 Windows 服務，並啟動該服務。僅使用 -i、-r 和 -s 選項其中之一。 

False 

--name servicename-n

在主機上執行多個代理程式時，使用指定的服務名稱。 

HADBMgmt Agent 

--remove-r 

停止服務並從 Windows 服務管理員刪除代理程式。僅使用 -i、-r 和 -s 選項其中之一。 

False 

--service-s 

將代理程式做為 Windows 服務執行。僅使用 -i、-r 和 -s 選項其中之一。 

False 

自訂管理代理程式配置

HADB 包括可用於自訂管理代理程式設定的配置檔案。啟動管理代理程式而未指定配置檔案時，代理程式將使用預設值。如果指定了配置檔案，管理代理程式將使用該檔案中的設定。可以在網域中的所有主機上重複使用該配置檔案。

Procedure在每台 HADB 主機上自訂管理代理程式配置

  1. 編輯管理代理程式配置檔案，並依需求設定值。

  2. 啟動管理代理程式，並將自訂的配置檔案指定為引數。

配置檔案

使用 Java Enterprise System，檔案中的所有項目均已加入註釋。使用預設配置無需進行變更。若要自訂管理代理程式配置，請從檔案中移除註釋，按需變更值，然後啟動管理代理程式，並將配置檔案做為引數指定。

管理代理程式配置檔案安裝於：

如果使用獨立安裝程式，則管理代理程式配置檔案安裝於：

下表說明配置檔案中的設定。

表 3–3 配置檔案設定

設定名稱 

說明 

預設 

 
console.loglevel

主控台記錄層級。有效值為 SEVERE、ERROR、WARNING、INFO、FINE、FINER 及 FINEST 

警告 

 
logfile.loglevel

記錄檔記錄層級。有效值為 SEVERE、ERROR、WARNING、INFO、FINE、FINER 及 FINEST 

資訊 

 
logfile.name

記錄檔名稱和位置。必須為具有讀取/寫入存取權限的有效路徑。 

Solaris 和 Linux：/var/opt/SUNWhadb/ma/ma.log

Windows：HADB_install_dir\ma.log 

ma.server.type

用戶端協定。僅支援 JMXMP。 

jmxmp 

 
ma.server.
jmxmp.port

用於內部 (UDP) 和外部 (TCP) 通訊的連接埠號。必須為正整數。建議範圍為 1024-49151。 

1862 

 
ma.server.
mainternal.interfaces

用於多介面機器進行內部通訊的介面。必須為有效的 IPv4 位址遮罩。網域中的所有管理代理程式必須使用同一子網路 

例如，如果主機具有兩個介面 10.10.116.61 和 10.10.124.61，則使用 10.10.116.0/24 來使用第一個介面。斜線後的數字表示子網路遮罩中的位元數。 

無 

 
ma.server.
dbdevicepath

儲存 HADB 裝置資訊的路徑。 

Solaris 和 Linux：/var/opt/SUNWhadb/4

Windows：HADB_install_dir \device 

ma.server.
dbhistorypath

儲存 HADB 歷史檔案的路徑。 

Solaris 和 Linux：/var/opt/SUNWhadb

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

 
ma.server.
dbconfigpath

儲存節點配置資料的路徑。 

Solaris 和 Linux：/var/opt/SUNWhadb/dbdef

Windows：C:\Sun\SUNWhadb\dbdef 

repository.dr.path

網域儲存庫檔案的路徑。 

Solaris 和 Linux：/var/opt/SUNWhadb/repository

Windows：C:\Sun\SUNWhadb\repository

啟動管理代理程式

可以使用以下兩種方法啟動管理代理程式：

將管理代理程式做為服務啟動

將管理代理程式做為服務啟動，可確保其繼續執行，除非系統關閉或您明確停止它。

在安裝了 Java Enterprise System 的 Solaris 或 Linux 上將管理代理程式做為服務啟動

若要將管理代理程式做為服務啟動，請使用以下指令：

/etc/init.d/ma-initd start

若要停止服務，請使用以下指令：

/etc/init.d/ma-initd stop

在安裝了 Java Enterprise System 的 Windows 上將管理代理程式做為服務啟動

若要將管理代理程式做為 Windows 服務啟動，請使用以下指令： HADB_install_dir\bin\ma -i [config-file ]

選擇性引數 config-file 用於指定管理代理程式配置檔案。僅在要變更預設管理代理程式配置時使用配置檔案。

若要停止管理代理程式並做為服務移除 (取消註冊)，請使用以下指令：HADB_install_dir\bin\ma -r [ config-file ]

若要執行管理，請選擇 [管理工具] | [服務] 來執行啟動和停止服務、停用自動啟動等作業。

在安裝了獨立的應用程式伺服器的 Solaris 或 Linux 上將管理代理程式做為服務啟動

若要將管理代理程式做為服務啟動，請使用以下指令：

HADB_install_dir/bin/ma-initd start

若要停止服務，請使用以下指令：

HADB_install_dir/bin/ma-initd stop

在安裝了獨立的應用程式伺服器的 Windows 上將管理代理程式做為服務啟動

若要將管理代理程式做為 Windows 服務啟動，請使用以下指令： HADB_install_dir\bin\ma -i [config-file ]

選擇性引數 config-file 用於指定管理代理程式配置檔案。僅在要變更預設管理代理程式配置時使用配置檔案。

若要停止管理代理程式並做為服務移除 (取消註冊)，請使用以下指令：HADB_install_dir\bin\ma -r [ config-file ]

若要執行管理，請選擇 [管理工具] | [服務] 來執行啟動和停止服務、停用自動啟動等作業。

確保自動重新啟動管理代理程式

在 Windows 平台上，將管理代理程式做為服務啟動後，請即使用 Windows 管理工具將服務啟動類型設定為「自動」，並設定所需的回復選項。

在 Solaris 和 Linux 平台上，使用本小節中的程序來確保管理代理程式在 ma 程序失敗或作業系統重新開機時的可用性。對於生產部署，同樣適宜執行此作業。

以下程序可確保管理代理程式僅在系統進入以下執行層級時啟動：

進入其他執行層級會停止管理代理程式。

Procedure在安裝了 Java Enterprise System 的 Solaris 或 Linux 上配置自動重新啟動

開始之前

本小節假設您對作業系統初始化和執行層級已有基本的瞭解。如需有關這些主題的資訊，請參閱作業系統文件。

  1. 確定您的系統預設執行層級為 3 或 5。

    若要檢查系統的預設執行層級，請檢視 /etc/inittab 檔案，並在頂部查找類似於以下行的行：

    id:5:initdefault:

    本範例中為預設執行層級 5。

  2. 建立至檔案 /etc/init.d/ma-initd 的以下符號連結：


    /etc/rc0.d/K20ma-initd
/etc/rc1.d/K20ma-initd
/etc/rc2.d/K20ma-initd
/etc/rc3.d/S99ma-initd
/etc/rc5.d/S99ma-initd
/etc/rcS.d/K20ma-initd

  3. 重新開機。

接下來的步驟

若要關閉自動啟動和停止代理程式，請移除這些連結或將連結名稱中的字母 K 和 S 變更為小寫。

Procedure在安裝了獨立應用程式伺服器的 Solaris 或 Linux 上配置自動重新啟動

  1. 在 shell 中，將目前目錄變更至 HADB_install_dir/bin。

  2. 編輯 shell 程序檔 ma-initd。

    請確定程序檔中 HADB_ROOT 和 HADB_MA_CFG 的預設值表現您的安裝：

    • HADB_ROOT 為 HADB 安裝目錄 HADB_install_dir。

    • HADB_MA_CFG 為管理代理程式配置檔案的位置。如需更多資訊，請參閱自訂管理代理程式配置

  3. 將 ma-initd 複製至目錄 /etc/init.d

  4. 建立至 /etc/init.d/ma-initd 檔案的以下符號連結：


    /etc/rc0.d/K20ma-initd
/etc/rc1.d/K20ma-initd
/etc/rc2.d/K20ma-initd
/etc/rc3.d/S99ma-initd
/etc/rc5.d/S99ma-initd
/etc/rcS.d/K20ma-initd
接下來的步驟

若要關閉自動啟動和停止代理程式，請移除這些連結或將連結名稱中的字母 K 和 S 變更為小寫。

在主控台模式下啟動管理代理程式

您可能希望在主控台模式下手動啟動管理代理程式，以便進行試用或測試。請勿在生產環境中以此方式啟動管理代理程式，因為 ma 程序在系統或程序失敗後不會重新啟動，並在指令視窗關閉時終止。

在安裝了 Java Enterprise System 的 Solaris 或 Linux 上的主控台模式下啟動管理代理程式

若要在主控台模式下啟動 HADB 管理代理程式，請使用以下指令：

opt/SUNWhadb/bin/ma [config-file]

預設管理代理程式配置檔案為 /etc/opt/SUNWhadb/mgt.cfg

若要停止管理代理程式，請結束程序或關閉 shell 視窗。

在安裝了 Java Enterprise System 的 Windows 上的主控台模式下啟動管理代理程式

若要在主控台模式下啟動管理代理程式，請使用以下指令：

HADB_install_dir\bin\ma [config-file]

選擇性引數 config-file 為管理代理程式配置檔案的名稱。如需有關配置檔案的更多資訊，請參閱自訂管理代理程式配置。

若要停止代理程式，請結束此程序。

在安裝了獨立應用程式伺服器的 Windows 上的主控台模式下啟動管理代理程式

若要在主控台模式下啟動管理代理程式，請使用以下指令：

HADB_install_dir\bin\ma [config-file]

選擇性引數 config-file 為管理代理程式配置檔案的名稱。如需更多資訊，請參閱自訂管理代理程式配置

若要停止管理代理程式，請結束此程序。

在安裝了獨立應用程式伺服器的 Solaris 或 Linux 上的主控台模式下啟動管理代理程式

若要在主控台模式下啟動 HADB 管理代理程式，請使用以下指令：

HADB_install_dir/bin/ma [config-file]

預設管理代理程式配置檔案為 HADB_install_dir/bin/ma.cfg

若要停止管理代理程式，請結束程序或關閉 shell 視窗。