Sun Management Center 3.5 使用者指南

附錄 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 伺服器之後，如果預設連接埠正在使用中，安裝程序會提示您為登錄服務提供另一個連接埠號。

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

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

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

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

錯誤，超出虛擬記憶體大小

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

仔細評估情況。

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

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

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

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

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

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

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

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

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

按一下「警報」標籤按鈕。

警報列即會顯示出來。

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

讀取 Sun Management Center 日誌檔

Sun Management Center 伺服器和代理程式向目錄 /var/opt/SUNWsymon/log 中的各種日誌檔進行寫入。

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

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

使用 `ccat` 讀取 Sun Management Center 日誌檔

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

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

# /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 應用程式可被 ExampleSystemCommand Java 包裝類別包容，該類別可在單獨的程序中執行另一個程式或 shell script。此應用程式無需已選取的主機物件。應用程式一旦啟動，便不再與 Sun Management Center 互動。

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

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

每一個作為 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 資料庫以免遺失資料。例如，在您升級硬體或作業環境之前，應該備份資料庫。若要備份資料庫，請使用以下方法之一：

以下 script 以互動模式執行。此 script 可讓您指定資料庫檔案應該儲存的位置：
# /opt/SUNWsymon/sbin/es-backup
若要以靜音模式執行 es-backup 並使用預設答案回答 script 的問題，請使用以下指令：
# /opt/SUNWsymon/sbin/es-backup -y
資料庫檔案儲存於目錄 /var/opt/SUNWsymon/backup 中。

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

註解 –

在開始復原或備份之前，兩個 script 均會關閉 Sun Management Center 程序。一旦復原或備份完成，這些 script 均會重新啟動程序。

如果由於系統故障，您的 Sun Management Center 不慎毀壞，請作為超級使用者執行以下互動 script 以復原資料庫：

# /opt/SUNWsymon/sbin/es-restore

例如，當系統故障是由檔案系統問題引起時，您可能需要執行此程序。