第 4 章 コマンド
4.5 clgetoralog - Oracle 調査資料採取
3.6 ログファイル
PRIMECLUSTER Wizard for Oracle では、次のディレクトリにログファイルを出力します。
・ /var/opt/reliant/log 配下
RMS および userApplication が動作している間、特に userApplication の状態遷移が行われた場合に、追記型で出力されますが、
RMS により使用量管理が行われています。
参照
詳しくは、「PRIMECLUSTER RMS 導入運用手引書」を参照してください。
・ /var/opt/FJSVclora 配下
RMS および userApplication が動作している間、出力されますが、一定量に到達するとそれ以上は増えません。
－ Oracle インスタンスリソース
１つにつき、最大 5.5MB (スタンバイ運用、Oracle RAC スケーラブル運用共通)
－ リスナーリソース
１つにつき、最大 4.5MB (スタンバイ運用、Oracle RAC スケーラブル運用共通)
－ ASM インスタンスリソース １つにつき 0.0MB (出力なし)
－ Oracle Clusterware リソース １つにつき 0.0MB (出力なし)
注意
これらのログファイルは、トラブル発生時の調査資料となりますので、不用意に削除・編集しないでください。
第 4 章 コマンド
4.1 hvoradisable - リソース監視の中断
実行ユーザー スーパーユーザー 形式
/opt/FJSVclora/sbin/hvoradisable userApplicationResource /opt/FJSVclora/sbin/hvoradisable -a [ userApplication ] 機能説明
本コマンド実行ノード (ローカルノード) 上に存在する指定された Oracle インスタンス、リスナーリソースの監視を中断します。Oracle の保守などで Oracle インスタンス、リスナーの停止を行いたい場合に使用します。userApplication が停止中/起動中の両方で使用 できます。
userApplication が停止中に使用した場合、次に userApplication を起動した時、Oracle インスタンス、リスナーの起動を行わずに、
リソースの状態が Warning になります。
userApplication が運用中に使用した場合は、すぐに監視を無効にします。このときリソースの状態は Warning となり、Oracle インス タンス、リスナーを停止しても、リソースは Warning のままとなります。(userApplication 運用中に使用する場合、リソースの状態が
Warning になったことを確認して Oracle インスタンス、リスナーの停止を行ってください。)
userApplication を停止するときには、リソース監視の中断設定は、自動的に解除されます。
参考
－ ASM インスタンスリソース、Oracle Clusterware リソースは監視が行われませんので、本コマンドによる監視の中断は必要ありま せん。
－ ASM インスタンスリソースについての詳細は、「2.4.2 ASM（Automatic Storage Management）を使用する場合」を参照してくだ さい。
パラメータ
userApplication Resource
userApplication には、監視中断するリソースが含まれる userApplication 名を指定します。 Resource には、監視中断する Oracle インスタンスリソース、リスナーリソースいずれかのリソース名を指定します。
userApplicationとResourceには、ローカルノードに存在するものを指定してください。
-a [ userApplication ]
ローカルノード上に存在し、かつ userApplication に指定された userApplication に属する全ての Oracle インスタンス、リスナー リソースの監視を中断します。
userApplicationが省略された場合、本コマンドはローカルノード上の全ての Oracle インスタンス、リスナーリソースの監視を中 断します。
終了ステータス
0 : 正常終了 1 : 異常終了
2 : 異常終了 (-a オプション指定時に、いくつかのリソースの監視中断に失敗)
注意
本コマンドの実行タイミングに注意してください。状態不整合や意図せぬリソース異常を引き起こす場合があります。
・ 本コマンドを userApplication の状態遷移中に実行してはいけません。
・ 本コマンドを RMS 停止中に実行してはいけません。
・ 本コマンドの実行直後に、userApplication の起動や停止を行わないでください(5秒程度の間を置いてください)。
4.2 hvoraenable - リソース監視の再開
実行ユーザー スーパーユーザー 形式
/opt/FJSVclora/sbin/hvoraenable userApplicationResource /opt/FJSVclora/sbin/hvoraenable -a [ userApplication ] 機能説明
hvoradisable コマンドによってリソース監視が中断されたローカルノード上の Oracle インスタンスリソース、リスナーリソースの監視を 再開します。userApplication が停止中/起動中の両方で使用できます。
userApplication が停止中に使用した場合、hvoradisable コマンドで設定された監視無効設定を解除します。
userApplication が運用中に使用した場合は、すぐに監視を再開します。そのため、Oracle インスタンス、リスナーを手動起動した 状態で、本コマンドを実行してください。(この場合、リソースの状態が Warning から Online になることを確認してください。)
参考
－ ASM インスタンスリソース、Oracle Clusterware リソースは監視が行われませんので、本コマンドによる監視の再開は必要ありま
せん。
－ ASM インスタンスリソースについての詳細は、「2.4.2 ASM（Automatic Storage Management）を使用する場合」を参照してくだ さい。
パラメータ
userApplication Resource
userApplicationには、監視再開するリソースが含まれる userApplication 名を指定します。Resourceには、監視再開する Oracle インスタンスリソース、リスナーリソースいずれかのリソース名を指定します。
userApplication と Resource には、ローカルノードに存在するものを指定してください。
-a [ userApplication ]
ローカルノード上に存在し、かつ userApplication に指定された userApplication に属する全ての Oracle インスタンス、リスナー リソースの監視を再開します。
userApplication が省略された場合、本コマンドはローカルノード上に存在する全ての Oracle インスタンス、リスナーリソースの監
視を再開します。
終了ステータス 0 : 正常終了 1 : 異常終了
2 : 異常終了 (-a オプション指定時に、いくつかのリソースの監視中断に失敗)
注意
本コマンドの実行タイミングに注意してください。状態不整合や意図せぬリソース異常を引き起こす場合があります。
・ 本コマンドを userApplication の状態遷移中に実行してはいけません。
・ 本コマンドの実行直後に、userApplication の起動や停止を行わないでください(5秒程度の間を置いてください)。
4.3 clorapass - 監視用パスワードの登録
実行ユーザー スーパーユーザー 形式
/opt/FJSVclora/sbin/clorapass 機能説明
本コマンドは PRIMECLUSTER Wizard for Oracle が使用する Oracle の SYSTEM ユーザーのパスワードを登録します。ディテクタは
Oracle インスタンスの監視のために SYSTEM ユーザーを使って接続を行います。このためディテクタは SYSTEM ユーザーのパ
スワードを必要とします。
パスワードが設定されていなければ、ディテクタは SYSTEM ユーザーのパスワードとして“manager” を使用します。
本コマンドは、任意の1ノードで実行してください。
パラメータ なし 終了ステータス
0 : 正常終了 0以外 : 異常終了
参照
クラスタ運用中に Oracle SYSTEM ユーザーパスワードを変更する場合は、「3.3 クラスタ運用中の Oracle SYSTEM ユーザーパスワー ド変更手順」を参照してください。
注意
スケーラブル運用の場合、Oracle SYSTEM ユーザーのパスワードはインスタンス別に登録する必要があります。例えば、
DB_NAME=ora、ORACLE_SID=ora1、ORACLE_SID=ora2 の場合、本コマンドを2回実行し、ora1 と ora2 に対してパスワードを登 録してください。
4.4 cloracpy - Oracle 設定ツール（待機ノード用）
実行ユーザー Oracle ユーザー 形式
/opt/FJSVclora/sbin/cloracpy 機能説明
本コマンドを使って、Oracle データベース設定に必要な運用ノード上のファイルを tar 形式にバックアップすることができます。本コ マンドを使用してバックアップしたファイルを待機ノード側で展開することで、ファイルコピー、リンクの設定が行えます。
－ 本コマンドの使用条件
- 運用・待機ノードの $ORACLE_HOME、$ORACLE_BASE の設定が同一である
- 1:1 運用待機のように、運用・待機ノードの Oracle 構成が同一である
- 運用ノードでのデータベースの作成や設定が完了している
- Oracle ユーザーで実行する
- Oracle ユーザーの環境変数に $ORACLE_BASE、$ORACLE_HOME、$ORACLE_SID の設定がされている
－ 本コマンドで tar 形式にまとめるファイル
- $ORACLE_HOME/dbs/ 配下のすべて
- $ORACLE_BASE/admin/$ORACLE_SID/ 配下のすべて
- $ORACLE_HOME/network/admin/配下のすべて
- $ORACLE_BASE/diag/ 配下のすべて
これらは、/tmp/oracle.<$ORACLE_SID>.tar ファイルにまとめられます。この tar ファイルを運用ノードから待機ノードへ転送し、そこ で“tar xvfP /tmp/oracle.<$ORACLE_SID>.tar”コマンドを実行すると、上記のファイルが待機ノード上で展開されます。
本コマンドは、フルパスで tar 形式にファイルをまとめ、フルパスで展開されますので、$ORACLE_BASE や $ORACLE_HOME の 設定が運用・待機ノードで異なる場合は、使用しないでください。また N:1 運用待機構成のように、運用・待機ノードで設定が異な る場合も、使用できません。同一名のファイルが存在する場合は上書きされますので注意してください。
パラメータ なし 終了ステータス
0 : 正常終了 0以外 : 異常終了
4.5 clgetoralog - Oracle 調査資料採取
実行ユーザー スーパーユーザー 形式
/opt/FJSVclora/bin/clgetoralog [ -n RMSconfiguration ] [ -d output_directory ] [ -a ]
機能説明
本コマンドは、Oracle のトラブル調査資料を採取します。PRIMECLUSTER 上で運用中の Oracle の設定情報、ログファイルを採取 します。
採取した資料は、<hostname>_<日付>_clgetoralog.tar.Z (または tar.gz) ファイルにまとめられます。
採取する情報は次の通りです。
－ 初期化パラメータ・ファイル
$ORACLE_HOME/dbs/*.ora
$ORACLE_BASE/admin/$ORACLE_SID/pfile/*.ora
－ アラート・ログ
background_dump_dest/*.log
$ORACLE_BASE/admin/$ORACLE_SID/bdump/*.log
$ORACLE_HOME/rdbms/log/*.log
$ORACLE_HOME/dbs/*.log
$ORACLE_BASE/diag/ 配下
－ listener.ora、tnsnames.ora
$ORACLE_HOME/network/admin/*.ora
－ リスナーログ
$ORACLE_HOME/network/log/*.log
－ Oracle Clusterware 情報
$ORA_CRS_HOME/crs/admin/*
$ORA_CRS_HOME/crs/log/* ($ORA_CRS_HOME/log/<hostname>/crsd/*)
－ PRIMECLUSTER Wizard for Oracle の V/L 情報、設定情報やログファイル
－ RMS の V/L 情報やログファイル (switchlog)
－ PRIMECLUSTER の V/L 情報や設定情報、パッチ情報
－ システム情報
uname -a 実行結果 (システム基本情報) uptime 実行結果 (システム稼働時間) cat /proc/cpuinfo 実行結果 (CPU情報)
cat /proc/version 実行結果 (Linux バージョン情報) sysctl -a 実行結果 (カーネルパラメータ情報) ipcs 実行結果 (共有資源情報)
cat /proc/swaps (スワップ情報)
pstree -pal, ps -efw 実行結果 (プロセス情報) ntpq -p 実行結果 (NTP情報)
/var/log/messages ファイル
参考
本コマンドで採取される情報は、pclsnap コマンドでも採取されます。(-a、-A または -h オプション指定時)
パラメータ
[ -n RMSconfiguration ]
RMSconfigurationには、採取する RMS 構成定義名を指定します。
RMS 構成定義名を指定した場合、本コマンドは、上記 [機能説明] で記載した資料や情報に加え、RMS 構成定義ファイル群 も採取します。 RMS 動作中の場合は、以下のコマンドで RMS 構成定義名を確認することもできます。
# /opt/SMAW/bin/hvdisp -a | grep Configuration Configuration: /opt/SMAW/SMAWRrms/build/config.us
本オプションを省略した場合、本コマンドは、上記 [機能説明] で記載した資料や情報のみを採取します。
[ -d output_directory ]
採取資料を格納するディレクトリを指定します。
ディレクトリを指定した場合、本コマンドは、採取した資料や情報をまとめた <hostname>_<日付>_clgetoralog.tar.Z (または tar.gz) ファイルを、そのディレクトリに格納します。 指定したディレクトリが存在しない場合、自動的に作成します。
本オプションを省略した場合、本コマンドは、採取資料をまとめた <hostname>_<日付>_clgetoralog.tar.Z (または tar.gz) ファイ ルを、デフォルトディレクトリ (/var/tmp/ 配下) に格納します。
[ -a]
本オプションを指定した場合、本コマンドは、上記 [機能説明] で記載した資料や情報に加え、以下の情報も採取します。
- 現在有効となっている RMS 構成定義ファイル群
-n オプションも指定された場合はその RMS 構成定義ファイル群 - RMS ログファイル群 (/var/opt/reliant/log/*)
- RMS 環境変数定義ファイル (/usr/opt/reliant/bin/hvenv.local) - /var/log/messages* (全世代)
- /etc/hosts - /etc/passwd - /etc/services - /etc/fstab - /etc/fstab.pcl
注意
本オプションを省略した場合、本コマンドは、上記 [機能説明] で記載した資料や情報のみを採取します。
終了ステータス 0 : 正常終了 0以外 : 異常終了
注意
本コマンドは初期化パラメータ・ファイル、またはサーバー・パラメータ・ファイルから background_dump_dest または、diagnostic_dest 初 期化パラメータの値を取得し、Oracle アラート・ログを採取しますが、サーバー・パラメータ・ファイルがマウントされていない共用ディス ク上にあるなどで初期化パラメータが読み込めなかった場合、Oracle アラート・ログが採取できません。
/opt/FJSVclora/etc/clgetoralog.conf にアラート・ログをフルパスで定義することで、アラート・ログを採取することができます。アラート・ロ グの格納場所は、初期化パラメータ background_dump_dest/ diagnostic_dest に定義されています。(これらの値は、初期化パラメータ・
ファイルやサーバー・パラメータ・ファイルを確認するか、または Oracle 起動状態で SQL 文 "show parameter dest" を実行することで確