Sun Management Center 3.6 使用者指南

附錄 A 其他 Sun Management Center 程序

本附錄說明尚無法歸入本文件其他章節的數個程序。具體來說，本附錄包括以下資訊：

監視拓樸管理程式和事件管理程式

伺服器層包含五個組件：

Sun Management Center 伺服器
拓樸管理程式
陷阱處理程式
配置管理程式
事件管理程式

除伺服器以外，其他四個組件均為載入專用模組的 Sun Management Center 代理程式。

拓樸管理程式、事件管理程式以及所有其他 Sun Management Center 代理程式的預設配置均由代理程式統計模組定義。此模組具有的功能可以防止會導致主機當機的錯誤。預設動作為，當超出預先定義的臨界值時，該軟體將終止拓樸管理程式程序。請參閱代理程式統計模組版本 2.0以得知關於代理程式統計模組的更多資訊。

建立作為受監視物件的伺服器組件

您也許想要監視拓樸管理程式、陷阱處理程式、配置管理程式和事件管理程式以判定其狀況。配置管理程式和陷阱處理程式均已配置，因此您無需執行任何維護程序。此外，拓樸管理程式和事件管理程式的預設配置均可在大多數使用者環境中作業。但是，您可以修改預設配置以用於專用環境。

步驟

在主控台視窗中，從 [編輯 ] 功能表中選擇 [建立物件]。

[建立物件 ] 視窗即會顯示出來。依預設，標籤設定為 [節點]。如需更多資訊，請參閱建立節點。

從 [監視方式 ] 功能表中，選擇 [Sun Management Center 代理程式 - 主機]。

在 [節點標籤 ] 欄位中鍵入伺服器組件的名稱。

(可選擇) 鍵入伺服器組件的說明。

在 [主機名稱 ] 欄位中，鍵入 Sun Management Center 伺服器的名稱。

在 [連接埠 ] 欄位中，鍵入伺服器組件的連接埠號。

Sun Management Center 軟體使用下列預設連接埠值：
- 代理程式組件：連接埠 161
- 伺服器陷阱處理程式：連接埠 162
- 伺服器事件管理程式：連接埠 163
- 伺服器拓樸管理程式：連接埠 164
- 伺服器配置管理程式：連接埠 165
備註 –
依預設，伺服器組件使用連接埠 2099。但是，您不能在此處變更伺服器組件的連接埠號。

利用以下動作之一完成此程序：
- 按一下 [確定 ] ，建立伺服器組件物件，並關閉此視窗。
- 按一下 [套用 ] 按鈕，建立伺服器組件物件，但不關閉此視窗。

變更登錄連接埠號

Sun Management Center 伺服器具有登錄功能，可讓加值產品 (例如 Hardware Diagnostics Suite) 在伺服器上登錄。依據預設，登錄功能是使用連接埠 5600。若此連接埠被另一個應用程式使用，則該應用程式將會無法使用。若要變更登錄連接埠，請執行以下步驟：

步驟

變更 /var/opt/SUNWsymon/cfg/javaserver.properties 檔案中的 ServiceRegistryPort 值。

變更 /var/opt/SUNWsymon/cfg/javaservice.properties 檔案中的 ServiceRegistryPort 值，使之與您在上一步中提供的值相符。

重新啟動 Sun Management Center 伺服器。

備註 –
在您設定 Sun Management Center 伺服器之後，如果預設連接埠正在使用中，安裝程序會提示您為登錄服務提供另一個連接埠號。

增加拓樸管理程式中虛擬大小資料屬性的緊急臨界值

拓樸管理程式可讓主控台視窗在拓樸檢視中顯示邏輯物件。拓樸管理程式還可提供建立邏輯物件（如群組）的功能，該邏輯物件的狀態可以對多個受管理物件的狀態進行摘要。

受管理物件包括網路、主機、硬體組件及軟體組件。物件的總數及其內容決定拓樸管理程式的系統資源需求，如虛擬大小。此需求必須小於拓樸管理程式的預設設定。

如果拓樸管理程式的虛擬大小超出預設值，拓樸管理程式將結束並生成以下錯誤訊息：

error excessive virtual memory use

若要解決此錯誤，請按照以下步驟中的說明增加預設虛擬大小。

步驟

仔細評估情況。

建立拓樸管理程式的受監視物件。

請參閱建立作為受監視物件的伺服器組件。

使用以下方法之一開啟 [細節] 視窗：
- 在拓樸管理程式物件圖示上按滑鼠按鈕 3。從階層結構視圖或拓樸視圖中的快顯式功能表中選擇 [細節]。
- 連按兩下拓樸管理程式圖示。
- 在主控台視窗中選取拓樸管理程式圖示，然後從 [工具] 功能表中選擇 [細節]。

在 [瀏覽器細節] 視窗中，連按兩下階層結構（樹狀）視圖中的 [本端應用程式] 圖示。

連按兩下內容視圖中的 [代理程式統計] 圖示，或按一下階層結構視圖中 [代理程式統計] 圖示旁邊的展開圖示。

[代理程式統計] 資料夾即會顯示出來。

連按兩下 [PA 程序統計] 的資料夾圖示。

屬性表中將顯示受監視的屬性。

選取 [虛擬大小] 表格儲存格，然後透過以下方法之一開啟屬性編輯程式：
- 在表格列中按滑鼠按鈕 3，然後從快顯功能表中選擇 [屬性編輯程式]。
- 按一下 [屬性] 按鈕。

按一下 [警報] 標籤按鈕。

警報列即會顯示出來。

在 [緊急臨界值 (>)] 欄位中鍵入所需的值。

利用以下動作之一完成此程序：
- 按一下 [確定]，建立新的 [緊急臨界值]，並關閉此視窗。
- 按一下 [套用] 按鈕，建立新的 [緊急臨界值]，但不關閉此視窗。

變更事件管理程式中智慧刪除的預設值

事件管理程式使用預設連接埠 163 透過 SNMP 與其他伺服器元件通訊。與拓樸管理程式類似，事件管理程式也是使用代理程式統計模組載入。此外，事件管理程式會自動載入專門的事件管理模組。事件管理模組顯示在 [本端應用程式] 類別的 [瀏覽器細節] 視窗中。

事件管理模組負責事件資料庫的全面維護。此模組的責任包括清理刪除的事件、重新命名垃圾檔案及 [智慧刪除]。

[智慧刪除] 意即 Sun Management Center 軟體在設定時間過後，會自動從事件資料庫刪除已關閉、修正和開啟的事件。依預設，已關閉或修復的事件將在 7 天後從資料庫中移除，已開啟的事件將在 30 天後移除。若要變更這些預設值，請執行以下步驟。

步驟

建立事件管理程式的受監視物件。

請參閱建立作為受監視物件的伺服器組件。

透過以下方法之一開啟 [細節] 視窗：
- 在 [事件管理程式] 圖示上按滑鼠按鈕 3。從階層結構視圖或拓樸視圖中的快顯式功能表中選擇 [細節]。
- 連按兩下階層結構視圖或拓樸視圖中的 [事件管理程式] 圖示。
- 在主控台視窗中選取 [事件管理程式] 圖示，然後從 [工具] 功能表中選擇 [細節]。

在 [瀏覽器細節] 視窗中，連按兩下階層結構（樹狀）視圖中的 [本端應用程式] 圖示。

透過以下方法之一開啟 [模組編輯程式] ：
- 在事件管理模組上按滑鼠按鈕 3。在階層結構視圖或內容視圖的快顯式功能表中選擇 [編輯模組]。
- 在 [細節] 視窗中，選取事件管理模組，然後從 [模組] 功能表中選擇 [編輯模組]。
[模組參數編輯程式] 即會顯示出來。如需更多資訊，請參閱修改模組參數。

在可編輯的欄位中，鍵入新的時間值。

依預設，已關閉或修復的事件將在 7 天後從資料庫中移除。開啟的事件將在 30 天後移除。

若要關閉 [智慧刪除]，請從 [智慧刪除啟用開關] 功能表中選擇 [停用]。

按一下 [確定]，接受您所作的變更，並關閉此視窗。

讀取 Sun Management Center 記錄檔

Sun Management Center 伺服器和代理程式會寫入到 /var/opt/SUNWsymon/log 目錄中的各種記錄檔。

這些檔案是循環記錄檔。循環記錄檔在達到一定限制後將不再增大。新訊息被記入檔案時，最舊的訊息將被移除。

搭配 ctail 和 ccat 指令使用 es-run 介面可檢視這些記錄檔。es-run 介面會設定適當的環境來執行 Sun Management Center 公用程式。在依時間先後順序排序資料之後，公用程式 ccat 和 ctail 將僅顯示相關資料。ccat 和 ctail 指令與 UNIX cat 和 tail 指令相似，但是用於 Sun Management Center 循環記錄檔。

使用 `ccat` 讀取 Sun Management Center 記錄檔

ccat 指令可讀取指定的記錄檔、依時間先後順序升冪排序訊息，以及寫入標準輸出。ccat 指令具有一個引數，該引數為循環記錄檔的完整路徑。

若要搭配 ccat 指令使用 es-run 介面，請鍵入：

# /opt/SUNWsymon/sbin/es-run ccat path_to_file/filename

使用 `ctail` 讀取 Sun Management Center 記錄檔

ctail 指令可讀取循環記錄檔，並依預設將該檔案的最後 15 行寫入標準輸出。

ctail 指令具有四個引數：

filename: filename 引數為循環記錄檔的完整路徑名稱。filename 引數是必需的。
-f: -f 選項是用來監視記錄檔的增大。隨著記錄檔的增大，附加至檔案的訊息也將被寫入標準輸出。ctail -f 選項與 UNIX tail 指令的 -f 選項類似。
-l: -l 選項是用來列印每條訊息開頭的絕對行號。
-n: -n NumOfLines 選項是用來變更顯示的行號。依預設，僅列印最後 15 行。

若要使用 es-run 介面和 ctail 指令，請鍵入：

# /opt/SUNWsymon/sbin/es-run ctail [-f, -l, -n NumOfLines] path_to_file_filename

新增自訂功能表項目

Sun Management Center 軟體可讓您藉由新增可從主控台視窗啟動之外部獨立的應用程式來自訂工具功能表。應用程式是以 Java 程式語言撰寫。非 Java 的應用程式可以由在個別程序執行其他程式或 shell 程序檔的 ExampleSystemCommand Java 包裝程式類別加入。此應用程式無需已選取的主機物件。應用程式一旦啟動，便不再與 Sun Management Center 互動。

應用程式的名稱在檔案 console-tools.cfg 中指定。應用程式名稱將新增至主控台視窗中標準 Sun Management Center 功能表項目下的 [工具] 功能表。應用程式將在單獨的視窗中啟動。

檔案 console-tools.cfg 是常駐於 Sun Management Center 伺服器主機上的純文字檔案。此檔案可以隨時被修改，包括在主控台執行時。但是，透過編輯檔案所做的變更要在執行 es-tool 程序檔並重新啟動主控台後才能生效。檔案由一系列行組成，每一行說明一個應用程式。空白行及以井字符號 (#) 開頭的行將被忽略。每一行中的欄位由逗號 ( ,) 分隔。

每一個作為 shell script 或可執行二進位執行的應用程式均由具有以下格式的行定義：

menu_label,class [args]

其中：

menu label 為顯示在 [工具] 功能表中的字串。此字串既可以是本土化文字，也可以是非本土化文字。非本土化文字可以包含內嵌式空格。本土化文字必須指定為 property-file：key 組，其中：
- property-file 為檔案名稱，該檔案包含用於特定語言環境的可本土化訊息。
- key 為識別碼，用於定位顯示在屬性檔案 [工具] 功能表中的字串。
  
  請注意，識別碼中不能包含空格。
class 為完整的 Java 類別名稱。
args 為類別引數清單。

例如，以下檔案顯示了要新增至 [工具] 功能表的三個應用程式的項目：Example GUI、rlogin 和 ftp。

# Format:
# menu_label, class arguments

Example GUI,exampleApp.ExampleGUITool

Rlogin,com.sun.symon.base.client.console.SMSystemCommand 
"/usr/openwin/bin/xterm -e rlogin $host" "start rlogin $host"

exampleApp.ExampleSystemCommand:ftp,exampleApp.ExampleSystemCommand 
"/usr/openwin/bin/xterm -e ftp $host" "start ftp $host"

注意 –

每一個項目均必須在單一行上指定，即使文字在範例中以換行顯示。

Java 包裝程式類別SMSystemCommand 可讓您執行任一 shell 指令。此類別具有兩個引數。第一個引數為要執行的 shell 指令。

如果已指定程式名稱，請提供完整路徑名稱。
如果指令包含內嵌式空格，請用雙引號括住整個 shell 指令。

第二個引數為要在 Microsoft Windows 用戶端執行的指令。以下行為該指令的範例：

com.sun.symon.base.client.console.SystemCommand "<shell command>" "<windows command>"

在此情況下，第一個引數被忽略。如果存在特殊的變數參考，則會對引數執行變數取代。允許以下兩個變數：

$host，由目前已選取的代理程式主機名稱取代
$port，由目前已選取的連接埠號取代

自訂 [工具] 功能表

步驟

使用標準文字編輯程式在 /var/opt/SUNWsymon/cfg/console-tools.cfg 檔案中新增文字行。

此行指定以下項目：
- 要在 [工具] 功能表上顯示的名稱
- 應用程式的完整 Java 類別名稱
- 任何所需的類別引數
請參閱章節介紹中的詳細說明，以取得更多資訊。

將應用程式的 Java 類別檔案置於 /opt/SUNWsymon/apps/classes 目錄中。

在 Sun Management Center 伺服器主機上執行 es-tool 更新 script。

# /opt/SUNWsymon/sbin/es-tool /var/opt/SUNWsymon/cfg/console-tools.cfg

透過從主控台視窗的 [檔案] 功能表中選擇 [結束] 來停止主控台。

按一下 [結束] 按鈕，結束應用程式。

重新啟動主控台，以將該應用程式新增至 [工具] 功能表。
# /opt/SUNWsymon/sbin/es-start -c
備註 –
您的網站配置可能也需要您重新啟動 Sun Management Center 伺服器。

Sun Management Center 模組的 SNMP MIB

Sun Management Center 軟體含有模組的簡單網路管理協定管理資訊庫 (SNMP MIB)。MIB 檔案是 Sun Management Center 模組（在此情況下）所塑型資料的抽象語法表示式 (ASN.1) 規格。這些 MIB 可由協力廠商 SNMP 型管理站（如 HP OpenView 和 Unicenter^TM）用作資料定義。Sun Management Center 具有以下模組的 MIB：

file-scan.mib
health-monitor-mib.mib
kernel-reader-mib.mib
nfsmon-mib.mib
nfsstat-mib.mib
print-spool-mib.mib
process-details-mib.mib
process-monitor.mib
trap-mib.mib

依預設，以上 MIB 由 Sun Management Center 軟體在安裝代理程式層期間安裝在 /opt/SUNWsymon/util/cfg 目錄中。在您的安裝中，基本目錄可能會有所不同。

在協力廠商管理站上使用 Sun Management Center SNMP MIB

步驟

預先處理 MIB。

某些 SNMP 管理站可以讀取 ASN.1 MIB。其他管理站則需要將 ASN.1 MIB 轉換為其他格式才能讀取。例如，您可能需要將 MIB 轉換為受管理物件說明規格 (GDMO) 格式，或使用 MIB 編譯程式生成其他中間格式。

載入 MIB。

將 ASN.1 MIB 或預先處理過格式的 MIB 載入協力廠商管理站。此步驟會將由 MIB 所塑型資料的佈局和結構通知給協力廠商管理站。

使用 MIB 資訊與 Sun Management Center 代理程式對話。

MIB 成功載入協力廠商 SNMP 代理程式之後，您便可與 Sun Management Center 代理程式通訊，以從 MIB 取得資料。必須在 Sun Management Center 代理程式中載入並啟用 MIB-II 代理監視模組。

例如，您可以開始對 MIB 中的某些變數發出 SNMP Get 指令。

依據預設，會透過使用 SNMPv1 社群 public 和 SNMPv2 使用者名稱 public，為 SNMP Get 指令啟用 Sun Management Center 模組。但是，如果 Sun Management Center 模組具有不同的設定，則您需要使用正確的團體名稱和使用者名稱來與 Sun Management Center 代理程式通訊。

備註 –
因為 Sun Management Center 代理程式與 SNMPv2 usec 型安全性配合作業，所以會涉及代理程式上的 SNMP Set 指令。請參閱與 SNMPv2 usec 相關的請求註解 (RFC)，以取得更多資訊。

存取多個實例模組

SNMPv2 將術語 context 用於可將模組的多個實例載入代理程式的 MIB。如果您使用 SNMPv2 型協力廠商管理站與此類代理程式通訊，請確定您使用的是正確的環境資訊。但是，如果您使用的是 SNMPv1 型管理站，則請將環境資訊新增至 SNMP 團體，如下所示：

community:context

透過新增此環境資訊，您可以從代理程式上執行的同一模組的多個實例存取資料。

當代理程式在啟動期間結束

Sun Management Center 代理程式具有監視其本身並限制其記憶體用量的功能。已對代理程式程序的記憶體用量設定了某些預先定義的限制。這些限制取決於以下標準：

載入模組的數量
載入模組的類型
受管理系統的類型

在代理程式啟動期間和代理程式停止執行時，記憶體用量很少會超出預設限制。如果超出此限制，則代理程式記憶體大小的預設限制對於您的配置來說不足。

若要確認是否由記憶體用量引起，請查看 /var/opt/SUNWsymon/log/agent.log 檔案以找到以下訊息之一：

Excessive Virtual Memory Use
Excessive Physical Memory Use

如果您在代理程式啟動期間看見這些訊息之一，請使用以下程序重新配置代理程式主機上的記憶體用量限制。

增加代理程式記憶體大小

步驟

成為代理程式主機上的超級使用者。
# su -

將 agent-stats-d.def 檔複製到 /var/opt/SUNWsymon。

# cp /opt/SUNWsymon/modules/cfg/agent-stats-d.def /var/opt/SUNWsymon/cfg/

在 /var/opt/SUNWsymon/cfg/agent-stats-d.def 檔中，將 alarmlimit:error-gt 增加至所需的值，如下列程式碼區段所示。

值以 KB 為單位。

procstats = {
        size = {
            statusActions(error-gt)
      = abort
            statusService(abort) 
      = _internal
            statusCommand(abort) 
      = abort "Excessive Virtual Memory Use"
            alarmlimit:error-gt = 70000
            alarmlimit:warning-gt = 60000
            alarmlimit:info-gt =
        }
     .....
     }

儲存檔案並重新啟動代理程式。

沒有回應的主控台視窗

本節說明如何對某些環境中沒有回應的主控台視窗做出回應。在此情況下，當使用者嘗試啟動新的主控台視窗並將其連接至 Sun Management Center 伺服器時，主控台視窗會沒有回應。但是，現有的主控台視窗連接不會出現問題。

主控台視窗可能會由於以下原因而沒有回應：

伺服器記憶體用盡。當通訊端任一端的讀取和寫入速率之間出現巨大差異時，正從通訊端讀取資料的執行緒會沒有回應。當 Sun Management Center 伺服器中有大量的緩衝資料等待發送至用戶端時，會出現記憶體問題。緩衝資料可以很大，從而導致伺服器在嘗試向套接字寫入時用盡記憶體。伺服器一旦用盡記憶體，便不再復原。

備註 –
如果您在監視伺服器記錄檔，請使用以下指令檢查伺服器用盡記憶體的訊息：/opt/SUNWsymon/sbin/es-run ctail -f /var/opt/SUNWsymon/log/server.log
用於主控台程序的主控台記憶體已用盡。您可以確認主控台程序已用盡記憶體。從主控台視窗的 [檔案] 功能表中，選擇 [Sun Management Center 主控台訊息]。 [Sun Management Center 主控台訊息」視窗可能會顯示一則或更多訊息表明主控台記憶體已用盡。

您用來解決掛起的主控台視窗的方法，取決於安裝的是哪一個記憶體：

如果伺服器記憶體用盡，請增加伺服器程序可用的記憶體。預設大小為 64 MB。

例如，若要將預設記憶體從 64 MB 增加至 128 MB，請使用以下指令：
# es-start -s -- -Xmx128m
備註 –
若您是藉由使用 es-start -A 指令或重新開機來呼叫伺服器，您就可以自動設定記憶體大小。要自訂預設記憶體大小，請在 /opt/SUNWsymon/classes/base/server/bin/es-server.sh 檔中將 -Xmx64m 變更為想要的大小。
如果主控台記憶體用盡，請使用較大的記憶體並重新啟動主控台。

例如，若要將記憶體增加至 100 MB，請使用此指令：
# es-start -c -- -Xmx100m
此程序會為目前階段作業的主控台分配更多的記憶體。

備註 –
若要自動分配更多記憶體，請在 /opt/SUNWsymon/classes/base/console/bin/es-console.sh 檔中將預設記憶體大小從 -Xmx64m 變更為所需大小。

資料庫備份與回復

您有時需要備份 Sun Management Center 資料庫以免遺失資料。例如，在您升級硬體或作業系統之前，應該備份資料庫。您可以使用下列其中一種方法來備份 Sun Management Center 資料庫：

關閉產品，然後執行備份 (離線備份)
在產品仍在執行時執行備份 (線上備份)

離線備份

在離線備份時，請先關閉產品，然後再進行備份。在設定線上備份功能時，請先執行離線備份以防意外發生。

執行離線備份

步驟

成為超級使用者。
# /opt/SUNWsymon/sbin/es-backup
因為程序檔會關閉 Sun Management Center，所以會提示您確認。

鍵入 y 並按 Enter 鍵。

將會提示您輸入要儲存備份資料檔案的目錄路徑。

按 Enter 接受預設目錄或輸入新路徑。

程序檔會建立備份檔，然後重新啟動產品。

線上備份

此程序會引導您進行下列作業：

執行離線備份以防止意外發生
啟用 ARCHIVELOGMODE 來關閉 Sun Management Center 並設定歸檔
線上備份資料庫

使用線上備份有幾點好處。您可以備份最即時的資料庫而且不需要停止產品。您可以隨時停用或啟用 ARCHIVELOG 模式。

備註 –

線上備份不會關閉產品。

執行線上備份

步驟

(可選擇) 執行離線備份。請參閱執行離線備份。

啟用 ARCHIVELOGMODE。
1. 成為超級使用者。
  # /opt/SUNWsymon/sbin/es-config -a enable
  會提示您確認是否要啟用歸檔功能。
2. 鍵入 y 並按 Enter 鍵。
  
  因為程序檔將會關閉 Sun Management Center，所以會提示您確認。
3. 鍵入 y 並按 Enter 鍵。
  
  程序檔會關閉產品，並建議進行離線備份。會提示您確認是否要在 ARCHIVELOGMODE 設定資料庫。
4. 鍵入 y 並按 Enter 鍵。
  
  將會提示您輸入要儲存歸檔記錄檔案的目錄路徑。
5. 輸入完整路徑，例如：
  Enter full directory path to store the archive log files:
  /var/opt/SUNWsymon/archives
  程序檔會建立目錄 (若該目錄不存在)，然後啟用 ARCHIVELOGMODE。將會提示您啟動代理程式與伺服器元件。
6. 鍵入 y 並按 Enter 鍵。

執行線上備份。
1. 輸入此指令：
  # /opt/SUNWsymon/sbin/es-backup -o
  將會提示您輸入要儲存備份資料檔案的目錄路徑。
2. 按 Enter 接受預設路徑或輸入不同的路徑，例如：
  Enter full directory path to store the backup data files [/var/opt/SUNWsymon/backup]:
  /var/opt/SUNWsymon/mybackup
  備註 –
  若您接受預設目錄並於稍後想要解除安裝產品，備份檔可能會被刪除。在解除安裝產品之前，請將備份檔移到其他位置。或者，請使用不同的路徑來儲存備份檔。

停用 `ARCHIVELOGMODE`

若您不要開啟歸檔功能，您可以停用歸檔功能。

步驟

若要停用 ARCHIVELOGMODE，請輸入此指令：

# /opt/SUNWsymon/sbin/es-config -a disable

Sun Management Center 會關閉、歸檔記錄檔會被移除，而且產品會被重新啟動。

備份前關閉產品

步驟

若要在備份前關閉產品，您有兩個選擇：

要以互動式的方式執行備份，請輸入此指令：
# /opt/SUNWsymon/sbin/es-backup
要以無訊息模式執行備份並以預設答案回答程序檔的問題，請輸入此指令：
# /opt/SUNWsymon/sbin/es-backup -y
資料庫檔案儲存於目錄 /var/opt/SUNWsymon/backup 中。

如果您需要定期執行 es-backup script，可以為要例行執行的 script 設定 cron 程式。在此情況下，即可在 es-backup 程序檔中使用 -y 選項，則無需互動。