Windows環境用のOracle ACFSコマンドライン・ツール

このトピックでは、Windows用のOracle ACFSファイル・システム・コマンドの概要を示します。

表16-17に、Oracle ACFS Windowsファイル・システム・コマンドと簡単な説明を示します。これらのコマンドは、Oracle ACFSをサポートするために拡張されています。その他のWindowファイル・システム・コマンドはすべて、Oracle ACFS用の変更なしで動作します。

ノート:

Oracle ACFS 19c (19.5)以降では、Microsoft WindowsでのOracle ACFSの使用は非推奨になりました。特定のクラスタ機能を非推奨にし、制限付きの採用とすることにより、オラクル社では、すべての機能の中核となるスケーリング、可用性および管理性の向上に注力できます。Microsoft WindowsでのOracle ACFSファイル・システムの使用は非推奨であり、将来のリリースでサポートされなくなる可能性があります。ユース・ケースに応じて、現在のOracle ACFSファイル・システムを置き換えるために、Oracle Automatic Storage Management (Oracle ASM)、Oracle Databaseファイル・システム(DBFS)またはMicrosoft Windowsの共有に移行することをお薦めします。

表16-17 Windows用のOracle ACFSファイル・システム・コマンドの概要

コマンド	説明
acfschkdsk	WindowsでOracle ACFSファイル・システムをチェックおよび修復します。
acfsdismount	WindowsでOracle ACFSをディスマウントします。
acfsformat	WindowsでOracle ACFSファイル・システムを作成します。
acfsmountvol	WindowsでOracle ACFSファイル・システムをマウントします。
acfsutil detach	WindowsでモジュールのアンロードのためにOracle ACFSドライバの準備をします。

表16-18に、Oracle ACFS以外のWindowsファイル・システム・コマンドと簡単な説明を示します。

表16-18 Windows用のOracle ACFS以外のファイル・システム・コマンドの概要

コマンド	説明
advmutil dismount	WindowsでOracle ACFS以外のファイル・システムのOracle ADVMボリューム・デバイスをディスマウントします。
advmutil list	WindowsでOracle ACFS以外のファイル・システムのOracle ADVMボリューム・デバイスをリストします。
advmutil mount	WindowsでOracle ACFS以外のファイル・システムのOracle ADVMボリューム・デバイスをマウントします。

acfschkdsk

目的

Oracle ACFSファイル・システムをチェックおよび修復します。

構文および説明

acfschkdsk /h
acfschkdsk [/a|/f] [/v] [/n|/y] volume_device

表16-19に、acfschkdskコマンドで使用可能なオプションを示します。

表16-19 acfschkdskコマンドのオプション

オプション	説明
`/a`	ファイル・システムを自動的に修正することを指定します。
`/f`	ファイル・システムのチェックまたは修正を完了せずに、ファイル・システムを強制的にマウント可能な状態にします。
`/v`	verboseモードを指定します。操作が発生すると、進捗状況が表示されます。verboseモードで実行すると、パフォーマンスに影響を及ぼす場合があります。
`/h`	使用方法のヘルプ・テキストを表示して終了します。
`/n`	すべてのプロンプトに対してnoと答えます。
`/y`	すべてのプロンプトに対してyesと答えます。
`volume_device`	Oracle ADVMボリューム・デバイスを指定します。

acfschkdskは、既存のOracle ACFSをチェックおよび修復します。このコマンドは、クラスタ全体でディスマウントされているファイル・システムでのみ実行できます。

acfschkdskを機能させるには、Oracle ACFSドライバをロードする必要があります。ドライバがロードされていない場合、管理者はこれが意図的であることを確認するように要求されます。ドライバのロードの詳細は、「Oracle ACFSドライバ・リソース管理」を参照してください。

Oracle ACFSドライバでは通常、acfschkdskがクラスタ全体で唯一のファイル・システムのユーザーです。極端な場合、ファイル・システムの自動マウントによりシステム障害が発生すると、ドライバをロードせずにファイル・システムを修正することが必要になる可能性があります。排他的アクセスのために通常ドライバによって行われる検証は、この場合は省略されます。

デフォルトでは、acfschkdskはエラーがないかチェックし、エラーを報告するのみです。/aフラグは、acfschkdskにファイル・システムでのエラーの修正を指示するために指定する必要があります。修復操作中にacfschkdskを中断しないでください。

acfschkdskでは、ファイル・システムのチェックに進む前に、質問に対する答えを要求されることがあります。たとえば、acfschkdskによって別のacfschkdskがファイル・システムで進行中であることが検出された場合、またはacfschkdskによってOracle ACFSドライバがロードされていないことが検出された場合、またはファイル・システムがOracle ACFSではないと思われる場合です。チェック・モードでは、acfschkdskは不完全な停止によって完全に処理されていないトランザクション・ログがある場合にも回答を要求します。非対話モードで実行するには、質問に対してyesまたはnoと回答するために/yまたは/nオプションを含めます。

acfschkdskでは、ファイル・システムをチェックする前に、作業ファイルを作成します。これらの作業ファイルは、領域が使用可能な場合、tempディレクトリに作成されます。使用可能な領域が不十分な場合、acfschkdskでは、現在の作業ディレクトリに書込みを試みます。acfschkdskで作成するファイルは、およそチェック対象のファイル・システムを32Kで割ったサイズです。ファイルは多くても3つ割り当てられます。これらのファイルは、acfschkdskの終了時に削除されます。

acfschkdskでファイル・システムで(親ディレクトリ内の破損などにより)名前または目的の場所を特定できないファイルまたはディレクトリが検出された場合、acfschkdskを修正モードで実行していると、そのオブジェクトは\lost+foundディレクトリに配置されます。セキュリティ上の理由で、WindowsではAdministratorのみが\lost+found内のファイルを読み取ることができます。内容に基づいてファイルの元の名前および場所を管理者が後で特定できた場合は、そのファイルを目的の場所に移動またはコピーできます。

\lost+foundディレクトリ内のファイル名の書式は、次のとおりです。

parent.id.file.id.time-in-sec-since-1970
parent.id.dir.id.time-in-sec-since-1970

idフィールドは、ファイル・システムでのファイルおよびディレクトリそれぞれのOracle ACFSの内部数値識別子です。

acfsutil info id id mount_pointを使用すると、parent.idに関連付けられたディレクトリの特定を試みることができます。このディレクトリは、削除されたオブジェクトの元の場所とみなされます。acfsutil infoの詳細は、「acfsutil info file」を参照してください。

親ディレクトリが不明な場合は、親のidフィールドをUNKNOWNと設定します。

ノート:

\lost+foundディレクトリの内容は、スナップショットから表示することはできません。

例

次の例は、WindowsでのOracle ACFSファイル・システムのチェック方法を示しています。

例16-16 acfschkdskコマンドの使用方法

C:\> acfschkdsk asm-volume1-311

acfsdismount

目的

Oracle ACFSファイル・システムをディスマウントし、マウント・ポイント(ネームスペースの添付)を削除します。

構文および説明

acfsdismount /h
acfsdismount [/v] {drive_letter | mount_point} 
acfsdismount [/v] /all

表16-20に、acfsdismountコマンドで使用可能なオプションを示します。

表16-20 acfsdismountコマンドのオプション

オプション	説明
`/v`	verboseモードを指定します。操作が発生すると、進捗状況が表示されます。
`/h`	ヘルプ・テキストを表示して終了します。
`/all`	このノードのすべてのOracle ACFSファイル・システムをディスマウントすることを指定します。
`drive_letter`	後ろにコロンを付けてドライブ文字を指定します。
`mount_point`	マウント・ポイントのフルパス(ドライブ文字を含む)を指定します。

acfsdismountは、現在のノードで指定されたファイル・システムのマウント・ポイント(ネーム・スペースの添付)を削除し、ファイル・システムがマウントされている場合はディスマウントします。ファイル・システムがディスマウント済の状態の場合、データはデバイスで保存され、ファイル・システムはacfsmountvolコマンドで再マウントできます。

ウイルス・スキャナ、Process Explorer、Oracle Enterprise Managerなどの様々なプログラムからのオープン・ファイル参照があるため、acfsdismountは、状況によっては失敗することがあります。

acfsdismountコマンドを使用するには、WindowsのAdministrator権限が必要です。

例

次の例は、Oracle ACFSファイル・システムのディスマウント方法を示しています。1つ目の例では、ドライブ文字のみを使用してファイル・システムをディスマウントします。2つ目の例では、フルパス名を使用してファイル・システムをディスマウントします。3つ目の例では、マウントされているすべてのファイル・システムをディスマウントします。どの例もverboseモードを有効にします。

例16-17 acfsdismountコマンドの使用方法

C:\> acfsdismount /v O:

C:\> acfsdismount /v O:\mnt\

C:\oracle>acfsdismount /v /all
acfsdismount: valid path name: C:\oracle\acfsmounts\acfs1\
acfsdismount: opening handle to volume C:\oracle\acfsmounts\acfs1
acfsdismount: locking volume C:\oracle\acfsmounts\acfs1
acfsdismount: dismounting volume C:\oracle\acfsmounts\acfs1
acfsdismount: removing volume mount point on C:\oracle\acfsmounts\acfs1\
acfsdismount: closing handle to volume C:\oracle\acfsmounts\acfs1 and exiting cleanly

acfsformat

目的

Oracle ACFSファイル・システムを作成します。

構文および説明

acfsformat /h
acfsformat [/v] [/i {512 | 4096}] [/f] [/n name] volume_device 
            [/c release_version] [blocks]

表16-21に、acfsformatコマンドで使用可能なオプションを示します。

表16-21 acfsformatコマンドのオプション

オプション	説明
`/v`	verboseモードを指定します。操作が発生すると、進捗状況が表示されます。
`/i {512 \| 4096}`	512バイトまたは4096バイトのメタデータ・ブロック・サイズでファイル・システムを指定します。
`/n` `name`	ファイル・システムの名前を指定します。これは、ボリューム・ラベルともいいます。`acfsutil` `info` `fs`は、指定されていれば名前を戻します。また、`V$ASM_ACFSVOLUMES`ビューの`VOL_LABEL`列から表示することもできます。
`/f`	forceオプションを指定します。このアクションで、デバイスに既存のOracle ACFSがあっても、ファイル・システムが作成されます。ただし、フィアル・システムがディスマウントされている場合にかぎります。このオプションは、元のファイル・システム上の構造を上書きします。慎重に使用してください。
`/h`	使用方法のヘルプ・テキストを表示します。
`volume_device`	フォーマットするOracle ADVMデバイス・ファイルを指定します。
`/c` `release_version`	release_versionの値に設定されたOracle ACFSリリースの互換性でOracle ACFSファイル・システムを作成します。
`blocks`	指定したデバイスでファイル・システムが消費するブロック数を指定します。量は、`K`(KB)、`M`(MB)、`G`(GB)または`T`(TB)の単位で指定できます。単位が指定されていない場合、デフォルトはバイトです。このオプションを指定しない場合、デバイス全体が消費されます。

acfsformatは、Oracle ACFSのマウントに必要なディスク上の構造を作成します。acfsformatは、ターゲット・ボリュームでクイック・フォーマットを実行します。acfsformatの実行に成功すると、V$ASM_VOLUMEビューのUSAGE列にはACFSが表示されます。

/c release_versionオプションで指定する値は、ディスク・グループのCOMPATIBLE.ADVM値以上にする必要があり、実行中のOracle Grid Infrastructureリリースのバージョン以下にする必要があります。/c release_versionを指定しないと、COMPATIBLE.ADVM値が使用されます。互換性は、設定するとダウングレードできません。/c release_versionオプションは、ディスク・グループのCOMPATIBLE.ADVMおよびCOMPATIBLE.ASMの更新ができない、または望ましくない状況で、互換性の向上が必要なOracle ACFS機能を使用する場合に使用できます。Oracle ACFSの互換性を更新すると、以前のOracle Grid Infrastructureリリースを使用してファイル・システムをマウントできなくなります。既存のファイル・システムの互換性を変更するには、「acfsutil compat set」を参照してください。Oracle ASMディスク・グループの互換性属性の詳細は、「ディスク・グループの互換性」を参照してください。

最小ファイル・システム・サイズは、512バイトのメタデータ・ブロック・サイズ・フォーマットの場合は200 MB、4 KBのメタデータ・ブロック・サイズ・フォーマットの場合は512 MBです。

acfsformatを機能させるには、Oracle ACFSドライバをロードする必要があります。

このコマンドを使用するには、WindowsのAdministrator権限が必要です。

4 KBのセクター/メタデータ

次に、COMPATIBLE.ADVMディスク・グループ属性値に基づいた/iオプションおよびメタデータ・ブロック・サイズの使用についてまとめます。

COMPATIBLE.ADVMが12.2以上に設定されている場合、メタデータ・ブロック・サイズはデフォルトで4096バイトです。
COMPATIBLE.ADVMが12.2未満に設定されている場合、ブロック・サイズは512バイトに設定されます。
COMPATIBLE.ADVMが12.2未満に設定されているのに、論理セクター・サイズが512バイトでない場合、コマンドは失敗します。

ユーザー・データIOでは、標準ユーザーIOリクエストに対して512バイトの小規模な転送が引き続きサポートされます。ファイル・システムのOracle ADVMボリュームの論理ディスク・セクター・サイズが4 Kの場合、最良のパフォーマンスを得るには、ユーザー直接IOリクエストを4 Kファイル・オフセットに揃えて、4 KBの倍数の長さにする必要があります。4 Kメタデータ・ブロック・サイズ・フォーマットでのみ、論理ディスク・セクターが4 KのADVMボリュームがサポートされます。

論理ディスク・サイズが4096のOracle ADVMボリュームをフォーマットしたり、/i 4096オプションを使用して論理ディスク・セクター・サイズが512バイトのOracle ADVMボリュームをフォーマットするには、COMPATIBLE.ADVM値を12.2以上に設定する必要があります。

例

この例は、Oracle ACFSファイル・システムの作成方法を示しています。この例ではverboseオプションが指定されています。

例16-18 acfsformatコマンドの使用方法

C:\> acfsformat /v asm-volume1-311

acfsmountvol

目的

Oracle ACFSファイル・システムをマウントします。

構文および説明

acfsmountvol /h
acfsmountvol
acfsmountvol [/v]  /all 
acfsmountvol [/v] { drive_letter |dir } volume_device

表16-22に、acfsmountvolコマンドで使用可能なオプションを示します。

表16-22 acfsmountvolコマンドのオプション

オプション	説明
`/v`	verboseモードを指定します。操作が発生すると、進捗状況が表示されます。
`/h`	使用方法のヘルプ・テキストを表示して終了します。
`/all`	`acfsutil` `registry`を使用して作成されたACFSマウント・レジストリを読み取り、リストされているファイル・システムをこのノードにマウントします。
`drive_letter`	Oracle ADVMボリューム・デバイスにリンクするWindowsドライブ文字。
`dir`	マウント・ポイントの完全ディレクトリ(ドライブ文字を含む)を指定します。
`volume_device`	`acfsformat`でフォーマットされたOracle ADVMボリューム・デバイス・ファイルを指定します。

acfsmountvolは、指定したパス名またはドライブ名にあるファイル・システム階層にOracle ACFSをアタッチします。dirは、空のディレクトリである必要があります。Oracle ACFSマウント・ポイントは、任意の空のディレクトリに作成でき、階層化(ネスト化)できます。

acfsmountvolが正常に実行されると、V$ASM_VOLUMEビューのMOUNTPATH列に、ファイル・システムがマウントされた完全パスまたはドライブ名が表示されます。引数を指定しない場合、このノードにマウント済のOracle ACFSファイル・システムがすべてリストされます。

マウント失敗の原因をacfsmountvolコマンドに戻すことは、いつでもできるわけではありません。これが起こると、Oracle ACFSは失敗の原因をWindowsシステム・イベント・ログ出力に書き込みます。

Oracle ACFSファイル・システムは1つのマウント・ポイントにのみマウントされます。同じマウント・ポイント名をすべてのクラスタ・メンバーで使用する必要があります。

Oracle ACFSをマウントするには、WindowsのAdministrator権限が必要です。

例

1つ目の例は、F:ドライブとして識別されるマウント・ポイントにasm-volume1-311をマウントする方法を示しています。2つ目の例は、c:\oracle\acfsmounts\acfs1\で指定したマウント・ポイントにasm-volume1-215をマウントする方法を示しています。最初の2つの例はverboseモードを有効にします。3つ目の例では、ノードでマウントされているすべてのファイル・システムをディスマウントします。

例16-19 acfsmountvolコマンドの使用方法

C:\> acfsmountvol  /v  F:  asm-volume1-215

C:\> acfsmountvol /v  c:\oracle\acfsmounts\acfs1  asm-volume1-311

C:\oracle>acfsmountvol
   asm-volume1-311
       C:\oracle\acfsmounts\acfs1

acfsutil detach

目的

モジュールのアンロードのためにOracle ACFSドライバの準備をします。

構文および説明

acfsutil detach

acfsutil detachは、ドライバをアンロードできるようにOracle ACFSを準備します。Oracle ACFSは、ドライバのロード時に基本のファイル・システムとして登録されます。Windowsサービス制御マネージャからドライバに停止コマンドを送信するには、ドライバに関連付けられたすべてのデバイス・オブジェクトの削除に加えて、Oracle ACFSの基本ファイル・システムとしての登録を解除する必要があります。

acfsutil detachが正常に完了し、すべてのボリュームがディスマウントされると、管理者はWindowsサービス制御マネージャの停止コマンドをOracle ACFSドライバに実行できます。acfsutil detachコマンドが使用されない場合、stopコマンドでOracle ACFSドライバのアンロード・ルーティンはコールされません。このコマンドは、WindowsのAdministratorのみが実行できます。これはOracle ACFS停止スクリプトによって自動的にコールされます。

例

次の例は、Oracle ACFSファイル・システムをすべてデタッチしてWindows上のドライバをアンロードする方法を示しています。1つ目の例では、すべてのOracle ACFSファイル・システム・ボリューム・デバイスをディスマウントします。2つ目の例では、ボリューム・デバイスをデタッチします。

例16-20 acfsutil detachコマンドの使用方法

C:\> acfsdismount /all

C:\> acfsutil detach

advmutil dismount

目的

advmutil dismountコマンドは、Oracle ACFSではないファイル・システムのOracle ADVMボリューム・デバイスをディスマウントします。

構文および説明

advmutil dismount [/unregister] {drive_letter | dir}
advmutil dismount [/unregister] [/all | /dg=disk_group]

表16-23に、Windowsのadvmutil dismountコマンドで使用可能なオプションを示します。

表16-23 advmutil dismountコマンドのオプション

オプション	説明
`drive_letter`	ディスマウントするドライブ文字を指定します。
`dir`	マウント・ポイントのディレクトリ(ドライブ文字を含む)を指定します。
`/a`ll	このノード上のすべてのファイル・システムをディスマウントすることを指定します。
`/unregister`	必要に応じて、システム・レジストリからOracle ADVMボリューム・デバイスとそのドライブ文字を登録解除します。Oracle ASMインスタンスおよびOracle ACFSの起動時に、登録解除されたドライブ文字およびOracle ADVMボリューム・シンボリック・リンクは作成されません。
`/dg=disk_group`	ドライブ文字を作成し、場合によってはファイル・システムをマウントまたはディスマウントするための、登録済Oracle ADVMボリューム・デバイスを含むディスク・グループの任意の名前。

ノート:

NTFSでOracle ADVMボリューム・デバイスをフォーマットするには、ドライブ文字にマウントする必要があります。フォーマット後、NTFSではOracle ADVMボリューム・デバイスをドライブ文字またはディレクトリのいずれにもマウントできます。

このコマンドを正常に実行するには、ローカルOracle ASMインスタンスが実行中で、このコマンドに必要なディスク・グループがそのOracle ASMインスタンスに作成され、マウントされており、ボリュームが有効であることが必要です。

advmutil dismountコマンドは、ファイル・システムが完全にアンマウントされるまで、オペレーティング・システム・プロンプトに制御を戻しません。

例

次の例は、Oracle ACFSではないファイル・システムをディスマウントする方法を示しています。

1つ目の例は、Oracle ADVMボリューム・デバイスのドライブ文字を削除してファイル・システムにアクセスできないようにする方法を示しています。
2つ目の例は、Oracle ADVMボリューム・デバイスのドライブ文字を削除してファイル・システムにアクセスできないようにし、レジストリから削除する方法を示しています。
3つ目の例は、すべての登録済Oracle ADVMボリューム・デバイスのドライブ文字を削除して、すべてのファイル・システムにアクセスできないようにする方法を示しています。
4つ目の例は、特定のOracle ASMディスク・グループにあるすべての登録済Oracle ADVMボリューム・デバイスのドライブ文字を削除して、すべての関連ファイル・システムにアクセスできないようにする方法を示しています。

例16-21 advmutil dismountコマンドの使用方法

C:\> advmutil dismount H:

C:\> advmutil dismount H: /unregister

C:\> advmutil dismount /all

C:\> advmutil dismount /dg=data

advmutil list

目的

advmutil listコマンドは、advmutil mount /registerを使用して登録されたOracle ADVMボリューム・デバイスをリストします。

構文および説明

advmutil list /registry

表16-24に、Windowsのadvmutil listコマンドで使用可能なオプションを示します。

表16-24 advmutil listコマンドのオプション

オプション	説明
`list` `/registry`	Windowsレジストリに含まれる、ドライブ文字および対応するOracle ADVMボリューム・デバイス名をリストします。

Oracle ACFSのOracle ADVMボリューム・デバイスの表示の詳細は、「acfsutil info file」を参照します。

例

次の例は、システム・レジストリ内のすべてのエントリをリストする方法を示しています。

例16-22 advmutil listコマンドの使用方法

C:\> advmutil list /registry

  Drive Letter     Asm Volume
  ===================================
  H:               asm-volume1-123
  K:               asm-volume2-245

advmutil mount

目的

advmutil mountコマンドは、Oracle ACFSではないファイル・システムのOracle ADVMボリューム・デバイスをマウントします。

構文および説明

advmutil mount [/register] {drive_letter | dir} volume_device
advmutil mount /all

表16-25に、Windowsのadvmutil mountコマンドで使用可能なオプションを示します。

表16-25 advmutil mountコマンドのオプション

オプション	説明
`drive_letter`	マウントするドライブ文字を指定します。
`dir`	マウント・ポイントのディレクトリ(ドライブ文字を含む)を指定します。
`volume_device`	Oracle ADVMボリューム・デバイスを指定します。
`/a`ll	このノードのすべてのOracle ACFSではないファイル・システムをマウントすることを指定します。
`/register`	必要に応じて、Windowsシステム・レジストリにOracle ADVMボリューム・デバイスとそのドライブ文字を登録します。Oracle ASMインスタンスおよびOracle ACFSの起動後に、登録されたすべてのドライブ文字およびOracle ADVMボリューム・シンボリック・リンクが作成されます。これにより、Oracle ACFSファイル・システムの場合と同様に、Windowsではファイル・システムの自動マウントが可能になります。

ノート:

Oracle ACFSのOracle ADVMボリューム・デバイスの登録の詳細は、「acfsutil registry」を参照します。

例

次の例は、Oracle ACFSではないファイル・システムをマウントする方法を示しています。

1つ目の例は、非Oracle ACFSのアクセスとして使用されるOracle ADVMボリューム・デバイスのドライブ文字を作成し、ボリュームをNTFSで使用できるようにフォーマットするのに使用できるようにする方法を示しています。
2つ目の例は、非Oracle ACFSのアクセスとして使用されるOracle ADVMボリューム・デバイスのドライブ文字を作成し、ボリュームをNTFSで使用できるようにフォーマットしてWindowsシステム・レジストリに保存するのに使用できるようにする方法を示しています。
3つ目の例は、システム・レジストリに保存されているすべてのOracle ADVMボリューム・デバイスのドライブ文字を作成し、ファイル・システムへのアクセスも可能にする方法を示しています。

例16-23 advmutil mountコマンドの使用方法

C:\> advmutil mount H: asm-volume1-123

C:\> advmutil mount H: asm-volume1-123 /register

C:\> advmutil mount /all