test

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

使用 HADB 管理代理程式

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

啟動管理代理程式

您可以用以下方式啟動管理代理程式：

對於每種啟動方式，程序會視您使用的是 Java Enterprise System 還是獨立的 Application Server 而有所不同。

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

將管理代理程式做為服務啟動，可確保其繼續執行，除非系統關閉或您明確停止它。指令視您的安裝與平台而定：

Solaris 或 Linux 系統中的 Java Enterprise System

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

/etc/init.d/ma-initd start

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

/etc/init.d/ma-initd stop

Windows 系統中的 Java Enterprise System

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

選擇性引數 config-file 用於指定管理代理程式配置檔案。僅在要變更預設管理代理程式配置時使用配置檔案。如需更多資訊，請參閱自訂管理代理程式配置

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

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

Solaris 或 Linux 系統中的獨立 Application Server

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

HADB_install_dir/bin/ma-initd start

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

HADB_install_dir/bin/ma-initd stop

若要變更預設值，請編輯 shell 程序檔 HADB_install_dir/bin/ma-initd。將 ma-initd 複製至目錄 /etc/init.d。替代程序檔中 HADB_ROOT 和 HADB_MA_CFG 的預設值以反映安裝︰

Windows 系統中的獨立 Application Server

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

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

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

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

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

在產品部署中，請將管理代理程式配置成自動重新啟動。如此一來可確保萬一 ma 程序失敗或作業系統重新開機，管理代理程式依然可用。

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

在 Solaris 和 Linux 平台上，請使用本節說明的程序，將管理代理程式配置成自動重新啟動。以下程序可確保管理代理程式僅在系統進入以下執行層級時啟動：

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

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

開始之前

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

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

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

    id:5:initdefault:

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

  2. 如建立符號連結所述，請建立符號連結至 /etc/init.d/ma-initd 檔案。

  3. 重新開機。

接下來的步驟

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

Procedure在安裝了獨立 Application Server 的 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 檔案。

接下來的步驟

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

建立符號連結

在 Solaris 中建立下列符號連結：

/etc/rc0.d/K20ma-initd
/etc/rc1.d/K20ma-initd
/etc/rc2.d/K20ma-initd
/etc/rc3.d/S99ma-initd
/etc/rc5.d/K20ma-initd (僅適用於 Sun 4m 和 4u 架構)
/etc/rc6.d/K20ma-initd
/etc/rcS.d/K20ma-initd

在 Linux 中建立下列符號連結：

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

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

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

Solaris 或 Linux 系統中的 Java Enterprise System

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

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

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

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

Windows 系統中的 Java Enterprise System

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

HADB_install_dir\bin\ma [config-file]

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

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

Windows 系統中的獨立 Application Server

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

HADB_install_dir\bin\ma [config-file]

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

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

Solaris 或 Linux 系統中的獨立 Application Server

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

HADB_install_dir/bin/ma [config-file]

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

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

使用 Solaris 10 服務管理功能執行管理代理程式

服務管理功能 (SMF) 會提供重新啟動、檢視及管理 Solaris 10 服務的機制。您可以使用 SMF 來啟動、重新啟動並管理 HADB 管理代理程式。

管理代理程式的預設管理資源識別碼 (FMRI) 為 svc:/application/hadb-ma。

管理代理程式指令語法

管理代理程式 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 

表 3–2 說明將管理代理程式當成 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