このセクションでは、Oracle Solaris Cluster のオブジェクト指向のコマンドセットについて説明します。従来の Oracle Solaris Cluster コマンドセットもまだ使用できますが、オブジェクト指向のコマンドを使用すれば、クラスタをより直観的に構成できます。なお、従来のコマンドセットでは、今後の新機能を利用できない可能性があります。
オブジェクト指向のコマンドセットでは、共通の接頭辞として、cl を使用します。従来のコマンドセットでは、接頭辞に sc を使用していました。sc コマンドと cl コマンドは、どちらも /usr/cluster/bin にあります。
このコマンドセットの多くのコマンドには、長い形式と短い形式の両方があります。たとえば、clresource(1CL) と clrs(1CL) は同一です。
オブジェクト指向のコマンドは、それぞれ 1 種類のクラスタオブジェクトを管理するように設計されています。コマンド名は、そのコマンドで管理するオブジェクト名を示します。たとえば、clresource コマンドは、Oracle Solaris Cluster データサービスのリソースを管理します。コマンド内で、サブコマンドが特定のクラスタオブジェクト上で許可される操作を定義します。
オブジェクト指向のコマンドセットのコマンドの一般的な形式は次のとおりです。
cmdname [subcommand] [option…] [operand …]
オブジェクト指向のコマンドとともに使用するオプションにも長い形式と短い形式があります。短い形式のオプションは、1 つのダッシュ (-) とそのあとに続く 1 つの文字で指定します。長い形式のオプションは、2 つのダッシュ (--) とそのあとに続く 1 つのオプションワードで指定します。たとえば、–p は短い形式のプロパティーオプションです。–-property は、長い形式です。
オプション引数を受け入れるオプションもあれば、受け入れないオプションもあります。オプションがオプション引数を受け入れる場合、オプション引数が必要です。–? オプションには引数は不要です。ただし、–-property オプションには操作するプロパティーを特定するオプション引数が必要です。
1 つのダッシュ (-) のあとに引数を付けないで、短い形式のオプションをグループ化することができます。例: –eM。オプションのあとのオプション引数のグループをコンマ、タブまたは空白文字で区切る必要があります。タブまたは空白を使用する場合、オプション引数を引用符で囲みます (-o xxx,z,yy または -o "xxx z yy")。
長いオプション名でオプション引数を指定するには、--input=configurationfile 形式または --input configurationfile 形式のいずれかを使用します。
このコマンドセットのコマンドはすべて –? または --help オプションを受け入れます。サブコマンドなしでこれらのオプションを指定すると、コマンドのサマリーのヘルプが表示されます。サブコマンドを指定すると、そのサブコマンドだけのヘルプが表示されます。
一部のコマンドは、構成ファイルと組み合わせて機能します。このファイルの必要な形式については、clconfiguration(5CL) のマニュアルページを参照してください。
このコマンドセットの多くのサブコマンドは、適用できるすべてのオブジェクトを示すオペランドとして、+ を受け入れます。
このセクションでは、Oracle Solaris Cluster 製品で使用できるオブジェクト指向のコマンドをアルファベット順に説明します。
ノードを追加するための Oracle Solaris Cluster アクセスポリシーを管理する
Oracle Solaris Cluster デバイスを管理します
Oracle Solaris Cluster デバイスグループを管理します
Oracle Solaris Cluster インターコネクトを管理する
Oracle Solaris Cluster の NAS デバイスへのアクセスを管理する
Oracle Solaris Cluster ノードを管理します
Oracle Solaris Cluster プライベート文字列の管理
Oracle Solaris Cluster 定足数を管理する
論理ホスト名の Oracle Solaris Cluster リソースを管理します
Oracle Solaris Cluster データサービスのリソースを管理します
Oracle Solaris Cluster データサービスのリソースグループの管理
Oracle Solaris Cluster データサービスのリソースタイプを管理します
共有アドレスの Oracle Solaris Cluster リソースを管理します
Oracle Solaris Cluster を対話により構成します
Oracle Solaris Cluster SNMP ホストを管理します
Oracle Solaris Cluster SNMP MIB を管理します
Oracle Solaris Cluster SNMP ユーザを管理します
システムリソースモニタリングの構成
クラスタのグローバル構成とグローバルステータスの管理
Oracle Solaris Cluster のゾーンクラスタを管理します
新しいコマンドセットはオブジェクト指向なので、従来のコマンドセットとの明確な 1 対 1 の対応はありません。次のリストは、従来のコマンドセットの一般的な Oracle Solaris Cluster コマンドとそれに対応するオブジェクト指向のコマンドセットをいくつか示しています。
cluster status
さらに、多くのオブジェクト指向のコマンドで status サブコマンドを使用することもできます。
cluster create を使用して、XML 構成ファイルからクラスタを作成します。
対話形式でクラスタを作成するには、scinstall を使用します。
clresource
clresourcetype
clresourcegroup
これらの特定のリソースタイプを操作するときに、clressharedaddress および clreslogicalhostname を使用すると、さらに便利です。
clresource
clresourcetype
clresourcegroup
clreslogicalhostname
clressharedaddress
clnode evacuate (ノードからすべてのリソースグループおよびデバイスグループを退避させるために使用)
cldevicegroup
clinterconnect
clquorum
clnode
claccess
cluster show を scconf -p の代わりに使用します。
cluster check
cldevice
cldevice populate
cldevice
clnasdevice
clsetup
オブジェクト指向の Oracle Solaris Cluster コマンドは、指定されたすべてのオペランドで成功すると、ゼロ (CL_NOERR) を返します。あるオペランドでエラーが発生すると、コマンドはオペランドリストの次のオペランドを処理します。戻り値は常に、最初に発生したエラーを反映します。
これらの終了コードは、このセットのコマンド全体で共有されます。
エラーなし
実行したコマンドは正常に終了しました。
十分なスワップ空間がありません。
クラスタノードがスワップメモリーまたはその他のオペレーティングシステムリソースを使い果たしました。
無効な引数
コマンドを間違って入力したか、–i オプションで指定したクラスタ構成情報の構文が間違っていました。
クラスタは再構成されます
クラスタを再構成しています。
アクセス権がありません
指定したオブジェクトにアクセスできません。このコマンドを実行するには、スーパーユーザーまたは RBAC アクセスが必要である可能性があります。詳細は、su(1M)、および rbac(5) のマニュアルページを参照してください。
オブジェクトの状態が不正です
その時点で変更できない、または常時変更できないプロパティー、リソースグループ、またはその他のオブジェクトを変更しようとしました。
リソースのメソッドが失敗しました
リソースのメソッドが失敗しました。次のいずれかの理由のために、メソッドは失敗しました。
validate メソッドは、リソースを作成しようとしたときに、あるいは、リソースのプロパティーを変更しようとしたときに失敗しました。
validate 以外のメソッドは、リソースを有効、無効、または削除しようとしたときに失敗しました。
無効なプロパティーです
–p、–y、または –x オプションで指定したプロパティーまたは値が存在しないか、許可されていません。
内部エラーが発生しました
内部エラーは、ソフトウェアの欠陥またはその他の欠陥を示しています。
I/O エラー
物理的な入出力エラーが発生しました。
そのようなオブジェクトはありません。
次のいずれかの理由のために、指定したオブジェクトを見つけることができません。
オブジェクトが存在しません。
–o オプションで作成しようとした構成ファイルへのパスのディレクトリが存在しません。
–i オプションでアクセスしようとした構成ファイルにエラーが含まれています。
操作が許可されていません
サポートされていない構成に対する操作を実行しようとしたか、サポートされていない操作を実行しました。
オブジェクトはビジーです
アクティブなクラスタノードへの最後のクラスタインターコネクトパスからケーブルを取り外そうとしました。または、参照を削除していないクラスタ構成からノードを削除しようとしました。
オブジェクトは存在します。
指定したデバイス、デバイスグループ、クラスタインターコネクトコンポーネント、ノード、クラスタ、リソース、リソースタイプ、リソースグループ、またはプライベート文字列はすでに存在します。
無効なタイプです
–t または –p オプションで指定したタイプは存在しません。
ノードはクラスタモードです
クラスタモードでブートされているノードで操作を実行しようとしました。しかし、この操作は、非クラスタモードでブートされているノードだけで実行できます。
ノードはクラスタモードではありません
非クラスタモードでブートされているノードで操作を実行しようとしました。しかし、この操作は、クラスタモードでブートされているノードだけで実行できます。
次の属性については、attributes(5) を参照してください。
|