
# --------------------------- 新增 -------------------------------------------

<Add>新增

用法：按一下「新增」完成對話框；按一下「新增」。

您可以藉由提供下列資訊給 CandleDBConfig，以手動新增伺服器：

1) 伺服器名稱 - 要監視的資料庫伺服器名稱。

2) 起始目錄 - 安裝伺服器之目錄的完整名稱。

3) $Product 版本 -  資料庫可執行檔的版本或版次。

4) Init 檔案名稱 - 資料庫起始設定檔的完整名稱。此為選用欄位，而且提供的目的是僅供參考。$Product 的 OMA 不需要 init 檔名。

5) 登入 ID - 用於連接 $Product 的資料庫登入 ID。

6) 密碼 - 與「登入 ID」一起使用的密碼。

提供此資訊後，CandleDBConfig 中顯示的資料庫伺服器清單會更新，以併入新的伺服器。

</Add>

# --------------------------- 變更 ---------------------------------------
#
# 僅對 98R2 存在，因此已經移除。

# --------------------------- 顯示 ---------------------------------------
#
# 「顯示」已經與「修改」結合。


# --------------------------- 排除 ---------------------------------------

<Exclude/Include>
排除/併入

用法：從 CandleDBConfig 中顯示的資料庫伺服器中選取一或多個資料庫伺服器；按一下「排除」。

「排除」實際上是一種切換工具。使用它來排除您不想監視的伺服器。
如果目前已排除伺服器，則「排除」將重新啟動該伺服器，並併入到您正在監視的伺服器中。
如果「搜尋」也找到非執行中的伺服器，則 CandleDBConfig 會考量使用任何指向實際資料庫
的有效 $init_name 檔案，以代表伺服器。
不過，$init_name 檔案可能是實驗性或已作廢。「排除」可讓您將這些伺服器從進一步考量中排除。


請注意，不需要因為伺服器未在執行中，就排除該伺服器。您可以配置代理站，以監視非執行中的伺服器，甚至可以啟動該代理站。
代理站將登錄於 CMS 並定期嘗試連接資料庫。如果資料庫已啟動，則代理站將開始針對它進行報告。
因此，您可以定義代理站監視僅部分時間執行的 $Product 資料庫，且該代理站會在資料庫活動發生時進行報告。

CandleDBConfig 中所顯示之資料庫伺服器的「狀態」欄位會更新，以顯示已排除的伺服器。

</Exclude/Include>

# --------------------------- 簡介   ---------------------------------------
#
# 未使用。

# --------------------------- 清單 ------------------------------------------

<List Config Files>
清單配置檔

用法：從 CandleDBConfig 中顯示的資料庫伺服器中選取一或多個資料庫伺服器；
按一下「清單」檢視配置檔；如果顯示，則使用「上一個」及「下一個」按鈕來檢視不同的配置檔；按一下「取消」。

「清單」可用於檢視 CandleDBConfig 所建立之資料庫伺服器配置檔案的內容。此時，您只能檢視這些檔案；而不能從 CandleDBConfig 編輯它們。

</List Config Files>

# --------------------------- 尋找 ----------------------------------------

<Search II (Disk Searches)>
搜尋 II (磁碟搜尋)

用法：按一下「搜尋 II」；選取搜尋類型；按一下「執行」。

「搜尋 II」提供了數種搜尋技術，如果「搜尋」找不到要監視的所有資料庫，則您可以使用這些技術。
您的「搜尋 II」選項為：

1) 搜尋 \$PATH 中的 Script，尋找 $home_name。

   如果您通常使用在本端撰寫的 Script 啟動資料庫應用程式，
   則每個 Script 都必須包含陳述式，其會將 $home_name 設為資料庫的安裝目錄。
   此選項會搜尋 UNIX \$PATH 中的所有 Script，以尋找此類陳述式。

2) 搜尋，於特定目錄中開始。此目錄通常是資料庫擁有者的 \$HOME。不過，如果使用完整路徑名稱，則您可以指定任何目錄。
   除了搜尋受限於指定目錄下的目錄，而不是 \$PATH 中指定的目錄之外，此選項與 1) 類似。

3) 搜尋可能的 $Product 擁有者。

   您可以要求 CandleDBConfig 搜尋 UNIX 使用者的 \$HOME 目錄下的磁碟檔，這些使用者可能擁有該個資料庫安裝環境。
   然後，顯示其 ID 或說明中有 "$Prd" 或 "dba" 字元的所有 UNIX 使用者清單，他們可能是 $Product 擁有者。
   從此清單選取使用者之後，CandleDBConfig 會搜尋其目錄樹狀結構，以尋找 $Product 安裝。

   請注意，此選項支援 /etc/passwd 檔案或者 "yp" 或 "nis" 共用登入資料庫中定義的使用者。也請注意清單中指定的檔案系統。
   因為此欄位會告訴您使用者磁碟的實際位置，所以可協助您決定是否考慮該使用者。

   警告：如果檔案系統由慢速通訊鏈結另一端上的機器所管理，則搜尋 NFS 檔案系統可能要花費很長的時間。
   然而，此類檔案系統通常不包含此機器上執行的資料庫伺服器。


然後，CandleDBConfig 中顯示的資料庫伺服器清單會更新，以併入使用「搜尋 II」技術找到的任何其他伺服器。

</Search II (Disk Searches)>

# --------------------------- 登入  ----------------------------------------

<Specify Logins/Passwords>
指定登入/密碼

用法：從CandleDBConfig 中顯示的資料庫伺服器中選取一或多個資料庫伺服器；
按一下「指定」完成對話框；按一下「確定」。

「指定」可讓您定義代理站用於存取資料庫的資料庫登入及密碼。
您可以選取任何新的或現有的資料庫登入 ID。
預設登入為 "candle"。請注意，資料庫 ID 由資料庫管理者定義，並容許對資料庫進行存取。
UNIX 登入 ID 不一定是資料庫登入 ID，但是二者的名稱可以相同。
定義為 $Product 的 OMA，但是沒有任何登入或密碼資訊的伺服器會在 CandleDBConfig 內使用 (I) 顯示，表示不完整。

「指定」「只」告訴 Candle 監視代理站如何連接資料庫。
CandleDBConfig 不會建立資料庫登入 ID、為其指定密碼，或授與必要的權限。
您有責任確保資料庫登入及密碼與此處指定的項目相符。
不過，「驗證」將檢查 CandleDBConfig 中指定的登入/密碼實際上是否適用於資料庫。

如果您將密碼欄位保留空白，則 CandleDBConfig 會詢問您是否確定需要空值密碼。
空值密碼表示已配置資料庫登入，不需要密碼即可運作。
基於安全性考量，密碼在日誌檔 $CANDLEHOME/logs/<host_name>_dd_config.log 中顯示為 "xxxxxx"。

Oracle 7.1.4 注意事項：racle 7.1.4 僅容許內部管理登入 ID "sys" 讀取效能視圖。Oracle 已在以後的版次中修正此錯誤，但
7.1.4 則沒有此修正程式。因此，連接至 Oracle 7.1.4 資料庫時，您必須指定資料庫登入 ID "sys"。

然後，CandleDBConfig 中顯示的資料庫伺服器清單會更新，以顯示任何新的登入 ID。

</Specify Logins/Passwords>

# --------------------------- 修改  ---------------------------------------

<Modify/Display>
修改/顯示

用法：從 CandleDBConfig 中顯示的資料庫伺服器中選取一或多個資料庫伺服器；
按一下「修改」輸入或變更對話框中的值；按一下「修改」。

「修改」列出伺服器下列所有已配置的屬性，並可讓您變更除伺服器名稱以外的任何屬性：

1) 起始目錄 - 安裝伺服器之目錄的完整名稱。

2) $Product 版本 - 資料庫可執行檔的版本或版次。

3) Init 檔案名稱 - 資料庫起始設定檔的完整名稱。此為選用欄位，而且提供的目的是僅供參考。$Product 的 OMA 不需要 init 檔名。

   重要事項：如果伺服器已變更名稱，「請勿」使用此欄位指向新的 $init_name 檔案。請改為排除此伺服器，並讓 CandleDBConfig 新增名稱作為新伺服器。

4) 登入 ID - 用於連接 $Product 的資料庫登入 ID。

5) 密碼 - 與「登入 ID」一起使用的密碼。

然後，CandleDBConfig 中顯示的資料庫伺服器清單會更新，以顯示任何新配置資訊。

</Modify/Display>

# --------------------------- 選項 ------------------------------------------

<Options>
選項

用法：按一下「選項」選取選項；按一下「確定」。

「選項」可用於設定 CandleDBConfig 作業的執行時期行為。
如果已選取「驗證配置檔」，則每一個 CandleDBConfig 作業都會確定位於 $CANDLEHOME/config 中的資料庫配置檔具有正確的格式。

根據預設值 (使用現有日誌檔)，每次執行作業時，CandleDBConfig 都會將項目寫入其現有日誌檔 $CANDLEHOME/logs/<host_name>_dd_config.log。
如果您要僅記載最新作業或不記載任何內容，請選取
「建立新日誌檔」或「不寫入日誌檔」。

</Options>

# --------------------------- 擁有者  ----------------------------------------
#
# 「擁有者」現在是 Search2 的一部分。

# --------------------------- 掃描 ------------------------------------------

<Search>
搜尋

用法：如果需要，請勾選「未執行」；按一下「選項」選取選項；
按一下「確定」；按一下「搜尋」。

呼叫 CandleDBConfig 或按「搜尋」時，CandleDBConfig 會執行環境的起始掃描，以尋找所有執行中的
$Product 伺服器。如果您勾選「未執行」，則 CandleDBConfig 也會搜尋目前未執行的資料庫。
搜尋結果會顯示在 CandleDBConfig 對話框中。

CandleDBConfig 會檢查所有執行中的 $Product 伺服器，尋找它們在 UNIX 系統上的安裝位置，並獲得它們的其他相關資訊。
完成搜尋所需的時間視您所執行的 UNIX 版本而定。

如果您需要 CandleDBConfig 搜尋非執行中的伺服器，則其會建立所有可能
 $home_name 目錄的內部清單，並尋找該清單中定義的任何伺服器。
CandleDBConfig 會從下列位置顯現出此可能的 $home_name 目錄清單：

1) 任何執行中伺服器的 $home_name 目錄。

2) $home_name 環境變數的目前設定 (若有的話)。

3) 自動 Script 中的任何陳述式 (.profile、.login 等)，其位於建立 $home_name 環境變數之資料庫擁有者的 \$HOME 目錄中。

4) 如果安裝 Oracle 時，Oracle 後置安裝 Root script (\$ORACLE_HOME/orainst/root.sh) 正在執行，則其會建立名為 /etc/oratab 的登錄檔。Oracle 與 Candle 都建議您執行此 Script，以輕鬆地找到
   您的 Oracle 伺服器。請注意，CandleDBConfig 假設該登錄或 oratab 檔案名為 /etc/oratab。

如果「搜尋」找到您不想監視的伺服器，您可以使用「排除」按鈕排除它。此外，任何使用「選項」按鈕選擇的搜尋選項，在您變更它們之前都會有效。

</Search>

# --------------------------- 系統 ---------------------------------------

<System/DB Config>
系統/DB 配置

下列是「OMEGAMON 監視代理站 (OMA)」可以監視資料庫之前，所需的系統及資料庫準備的簡要概觀。請參閱文件「在 UNIX 上安裝 Candle 產品」，以取得完整明細。

SYSTEM

1) kddos 可執行檔需要特殊 UNIX 許可權。這些許可權應該在安裝 OMA 時已設定。
   如果未設定，則可以使用 Candle 產品安裝程式設定它們。如需明細，請參閱「在 UNIX 上安裝 Candle 產品」文件。

2) CMS 必須與適當的種子資料一起植入。CMS 應該在安裝 OMA 時已植入。
   如果未植入，則可以使用 Candle 產品安裝程式植入它們。如需明細，請參閱「在 UNIX 上安裝 Candle 產品」文件。

資料庫

INFORMIX

Informix 所需的唯一權限是連接資料庫的權限。$CANDLEHOME/misc/koxgrant.sql 具有執行此動作的正確 SQL 語法。

Informix 的 OMA 包括需要作為選用 Informix ALARMPROGRAM 執行的程式。修改 ONCONFIG，以讓 ALARMPROGRAM 成為適合您 UNIX 系統種類的 $CANDLEHOME/<arch>/koxerr。如果您已經具有自訂 ALARMPROGRAM，請修改 ONCONFIG ALARMPROGRAM 陳述式，以指向
koxerr.sh，並修改 koxerr.sh 以適用於您的程式。koxerr.sh
Script 具有完整指示。

ORACLE

Oracle 的 OMA 使用 Oracle 登入 ID 連接資料庫。除了 Oracle 7.1.4 以外，OMA 可能會使用任何 Oracle ID，即使該 ID 用於其他目的。
CandleDBConfig 不會建立此 ID。如果需要，可以定義不含密碼的 ID。如果是，請向 CandleDBConfig 指出空值密碼。
此外，Oracle 登入及密碼「不」區分大小寫。

下列 Oracle SQL 陳述式定義 Oracle 的 ID 及密碼。在此範例中，
"oralogin" 表示要使用的 Oracle 登入，而 "password" 表示其密碼：

  CREATE USER oralogin IDENTIFIED BY password;

下列 Oracle 版次的安全需求會有所不同：

  7.1.4 Oracle 的 OMA 必須以 "sys" 連接。這是 Oracle 的限制。

  7.1.6  您可使用任何 Oracle 登入，但其必須具有讀取任何表格的權限。
         如果 ID 為 "candle"，則您需要使用具有 DBA 專用權的 Oracle 登入連接 Oracle，並發出下列 SQL 陳述式，才能授與此權限：

           GRANT SELECT ANY TABLE TO oralogin;

         此基本需求是 Oracle 的限制。

  7.2 與以上的版本。您可使用任何 Oracle 登入，但是它僅需要為其授與特定的專用權。
      Candle 提供的 SQL Script 會執行這些授與。
      此 Script 位於 $CANDLEHOME/misc/korgrant.sql 中。
      此處為執行此 Script 的簡要指示。如需詳細資訊，請參閱「在 UNIX 上安裝 Candle 產品」文件。

      a) 設定此安裝的 Oracle 環境變數，ORACLE_SID 及 ORACLE_HOME。
         如果您已完成資料庫的配置，則可以將配置目錄中的檔案作為「來源」，以設定這些變數。

      b) 啟動 sqlplus。

      c) 於 SQL 提示處發出下列指令：SQL> @korgrant candle

      注意：sqldba 及 svrmgr(l) 不容許具有 sql Script 的參數。
      如果您使用其中一個程式執行 korgrant.sql，則必須對其進行修改，以使用要使用的登入 ID 取代所有出現的 &1。

Oracle 的 OMA 需要安裝 Oracle 效能視圖及同義字。
如果執行即將完成，則它們由 Oracle 安裝程式建立。
效能視圖及同義字也可以由 ORACLE_HOME/rdbms/admin 中適當的 SQL Script 建立。請參閱您的 Oracle 文件以取得明細。
請注意，如果您使用 Oracle "sys" 登入 ID，則此基本需求不是必要的，而對於 Oracle 7.1.4 則必須執行。

(僅限 Oracle 7.2) Oracle 會忽略對 V\$LATCH 表格的授與。若要更正此問題，請套用 Oracle 修補程式來更正「基本錯誤 #254661」。此修補程式可讓您檢視「快取總數報告」中的資料。如果您未安裝此修補程式，則必須使用 "sys" 登入安裝 Oracle。

Oracle 的 OMA 不需要存取 SYS.DBA_VIEWS 及 SYS.DBA_SYNONYMS 表格，但 CandleDBConfig 的「驗證」程序需要。如果 CandleDBConfig 無法讀取這些表格，就無法完全驗證安裝。
然而，OMA 仍然可以運作。

SYBASE

Sybase 的 OMA 使用 Sybase 登入 ID 連接資料庫。它可以使用任何 Sybase ID，即使該 ID 用於其他目的。CandleDBConfig 不會建立此 ID。如果需要，可以定義不含密碼的 ID。如果是，請向 CandleDBConfig 指出空值密碼。
此外，Sybase 登入及密碼「會」區分大小寫。

下列 Sybase isql 陳述式定義 Sybase 的 ID 及密碼。在此範例中，"syblogin" 表示要使用的 Sybase 登入，而 "password" 表示其密碼：

  sp_addlogin syblogin,password
  go

Candle 還提供 SQL Script ($CANDLEHOME/misc/koygrant.sql)，以授與必要的權限。

OMEGAMON Monitoring Agent for Sybase 使用 Sybase「開放式用戶端」程式庫連接 Sybase。如果 Sybase 系統上未安裝「開放式用戶端」，
則代理站無法連接 Sybase，且您會收到 col.out 檔案中的訊息，其指出 CT-INIT 失敗。您可以藉由檢查 Sybase 起始目錄中的 lib/libct.a，以判定是否已安裝「開放式用戶端」。

如果未安裝「開放式用戶端」，則您必須取得下列一項：

1) Sybase 的「開放式用戶端」產品。我們需要理解，每一個 Sybase 伺服器授權都會授與客戶單一可用的「開放式用戶端」授權。如需相關資訊，請聯絡 Sybase。

2) CTlib for Sybase 的執行時期版本。這在 Candle「層次 2」支援中是免費使用的。Candle 具有 Sybase 的許可權，可以配送 CTlib 的執行時期部分。

</System/DB Config>

# --------------------------- 驗證 ---------------------------------------

<Verify OMA Installation>
驗證 OMA 安裝

用法：按一下「驗證」檢查對話框中顯示的結果；按一下「取消」。

「驗證」藉由檢查下列項目，可確定已正確地安裝 OMA：

1) 存在有效的 UNIX 版本。

2) $CANDLEHOME 下金鑰目錄上的 UNIX 許可權是正確的。

3) 已為 kddos 設定特殊的 UNIX 許可權。

4) 此主機存在產品配置檔。

對於每一個已配置的伺服器，「驗證」都會檢查下列項目：

5) 配置檔有效，且配置是完整的。

6) 存在資料庫起始目錄及資料庫起始設定檔，而且您具有對該檔案的讀取權。

7) 伺服器上已安裝 Sybase「開放式用戶端」產品。

8) 資料庫伺服器正在執行。如果未執行，則此資料庫的 OMA 驗證無法繼續。

9) 您可以順利登入資料庫。

10) 您可以存取 Oracle V\$ 效能表格。如果無法存取，則可能由於下列原因：

    a) 從未建立表格 (請參閱規劃手冊的第 5 章中，標題如下的小節：「V\$ 動態效能表格」)。

    b) korgrant.sql Script 未執行。

    沒有 DBA 權限，則無法知道是哪種情況。

    請注意，「驗證」會測試所有 Oracle 效能視圖及同義字。部分站台的 Oracle 的 OMA
    已失敗，因為 Oracle 安裝時僅建立了部分效能視圖及同義字。
    而且，此測試需要 Oracle 使用者具有對 SYS.DBA_VIEWS 及 SYS.DBA_SYNONYMS 的 SELECT 權限。
    這些授權「不是」korgrant.sql Script 的一部分，因為大部分 Oracle 安裝都會授與對型錄表的 SELECT 權限給 PUBLIC。

11) 您可以存取 Oracle 7.2 SYS.V_\$LATCH 效能視圖。如果無法存取，請參閱「在 UNIX 上安裝 Candle 產品」文件。

12) Sybase koygrant.sql Script 已執行。此 Script 會將 sa_role 授與 Sybase 登入。

13) 若為 Informix，您的站台會對 ONCONFIG 檔案 ALARMPROGRAM 陳述式進行必要的修改。請參閱「在 UNIX 上安裝 Candle 產品」文件。

14) CMS 主機對 Ping 作出回應。

15) 代理站可以連接 CMS。如果無法連接，則可能由於下列原因：

    a) CMS 主機、CMS 埠號或 CMS 名稱是錯誤的。

    b) CMS 未執行。

    如果沒有對 CMS 機器的直接存取權，且不知道 CMS 在該機器上確切的安裝位置，則 CandleDBConfig 無法指出是哪個原因。

16) 已植入 CMS，並自植入後重新啟動。如果僅重新啟動 CMS，則可能不會包括先前的結果。
    基於這個原因，「驗證」
    讓代理站執行長達五分鐘後，才能斷定 CMS 已關閉還是未植入。
    然而，如果代理站判定 CMS 已關閉，則 IVP 代理站會立即重新啟動，因為預設行為是等待十分鐘，然後再嘗試重新連接。

「驗證」不會檢查下列項目：

1) cat、atr、sql (種子資料) 及其在 CMS 中的檔案，與已安裝的此代理站位於一致層次。

2) 計時問題導致通訊逾時。

3) 若為 Informix，您的站台尚未從 PUBLIC 撤消系統表格的 SELECT 權限。
   koxgrant.sql Script 不包含這些項目的特定授權
   - 它假設您的站台將這些授權保留為 Informix 原始出貨時的狀態。

</Verify OMA Installation>

