
# --------------------------- ADD -------------------------------------------

<Add>
追加

使用法:  「追加」を押し、ダイアログを完了し、「追加」をクリックします。

以下の情報を CandleDBConfig に提供することにより、手動でサーバーを追加
できます:

1) Server name - モニターしたいデータベース・サーバーの名前

2) ホーム・ディレクトリー - サーバーがインストールされたディレクトリーの
   完全修飾名。

3) $Product バージョン -  データベース実行可能ファイルのバージョンまたはリリース・レベル。

4) Init file name - データベース初期設定ファイルの完全修飾名。
   このフィールドはオプションであり、情報提供のみを目的としたフィールドです。$Product
   の OMA に初期設定ファイル名は必要ありません。

5) Login ID - $Product と接続するために使用されるデータベース・ログイン ID。

6) Password - 「ログイン ID」とともに使用するパスワード。

この情報が指定されると、CandleDBConfig に表示されるデータベース・サーバーの
リストが更新され、新しいサーバーが含まれるようになります。

</Add>

# --------------------------- CHANGES ---------------------------------------
#
# Removed since it was only current to 98R2.

# --------------------------- DISPLAY ---------------------------------------
#
# DISPLAY has been combined with MODIFY.


# --------------------------- EXCLUDE ---------------------------------------

<Exclude/Include>
除外/組み入れ

使用法:  CandleDBConfig に表示されるデータベース・サーバーから 1 つ以上を選択し、
「除外」をクリックします。

「除外」は、実際にはトグルになっています。モニターしたくないサーバーを除外する
ために使用してください。あるサーバーが現在除外されている場合、「除外」を使用する
とそのサーバーが再アクティブ化され、モニター対象のサーバーに入れられます。

「検索」で非稼働サーバーも検索する場合、CandleDBConfig は、実データベースを
指す有効な $init_name ファイルを、サーバーを表すものと見なします。
ただし、$init_name ファイルは実験的なものであったり、使用されなくなっていたりする
場合があります。「除外」を使用すると、これらのサーバーがそれ以降検索対象から除外
されるようにすることができます。

サーバーが稼働していないというだけの理由でそのサーバーを除外する必要はありません。
エージェントが非稼働サーバーをモニターするように構成することや、さらにはそのエージェントを
開始するように構成することもできます。そのエージェントは CMS に登録され、データベースに
接続することを定期的に試みます。データベースが始動すると、エージェントはそれに関する報告
を開始します。したがって、常時稼働ではない $Product データベースをモニターするように
エージェントを定義して、そのエージェントが、データベース・アクティビティーの発生時に
そのアクティビティーを報告するようにすることができます。

CandleDBConfig に示されるデータベース・サーバーの「状況」フィールドが更新され、
除外されたサーバーが表示されるようになります。

</Exclude/Include>

# --------------------------- INTRO   ---------------------------------------
#
# Not used.

# --------------------------- LIST ------------------------------------------

<List Config Files>
構成ファイルのリスト

使用法:  CandleDBConfig に表示されるデータベース・サーバーから 1 つ以上を選択して、
「リスト」ビュー構成ファイルをクリックし、表示されている場合には「前へ」および
「次へ」ボタンを使用して別の構成を表示してから、「取り消し」をクリックします。

「リスト」は、CandleDBConfig によって作成されたデータベース・サーバー構成ファイル
の内容を表示するために使用されます。この時点では、ファイルは表示のみが行え、
CandleDBConfig から編集することはできません。

</List Config Files>

# --------------------------- LOCATE ----------------------------------------

<Search II (Disk Searches)>
検索 II (ディスク検索)

使用法:  「検索 II」をクリックし、検索タイプを選択し、「実行」をクリックします。

「検索 II」には、モニターしたいすべてのデータベースが「検索」で検出されない
場合に使用できる、いくつかの検索技法が用意されています。
「検索 II」では以下の選択を行うことができます:

1) \$PATH 内のスクリプトを検索し、$home_name を探す。

   データベース・アプリケーションを開始する際、通常どおり、ローカル作成された
   スクリプトを使用する場合、各スクリプトには、$home_name をデータベースの
   インストール・ディレクトリーに設定するステートメントが含まれている必要があります。
   このオプションは、UNIX \$PATH 内のすべてのスクリプトを検索して、このような
   ステートメントを探します。

2) 特定のディレクトリーから検索を開始する。このディレクトリーは通常、
   データベース所有者の \$HOME です。ただし、絶対パス名を使用する場合には、
   任意のディレクトリーを指定できます。このオプションは 1) と類似していますが、
   \$PATH で指定されたディレクトリーではなく、指定されたディレクトリー内の
   ディレクトリーに検索対象が限定される点が異なります。

3) $Product の所有者として考えられるユーザーを検索する。

   CandleDBConfig が、インストール済みのデータベースを所有している可能性のある
   UNIX ユーザーの \$HOME ディレクトリーにあるディスク・ファイルの中を検索するように
   要求できます。ID または記述に「$Prd」または「dba」という文字が含まれる、
   つまり $Product 所有者である可能性があるすべての UNIX ユーザーを示すリストが
   表示されます。このリストからユーザーを選択すると、CandleDBConfig が
   ディレクトリー・ツリー内からインストール済みの $Product を検索します。

   このオプションは、/etc/passwd ファイルあるいは「yp」または「nis」共用
   ログイン・データベースで定義されたユーザーをサポートします。また、このリスト
   にはファイル・システムが示されることにも注意してください。このフィールドを
   使用すると、ユーザーのディスクの物理的な位置が示されるため、そのユーザーを
   検索対象とするかどうかを決めることができます。

   注意:  NFS ファイル・システムが低速な通信リンクの相手側にあるマシンで管理
   されている場合、NFS ファイル・システム全体を検索すると非常に長い時間がかかる
   ことがあります。ただし、このようなファイル・システムには通常、このマシンで
   実行されるデータベース・サーバーは含まれません。


CandleDBConfig に表示されるデータベース・サーバーのリストが更新され、検索 II」
技法で検出された追加サーバーが含まれるようになります。

</Search II (Disk Searches)>

# --------------------------- LOGIN  ----------------------------------------

<Specify Logins/Passwords>
ログイン/パスワードの指定

使用法:  CandleDBConfig に表示されるデータベース・サーバーから 1 つ以上を選択して、
「指定」をクリックし、ダイアログを完了してから、「OK」をクリックします。

「指定」を使用すると、エージェントがデータベースへのアクセスに使用するデータベース
のログインおよびパスワードを定義できます。任意の新規または既存データベース・ログイン
ID を自由に選択できます。デフォルトのログインは「candle」です。データベース ID
はデータベース管理者によって定義され、データベースへのアクセスを可能にするものです。
UNIX ログイン ID は必ずしもデータベース・ログイン ID ではありませんが、両者に同じ
名前を付けることができます。OMA for $Product に定義されていながら、ログインまたは
パスワード情報が指定されていないサーバーは、CandleDBConfig で未完了 (incomplete) を
表す (I) を付けて表示されます。

「指定」では、Candle モニター・エージェントに対し、データベースへの接続方法のみが
指示されます。CandleDBConfig はデータベース・ログイン ID の作成、ログイン ID への
パスワードの割り当て、または必要な権限の付与を行いません。必ず、データベース・ログイン
およびパスワードが、ここで指定するログインおよびパスワードと一致するようにしてください。
ただし、「検査」で、CandleDBConfig で指定したログイン/パスワードがデータベースで実際に
機能するかどうかが検査されることになります。

パスワード・フィールドを空のままにすると、CandleDBConfig が、ヌル・パスワードを
使用したいのかを尋ねてきます。ヌル・パスワードを指定することは、データベース・
ログインを、パスワードなしで行えるように構成することを意味します。セキュリティー
上の理由から、ログ・ファイル $CANDLEHOME/logs/<host_name>_dd_config.log ではパスワード
は「xxxxxx」と表示されます。

Oracle 7.1.4 に関する注:  Oracle 7.1.4 では、内部管理ログイン ID 「sys」のみが
パフォーマンス・ビューを読み取ることができます。これはバグであり、Oracle のその
後のリリースでは修正されていますが、7.1.4 では修正は利用できません。したがって、
Oracle 7.1.4 データベースに接続するときには、「sys」というデータベース・ログイン ID
を指定する必要があります。

CandleDBConfig に表示されるデータベース・サーバーのリストが更新され、新規ログイン ID
が表示されるようになります。

</Specify Logins/Passwords>

# --------------------------- MODIFY  ---------------------------------------

<Modify/Display>
変更/表示

使用法:  CandleDBConfig に表示されるデータベース・サーバーから 1 つ以上を選択して、
「変更」をクリックし、ダイアログで値を入力または変更してから、「変更」をクリックします。

「変更」を使用すると、サーバーに関して構成された以下のすべての属性がリストされ、
サーバー名以外の任意の属性を変更できます: 

1) ホーム・ディレクトリー - サーバーがインストールされたディレクトリーの
   完全修飾名。

2) $Product バージョン -  データベース実行可能ファイルのバージョンまたはリリース・レベル。

3) 初期設定ファイル名 - データベース初期設定ファイルの完全修飾名。
   このフィールドはオプションであり、情報提供のみを目的としたフィールドです。$Product
   の OMA に初期設定ファイル名は必要ありません。

   重要:  サーバーの名前が変更された場合、新規の $init_name ファイルを指すものとして
   このフィールドを使用しないでください。代りに、このサーバーを除外し、CandleDBConfig
   に新規サーバーとして新しい名前を追加させてください。

4) ログイン ID - $Product と接続するために使用されるデータベース・ログイン ID。

5) パスワード - 「ログイン ID」とともに使用するパスワード。

CandleDBConfig に表示されるデータベース・サーバーのリストが更新され、新規構成情報
が表示されるようになります。

</Modify/Display>

# --------------------------- OPTIONS ------------------------------------------

<Options>
オプション

使用法:  「オプション」をクリックして、オプションを選択し、「OK」をクリックします。

「オプション」は、CandleDBConfig 操作のランタイムの動作を設定するために使用します。
「構成ファイルの検証」を選択すると、CandleDBConfig 操作のたびに、$CANDLEHOME/config
にあるデータベース構成ファイルが正しい形式になっているかが確認されます。


デフォルト (「既存のログ・ファイルを使用」) では、CandleDBConfig は、操作を実行
するたびにその既存ログ・ファイル $CANDLEHOME/logs/<host_name>_dd_config.log に項目
を書き込みます。最新の操作のみをログに記録したい場合、またはログに何も記録したく
ない場合には、「新規ログ・ファイルを作成」または「ログ・ファイルに書き込まない」を
選択してください。

</Options>

# --------------------------- OWNER  ----------------------------------------
#
# OWNER is now a part of Search2.

# --------------------------- SCAN ------------------------------------------

<Search>
検索

使用法:  必要に応じて「非稼働」にチェック・マークを付け、「オプション」を
クリックして、オプションを選択し、「OK」をクリックしてから、「検索」をクリックします。

CandleDBConfig を呼び出すか、「検索」を押すと、CandleDBConfig が環境の初期スキャンを
実行して、稼働中のすべての $Product サーバーを探します。「非稼働」にチェック・マーク
を付けると、CandleDBConfig は、現在稼働していないすべてのデータベースも検索します。
検索の結果は CandleDBConfig ダイアログに表示されます。

CandleDBConfig は稼働中のすべての $Product サーバーを検査し、それらが UNIX システム
上のどこにインストールされているのかを判別し、$Product サーバーに関するその他の情報
を獲得します。検索を完了するために必要な時間は、実行している UNIX のバージョンに
よって異なります。

CandleDBConfig に非稼働サーバーを検索するように要求した場合、CandleDBConfig は、
該当する可能性のあるすべての $home_name ディレクトリーの内部リストを作成し、そこに
定義されているサーバーを探します。CandleDBConfig は該当する可能性のある $home_name
ディレクトリーのリストを、以下のものから作成します:

1) 稼働中のサーバー (複数可) の $home_name ディレクトリー。

2) $home_name 環境変数の現行設定 (存在する場合)。

3) $home_name 環境変数を作成する、データベース所有者の \$HOME ディレクトリー内の
   自動スクリプト (.profile、.login など) に含まれるステートメント。

4) Oracle のインストール時に Oracle ポストインストール・ルート・スクリプト
   \$ORACLE_HOME/orainst/root.sh が実行されていた場合、このルート・スクリプト
   は /etc/oratab という名前のレジストリー・ファイルを作成しています。Oracle
   と Candle はともに、Oracle サーバーを検出しやすくするためにこのスクリプトを
   実行することを推奨しています。CandleDBConfig は、レジストリーまたは oratab
   ファイルの名前が /etc/oratab であると想定していることに注意してください。

モニターしたくないサーバーが「検索」で検出される場合には、「除外」ボタンを
使用してそのサーバーを除外できます。また、「オプション」ボタンで選択された検索
オプションは、変更されるまで有効です。

</Search>

# --------------------------- SYSTEM ---------------------------------------

<System/DB Config>
システム/DB 構成

OMEGAMON Monitoring Agent (OMA) がデータベースをモニターできるようにするために
必要な、システムとデータベースの準備の概要を次に示します。詳細については、
「Installing Candle Products on UNIX」文書を参照してください。

SYSTEM

1) kddos 実行可能ファイルは特別な UNIX 許可を必要とします。これらの許可は、OMA
   のインストール時に設定されているはずです。設定されていない場合には、Candle
   製品のインストーラーを使用して設定できます。詳細については、
  「Installing Candle Products on UNIX」文書を参照してください。

2) CMS は適切なシード・データでシードしなければなりません。CMS は、OMA
   のインストール時にシードされているはずです。シードされていない場合には、Candle
   製品のインストーラーを使用してシードできます。詳細については、
  「Installing Candle Products on UNIX」文書を参照してください。

データベース

Informix

Informix のために必要な許可は、データベースに接続する権限のみです。
$CANDLEHOME/misc/koxgrant.sql は、そのための正しい SQL 構文を備えています。

OMA for Informix にはオプションの Informix ALARMPROGRAM として実行する必要の
あるプログラムが含まれています。ONCONFIG を変更して、ALARMPROGRAM をご使用の
UNIX システムに適した $CANDLEHOME/<arch>/koxerr にしてください。すでにカスタム
ALARMPROGRAM がある場合には、koxerr.sh を指すように ONCONFIG ALARMPROGRAM
ステートメントを変更し、ご使用のプログラムを指すように koxerr.sh を変更して
ください。koxerr.sh スクリプトには完全な手順が含まれています。

ORACLE

OMA for Oracle は、データベースに接続するために Oracle ログイン ID を使用します。
Oracle 7.1.4 を除き、OMA は、他の目的に使用されるものであっても、任意の Oracle ID
を使用できます。CandleDBConfig はこの ID を作成しません。この ID は、希望する場合
には、パスワードなしで定義することができます。その場合、CandleDBConfig に対して
ヌル・パスワードを示してください。また、Oracle のログインおよびパスワードでは大/小
文字は区別されません。

次の Oracle SQL ステートメントは、Oracle に対して ID とパスワードを定義するものです。
この例で、「oralogin」は使用する Oracle ログインを示し、「password」はそのパスワードを
示しています。

  CREATE USER oralogin IDENTIFIED BY password;

セキュリティー要件は、以下の Oracle リリースごとに異なります。

  7.1.4  OMA for Oracle の接続は「sys」として行う必要があります。これは Oracle
         の制限です。

  7.1.6  任意の Oracle ログインを使用することができますが、そのログインはすべての
         表を読み取る権限を持っていなければなりません。この ID が「candle」で
         ある場合には、DBA 特権を持つ Oracle ログインで Oracle に接続して、以下の
         SQL ステートメントを発行することにより、この権限を付与することができます。

           GRANT SELECT ANY TABLE TO oralogin;

         この要件は Oracle の制限です。

  7.2 以降。任意の Oracle ログインを使用することができますが、そのログインには
      特定の特権が付与されている必要があります。Candle には、これらの権限付与を
      行う SQL スクリプトが用意されています。このスクリプトは
      $CANDLEHOME/misc/korgrant.sql にあります。このスクリプトを実行するための
      手順を以下に示します。詳細については、
      「Installing Candle Products on UNIX」文書を参照してください。

      a) このインストール済み環境に合わせて Oracle 環境変数 ORACLE_SID および
         ORACLE_HOME を設定します。データベースの構成が完了している場合、構成
         ディレクトリー内のファイルの「ソースを示」し、それらの変数を設定し
         ます。

      b) sqlplus を開始します。

      c) SQL プロンプトで次のように発行します:  SQL> @korgrant candle

      注意:  sqldba および svrmgr(l) では、sql スクリプトでパラメーターを
      使用することができません。これらのいずれかのプログラムで korgrant.sql を
      使用する場合、&1 のすべてのオカレンスを、使用したいログオン ID で置き換える
      ように変更する必要があります。

OMA for Oracle では、Oracle パフォーマンス・ビューおよびシノニムがインストール
されている必要があります。これらは、Oracle インストーラーが最後まで実行されると、
インストーラーによって作成されます。パフォーマンス・ビューとシノニムは、
ORACLE_HOME/rdbms/admin にある該当の SQL スクリプトによっても作成できます。詳し
くは Oracle 文書を参照してください。
この要件は、Oracle 「sys」ログイン ID を使用する場合には不要です (Oracle 7.1.4
ではこのログイン ID を使用する必要があります)。

Oracle 7.2 の場合に限り、Oracle は V\$LATCH テーブルへの権限付与を無視します。
これを訂正するには、Oracle パッチを適用して「基本バグ #254661」を訂正してくだ
さい。このパッチを適用すると、「キャッシュ合計レポート」のデータを表示できるよ
うになります。このパッチをインストールしない場合は、「sys」ログインで Oracle を
インストールする必要があります。

OMA for Oracle では SYS.DBA_VIEWS および SYS.DBA_SYNONYMS テーブルへのアクセスは
必要になりませんが、CandleDBConfig の「検査」手順ではこれらのテーブルへのアクセスが
必要になります。CandleDBConfig は、これらのテーブルを読み取ることができない場合、
インストール済み環境を完全に検証することができません。ただし、その場合にも OMA
は機能します。

Sybase

OMA for Sybase は、データベースに接続するために Sybase ログイン ID を使用します。
OMA for Sybase は、他の目的に使用されるものであっても、任意の Sybase ID を使用
できます。CandleDBConfig はこの ID を作成しません。この ID は、希望する場合
には、パスワードなしで定義することができます。その場合、CandleDBConfig に対して
ヌル・パスワードを示してください。また、Sybase のログインおよびパスワードでは大/小
文字が区別されます。

次の Sybase isql ステートメントは、Sybase に対して ID とパスワードを定義するものです。
この例で、「syblogin」は使用する Sybase ログインを示し、「password」はそのパスワードを
示しています。

  sp_addlogin syblogin,password
  go

Candle には、必要な権限を付与するための SQL スクリプト
$CANDLEHOME/misc/koygrant.sql も用意されています。


OMEGAMON Monitoring Agent for Sybase は、Sybase の「Open Client」ライブラリー
を使用して Sybase に接続します。「Open Client」が Sybase システムに
インストールされていない場合、エージェントは Sybase に接続できず、
CT-INIT が失敗したことを示すメッセージが col.out ファイルに示されます。
Sybase ホーム・ディレクトリーで lib/libct.a の有無を調べることにより、
「Open Client」がインストールされているかどうかを判別できます。

「Open Client」がインストールされていない場合、次のいずれかを取得する必要が
あります。

1) Sybase 提供の「Open Client」製品。弊社では、各 Sybase サーバー・ライセンスごとに、
単一の無償「Open Client」の使用資格がユーザーに与えられるものと理解しています。
詳しくは Sybase にご連絡ください。

2) CTlib for Sybase のランタイム・バージョン。これは、Candle Level 2 サポート
から無償で入手できます。Candle は、Sybase より、CTlib のランタイム部分を配布
する許可を受けています。

</System/DB Config>

# --------------------------- VERIFY ---------------------------------------

<Verify OMA Installation>
OMA インストールの検査

使用法:  「検査」をクリックして、ダイアログに表示される結果を確認し、
「取り消し」をクリックします。

「検査」を使用すると、以下のことが検査されて、OMA が適切にインストールされ
ているかどうかが確かめられます。

1) 有効な UNIX バージョンが存在する。

2) $CANDLEHOME の主要なディレクトリーについて適切な UNIX 許可がある。

3) kddos について特別な UNIX 許可が設定されている。

4) このホストに関する製品構成ファイルが存在する。

「検査」では、構成済みのサーバーごとに次のことを検査します:

5) 構成ファイルが有効であり、構成が完了している。

6) データベース・ホーム・ディレクトリーとデータベース初期設定ファイルが
   存在し、このファイルに対する読み取り権限がある。

7) サーバー用に Sybase Open Client 製品がインストールされている。

8) データベース・サーバーが稼働している。稼働していない場合、この
   データベースに関する OMA の検査は続行できません。

9) データベースに正常にログインできる。

10) Oracle V\$ パフォーマンス・テーブルにアクセスできる。アクセスできない
   場合には、次のことが考えられます。

    a) これらのテーブルが作成されていない (計画ガイドの第 5 章にある『V\$ 動的
       パフォーマンス・テーブル』を参照してください)。

    b) korgrant.sql スクリプトが実行されていない。

    DBA 権限がないと、原因がいずれであるかを特定できません。

    「検査」では、すべての Oracle パフォーマンス・ビューおよびシノニムがテスト
    されます。Oracle インストールでパフォーマンス・ビューとシノニムが部分的にし
    か作成されなかったため、OMA for  Oracle は、いくつかのサイトで失敗しています。
    また、このテストのためには、Oracle ユーザーが SYS.DBA_VIEWS および
    SYS.DBA_SYNONYMS に対する SELECT 権限を持っていることが必要です。これらの
    権限付与は、korgrant.sql スクリプトの一部には含まれません。ほとんどの
    Oracle インストールでは、カタログ・テーブルに対する SELECT 権限が PUBLIC
    に与えられているためです。

11) Oracle 7.2 SYS.V_\$LATCH パフォーマンス・ビューにアクセスできる。アクセス
    できない場合は、「Installing Candle Products on UNIX」文書を参照してください。

12) Sybase koygrant.sql スクリプトが実行されている。このスクリプトは、sa_role
    を Sybase ログインに付与します。

13) Informix の場合、ONCONFIG ファイルの ALARMPROGRAM ステートメント
    に対して必要な変更がサイトで行われている。「Installing Candle
    Products on UNIX」文書を参照してください。

14) CMS ホストが ping に応答する。

15) エージェントが CMS に接続できる。接続できない場合には、次のことが考えられます。

    a) CMS ホスト、CMS ポート番号、または CMS 名が正しくない。

    b) CMS が実行されていない。

    CMS マシンへの直接アクセス権と CMS がそのマシンにインストールされている正確な
    場所に関する情報がないと、CandleDBConfig は原因がいずれであるかを特定できません。

16) CMS がシードされていて、シード後にリサイクルされている。CMS がリサイクル
    された直後の場合、初期の結果は確定的でないものとなる可能性があります。したがって、
    「検査」は、CMS がダウンしているか、シードされていないと判定するまで、エージェント
    を最長 5 分まで実行させます。ただし、CMS がダウンしているとエージェントが判断
    した場合、IVP エージェントがただちにリサイクルされます。これは、デフォルトの動作
    では、再接続を試みるまで 10 分待つようになっているためです。

「検査」では以下のことは検査されません:

1) CMS 内の cat、atr、sql (シード・データ)、および his ファイルが、この
   インストール済みエージェントと整合するレベルになっている。

2) タイミングの問題が原因で通信がタイムアウトになる。

3) Informix の場合、サイトでシステム・テーブルに関する SELECT 権限が PUBLIC
   に設定されたままになっている。koxgrant.sql スクリプトにはこれらに関する
   特別な権限付与は含まれていません (サイトでこれらの権限付与は Informix の
   出荷時の設定のままになっていると想定されています)。

</Verify OMA Installation>

