ASMCMDについて

ASMCMDコマンドのタイプ

ASMCMDコマンドのタイプは、表10-15にリストされています。

表10-15 ASMCMDコマンドのタイプ

カテゴリ	コマンド
Oracle ASMインスタンスの管理	コマンドのリストは、「ASMCMDインスタンス管理コマンド」を参照してください。
Oracle ASMクライアント・クラスタ	コマンドのリストは、「ASMCMDメンバー・クラスタ管理コマンド」を参照してください。
Oracle ASMフィルタ・ドライバ管理	コマンドのリストについては、「ASMCMD Oracle ASMフィルタ・ドライバ管理コマンド」を参照してください
Oracle ASM監査ファイル管理	コマンドのリストは、ASMCMD監査ファイル管理コマンドを参照してください
Oracle ASMファイルの管理	コマンドのリストは、「ASMCMDファイル管理コマンド」を参照してください
Oracle ASMディスク・グループの管理	コマンドのリストは、「ASMCMDディスク・グループ管理コマンド」を参照してください
Oracle ASMファイル・グループの管理	コマンドのリストは、「ASMCMDファイル・グループ管理コマンド」を参照してください。
Oracle ASMテンプレートの管理	コマンドのリストは、「ASMCMDテンプレート管理コマンド」を参照してください
Oracle ASMファイル・アクセス制御	コマンドのリストは、「ASMCMDファイル・アクセス制御コマンド」を参照してください

Oracle ASMファイル、ファイル名、ディレクトリおよびエイリアスについて

ASMCMDでは、Oracle ASMのファイル、ディレクトリおよびエイリアスを使用します。ASMCMDを使用する前に、これらの一般的な処理の概念がOracle ASMの環境にどのように適用されるかを理解しておく必要があります。

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

システム生成のファイル名(完全修飾されたファイル名)

Oracle ASMで作成されたすべてのファイルには、システム生成のファイル名(完全修飾されたファイル名)が付けられます。これは、ローカル・ファイル・システムでの完全パス名と類似しています。

Oracle ASMでは、次の形式に従ってファイル名が生成されます。

+diskGroupName/databaseName/fileType/fileTypeTag.fileNumber.incarnation

次に、完全修飾されたファイル名の例を示します。

+data/orcl/CONTROLFILE/Current.256.541956473

前述の完全修飾されたファイル名では、dataがディスク・グループ名、orclがデータベース名、CONTROLFILEがファイル・タイプとなります。

ASMCMDではスラッシュ(/)のみがサポートされます。ファイル名の大文字と小文字は区別されませんが、保持されます。小文字でパス名を入力すると、ASMCMDは小文字で保持します。

Oracle ASMのファイル名の詳細は、完全修飾ファイル名形式を参照してください。

ディレクトリ

他のファイル・システムと同様、Oracle ASMディレクトリはファイルのコンテナであり、Oracle ASMディレクトリは他のディレクトリのツリー構造の一部になります。完全修飾されたファイル名は、ルートにプラス記号(+)が付いたディレクトリの階層で示されます。ディスク・グループごとに、Oracle ASMによりディスク・グループ内で完全修飾されたファイル名の構造に対応するディレクトリ階層が自動的に作成されます。この階層構造でのディレクトリを、システム生成のディレクトリと呼びます。

ASMCMDでは、cd(ディレクトリ変更)コマンドを使用して、このディレクトリ階層を上下に移動できます。ASMCMDのls(ディレクトリのリスト)コマンドでは、現行ディレクトリの内容をリストし、pwdコマンドでは、現行ディレクトリ名を出力します。

ASMCMDを起動すると、現行ディレクトリはルート(+)に設定されます。たとえば、dataおよびfraの2つのディスク・グループを持つOracle ASMインスタンスの場合、ルート・ディレクトリを現行ディレクトリとしてlsコマンドを入力すると、出力結果は次のようになります。

ASMCMD> ls
data/
fra/

次に、Oracle ASMディレクトリ・ツリー(前述の完全修飾されたファイル名を参照)を移動する例を示します。

ASMCMD> cd +data/orcl/CONTROLFILE
ASMCMD> ls
Current.256.541956473
Current.257.541956475

システム生成のディレクトリのサブディレクトリとして、独自のディレクトリを作成できます。これを行うには、ASMCMD mkdirコマンドを使用します。ユーザー作成のディレクトリにもサブディレクトリを作成でき、システム生成のディレクトリおよびユーザー作成のディレクトリの両方の階層構造をcdコマンドを使用して移動できます。

次の例では、ディスク・グループdataのorclの下にディレクトリmydirを作成します。

ASMCMD> mkdir +data/orcl/mydir

ノート:

ディレクトリorclは、システム生成のディレクトリです。dataの内容は、ディスク・グループdataの内容を表します。

-pフラグを付けてASMCMDを起動すると、ASMCMDでは、プロンプトの一部に常に現行ディレクトリが表示されます。詳細は、ASMCMDプロンプトへの現行ディレクトリの表示を参照してください。

ASMCMD [+] > cd data/orcl
ASMCMD [+data/orcl] >

ASMCMDでは、ディレクトリの大文字と小文字は入力したとおりに保持されます。

エイリアス

エイリアスは、システム生成のファイル名への参照またはポインタとなるファイル名です。ただし、エイリアスはユーザーにわかりやすい名前です。UNIXまたはLinuxコンピュータでのシンボリック・リンクと同様です。Oracle ASMファイル名の管理を簡略化するためにエイリアスを作成できます。エイリアスは、mkalias ASMCMDコマンドまたはSQL ALTER DISKGROUPコマンドを使用して作成できます。

エイリアスの完全パスの一部には、少なくともディスク・グループ名が含まれます。エイリアスは、ディスク・グループ・レベル、システム生成またはユーザー作成の任意のサブディレクトリで作成できます。次にエイリアスの例を示します。

+data/ctl1.f
+data/orcl/ctl1.f
+data/mydir/ctl1.f

ASMCMDのls(ディレクトリのリスト)に-lフラグを付けて実行すると、各エイリアスは、参照するシステム生成のファイルとともにリストされます。

ctl1.f => +data/orcl/CONTROLFILE/Current.256.541956473

エイリアスの詳細は、エイリアスOracle ASMファイル名形式を参照してください。

絶対パスおよび相対パス

引数としてファイル名またはディレクトリ名をとるASMCMDコマンドを実行する場合、名前は絶対パスまたは相対パスのいずれかとして使用できます。

絶対パスは、ファイルまたはディレクトリの完全パスを示します。絶対パスはプラス記号(+)で始まり、その後にディスク・グループ名、ディレクトリ・ツリー内の後続ディレクトリが続きます。絶対パスには、対象のファイルまたはディレクトリまでのディレクトリが含まれます。システム生成の完全なファイル名(完全修飾されたファイル名とも呼ばれる)は、ファイルへの絶対パスの例です。

絶対パスを使用すると、現行ディレクトリがどこに設定されているかに関係なく、コマンドを実行してファイルまたはディレクトリにアクセスできます。次のrmコマンドでは、ファイル名への絶対パスを使用しています。

ASMCMD [+] > rm +data/orcl/datafile/users.259.555341963

次のcdコマンドでは、ディレクトリへの絶対パスを使用しています。

ASMCMD [+data/mydir] > cd +data/orcl/CONTROLFILE

相対パスは、現行ディレクトリの部分を含まないファイル名またはディレクトリ名の部分でのみ構成されます。つまり、ファイルまたはディレクトリへのパスは、現行ディレクトリに対する相対的な位置を示します。

次の例で、rmコマンドは、相対パスであるファイルundotbs1.272.557429239で動作します。ASMCMDは、コマンド引数に現行ディレクトリを追加し、このファイルへの絶対パスを取得します。この例では、これは+data/orcl/DATAFILE/undotbs1.272.557429239です。

ASMCMD [+] > cd +data
ASMCMD [+data] > cd orcl/DATAFILE
ASMCMD [+data/orcl/DATAFILE] > ls
EXAMPLE.269.555342243
SYSAUX.257.555341961
SYSTEM.256.555341961
UNDOTBS1.258.555341963
UNDOTBS1.272.557429239
USERS.259.555341963
ASMCMD [+data/orcl/DATAFILE] >
 rm undotbs1.272.557429239

また、ディレクトリへのパスを相対パスとして指定できます。cdコマンドに、現行ディレクトリへの相対パスを持つディレクトリ引数を指定して、現行ディレクトリ・ツリー・ブランチの階層を上下に移動できます。

また、ディレクトリ名のかわりに擬似ディレクトリ「.」および「..」を使用できます。「.」擬似ディレクトリは、現行ディレクトリです。「..」擬似ディレクトリは、現行ディレクトリの親ディレクトリです。

次に、相対ディレクトリ・パスおよび擬似ディレクトリの使用例を示します。

ASMCMD [+data/orcl] > cd DATAFILE
ASMCMD [+data/orcl/DATAFILE] >cd ..
ASMCMD [+data/orcl] >

ワイルドカード文字

ワイルドカード文字の*および%は、絶対パスまたは相対パス内の0文字以上に一致します。絶対パスまたは相対パスは、完全なディレクトリまたはファイル名の入力を保存します。これら2つのワイルドカード文字の動作は同じです。ワイルドカードは、cd、du、find、ls、lsattr、lsdg、lsdsk、lsgrp、lsusr、rmなど、様々なASMCMDコマンドで使用できます。

cdでワイルドカード文字を使用する場合、ワイルドカードのパターンと一致するのが1つのディレクトリのみの場合、cdはそのディレクトリを目的のディレクトリに変更します。ワイルドカードのパターンが複数のディレクトリと一致する場合、ASMCMDはディレクトリを変更せず、エラーが戻されます。

非対話モードでASMCMDコマンドを実行する場合、ほとんどのオペレーティング・システムで、ワイルドカード文字を引用符で囲む必要があります。詳細は、非対話モードでのASMCMDの実行を参照してください。

例10-20に、ワイルドカードの使用例を示します。

例10-20 ASMCMDコマンドでのワイルドカードの使用方法

ASMCMD [+] > cd +data/orcl/*FILE
ASMCMD-08005: +data/orcl/*FILE: ambiguous

ASMCMD [+] > cd +data/orcl/C*
ASMCMD [+data/orcl/CONTROLFILE] >

ASMCMD [+] > ls +fra/orcl/A%
2009_07_13/
2009_07_14/

ASMCMD [+] >  ls +fra/orcl/ARCHIVELOG/2009%

+fra/orcl/ARCHIVELOG/2009_07_13/:
thread_1_seq_3.260.692103543
thread_1_seq_4.261.692108897
thread_1_seq_5.262.692125993
thread_1_seq_6.263.692140729
thread_1_seq_7.264.692143333
 
+fra/orcl/ARCHIVELOG/2009_07_14/:
thread_1_seq_8.271.692158265
thread_1_seq_9.272.692174597

ASMCMD [+] > ls data/orcl/*

+data/orcl/CONTROLFILE/:
Current.260.692103157

+data/orcl/DATAFILE/:
EXAMPLE.265.692103187
SYSAUX.257.692103045
SYSTEM.256.692103045
UNDOTBS1.258.692103045
USERS.259.692103045

+data/orcl/ONLINELOG/:
group_1.261.692103161
group_2.262.692103165
group_3.263.692103169

+data/orcl/PARAMETERFILE/:
spfile.266.692103315

+data/orcl/TEMPFILE/:
TEMP.264.692103181
spfileorcl.ora

ASMCMDの実行の準備

ASMCMDユーティリティを実行する前に、この項の情報を確認してください。

ASMCMDユーティリティは、対話モードでも非対話モードでも実行できます。ASMCMDを実行する前に、次の事柄を確認します。

管理する予定のOracle ASMインスタンスがあるホストにログインします。

オペレーティング・システム認証によって、SYSASMまたはSYSDBA権限を持つユーザーとしてログインする必要があります。SYSASM権限は、Oracle ASMインスタンスを管理するために必要な接続です。
Oracle ASMインスタンスに接続するには、Oracle Gridインフラストラクチャ・ホーム(Oracle ASMホーム)のbinサブディレクトリにあるASMCMDを実行します。

Oracle ASMインスタンスを管理するには、SYSASMとして接続(デフォルトの接続)します。

環境変数ORACLE_HOMEおよびORACLE_SIDがOracle ASMインスタンスを参照していることを確認します。オペレーティング・システムによっては、Oracle ASMインスタンスに正しく接続するために、その他の環境変数を設定する必要があります。

Oracle Gridインフラストラクチャ・ホームのbinサブディレクトリがPATH環境変数に指定されていることを確認します。

単一インスタンス・データベース用のOracle ASM SIDのデフォルト値は、+ASMです。Oracle Real Application Clusters環境では、すべてのノードでOracle ASM SIDのデフォルト値は、+ASMnode#です。
ほとんどのASMCMDコマンドを使用するには、Oracle ASMインスタンスが起動し、Oracle ASMディスク・グループがマウントされていることを確認します。

Oracle ASMインスタンスが実行されていない場合、ASMCMDは実行されますが、Oracle ASMインスタンスを必要としないコマンドのみが実行されます。実行されるのは、startup、shutdown、lsdsk、helpおよびexitコマンドです。その他のASMCMDコマンドを実行しようとすると、エラー・メッセージが表示されます。
Oracle DatabaseホームのbinディレクトリにあるASMCMDを実行すると、データベース・インスタンスにはSYSDBAとして接続できます。

環境変数ORACLE_HOMEおよびORACLE_SIDがデータベース・インスタンスを参照していることを確認します。オペレーティング・システムによっては、データベース・インスタンスに正しく接続するために、その他の環境変数を設定する必要があります。

SYSDBAとして接続するには、--privilegeオプションを入力する必要があります。

この接続では、実行できる操作が制限されます。

ディスク・グループを管理する場合、ディスク・グループ内のファイルの所有者であるデータベース・インスタンスのデータベース・ホームからASMCMDを実行することをお薦めします。

対話モードでのASMCMDの実行

ASMCMDユーティリティの対話モードは、ASMCMDコマンドの入力が求められるシェルに似た環境で動作します。

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

ASMCMDを起動するための構文

対話モードでのASMCMDを起動する構文は、次のとおりです。

asmcmd [-V]
asmcmd [--nocp] [-v {errors|warnings|normal|info|debug}]
       [--privilege connection_type ] [-p]
       [--inst instance_name] [--discover]

表10-16に、ASMCMDオプションを示します。

表10-16 対話型のASMCMDオプション

オプション	説明
-`V`	ASMCMDのバージョンを表示してから終了します。
`--nocp`	接続プーリングを無効にします。接続プーリングの詳細は、『Oracle Database管理者ガイド』を参照してください。
`-v` `display_level`	ユーザーが問題を判断する助けとなり、ログインの要求時にメッセージファイルを書き込む、いくつかのコマンドの詳細を表示します。表示レベルが指定されない場合は、`normal`がデフォルトです。
`--privilege connection_type`	Oracle ASMインスタンスまたはデータベース・インスタンスへのアクセス時に接続する権限を指定します。`SYSASM`または`SYSDBA`を指定できます。デフォルトは`SYSASM`で、Oracle ASMインスタンスを管理する場合に使用されます。
`-p`	プロンプトで現行ディレクトリが表示されます。
`--inst instance_name`	特定のOracle ASMインスタンスに接続することを指定します。
`--discover`	`ORACLE_SID`環境変数からではなく、リスナーから取得した検出文字列を使用します。

ORACLE_HOME環境変数とORACLE_SID環境変数は、ASMCMDが接続するインスタンスを判別します。ASMCMDは、ユーザーがOSASMグループのメンバーであることを要求するSQLPLUS / AS SYSASMと同じ方法でBequeath接続を確立します。

Oracle Flex ASMが有効になっている場合、ASMCMDは、クラスタ内で実行されているOracle ASMインスタンスのいずれかに接続します。Oracle ASMインスタンスへの接続は、ORACLE_HOME環境変数とORACLE_SID環境変数に依存しません。ASMCMDアラート・ログには、ASMCMDが接続しているインスタンスが表示されます。特定のOracle ASMインスタンスに接続する場合は、--instオプションを使用します。

ASMCMDは複数のオプションを指定して起動することができます。次に例を示します。

asmcmd -p -v info

この章のほとんどの例では、-pオプションを指定してASMCMDが起動されています。

オプションなしでのASMCMDの実行

オプションを指定せずに対話モードでASMCMDを実行するには:

オペレーティング・システムのコマンド・プロンプトで、次のように入力します。

asmcmd

次のようにASMCMDコマンド・プロンプトが表示されます。

ASMCMD>
ASMCMDコマンドを入力し、[Enter]を押します。コマンドが実行され、出力がある場合は表示され、ASMCMDにより次のコマンドの入力が求められます。
タスクが完了するまでASMCMDコマンドの入力を続行します。
exitまたはquitコマンドを入力してASMCMDを終了します。

接続タイプの指定

--privilegeオプションを指定して、接続タイプ(SYSASMまたはSYSDBAのいずれか)を選択できます。デフォルトはSYSASMで、Oracle ASMインスタンスを管理する場合に使用されます。データベース・インスタンスに接続する場合は、SYSDBAとして接続します。

次に例を示します。

$ asmcmd --privilege sysasm

verboseモードの指定

asmcmdコマンドで-vオプションを指定すると、ユーザーが問題を診断するのに役立ついくつかのコマンドとともに追加情報を表示できます。次に例を示します。

$ asmcmd -v debug

asmcmd操作中はログインする必要があるというメッセージが表示される場合、メッセージはalert.logファイルまたはtrace.trcファイルに書き込まれます。

alert.logファイルは、asmcmdが-v errors、-v warnings、または-v normalの表示レベルで開始されたときに作成または更新されます。asmcmdが、-v infoまたは-v debugの表示レベルで開始されたときにtrace.trcファイルが作成または更新されました。

デフォルトでは、alert.logは、$ORACLE_BASE/diag/asmcmd/user_username/hostname/alert/ディレクトリで作成されたファイルです。デフォルトでは、trace.trcファイルは、$ORACLE_BASE/diag/asmcmd/user_username/hostname/trace/ディレクトリで作成されます。

特定の状況では、$ORACLE_BASEと$ORACLE_HOMEは、alert.logファイルとtrace.trcファイルのデフォルト場所を上書きするように設定できます。

ASMCMDプロンプトへの現行ディレクトリの表示

asmcmdコマンドで-pオプションを指定すると、ASMCMDプロンプトに現行ディレクトリを表示できます。次に例を示します。

$ asmcmd -p
ASMCMD [+] > cd data
ASMCMD [+data] >

ASMCMDのバージョン番号の表示

asmcmdの起動時に-Vオプションを指定すると、asmcmdバージョン番号を表示できます。バージョン番号が表示されると、asmcmdはすぐに終了します。

次に例を示します。

$ asmcmd -V
  asmcmd version 19.0.0.0.0

非対話モードでのASMCMDの実行

非対話モードでは、ASMCMDの起動時にコマンドラインにコマンドおよびコマンド・オプションを含めることにより、単一のASMCMDコマンドを実行します。ASMCMDはコマンドを実行し、必要な場合は出力を生成し、終了します。非対話モードは、特にスクリプトの実行に便利です。

ほとんどのオペレーティング・システムでは、非対話モードでASMCMDコマンドを実行する場合、ワイルドカード文字を引用符で囲む必要があります。

非対話モードでASMCMDを実行するには、コマンド・プロンプトで次のように入力します。この場合、commandは任意の有効なASMCMDコマンドで、optionsはコマンド・オプションのリストです。

asmcmd command options

非対話モードでは、ASMCMDは表10-17に示すコードを戻します。

表10-17 ASMCMDのリターン・コード

タイプ	リターン・コード	説明
一般	0	コマンドに問題はありません。
一般	1	内部エラーです。
一般	255または-1	コマンドにより戻された外部ユーザー・エラーです。
`lsdsk`	0	結果にはメンバー・ディスクのみが含まれます。
`lsdsk`	1	結果には候補ディスクのみが含まれます。
`lsdsk`	2	結果にはメンバー・ディスクおよび候補ディスクの両方が含まれます。

例10-21に、非対話モードでASMCMDを実行する方法を示します。1番目のコマンドでは、lsコマンドを実行してOracle ASMインスタンスのディスク・グループをリストします。2番目のコマンドでは、lsodコマンドの出力をmy_lsod_testファイルにリダイレクトします。3番目のコマンドでは、ワイルドカード文字のパターンを使用してlsdskを実行し、dataディスク・グループの特定のディスクをリストします。ほとんどのオペレーティング・システムでは、非対話モードでASMCMDコマンドを実行する場合、ワイルドカード文字を引用符で囲む必要があることに注意してください。

例10-22では、間違ったディスク・グループ名によりエラーが発生し、リターン・コード(255)が表示されます。

例10-23に、スクリプト内で非対話モードでASMCMDコマンドを実行する例を示します。

例10-21 非対話モードでのASMCMDコマンドの実行

$ asmcmd ls -l
State    Type    Rebal  Name
MOUNTED  NORMAL  N      DATA/
MOUNTED  NORMAL  N      FRA/

$ asmcmd lsod --suppressheader -G data > my_lsod_test

$ asmcmd lsdsk -G data '/devices/diska*'
Path
/devices/diska1
/devices/diska2
/devices/diska3

例10-22 非対話モードでのASMCMDの実行時のリターン・コードの表示

$ asmcmd ls -l dat
ASMCMD-08001: diskgroup 'dat' does not exist or is not mounted

$ echo $?
255

例10-23 スクリプト内でのASMCMDコマンドの実行

#!/bin/sh
for ((i = 1; i <=3; i++))
 do
   asmcmd lsdsk -G data '/devices/diska'$i
done

$ ./asmcmd_test_script
Path
/devices/diska1
Path
/devices/diska2
Path
/devices/diska3

ヘルプの利用

ASMCMDに関する一般情報および使用可能なASMCMDコマンドのリストを表示するには、ASMCMDプロンプトまたは非対話モードでのコマンドとして、helpと入力します。

help commandと入力すると、オプションを指定したコマンドの実行方法に関する使用情報など、特定のコマンドのヘルプ・テキストを表示できます。

次に、helpコマンドの使用例を示します。

例10-24 ASMCMDヘルプ・テキストの表示

ASMCMD [+] > help startup
        startup [--nomount] [--restrict] [--pfile <pfile.ora>]
 
        Start the ASM instance.
 
        [--nomount]           specifies the nomount option.
        [--restrict]          start the instance in restricted mode.
        [--pfile <pfile.ora>] specifies the location of the pfile.