Oracle Cluster Registryユーティリティ・リファレンス

I Oracle Cluster Registryユーティリティ・リファレンス

この付録はOracle Cluster Registry(OCR)構成ユーティリティOCRCONFIGの構文およびOCRのトラブルシューティングについて説明します。OCRCHECKとOCRDUMPに関する説明および使用情報も含まれています。

この付録の内容は次のとおりです。

OCRCONFIGについて

ocrconfigコマンドを使用して、OCRを管理します。このユーティリティを使用すると、OCRのインポート、エクスポート、追加、削除、リストア、上書き、バックアップ、修復、置換、移動、アップグレードまたはダウングレードを行うことができます。

使用方法

OCRCONFIG実行可能ファイルは、Grid_home/binディレクトリに格納されています。
ocrconfig コマンドの構文は次のとおりです。
```
ocrconfig -option
```

ユーティリティ・ヘルプの使用

OCRCONFIGユーティリティのヘルプ出力を表示するには、次のコマンドを使用します。

ocrconfig -help

権限およびセキュリティ

OCRCONFIGユーティリティを使用するには、管理権限を持つユーザーとしてオペレーティング・システムにログインする必要があります。

ログ・ファイル

OCRCONFIGユーティリティでは、ログ・ファイルがORACLE_BASE/diag/crs/host_name/crs内に作成されます。

ロギングの量を変更するには、ORACLE_BASE/crsdata/host_name/crsdiag/ocrconfig.iniファイルでパスを編集します。

OCRCONFIGコマンド・リファレンス

この項では、次のOCRCONFIGコマンドについて説明します。

ocrconfig -add

Oracle Automatic Storage Management (Oracle ASM)ディスク・グループにOCRの場所を追加します。

構文

ocrconfig -add +diskgroup_name

使用上のノート

追加するOCRの場所が存在し、十分な権限を所有している必要があり、また、追加する前に、この場所をマウントしておく必要があります。
このコマンドは、rootで実行する必要があります。
diskgroup_name変数は、Oracle ASMディスク・グループの名前です。たとえば:
- +newdg: ディスク・グループが存在し、マウントされていることを確認します。
  
  ディスク・グループの名前の前に、プラス記号(+)を付ける必要があります。
関連項目:
- OCRの場所の作成、および適切な権限の設定の詳細は、『Oracle Grid Infrastructureインストレーションおよびアップグレード・ガイドfor Linux』を参照してください
- Oracle ASMディスク・グループ管理の詳細は、『Oracle Automatic Storage Management管理者ガイド』を参照してください。

例

dataというOracle ASMのデフォルトの場所にOCRの場所を追加するには、次のコマンドを使用します。

# ocrconfig -add +data

ocrconfig -backuploc

OCRバックアップ・ディレクトリの場所を指定します。

構文

ocrconfig -backuploc +disk_group_name
ocrconfig -local -backuploc dir_name

使用上のノート

このコマンドは、rootで実行する必要があります。
-localオプションを使用して、OLRバックアップ・ディレクトリの場所を指定します。
OCRバックアップの場所のdisk_group_name変数は、Oracle ASMディスク・グループにする必要があります。たとえば:

+bkupdg: Oracle ASMディスク・グループが存在し、すべてのノードにマウントされていることを確認します

Oracle ASMディスク・グループの名前の前に、プラス記号(+)を付ける必要があります。
OLRバックアップの場所のdir_name変数は、ディレクトリのフルパス名にすることができます。たとえば:
- Grid_home/cdata/cluster3/: 場所が存在することを確認します
- d:\cdata\cluster3: 場所が存在することを確認します
LinuxまたはUNIXシステムでOLRバックアップが生成されるデフォルトの場所はGrid_base/crsdata/host_name/olr/で、host_nameは、バックアップ対象のOLRが存在するノードの名前です。WindowsでOLRバックアップが生成されるデフォルトの場所は、同じパス構造を使用します。

例

OCRバックアップの場所をOracle ASMディスク・グループに指定するには、次のようにします。

# ocrconfig -backuploc +bkupdg

OLRバックアップの場所を指定するには、次のようにします。

# ocrconfig -local -backuploc full_directory_path

ocrconfig -copy

OCRバックアップ・ファイルをある場所から別の場所にコピーします。

構文

ocrconfig -copy source_file_name destination_file_name

使用上のノート

このコマンドは、rootで実行する必要があります。
source_file_nameには有効なOCRバックアップ・ファイルを指定する必要があります。たとえば:
- /oradbocfs/crs/BACKUP00.ocr
- d:\oracle\BACKUP01.ocr
- +bkupdg:/aimev1/ocrbackup/day.ocr.260.739756845
Oracle ASMディスク・グループを指定した場合は、そのディスク・グループが存在し、マウントされていることを確認します。

有効なdestination_file_name値の例を次に示します。
- /oradbocfs/crs/mybkp01.ocr
- d:\oracle\mybkp01.ocr
- +bkupdg:mybkp01
Oracle ASMディスク・グループの名前の前にプラス記号(+)を付ける必要があります。

例

OCRバックアップ・ファイルをファイル・システムからOracle ASMディスク・グループにコピーするには、次のコマンドを実行します。

# ocrconfig -copy /oradbocfs/crs/BACKUP00.ocr +bkupdg:mybkp01.ocr

OCRバックアップ・ファイルをOracle ASMディスク・グループからファイル・システムにコピーするには、次のコマンドを実行します。

# ocrconfig -copy +bkupdg:/aimev1/ocrbackup/day.ocr.260.739756845 /oradbocfs/crs/mybkp01.ocr

OCRバックアップ・ファイルをあるOracle ASMディスク・グループから別のOracle ASMディスク・グループにコピーするには、次のコマンドを実行します。

# ocrconfig -copy +bkupdg01:/aimev1/ocrbackup/day.ocr.260.739756845 +bkupdg02:mybkp01.ocr

ocrconfig -delete

OCRデバイスまたはOCRファイルを削除します。

構文

ocrconfig -delete +diskgroup_name

使用上のノート

このコマンドは、rootで実行する必要があります。
+diskgroup_name変数は、Oracle ASMディスク・グループの名前です。たとえば: +olddg

ディスク・グループの名前の前に、プラス記号(+)を付ける必要があります。

例

OCRの場所を削除するには、次のコマンドを使用します。

# ocrconfig -delete +olddg

ocrconfig -downgrade

このコマンドを使用してOCRを指定の旧バージョンにダウングレードするのは、rootスクリプトだけです。

構文

ocrconfig -downgrade

使用上のノート

このコマンドにはオプションはありません。

ocrconfig -export

OCRの内容をターゲット・ファイルにエクスポートします。

構文

ocrconfig [-local] -export file_name

使用上のノート

このコマンドは、rootで実行する必要があります。
-localオプションを使用して、OLRの内容をエクスポートします。
file_name変数は、ファイル名またはOracle ASMディスク・グループの名前です(名前の前にプラス記号(+)を付ける必要があります)。たとえば:
- /oradbocfs/crs/data.ocr
- d:\oracle\data.ocr
- +bkupdg:data.ocr

例

OCRの内容をファイルにエクスポートするには、次のコマンドを使用します。

# ocrconfig -export d:\tmp\a

ocrconfig -import

OCRの内容をエクスポートしたターゲット・ファイルの内容を、OCRにインポートし直します。

構文

ocrconfig [-local] -import file_name

使用上のノート

このコマンドは、rootで実行する必要があります。
-localオプションを使用して、OLRの内容をファイルからインポートします。
file_name変数は、ファイル名またはOracle ASMディスク・グループの名前です(名前の前にプラス記号(+)を付ける必要があります)。たとえば:
- /oradbocfs/crs/data.ocr
- d:\oracle\data.ocr
- +bkupdg:/aimev1/ocrbackup/data.ocr.260.739756845
このコマンドを実行する前にOracle Clusterwareを停止する必要があります。

例

ファイルの内容をOCRにインポートするには、次のコマンドを使用します。

# ocrconfig -import d:\tmp\a

ocrconfig -manualbackup

必要に応じてOCRを特定の場所にバックアップします。

前提条件

ocrconfig -backuplocを使用して、オンデマンド・バックアップの場所を確認します。

構文

ocrconfig [-local] -manualbackup

使用上のノート

このコマンドは、rootで実行する必要があります。
-localオプションを使用して、OLRの手動バックアップを実行します。

ocrconfig -overwrite

OCRメタデータ内のOCR構成を、このコマンドの実行元ノードにあるOCR構成情報で上書きします。

構文

ocrconfig -overwrite

使用上のノート

このコマンドは、rootで実行する必要があります。

ocrconfig -repair

このコマンドの実行元ノードでOCR構成を修復します。

このコマンドを使用して、クラスタのOCR構成の変更中に停止していた可能性のあるノードのOCRの場所を追加、削除または置換します。追加するOCRの場所が存在し、十分な権限を所有している必要があり、また、追加する前に、この場所をマウントしておく必要があります。

前提条件

修復を正常に完了させるには、Oracle高可用性サービスを起動する必要があります。
ocrconfig -repairを実行する前にクラスタ・レディ・サービス・デーモンを停止する必要があります。

構文

ocrconfig -repair -add +diskgroup_name | -delete +diskgroup_name | -replace
   +current_diskgroup_name -replacement +new_diskgroup_name

使用上のノート

このコマンドは、rootで実行する必要があります。
+diskgroup_name変数は、Oracle ASMディスク・グループの名前です。たとえば: +newdg/mycluster/OCRFILE/registry.255.842574125

Oracle ASMディスク・グループを指定する場合は、ディスク・グループの名前の前にプラス記号(+)を付ける必要があります。

Oracle ASMディスク・グループの名前を取得するには、OCR構成を修復する必要がないノードでocrcheck -config -detailsコマンドを実行します。
関連項目:
- OCRの場所の作成、および適切な権限の設定の詳細は、『Oracle Grid Infrastructureインストレーションおよびアップグレード・ガイドfor Linux』を参照してください
- Oracle ASMディスク・グループ管理の詳細は、『Oracle Automatic Storage Management管理者ガイド』を参照してください。
- ocrcheck -config -detailsコマンドの詳細は、「OCRCHECKユーティリティの使用」を参照してください。
ocrconfig -repairと同時に使用できるオプションは1つのみです。
このコマンドの実行によって変更されるのはローカル構成のみであり、影響を受けるのは現行のノードのみです。

例

OCR構成を修復するには、次の手順を実行する必要があります。

# ocrconfig -repair -delete +olddg

ocrconfig -replace

OCRの場所をOracle Automatic Storage Management (Oracle ASM)ディスク・グループに再配置します。

前提条件

追加するOCRの場所が存在し、十分な権限を所有している必要があり、また、追加する前に、この場所をマウントしておく必要があります。
このコマンドを使用するには2つ以上のOCRデバイスが必要です。OCRデバイスが2つ未満の場合、ocrconfig -addコマンドを実行して新しいOCRデバイスを追加してからocrconfig -deleteコマンドを実行し、置換するOCRデバイスを削除します。

構文

ocrconfig -replace +current_diskgroup_name -replacement +new_diskgroup_name

使用上のノート

このコマンドは、rootで実行する必要があります。
+diskgroup_name変数は、Oracle ASMディスク・グループの名前です(名前の前にプラス記号(+)を付ける必要があります)。たとえば: +newdg。ディスク・グループは存在し、マウントされている必要があります。
関連項目:
- OCRの場所の作成、および適切な権限の設定の詳細は、『Oracle Grid Infrastructureインストレーションおよびアップグレード・ガイドfor Linux』を参照してください
- Oracle ASMディスク・グループ管理の詳細は、『Oracle Automatic Storage Management管理者ガイド』を参照してください。

例

OCRデバイスまたはファイルを置換するには、次のコマンドを使用します。

# ocrconfig -replace +olddg -replacement +newdg

ocrconfig -restore

自動的に作成されたOCRバックアップ・ファイルからOCRをリストアします。

前提条件

このコマンドを実行する前に、元のOCRファイルまたはOLRファイルが存在することを確認します。元のファイルが存在しない場合、空のファイルを作成する必要があります。

ノート:

ocrconfig -exportコマンドによって生成されたファイルを使用してOCRをリストアすることはできません。ファイルは手動バックアップまたは自動バックアップである必要があります。
OCRがOracle ASMディスク・グループに存在する場合、ディスク・グループが存在し、マウントされていることを確認します。

構文

ocrconfig [-local] -restore file_name

使用上のノート

このコマンドは、rootで実行する必要があります。
OCRバックアップ・ファイルがOracle ASMディスク・グループにある場合、ディスク・グループが存在し、マウントされていることを確認します。
Oracle ASMディスク・グループの名前の前に、プラス記号(+)を付ける必要があります。
-localオプションを使用して、OLRのバックアップをリストアします。
次にファイル名の例を示します。
- /oradbocfs/crs/BACKUP00.ocr
- d:\oracle\BACKUP01.ocr
- +bkupdg:/aimev1/ocrbackup/day.ocr.260.739756845

例

ファイルからOCRをリストアするには、次のコマンドを使用します。

# ocrconfig -restore /oradbocfs/crs/BACKUP00.ocr

ocrconfig -showbackup

利用可能なすべてのバックアップを表示します。

構文

ocrconfig [-local] -showbackup [auto | manual]

使用上のノート

-localオプションを使用して、手動のOLRバックアップ情報を表示します。-localフラグは、manualオプションとあわせて指定した場合にのみ機能します。
必要に応じてautoまたはmanualを指定して、自動バックアップまたは手動バックアップのいずれかの情報のみを表示することもできます。
- auto: 過去4時間、8時間、12時間、前日および先週に作成された自動バックアップの情報を表示します。
- manual: ocrconfig -manualbackupコマンドを使用して、最後から最大5つの手動バックアップの情報を表示します。

例

このコマンドは、次のようにOLRの手動バックアップ情報を表示します。

$ ocrconfig -local -showbackup manual
cc40524 2020/05/08 15:06:57 /gridbase/crsdata/dglnx6/olr/backup_20200508_150657.olr 0

ocrconfig -showbackuploc

OCRおよびOLRバックアップ・ファイルのバックアップ場所を表示します。

構文

ocrconfig [-local] -showbackuploc

使用上のノート

このコマンドは、rootで実行する必要があります
-localオプションを使用して、OLRバックアップの場所を表示します。

例

このコマンドによって、次のような出力が返されます。

# ocrconfig -showbackuploc

The Oracle Cluster Registry backup location is [+bkupdg]

# ocrconfig -local -showbackuploc
The Oracle Local Registry backup location is [/gridbase/crsdata/dglnx6/olr]

ocrconfig -upgrade

OCRを以前のバージョンからアップグレードします。

構文

ocrconfig -upgrade

使用上のノート

このコマンドにはオプションはありません。

Oracle Cluster Registryのトラブルシューティングおよび診断出力

この項では、OCRに関する問題のトラブルシューティングを行う様々な方法およびOCRの管理に使用されるユーティリティから診断情報を取得する様々な方法について説明します。これらのユーティリティは、OLRのトラブルシューティングにも使用できます。

この項では、次の項目について説明します。

Oracle Cluster Registryのトラブルシューティング

表I-1に、OCRの一般的な問題およびそれに対応する推奨の解決策を示します。

表I-1 Oracle Cluster Registryの一般的な問題および解決策

問題	解決策
現在使用されていないOCRのミラー化を有効にする必要があります。	`-replace`オプションを指定して`ocrconfig`コマンドを実行します。
OCRに障害が発生したため、置換する必要があります。Oracle Enterprise ManagerまたはOCRのログ・ファイルにエラー・メッセージが書き込まれます。	`-replace`オプションを指定して`ocrconfig`コマンドを実行します。
OCRの構成が不適切です。	説明されているように、`-repair`オプションを指定して`ocrconfig`コマンドを実行します。
OCRの処理によってパフォーマンスに重大な影響が及ぼされたか、または他の理由のためにOCRを削除します。	説明されているように、`-replace`オプションを指定して`ocrconfig`コマンドを実行します。
OCRに障害が発生したため、修正する前に、1つのOCRのみを使用してノードを再起動する必要があります。	`-repair`オプションを指定して`ocrconfig`を実行し、問題のあるOCRの場所を削除します。定義済のすべてのOCRが見つからない場合、Oracle Clusterwareは起動されません。

OCRCHECKユーティリティの使用

OCRCHECKユーティリティを実行すると、構成したOCRのブロック形式のバージョン、使用可能な領域の合計、使用済の領域、OCRのIDおよび場所が表示されます。

OCRCHECKでは、構成したすべてのOCRにあるすべてのブロックに対して、ブロック単位のchecksum操作が実行されます。各ファイルごとのステータスと、OCR全体の整合性チェックの結果も返されます。

ノート:

Oracleでは、最低でもOracleクラスタ・レディ・サービス・スタックがクラスタ内のすべてのノードでOFFLINEの場合、ocrcheckの使用がサポートされています。これは、スタックがONLINEの場合でもコマンドは実行されますが、OCRの更新が進行中のときにチェックが実行されると、OCRは破損していると誤って示されることがあるためです。

構文

ocrcheck [-local] [-config | -backupfile <backup_file_name>] [-details] [-help]

ocrcheck -helpコマンドを実行して、このユーティリティの使用方法を表示します。

-detailsオプションを指定すると、Oracle ASMディスク・グループの名前を含む、詳しいOCR構成情報が表示されます。

例

次の例に、OCRCHECKコマンドの出力とコマンドの使用方法のサンプルを示します。

例I-1 OCRCHECKユーティリティのサンプル出力

# ocrcheck

Status of Oracle Cluster Registry is as follows :
        Version                  :          4
        Total space (kbytes)     :     409568
        Used space (kbytes)      :      17012
        Available space (kbytes) :     392556
        ID                       :  467263828
        Device/File Name         : +ocrdg1
                                   Device/File integrity check succeeded
        Device/File Name         : +ocrdg2
                                   Device/File integrity check succeeded
                                   Device/File not configured
                                   Device/File not configured
                                   Device/File not configured
        Cluster registry integrity check succeeded 
        Logical corruption check succeeded

ノート:

論理破損チェックは、rootとしてocrcheckコマンドが実行される場合のみ実行されます。

例I-2では、ocrcheck -local -configコマンドを使用してOLR情報を取得します。

ノート:

Oracleクラスタ・レディ・サービス・スタックとOracle高可用性サービス・スタックの両方がローカル・ノードでOFFLINEの場合、Oracleでは、ocrcheck -localコマンドの使用がサポートされています。

OCRDUMPユーティリティを使用したOracle Cluster Registryの内容の表示

OCRDUMPユーティリティを使用すると、OCRおよびOLRの内容を読みやすい形式でファイルまたはstdoutに書き込むことによって表示できます。

この項では、OCRDUMPユーティリティを使用してトラブルシューティングのためにOCRおよびOracle Local Registry(OLR)の内容を表示する方法について説明します。

OCRDUMPにはいくつかのオプションを使用できます。たとえば、出力をキーおよびその子に制限できます。ブラウザを使用して表示可能なXMLファイルに内容を書き込むこともできます。OCRDUMPは、ASCII文字列およびデータ型形式の値としてOCRのキーを書き込みます。OCRDUMPは、ベスト・エフォート原則に基づいてヘッダー情報を取得します。

OCRDUMPでは、ログ・ファイルがORACLE_BASE/diag/crs/host_name/crs内に作成されます。ログ・レベルを変更するには、ORACLE_BASE/crsdata/host_name/crsdiag/ocrlog.iniファイルを編集します。

ロギング・コンポーネントを変更するには、comploglvl=エントリを含むエントリを編集します。たとえば、OCRAPIコンポーネントのログ・レベルを3に変更し、OCRRAWコンポーネントのログ・レベルを5に変更するには、ocrlog.iniファイルに次のエントリを作成します。

comploglvl="OCRAPI:3;OCRRAW:5"

ノート:

OCRDUMPユーティリティを使用する前に、Grid_homeディレクトリにファイルを作成する権限を持っていることを確認してください。

この項には次のトピックが含まれます:

OCRDUMPユーティリティの構文およびオプション

この項では、OCRDUMPユーティリティのコマンド構文および使用方法について説明します。次の構文を使用してocrdumpコマンドを実行します(この場合、file_nameにはOracle Cluster Registryの出力を書き込むターゲット・ファイルの名前、key_nameにはOracle Cluster Registryのサブツリーの内容を書き込むキーの名前を指定します)。

$ ocrdump [file_name | -stdout] [-local] [-backupfile backup_file_name
[-keyname key_name] [-xml] [-noheader]
]

表I-2に、OCRDUMPユーティリティのオプションおよびオプションの説明を示します。

表I-2 OCRDUMPのオプションおよびオプションの説明

オプション	説明
`file_name`	OCRDUMPによって出力を書き込むファイルの名前です。デフォルトでは、OCRDUMPによって、事前定義された出力ファイル`OCRDUMPFILE`に出力が書き込まれます。`file_name`オプションによって、OCRDUMP出力は指定したファイルにリダイレクトされます。
`-stdout`	このオプションを使用して、プログラムを起動したテキスト端末にOCRDUMP出力をリダイレクトできます。出力をリダイレクトしない場合、OCRDUMPによって、事前定義された出力ファイル`OCRDUMPFILE`に出力が書き込まれます。
`-local`	OLRの内容をダンプするには、このオプションを使用します。
`-backupfile`	OCRバックアップ・ファイルの内容を表示するには、このオプションを使用します。`-local`オプションをこのオプションとともに使用すると、OLRバックアップ・ファイルの内容が表示されます。
`backup_file_name`	表示する内容を含むバックアップ・ファイルの名前です。`ocrconfig -showbackup`コマンドを使用して、バックアップを問い合せることができます。バックアップ・ファイルがOracle ASMディスク・グループにある場合、ディスク・グループが存在し、マウントされていることを確認します。
`-keyname` `key_name`	サブツリーがダンプされるOracle Cluster Registryキーの名前です。
`-xml`	出力をXML形式で書き込むにはこのオプションを使用します。
`-noheader`	コマンドを実行した時間およびOracle Cluster Registry構成が作成された時間を出力しません。

OCRDUMPユーティリティの例

次に示すocrdumpユーティリティの例では、様々なタイプのOCR情報を抽出し、様々なターゲットに書き込みます。

ocrdump

OCRの内容を現在のディレクトリのOCRDUMPFILEというファイルに書き込みます。

ocrdump MYFILE

OCRの内容を現在のディレクトリのMYFILEというファイルに書き込みます。

ocrdump -stdout -keyname SYSTEM

OCRの内容をSYSTEMキーのサブツリーから端末ウィンドウに表示します。

ocrdump -stdout -xml

OCRの内容をXML形式で端末ウィンドウに表示します。

ocrdump -stdout -backupfile Grid_home/cdata/cluster_name/file_name

Grid_home/cdata/cluster_name/file_nameディレクトリのコンテンツを表示します。すべてのキーを表示できるようにするには、このコマンドをrootで実行する必要があります。OCRバックアップ・ファイルであることを認識できるように、ファイルにはBACKUPOO.ocrなどの適切な名前を付けてください。

OCRDUMPユーティリティの出力例

次のOCRDUMPの例は、ocrdumpコマンドの2つの実行例について、KEYNAME、VALUE TYPE、VALUE、権限のセット(user、group、world)およびアクセス権を示します。テキスト値がAMERICAN_AMERICA.WE8ASCII37であるSYSTEM.languageキーの出力を次に示します。

[SYSTEM.language]
ORATEXT : AMERICAN_AMERICA.WE8ASCII37
SECURITY : {USER_PERMISSION : PROCR_ALL_ACCESS, GROUP_PERMISSION : PROCR_READ,
OTHER_PERMISSION : PROCR_READ, USER_NAME : user, GROUP_NAME : group}

3という整数値を持つ SYSTEM.versionキーの出力を次に示します。

[SYSTEM.version]
UB4 (10) : 3
SECURITY : {USER_PERMISSION : PROCR_ALL_ACCESS, GROUP_PERMISSION : PROCR_READ,
OTHER_PERMISSION : PROCR_READ, USER_NAME : user, GROUP_NAME : group}