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

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

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

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

表13-17に、Windows用のOracle ACFS以外のファイルシステム・コマンドの概要を示します。

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

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

acfschkdsk

用途

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

構文および説明

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

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

表13-18 acfschkdskコマンドのオプション

オプション	説明
`/a`	ファイルシステムを自動的に修正することを指定します。
`/f`	ファイルシステムのチェックまたは修正を完了せずに、ファイルシステムを強制的にマウント可能な状態にします。
`/v`	verboseモードを指定します。操作が発生すると、進捗状況が表示されます。
`/vv`	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によってOracle ACFSドライバがロードされていないことが検出された場合、またはファイルシステムがOracle ACFSではないと思われる場合です。チェック・モードでは、acfschkdskは不完全な停止によって完全に処理されていないトランザクション・ログがある場合にも回答を要求します。非対話モードで実行するには、質問に対してyesまたはnoと回答するために/yまたは/nオプションを含めます。

acfschkdskでは、ファイルシステムをチェックする前に、作業ファイルを作成します。これらの作業ファイルは、領域が使用可能な場合、tempディレクトリに作成されます。使用可能な領域が不十分な場合、acfschkdskでは、現在の作業ディレクトリに書込みを試みます。acfschkdskで作成するファイルは、およそチェック対象のファイルシステムを32Kで割ったサイズです。ファイルは多くても2つ割り当てられます。これらのファイルは、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」を参照してください。

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

注意:

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

例

次の例は、WindowsでのOracle ACFSファイルシステムのチェック方法を示しています。この例ではverboseモードが有効です。

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

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

acfsdismount

用途

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

構文および説明

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

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

表13-19 acfsdismountコマンドのオプション

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

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

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

例

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

例13-14 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] [/f] [/b blocksize] [/n name] volume_device [blocks]

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

表13-20 acfsformatコマンドのオプション

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

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

このコマンドを使用するのに、WindowsのAdministrator権限は必要ありません。最初のファイルシステム・サイズは200 MBです。acfsformatを機能させるには、Oracle ACFSドライバをロードする必要があります。

例

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

例13-15 acfsformatコマンドの使用方法

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

acfsmountvol

用途

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

構文および説明

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

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

表13-21 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つ目の例では、ノードでマウントされているすべてのファイルシステムをディスマウントします。

例13-16 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つ目の例では、ボリューム・デバイスをデタッチします。

例13-17 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]

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

表13-22 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インスタンスに作成され、マウントされており、ボリュームが有効であることが必要です。

例

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

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

例13-18 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

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

表13-23 advmutil listコマンドのオプション

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

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

例

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

例13-19 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

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

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

例13-20 advmutil mountコマンドの使用方法

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

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

C:\> advmutil mount /all