9 DBMCLIユーティリティの使用
Oracle Exadata Database Machineコマンドライン・インタフェース(DBMCLI)ユーティリティは、データベース・サーバーの管理に使用します。スクリプト・ファイルの使用など、SQL*Plusで提供される多数の機能があります。
- DBMCLIユーティリティの概要
DBMCLIユーティリティは、データベース・サーバーの構成およびサーバー環境内のデータベース・サーバーの管理に使用するコマンドライン管理ツールです。 - DBMCLI管理コマンドについて
DBMCLI管理コマンドは、オブジェクトに対して直接機能しません。 - DBMCLIオブジェクト・コマンドについて
DBMCLIには、オブジェクト・コマンド、オブジェクト・タイプおよびオブジェクト属性があります。 - DBMCLIオブジェクト・タイプについて
- DBMCLIのオブジェクト属性
- メトリックを使用したデータベース・サーバーの監視
メトリックを表示することにより、データベース・サーバーを監視できます。 - DBMCLIコマンド・リファレンス
DBMCLIには、管理コマンドとオブジェクト・コマンドの両方があります。
9.1 DBMCLIユーティリティの概要
DBMCLIユーティリティは、データベース・サーバーの構成およびサーバー環境内のデータベース・サーバーの管理に使用するコマンドライン管理ツールです。
DBMCLIをそれぞれのサーバーで実行すると、個別のデータベース・サーバーを構成できます。DBMCLIを使用して、サーバーの開始および停止、サーバー構成情報の管理、およびサーバーの有効化または無効化が可能です。このコマンドライン・ユーティリティは、Exadata Database Machineの出荷時にインストール済です。
- DBMCLIの起動
- DBMCLIのコマンド構文とオプションの理解
このトピックでは、DBMCLIの構文およびコマンド・オプションについて説明します。 - 予約語
- DBMCLIのコマンド・ライン編集
- DBMCLIの入力および出力オプション
- DBMCLIスクリプトのコメント
- DBMCLIコマンドの行継続文字
親トピック: DBMCLIユーティリティの使用
9.1.1 DBMCLIの起動
DBMCLIは、管理するデータベース・サーバーでオペレーティング・システムのコマンドラインから起動できますが、ネットワーク接続されたクライアントからSecure Shell (SSH)を使用してリモートで起動することもできます。コマンドライン構文は次のとおりです。
dbmcli [port_number] [-n] [-m] [-xml] [-v | -vv | -vvv] [-x] [-e command]
port_number引数では、データベース・サーバーのHTTPポート番号を指定します。port_number引数を省略した場合は、データベース・サーバーのcellinit.ora
ファイルのHTTP_PORT
変数に割り当てられた値がDBMCLIユーティリティで使用されます。ファイルは、/opt/oracle/dbserver/dbms/deploy/config/
ディレクトリにあります。cellinit.ora
ファイルにHTTP_PORT
変数が設定されていない場合、ポート番号はデフォルトで8888
に設定されます。
次の表に、DBMCLIコマンドで使用できるオプションを示します。
オプション | 説明 |
---|---|
|
DBMCLIユーティリティを非対話型モードで実行します。このオプションでは、コマンド・プロンプトが非表示になり、コマンドライン編集機能が無効になります。 |
|
DBMCLIを監視モード(読取り専用)で実行します。 |
|
出力をOracle Enterprise Manager用のXML形式で表示します。 |
|
ログ・レベルを設定します。 |
|
バナーを抑止します。 |
|
指定されたDBMCLIコマンドを実行します。DBMCLIはコマンドの実行後に終了します。次に例を示します。
|
DBMCLIでは、データベース・サーバーのオペレーティング・システム認証を使用します。DBMCLIには、ログイン・パラメータや接続コマンドはありません。DBMCLIが起動されるディレクトリは、DBMCLIのSPOOL
およびSTART
コマンドでのファイル・アクセスに制限がないデフォルト・ディレクトリです。
親トピック: DBMCLIユーティリティの概要
9.1.2 DBMCLIのコマンド構文およびオプションの理解
このトピックでは、DBMCLIの構文およびコマンド・オプションについて説明します。
DBMCLIの構文は次のとおりです。
{admin-command | object-command object} [options] ;
この構文では、次の引数が使用されます。
-
admin-commandは管理アクションです。
-
object-commandは、オブジェクトで実行されるアクションです。
-
objectは、コマンドでアクションを実行するオブジェクトまたはターゲットです。
-
optionsは、コマンドの追加パラメータを使用できるようにコマンドの組合せの使用範囲を拡大します。
DBMCLIユーティリティを使用する場合は、次のルールが適用されます。
-
コマンド、オブジェクトおよびオプションは、
LIKE
演算子のフィルタ文字列で使用される文字列パターンなど、明示的に指定されている場合を除き、大/小文字は区別されません。 -
空白または記号を含むオブジェクトの名前は、一重引用符または二重引用符で囲みます。引用符を使用する場合は、開始と終了の引用符を同じにします。たとえば、
"this is incorrect'
は、最初の引用符が二重引用符で2番目の引用符が一重引用符のため正しくありません。 -
現在のローカル・セルには、すべてのDBMCLIコマンドが適用されます。
-
DBMCLIコマンドの最後のセミコロン(;)は省略可能です。
-
長いコマンドで次の行にまたがる場合は、行の最後でハイフン(-)を使用します。ハイフンを名前に使用する場合や負の値を示すために使用する場合は、そのハイフンの直後を英数字値にする必要があります。
親トピック: DBMCLIユーティリティの概要
9.1.3 予約語
ALERTDEFINITION ALERTHISTORY ALL ALTER BMC CONFIGUREBMC CREATE DESCRIBE DETAIL DROP FORCE LED LIST LUN MAIL MEMORY METRICDEFINITION METRICCURRENT METRICHISTORY MS NULL OFF ON PHYSICALDISK RESTART RS SHUTDOWN SNMP STARTUP THRESHOLD VALIDATE
これらのキーワードをコマンドの値として使用する場合は、引用符で囲む必要があります。
親トピック: DBMCLIユーティリティの概要
9.1.4 DBMCLIのコマンド・ライン編集
DBMCLIユーティリティでは、コマンドラインの履歴および編集をサポートしています。この機能は、BSD editlineおよびGNU readline機能に似ています。DBMCLIのコマンド編集機能のほとんどは、bash
やtcsh
などの最新のシェルに似ています。
親トピック: DBMCLIユーティリティの概要
9.1.5 DBMCLIの入力および出力オプション
データベースのコマンドライン・ユーティリティでは、標準入力からコマンドを読み取り、標準出力に出力を書き込みます。ホスト・オペレーティング・システムのオプションを使用すると、入力および出力をリダイレクトしてコマンド・スクリプトを構成および処理できます。たとえば、次のリダイレクションを実行できます。
$ dbmcli <command-script-in
>results-out
この例では、command-script-in
ファイルのDBMCLIコマンドからの出力がresults-out
ファイルに書き込まれます。
親トピック: DBMCLIユーティリティの概要
9.1.6 DBMCLIスクリプトのコメント
複数の書式を使用して1行コメントをDBMCLIスクリプトに追加できます。コメント行を開始するには、先頭にREMARK,REM
または--
(ハイフン2つ)を付けます。
たとえば、次の行はコメントとして有効な構文です。
REMARK This is a comment REM This is a comment -- This is a comment
親トピック: DBMCLIユーティリティの概要
9.1.7 DBMCLIコマンドの行継続文字
コマンドが長く次の行にまたがる場合は、行の最後にハイフン(-)を挿入します。次に、[Enter]を押してコマンド入力を続行します。
次に例を示します。
DBMCLI> LIST dbserver WHERE name LIKE '*.dbm04' - attributes name, status, comment
親トピック: DBMCLIユーティリティの概要
9.2 DBMCLIの管理コマンドについて
DBMCLI管理コマンドでは、オブジェクトに対して直接アクションが実行されることはありません。
DBMCLIでは、次の管理コマンドを使用します。
ノート:
データベース・サーバーですべてのサービスを実行するには、dbmadmin
ユーザーを使用する必要があります。dbmmonitor
ユーザーは監視用です。dbmmonitor
ユーザーは、次のコマンドを実行できます。
-
DESCRIBE
-
EXIT
-
HELP
-
LIST
-
REMARK
-
SET
-
START
親トピック: DBMCLIユーティリティの使用
9.3 DBMCLIのオブジェクト・コマンドについて
DBMCLIには、オブジェクト・コマンド、オブジェクト・タイプおよびオブジェクト属性があります。
Oracle Databaseのオブジェクトで動作するDBMCLIコマンドは次のとおりです。
関連トピック
親トピック: DBMCLIユーティリティの使用
9.4 DBMCLIオブジェクト・タイプについて
次に示すOracle Exadata System Softwareオブジェクト・タイプは、DBMCLIオブジェクト・コマンドで使用できます。
-
ALERTDEFINITION
— アラート定義では、データベース・サーバーで生成可能なすべてのアラートの定義が提供されます。アラートはメトリックおよびその他のアラートのソースで定義されます。 -
ALERTHISTORY
— アラート履歴では、データベース・サーバーで発生したアラートのリストが提供されます。 -
DBSERVER
— 現行のデータベース・サーバーまたはローカル・データベース・サーバー。 -
DBSERVER
— diagpackは$LOG_HOME
の圧縮ファイルを表し、ログ・ファイルおよびトレース・ファイルを含みます。 -
IBPORT
— データベース・サーバーに対するInfiniBandネットワーク・ファブリック・ポート。ノート:
このコマンドは、RoCEネットワーク・ファブリックを使用するExadata Database Machineサーバーでは機能しません。 -
LUN
— 論理ユニット番号(LUN)は、物理ディスク・デバイスのRAIDセットに対するアドレスです。LUNは、サーバーの起動時に自動的に検出されます。LUNは、ディスクを最初に作成した際、またはシステムの再起動後にディスクが検出された際に、対応するディスクに割り当てられます。ディスクに未割当てのLUNは、NULL
値です。 -
METRICCURRENT
— 現在のメトリックは、各メトリックの現在値の観測データのセットです。 -
METRICDEFINITION
— メトリック定義は、メトリックの構成です。 -
METRICHISTORY
— メトリック履歴は、すべてのメトリック値の過去の各観測データを収集したものです。 -
PHYSICALDISK
— ディスクは、サーバー上の物理ディスクと呼ばれます。 -
PRIVILEGE
— ロールに割り当てられた権利または権限。 -
ROLE
— 関連する権限の名前付きグループ。 -
SOFTWAREHISTORY
— ソフトウェア履歴は、過去のソフトウェア更新の最終ステータスのリストです。 -
SOFTWAREUPDATE
— ソフトウェア更新をスケジュールするためのソフトウェアの場所と時間パラメータを含むオブジェクト -
THRESHOLD
— しきい値は、特定のメトリックに基づいてステートフル・アラートを生成するためのルールです。このルールでは、境界値(しきい値)が設定され、メトリック値がこれらの境界値を超えた場合にアラートが生成されるまでの時間が設定されます。 -
USER
— DBMCLIを使用してコンピュート・ノードを管理できるアカウントです。
コマンド・オブジェクトには、組み合せることができないものがあります。コマンド・オブジェクトの有効な組合せについては、それぞれのオブジェクト・コマンドの構文を確認してください。
親トピック: DBMCLIユーティリティの使用
9.5 DBMCLIのオブジェクト属性
DBMCLIの各オブジェクトには、オブジェクトの作成時または変更時に割り当てられる属性のセットがあります。属性フィルタおよびリストは、LIST
コマンドの出力に表示される属性およびオブジェクトの指定に使用されます。
属性はすべて表示できますが、ユーザー側で直接変更できるのは一部の属性のみです。属性のリストを表示して、変更可能な属性を確認するには、DESCRIBE
コマンドを使用します。
- 共通の属性値の制限
複数のDBMCLIオブジェクトに使用する属性値について、次の制限事項を確認してください。 - LISTコマンドの属性リスト
- LISTおよびALTERコマンドでの属性フィルタ
attribute_filters句を使用して、LIST
コマンドで表示するオブジェクトを指定できます。一部のALTER
コマンドでも、attribute_filters句がサポートされています。
親トピック: DBMCLIユーティリティの使用
9.5.1 共通の属性値の制限
複数のDBMCLIオブジェクトに使用する属性値について、次の制限事項を確認してください。
-
name
属性の値は256文字未満にし、次のASCII文字のみで構成する必要があります。- 小文字の英字(
a
からz
) - 大文字の英字(
A
からZ
) - 数字(
0
から9
) - アンダースコア(
_
) - ハイフン(
-
)ノート:
Oracle Exadata System Softwareリリース19.2.0以前では、文字列を二重引用符で囲む必要があります。たとえば:"hyphenated-string"
- 小文字の英字(
-
comment
属性の値は256文字未満にする必要があります。
属性値の追加の制限については、DBMCLIの各コマンドの構文を参照してください。
親トピック: DBMCLIのオブジェクト属性
9.5.2 LISTコマンドの属性リスト
LIST
コマンドで表示する属性は、次のオプション句で指定できます。
ATTRIBUTES { ALL |attribute1
[,attribute2
] ... }
ALL
を指定すると、LIST
オブジェクトで組合せ可能なすべてのオブジェクト属性が表示されます。
親トピック: DBMCLIのオブジェクト属性
9.5.3 LISTおよびALTERコマンドでの属性フィルタ
attribute_filters句を使用して、LIST
コマンドで表示するオブジェクトを指定できます。一部のALTER
コマンドでも、attribute_filters句がサポートされています。
attribute_filters句の構文は次のとおりです。
WHERE attribute_filter1 [ AND attribute_filter2 ... ]
各attribute_filterNの構文は、次のとおりです。
attribute [ NOT | ! ] operator comparison_value
attributeプレースホルダは、フィルタ処理に使用される属性の名前を表します。次の表に、サポートされている演算子のタイプを示します。これらの演算子は、NOT
または!
と組合せ可能です。
表9-1 属性フィルタでサポートされる演算子
演算子 | 説明 |
---|---|
|
文字列、ステータスまたは数値の属性間の等号をテストします。次に例を示します。 status NOT = normal |
|
数値属性より大きい値かどうかをテストします。次に例を示します。 size > 139920M |
|
数値属性より小さい値かどうかをテストします。次に例を示します。 freeSpace !< 100M |
|
大/小文字を区別する一致を使用して、正規表現が文字列属性に一致するかどうかをテストします。次に例を示します。 LIKE 'GD_IO_RQ.*' |
サポートされる演算子で使用される場合、comparison_valueは次のデータ型のいずれかです。
- 数値
- リテラル:
active
やnormal
などの値 - 日時:
ALERTHISTORY
でのみサポートされる時間値 - 文字列: 一重引用符(
''
)または二重引用符(" "
)で区切られる値 NULL
: 未割当ての文字列または空のリスト
親トピック: DBMCLIのオブジェクト属性
9.6 メトリックを使用したデータベース・サーバーの監視
メトリックを表示することにより、データベース・サーバーを監視できます。
メトリックには次のタイプがあります。
- cumulative: メトリックが作成されてからの統計。
- instantaneous: メトリックが収集される時点の値。
- rate: 特定の時間の統計を平均して計算される値。
- メトリックについて
Exadataメトリックは、Exadataシステム・ソフトウェアに関連する重要なプロパティまたは値の観測データを記録したものです。 - メトリックの表示
DBMCLIのLIST
コマンドを使用すると、データベース・オブジェクトのメトリックを表示および監視できます。 - データベース・サーバーのメトリック
データベース・サーバーのメトリックでは、CPU使用率、メモリー、ネットワーク・インターコネクトなど、サーバーに関する情報が提供されます。 - リアルタイム・インサイト
リアルタイム・インサイト機能を使用すると、Exadataシステムをリアルタイムで監視できます。 - リアルタイム・インサイトの使用
リアルタイム・インサイト機能を使用すると、外部のメトリック収集プラットフォームを使用してExadataシステムをリアルタイムで監視できます。
親トピック: DBMCLIユーティリティの使用
9.6.1 メトリックについて
Exadataメトリックは、Exadataシステム・ソフトウェアに関連する重要なプロパティまたは値の観測データを記録したものです。
Exadataメトリックには、ほとんどのExadataコンポーネントの詳細な統計が含まれます。
メトリックには次のタイプがあります。
-
累積メトリックは、メトリックが作成されてから、またはサーバーが再起動されてから一定期間累積される統計です。
-
即時メトリックには、メトリックの観測時点の現在の値が含まれます。
-
率メトリックは、値を経時的に観測する、計算された統計です。
デフォルトでは、メトリック収集は1分間隔で実行されます。ただし、Oracle Exadata System Software 22.1.0以降では、オプションでファイングレイン・メトリックを構成できます。ファイングレイン・メトリックを有効にするには、1から60秒までの収集間隔を指定する必要があります。ファイングレイン収集に含めるメトリックを選択することもできます。
ファイングレイン・メトリック収集は、リアルタイム・メトリック・ストリーミングの基盤です。そのため、ファイングレイン・メトリックは、外部収集へのストリーミングをサポートするためにメモリーにのみ記録されます。通常の(ファイングレインでない)メトリックは、最初にメモリーに記録され、後でディスクベースのリポジトリに書き込まれます。デフォルトでは、通常のメトリックについては、7日間のメトリック履歴が保持されます。
親トピック: メトリックを使用したデータベース・サーバーの監視
9.6.2 メトリックの表示
LIST
コマンドを使用すると、データベース・オブジェクトのメトリックを表示および監視できます。 LIST
コマンドを使用して、メトリック定義、現在のメトリック、およびメトリック履歴を表示できます。
- メトリックの特定の属性の表示
特定の属性を出力に表示するには、ATTRIBUTES
キーワードを使用します。 - メトリックの定義の表示
データベース・サーバーのメトリック定義を表示するには、LIST METRICDEFINITION
コマンドを使用します。 - 現在のメトリックの表示
データベース・サーバーの現行のメトリック値を表示するには、LIST METRICCURRENT
コマンドを使用します。 - メトリック履歴の表示
データベース・サーバーのメトリック履歴を表示するには、LIST METRICHISTORY
コマンドを使用します。
親トピック: メトリックを使用したデータベース・サーバーの監視
9.6.2.1 メトリックの特定の属性の表示
特定の属性を出力に表示するには、ATTRIBUTES
キーワードを使用します。
この例は、name
属性、metrictype
属性およびalertState
属性を指定したLIST METRICHISTORY
コマンドを示しています。この出力は、1時間の間隔に制限されています。コマンドに続けて、出力の一部を示します。
LIST METRICHISTORY ATTRIBUTES name, metrictype, alertState -
WHERE collectionTime > '2019-07-12T13:00:00-05:00' -
AND collectionTime < '2019-07-12T14:00:00-05:00'
DS_TEMP Instantaneous normal
DS_FANS Instantaneous normal
DS_BBU_CHARGE Instantaneous normal
DS_BBU_TEMP Instantaneous normal
DS_CPUT Instantaneous normal
DS_CPUT_MS Instantaneous normal
DS_FSUT Instantaneous normal
DS_FSUT Instantaneous normal
DS_FSUT Instantaneous normal
DS_MEMUT Instantaneous normal
DS_MEMUT_MS Instantaneous normal
DS_RUNQ Instantaneous normal
DS_SWAP_IN_BY_SEC Instantaneous normal
DS_SWAP_OUT_BY_SEC Instantaneous normal
DS_SWAP_USAGE Instantaneous normal
DS_VIRTMEM_MS Instantaneous normal
N_HCA_MB_RCV_SEC Rate normal
N_HCA_MB_TRANS_SEC Rate normal
N_IB_MB_RCV_SEC Rate normal
N_IB_MB_RCV_SEC Rate normal
N_IB_MB_RCV_SEC Rate normal
...
親トピック: メトリックの表示
9.6.2.2 メトリック定義の表示
データベース・サーバーのメトリック定義を表示するには、LIST METRICDEFINITION
コマンドを使用します。
メトリック定義のリストには、メトリックの構成が表示されます。例9-1は、METRICDEFINITION
オブジェクトの属性を表示する方法を示しています。
例9-1 メトリック定義の表示
DBMCLI> LIST METRICDEFINITION DS_CPUT DETAIL
DBMCLI> LIST METRICDEFINITION WHERE name LIKE 'DS_SWAP_*' -
ATTRIBUTES name, metricType, description
親トピック: メトリックの表示
9.6.2.3 現在のメトリックの表示
データベース・サーバーの現行のメトリック値を表示するには、LIST METRICCURRENT
コマンドを使用します。
現在のメトリックのリストには、各メトリックの現在値の観測データのセットが表示されます。例9-2は、METRICCURRENT
オブジェクトの属性を表示する方法を示しています。
例9-2 現在のメトリック値の表示
DBMCLI> LIST METRICCURRENT DS_FANS DETAIL
DBMCLI> LIST METRICCURRENT WHERE objectType = 'DBSERVER' AND -
metricValue != 0 ATTRIBUTES name, metricObjectName, -
metricValue, collectionTime
親トピック: メトリックの表示
9.6.2.4 メトリック履歴の表示
データベース・サーバーのメトリック履歴を表示するには、LIST METRICHISTORY
コマンドを使用します。
メトリック履歴のリストは、すべてのメトリック値の過去の各観測データを収集したものです。例9-3は、METRICHISTORY
オブジェクトの属性を表示する方法を示しています。
メトリック履歴ファイルの保存期間は、metricHistoryDays
属性で指定されます。この設定は、DBMCLIのALTER DBSERVER
コマンドで変更できます。
例9-3 メトリック履歴の値の表示
DBMCLI> LIST METRICHISTORY DS_TEMP WHERE alertState='critical' DETAIL
DBMCLI> LIST METRICHISTORY WHERE objectType = 'DBSERVER' AND metricValue != 0 -
AND collectionTime > '2014-08-12T09:10:51-07:00' -ATTRIBUTES name, -
metricObjectName, metricValue, collectionTime
関連トピック
親トピック: メトリックの表示
9.6.3 データベース・サーバーのメトリック
データベース・サーバーのメトリックでは、CPU使用率、メモリー、ネットワーク・インターコネクトなど、サーバーに関する情報が提供されます。
セル・ディスクのメトリックを表示するには、METRICCURRENT
オブジェクト、METRICDEFINITION
オブジェクトおよびMETRICHISTORY
オブジェクトでDBSERVER
と同等のオブジェクト・タイプ属性を使用します。例9-4は、データベース・サーバー・メトリックを表示する方法を示しています。
次のリストは、データベース・サーバー・メトリックのメトリック名および説明を示しています。メトリックを表示するデータベース・サーバーは、METRICCURRENT
オブジェクトおよびMETRICHISTORY
オブジェクトのmetricObjectName
属性で指定されます。
-
DS_BBU_CHARGE
: ディスク・コントローラのバッテリの充電。 -
DS_BBU_TEMP
: ディスク・コントローラのバッテリの温度。 -
DS_CPUT
: サーバーのCPU使用率(システムCPUがアイドル状態でなくなる直前の1分間のCPU使用率(/proc/stat
で取得))。 -
DS_CPUT_MS
: MSが使用しているCPU時間の割合(%)。 -
DS_FANS
: サーバーで動作中のファンの回転数。 -
DS_FSUT
: 現在使用中のファイル・システムで使用されている合計領域の割合。このメトリックは、サーバーの様々なファイル・システムの領域使用率を示します。 -
DS_MEMUT
: サーバーにおける合計の物理メモリー使用率。 -
DS_MEMUT_MS
: MSが使用している物理メモリーの割合(%)。 -
DS_RUNQ
: running (実行中)またはuninterruptible (無停止)とマークされるLinuxの実行キューの(直前の1分間の)プロセスの平均数(/proc/loadavg
で取得)。 -
DS_SWAP_IN_BY_SEC
: 1秒当たりの読み取られたスワップ・ぺージのKB数。 -
DS_SWAP_OUT_BY_SEC
: 1秒当たりの書き込まれたスワップ・ぺージのKB数。 -
DS_SWAP_USAGE
: 使用済のスワップ領域の割合(%)。 -
DS_TEMP
: ベースボード管理コントローラ(BMC)で提供されるサーバーの瞬間温度(摂氏)。 -
DS_VIRTMEM_MS
: MSが使用している仮想メモリー量(MB)。 -
N_NIC_KB_RCV_SEC
: イーサネット・インタフェースが1秒当たりに受信したKB数。 -
N_NIC_KB_TRANS_SEC
: イーサネット・インタフェースが1秒当たりに送信したKB数 - InfiniBandネットワーク・ファブリック・メトリック(RoCEネットワーク・ファブリックを使用するExadata Database Machineサーバーには適用されない)。:
N_HCA_MB_RCV_SEC
: InfiniBandインタフェースが1秒当たりに受信したMB数。N_HCA_MB_TRANS_SEC
: InfiniBandインタフェースが1秒当たりに送信したMB数。N_IB_MB_RCV_SEC
: InfiniBandポートが1秒当たりに受信したMB数。N_IB_MB_TRANS_SEC
: InfiniBandポートが1秒当たりに送信したMB数。N_IB_UTIL_RCV
: データ受信で使用されるInfiniBandポート容量のパーセンテージ。N_IB_UTIL_TRANS
: データ送信で使用されるInfiniBandポート容量のパーセンテージ。
例9-4 データベース・サーバーのメトリックの表示
CellCLI> LIST METRICCURRENT DS_CPUT DETAIL
name: DS_CPUT
alertState: normal
collectionTime: 2014-12-17T15:54:25-08:00
metricObjectName: abcd2x3
metricType: Instantaneous
metricValue: 6.7 %
objectType: DBSERVER
親トピック: メトリックを使用したデータベース・サーバーの監視
9.6.4 リアルタイム・インサイト
リアルタイム・インサイト機能を使用すると、Exadataシステムをリアルタイムで監視できます。
Oracle Exadata System Software 22.1.0以降では、リアルタイム・インサイトにより、インフラストラクチャで次のことが可能になります。
-
特定のメトリックをファイングレインとして分類し、ファイングレイン・メトリックを毎秒収集できます。
-
プッシュ(アップロード)またはプル(ダウンロード)伝送モデルを使用して、ユーザーが定義した場所にリアルタイムでファイングレイン・メトリック観測データをストリーミングします。
関連トピック
親トピック: メトリックを使用したデータベース・サーバーの監視
9.6.5 リアルタイム・インサイトの使用
リアルタイム・インサイト機能を使用すると、外部のメトリック収集プラットフォームを使用してExadataシステムをリアルタイムで監視できます。
- ファイングレイン・メトリックの使用
- 収集プラットフォームへのメトリック観測データのアップロード
- Exadataサーバーからのメトリック観測データのダウンロード
- メトリック観測データのタグ付け
- メトリック・ストリーム形式の理解
親トピック: メトリックを使用したデータベース・サーバーの監視
9.6.5.1 ファイングレイン・メトリックの使用
従来、Exadataメトリックの収集は1分間隔で実行されていました。しかしながら、リアルタイム監視には、よりタイムリーなメトリックが必要です。Oracle Exadata System Software 22.1.0以降では、ファイングレイン・メトリック収集を構成できます。
ファイングレイン・メトリック収集は、リアルタイム・インサイトの基盤です。ファイングレイン・メトリック収集は、外部のメトリック収集プラットフォームと連携して機能します。このプラットフォームで、ファイングレイン・メトリック観測データが収集され、可視化のために処理されます。ファイングレイン・メトリック観測データは、サーバー・メモリーにのみ存在し、サーバー上には保持されません。そのため、ファイングレイン・メトリックの履歴は各サーバー上に保持されません。
9.6.5.1.1 ファイングレイン・メトリック収集の制御
metricFGCollIntvlInSec
属性により、ファイングレイン・メトリック収集を制御します。
-
ファイングレイン・メトリック収集を有効にするには、収集間隔を1から60秒までの値に設定する必要があります。
次に例を示します。
DBMCLI> ALTER DBSERVER metricFGCollIntvlInSec=1
ファイングレイン・メトリック収集の収集間隔は、
metricStreamIntvlInSec
属性で指定された自動アップロード頻度に関連しています。自動アップロードが有効になっている場合、metricStreamIntvlInSec
をmetricFGCollIntvlInSec
の5倍から30倍にする必要があり、metricFGCollIntvlInSec
を変更する際にはこの関係を順守する必要があります。たとえば、metricStreamIntvlInSec
が60に設定されている場合、metricFGCollIntvlInSec
は2から12までである必要があります。 -
サーバーでファイングレイン・メトリック収集を無効にするには、
metricFGCollIntvlInSec=0
に設定します。次に例を示します。
DBMCLI> ALTER DBSERVER metricFGCollIntvlInSec=0
metricStreamIntvlInSec
属性を使用して自動メトリック・アップロードを有効にしてある場合は、ファイングレイン・メトリック収集を無効にできません。
親トピック: ファイングレイン・メトリックの使用
9.6.5.1.2 ファイングレイン・メトリック収集のカスタマイズ
デフォルトで、ファイングレイン収集に対して自動的に一連のキー・パフォーマンス・メトリックが有効になります。ただし、特定のメトリックを有効または無効にすることで、ファイングレイン・メトリック収集をカスタマイズできます。
-
メトリックのファイングレイン収集を有効にするには、
ALTER METRICDEFINITION
コマンドを使用してfinegrained=enabled
を指定します。次に例を示します。DBMCLI> ALTER METRICDEFINITION N_NIC_KB_TRANS_SEC finegrained=enabled
DBMCLI> ALTER METRICDEFINITION N_MB_SENT,N_MB_RECEIVED finegrained=enabled
DBMCLI> ALTER METRICDEFINITION finegrained=enabled WHERE name LIKE 'N_NIC.*'
-
メトリックのファイングレイン収集を無効にするには、
ALTER METRICDEFINITION
コマンドを使用してfinegrained=disabled
を指定します。次に例を示します。DBMCLI> ALTER METRICDEFINITION N_MB_SENT finegrained=disabled
-
ファイングレイン収集が有効になっているメトリックを表示するには、次のコマンドを使用します。これはいつでも実行できます。
DBMCLI> LIST METRICDEFINITION WHERE finegrained=enabled
-
各メトリックの説明や、そのメトリックのファイングレイン収集が有効になっているかどうかなど、メトリック定義の詳細をすべて表示するには、次のコマンドを使用します。これはいつでも実行できます。
DBMCLI> LIST METRICDEFINITION DETAIL
親トピック: ファイングレイン・メトリックの使用
9.6.5.2 収集プラットフォームへのメトリック観測データのアップロード
Exadataサーバーによってファイングレイン・メトリック観測データが外部のメトリック収集プラットフォームに自動的にアップロード(プッシュ)されるようにすることができます。
9.6.5.2.1 自動メトリック・アップロードの制御
metricStreamIntvlInSec
属性により、metricStreamEndPoint
属性で指定されたメトリック・ストリーミング・エンドポイントへの自動アップロードのアップロード間隔(秒)を設定します。
-
自動アップロードを有効にするには、
metricStreamIntvlInSec
値を、metricFGCollIntvlInSec
属性で指定された収集間隔の5倍から30倍にする必要があります。たとえば、metricFGCollIntvlInSec
が5に設定されている場合、metricStreamIntvlInSec
は25から150までである必要があります。次に例を示します。
DBMCLI> ALTER DBSERVER metricStreamIntvlInSec=25
ファイングレイン・メトリック収集が無効になっている(
metricFGCollIntvlInSec=0
)場合は、自動アップロードを有効にできません。 -
サーバーで自動メトリック・アップロードを無効にするには、
metricStreamIntvlInSec=0
に設定します。次に例を示します。
DBMCLI> ALTER DBSERVER metricStreamIntvlInSec=0
9.6.5.2.2 自動メトリック・アップロードのエンドポイントの構成
metricStreamEndPoint
属性を次のように設定すると、メトリック・ストリームを1つ以上の収集エンドポイントに自動的にアップロード(プッシュ)できます。
metricStreamEndPoint[+]=((host="endpoint-URL"[,type="stream-format"][,token="authentication-token"][,{httpProxy|httpsProxy}="proxy-server"])
[,(host="endpoint-URL"[,type="stream-format"][,token="authentication-token"][,{httpProxy|httpsProxy}="proxy-server"])]...)
metricStreamEndPoint
定義の内容:
-
host
: 収集エンドポイントのURLを指定します。このURLでは、HTTPまたはHTTPSを使用できます。 -
type
: オプションで、ストリームの形式を指定します。サポートされている値は次のとおりです。-
JSON
: ストリームをJSON形式で提供します。 -
plaintext
: ストリームをプレーン・テキスト形式で提供します。
デフォルト値は
json
です。 -
-
token
: オプションで、収集エンドポイントの認証トークンを指定します。トークンの生成の詳細は、メトリック収集プラットフォームを参照してください。 -
httpProxy
またはhttpsProxy
: オプションで、収集エンドポイントへのネットワーク接続を容易にするためのプロキシ・サーバーを指定します。Exadataシステムと収集エンドポイントの間にファイアウォールが存在する場合は、プロキシ・サーバーが必要です。
オプションの+=
演算子を使用すると、収集エンドポイントを既存のmetricStreamEndPoint
定義に追加できます。それ以外の場合は、=
演算子を使用すると前の属性値が上書きされます。
例9-5 JSONストリームの設定
この例では、JSONストリームを設定する方法を示します。この例のコマンドでは、host
およびtoken
の値が収集プラットフォームから取得されます。ネットワーク接続は、指定されたプロキシを介していると想定しています。
DBMCLI> ALTER DBSERVER metricStreamEndPoint=((host="https://ingest.stream.example.com/v2/datapoint",type="json",token="wcfA_**********Z58QpKg",httpProxy="www-proxy.example.com:80"))
例9-6 プレーン・テキスト・エンドポイントの追加
この例では、プレーン・テキスト・エンドポイントを既存のmetricStreamEndPoint
に追加する方法を示します。この例のコマンドでは、host
およびtoken
の値が収集プラットフォームから取得されます。また、ネットワーク・プロキシを必要としない企業ネットワーク内に収集プラットフォームがあると想定しています。
DBMCLI> ALTER DBSERVER metricStreamEndPoint+=((host="http://idbsrv.example.com:8086/api/v2/write?org=Exadata&bucket=Metrics&precision=ns",type="plaintext",token="6unif**********rOXwtfkG0gWGENyePd6uN6OLR_deTZL4IuG9VTfDWwvpB-QvJcCcFs_NVjmpsyANz0Q8psA=="))
9.6.5.3 Exadataサーバーからのメトリック観測データのダウンロード
指定したRESTエンドポイントを使用することでExadataサーバーからメトリック・ストリームをダウンロード(プル)できます。
各ストレージ・サーバーでは、RESTエンドポイントのURLは次のようになります。
https://server-name/metricstream/list?stream=true
各データベース・サーバーでは、エンドポイントによってポート7879が使用されます。そのため、URLは次のようになります。
https://server-name:7879/metricstream/list?stream=true
効率を最大限に高めるには、ダウンロード頻度を、ストレージ・サーバーまたはデータベース・サーバーでmetricFGCollIntvlInSec
属性で指定されている収集間隔と同じにします。
メトリック・ストリームへのアクセスを容易にするために、ストリームへのアクセス権のみを持つ専用ユーザー・アカウントを使用する必要があります。DBMCLIで次のコマンド・シーケンスを使用するとユーザー・アカウントを適切に構成できます。これは後でRESTエンドポイントへの認証に使用できます。このコマンド・シーケンスにおいては、自分のユーザー名とロール名に置き換えます。
CREATE ROLE metric_collector_role
GRANT PRIVILEGE LIST ON METRICSTREAM ALL ATTRIBUTES WITH ALL OPTIONS TO ROLE metric_collector_role
CREATE USER metric_collector PASSWORD=<password>
GRANT ROLE metric_collector_role TO USER metric_collector
親トピック: リアルタイム・インサイトの使用
9.6.5.4 メトリック観測データのタグ付け
各Exadataデータベース・サーバーおよびストレージ・サーバーで、そのサーバーによって生成されるすべてのメトリック観測データに含める、一連のメトリック・タグを定義できます。これらのタグは、多数のExadataサーバーによって生成された観測データを整理およびグループ化するために役立ちます。
メトリック・タグを構成するには、metricStreamTags
属性を、次のような、タグと値のペアを含む有効なJSON文字列に設定します。
metricStreamTags='{"tag1":"value1"[,"tag2":"value2"]...}'
次に例を示します。
DBMCLI> ALTER DBSERVER metricStreamTags='{"application":"personnel","department":"HR"}'
親トピック: リアルタイム・インサイトの使用
9.6.5.5 メトリック・ストリーム形式の理解
リアルタイム・メトリック観測データには、中心的な一連の属性が含まれています。ただし、メトリック・ストリームの形式は、アクセスのモードによって異なります。
メトリック・ストリームをメトリック収集プラットフォームに自動的にアップロードする場合は、メトリック・エンドポイント構成でメトリック・ストリーム形式を指定できます。使用可能な形式は、JSONまたはプレーン・テキストです。
次に、JSON形式の例を示します。
json: {
"gauge": [{
"metric": "OS_NET_RX_BY_SEC",
"value": "0.0012989044189453125",
"timestamp": 1652473286000,
"unit": "MB/sec",
"dimensions": {
"server": "celadm09.example.com",
"objectName": "eth0",
"nodeType": "STORAGE",
"fleet": "example-fleet",
"pod": "dbm01",
"cluster": "c01"
}
}, {
"metric": "SIO_IO_RD_FC_HD_SEC",
"value": "0.0",
"timestamp": 1652473286000,
"unit": "MB/sec",
"dimensions": {
"server": "celadm09.example.com",
"objectName": "SMARTIO",
"nodeType": "STORAGE",
"fleet": "example-fleet",
"pod": "dbm01",
"cluster": "c01"
}
}
]
}
プレーン・テキスト形式には、基本的に、JSONストリームと同じ情報が含まれています。ただし、プレーン・テキスト形式では、各メトリック観測データが別々の行で示されます。次に、プレーン・テキスト形式の例を示します。
metrics,name=OS_NET_RX_BY_SEC,objectName=eth0,server=celadm09.example.com,unit=MB/sec,nodeType=STORAGE,fleet=example-fleet,pod=dbm01,cluster=c01 value=9.441184615324398E-4 1652473456000000000
metrics,name=OS_NET_RX_BY_SEC,objectName=eth0,server=celadm09.example.com,unit=MB/sec,nodeType=STORAGE,fleet=example-fleet,pod=dbm01,cluster=c01 value=0.002647613311980988 1652473457000000000
指定したRESTエンドポイントを使用することでメトリック・ストリームをダウンロードする場合、データはプレーン・テキスト・アップロード形式に似た形式で示され、各メトリック観測データが別々の行で示されます。次に、ダウンロード形式の例を示します。
DS_CPUT{objectName="dbadm05",unit="%",server="dbadm05.example.com",nodeType="KVMHOST",fleet="example-fleet",pod="dbm01",cluster="c01"} 23.10906363831155 1652485449597
DS_MEMUT{objectName="dbadm05",unit="%",server="dbadm05.example.com",nodeType="KVMHOST",fleet="example-fleet",pod="dbm01",cluster="c01"} 99 1652485449597
DS_MEMUT_MS{objectName="dbadm05",unit="%",server="dbadm05.example.com",nodeType="KVMHOST",fleet="example-fleet",pod="dbm01",cluster="c01"} 0.12396045794483294 1652485449597
次のリストでは、メトリック・ストリームに含まれる属性を説明します。
-
メトリック名は、次のように特定します。
-
JSONアップロード形式では、メトリック名は
metric
タグの後に続きます。 -
プレーン・テキスト・アップロード形式では、メトリック名は、
name=
の後に続く値です。 -
ダウンロード形式では、メトリック名は、各行の最初の要素であり、左中カッコ(
{
)の前にあります。
-
-
メトリック値は、次のように見つけます。
-
JSONアップロード形式では、メトリック値は
value
タグの後に続きます。 -
プレーン・テキスト・アップロード形式では、メトリック値は
value=
の後に続きます。 -
ダウンロード形式では、メトリック値は、各行の最後から2番目の要素であり、右中カッコ(
}
)の後に続きます。
-
-
メトリック観測の時間は、次のように見つけます。
-
JSONアップロード形式では、タイムスタンプは
timestamp
タグの後に続きます。タイムスタンプは、1970年1月1日のグリニッジ標準時(GMT) 00:00:00からのミリ秒数(1 x 10-3秒)で表されます。 -
プレーン・テキスト・アップロード形式では、タイムスタンプは各行の最後の要素です。タイムスタンプは、1970年1月1日のグリニッジ標準時(GMT) 00:00:00からのナノ秒数(1 x 10-9秒)で表されます。
-
ダウンロード形式では、タイムスタンプは各行の最後の要素です。タイムスタンプは、1970年1月1日のグリニッジ標準時(GMT) 00:00:00からのミリ秒数(1 x 10-3秒)で表されます。
-
-
unit
値では、メトリック観測の測定単位が示されています。 -
server
値には、メトリック観測データを生成したExadataサーバーの名前が含まれています。 -
objectName
値には、メトリックに関連付けられているExadataオブジェクトの名前が含まれています。 -
nodeType
値には、メトリック観測データを生成したExadataサーバーのタイプが含まれています。 -
fleet
、pod
およびcluster
属性は、ユーザーが定義したメトリック・タグの例であり、多数のExadataサーバーによって生成された観測データを整理およびグループ化するために使用できます。メトリックにタグ付けするには、metricStreamTags
のDBSERVER属性を設定します。
関連トピック
親トピック: リアルタイム・インサイトの使用
9.7 DBMCLIコマンド・リファレンス
DBMCLIには、管理コマンドとオブジェクト・コマンドの両方があります。
DBMCLIユーティリティには次のコマンドがあります。
9.7.1 ALTER
用途
ALTER
コマンドは、単一のオブジェクトまたは複数のオブジェクトでアクションを実行したり、それらのオブジェクトの属性を変更したりします。ALTER
コマンドは、オブジェクトに対して属性を変更したり、アクションを実行するために使用できます。
構文
ALTER { object_type object_name[, object_name]... operation
| attribute_name = attribute_value
[, attribute_name = attribute_value]...
}
使用上のノート
このコマンドでは、次の引数を使用できます。
- object_typeは次のとおりです。
ALERTHISTORY
DBSERVER
IBPORT
(ユーザー・ドメイン(domU)環境では使用できません)THRESHOLD
(ユーザー・ドメイン(domU)環境では使用できません)USER
(ユーザー・ドメイン(domU)環境では使用できません)
- object_nameは、アラート履歴、データベース・サーバー、LUNまたはしきい値の名前であるか、識別子です。
- operationは、指定したobject_typeの有効なアクションです。
複数のオブジェクトがALTER
コマンドのターゲットである場合は、正常に実行されない場合があります。エラーが発生するとコマンドが中断され、残りのオブジェクトは変更されません。
- ALTER ALERTHISTORY
- ALTER DBSERVER
ALTER DBSERVER
コマンドは、データベース・サーバーの属性を変更します。 - ALTER IBPORT
- ALTER METRICDEFINITION
- ALTER SOFTWAREUPDATE
Oracle Exadata System Softwareリリース19.3.0以降では、SoftwareUpdate
属性を設定することで、データベース・サーバーのソフトウェア更新をスケジュールできます。 - ALTER THRESHOLD
- ALTER USER
関連トピック
親トピック: DBMCLIコマンド・リファレンス
9.7.1.1 ALTER ALERTHISTORY
用途
ALTER ALERTHISTORY
コマンドは、すべてのアラート履歴または指定したアラート履歴の属性を変更します。
構文
ALTER ALERTHISTORY { ALL |alertid1 [,alertid2 ...]
} examinedBy=user_name
使用上のノート
このコマンドでは、次の引数を使用できます。
-
alertidn
: 変更するアラートの識別子です。 -
user_name
: アラートを確認したユーザーの名前です。
例
例9-7は、examinedBy
属性を更新するためにALERTHISTORY
オブジェクトで使用したALTER
コマンドを示しています。examinedBy
属性は、変更可能な唯一のALERTHISTORY
属性です。
例9-7 ALERTHISTORY属性の変更
DBMCLI> ALTER ALERTHISTORY 1671443714 - examinedBy="jdoe" DBMCLI> ALTER ALERTHISTORY ALL examinedBy="jdoe"
親トピック: ALTER
9.7.1.2 ALTER DBSERVER
ALTER DBSERVER
kコマンドは、データベース・サーバーの属性を変更します。
構文
ALTER DBSERVER {
| SHUTDOWN SERVICES { RS | MS | ALL }
| RESTART SERVICES { RS | MS | ALL }
| RESTART BMC
| STARTUP SERVICES { RS | MS | ALL }
| LED { ON | OFF }
| VALIDATE { MAIL | SNMP | CONFIGURATION }
| VALIDATE SYSLOGCONF facility.priority
| CONFIGUREBMC
| { snmpuser=((user_clause)[,(user_clause)[,..]]) | snmpuser.name=(user_clause) }
| attribute_name = attribute_value
[, attribute_name = attribute_value]...
}
使用上のノート
次の表は、ALTER DBSERVER
コマンドの引数およびオプションを示しています。
引数 | オプション | 説明 |
---|---|---|
|
|
MSサービスが停止します。 RSサービスが停止します。
|
|
|
MSサービスが停止し、それから開始します。 RSサービスが停止し、それから開始します。
|
|
なし |
ベースボード管理コントローラ(BMC)を再起動します。 |
|
|
MSサービスが開始します。 RSサービスが開始します。
|
|
|
データベース・サーバーでメンテナンスが必要になった場合にLEDを点灯するように手動で設定できます。コンポーネントに障害が発生した場合にLEDが自動的に点灯するように設定することもできます。 |
|
|
|
|
|
|
|
なし |
管理サーバーでアラートを検出できるように、ローカル・データベース・サーバーにハードウェア・アラートを設定するようBMCを構成します。 |
|
user_clause |
SNMPアラートを受信するユーザーを定義します。すべてのSNMPユーザーについてのuser clausesのリストを指定することも、属性
単一のユーザーを更新する場合は、user_clauseにフレーズ |
属性 |
該当なし |
|
ノート:
ユーザー・ドメイン(domU)環境では、次のコマンドは許可されません。
ALTER DBSERVER CONFIGUREBMC
ALTER DBSERVER RESTART BMC
ALTER DBSERVER LED { ON | OFF }
ALTER DBSERVER
コマンドについて、その他の使用上のノートは次のとおりです。
- 次の場合は、データベース・サーバーを再起動、停止または起動する必要がありません。
- ソフトウェアのアップグレード
- サービス停止(データベース・サーバーがサービス・リクエストに応答していない状態を含む)
- アラート通知を送信するようにデータベース・サーバーを設定する場合、次のデータベース・サーバー属性を構成する必要があります。
mailServer
smtpPort
smtpUseSSL
smtpFrom
smtpFromAddr
smtpToAddr
snmpSubscriber
snmpUser
snmpEngineID
notificationMethod
notificationPolicy
emailSubscriber
smtpToAddr
属性は、アラート通知の受信先のカンマ区切りの電子メール・アドレス・リストに設定できます。このリストは引用符で囲む必要があります。snmpSubscriber
属性は、SNMPアラート通知を送信するSNMPターゲットのリストに設定できます。これらのターゲットは次のように指定されます。snmpSubscriber=( (host=host[,port=port][,community=community][,type=user_type][,fromIP="ip"] [,asrmPort="ASRManager_port"]) [,(host=host[,port=port][,community=community][,type=user_type][,fromIP="ip"] [,asrmPort="ASRManager_port"])] ...)
ノート:
-
ALTER DBSERVER ... smnpSubscriber
コマンドでは、smnpSubscriber
に設定されている既存の値を置き換えます。SNMPターゲットのリストを追加するには、既存の値がコマンドに含まれるようにします。コマンドを実行すると、次のメッセージが表示されます。snmpSubscriber {0} has been replaced with {1}.
-
snmpSubscriber
属性はOracle自動サービス・リクエスト(ASR)の構成に使用します。 -
SNMPアラートは、Oracle Exadata System Softwareの各インストールに含まれているMIB (管理情報ベース)に準拠しています。データベース・サーバーのMIBファイルは、
/opt/oracle/dbserver/dbms/deploy/config/
にあります。タイプ
ASR
およびv3ASR
のアラートは、SUB-HW-TRAP-MIB.mib
ファイルにあるSUN-HW-TRAP-MIBに準拠しています。その他のアラート・タイプは、
cell_alert.mib
ファイルにあるcell_alert MIBに準拠しています。SNMPアラートとMIBはSNMPバージョン 1(SNMPv1)に準拠しています。ただし、自動サービス・リクエストのアラートはSNMPバージョン2c(SNMPv2c)に準拠しています。
port
のデフォルト値は162
です。community
のデフォルト値はpublic
です。notificationMethod
属性の値は、mail
、snmp
、none
、またはmail
とsnmp
の組合せ(notificationMethod='mail,snmp'
など)が可能です。デフォルト値はmail
です。snmpSubscriber
タイプは、ASR
、v3
およびv3ASR
です。v3
およびv3ASR
タイプの場合、snmpUser
を定義する必要があり、community
のかわりにユーザー名を指定します。v3ASR
タイプの場合、authProtocol=SHA
およびprivProtocol=AES
を使用してユーザーを定義する必要があります。ASR Managerによってサポートされるプロトコルはこれらのみです。snmpSubscriber
をv3ASR
タイプとして設定すると、ILOMによって送信されるトラップのILOMプロパティおよびルールも設定されます。タイプが指定されない場合、デフォルトはバージョン1、cell_alert trapsです。このタイプを指定する文字列はありません。このタイプを使用するにはタイプ・フィールドを省略してください。
fromIP
フィールドで、トラップが送信されるIPアドレスを指定できます。このフィールドが指定されていない場合、デフォルトで、eth0に関連付けられているIPアドレスが設定されます。Oracle ASR ManagerにデフォルトのIPアドレスが登録されていなければ、このフィールドを使用します。Oracle ASR Managerは、認識できるIPアドレスから送信されたSNMPトラップのみを処理します。fromIP
フィールドは、タイプがASR
またはv3ASR
に設定されているsnmpSubscriber
に対してのみ使用できます。次に例を示します。
DBMCLI> alter dbserver snmpSubscriber=((host=asrhost,port=162,community=public,fromIP="1.1.1.1",type=ASR))
次の例では、タイプが
ASR
またはv3ASR
ではないため、エラーが返されます。DBMCLI> alter dbserver snmpSubscriber=((host=localhost,port=162,community=public,fromIP="1.1.1.1")) DBM-00068: The fromIP field is only supported for ASR SNMP subscribers.
asrmPort
フィールドにより、Oracle ASR Managerとの通信のためにMSで使用されるOracle ASR Managerマシンのポート番号を指定できます。このポートは、Oracle ASR ManagerのHTTP受信機能のHTTPポートと同じにする必要があります。これを確認するには、Oracle ASR Managerマシンでasr show_http_receiver
を実行します。asrmPort
フィールドは、タイプがASR
またはv3ASR
に設定されているsnmpSubscriber
に対してのみ使用できます。このポートのデフォルト値は16161です。snmpUser
属性では、SNMPアラートを受信するユーザーを定義します。このコマンドは、対話型モードでのみ実行できます。この属性の構成方法は2通りあります。snmpuser=((user_clause)[,(user_clause)[,..]]) snmpuser.name=(user_clause)
-
snmpuser
を指定する場合は、すべての構成対象ユーザーのuser_clauseを指定します。ユーザーを省略すると、そのユーザーはSNMPアラートを受信しなくなります。((user_clause)[,(user_clause)[,..]])
文字列を指定すると、その前にsnmpuser
属性に使用していた文字列が上書きされます。 -
snmpuser.name
指定する場合は、特定のユーザーのみのuser_clauseを指定する必要があります。これにより、各ユーザーを個別に追加、削除または変更できるようになり、snmpuser
属性文字列全体を毎回指定する必要がなくなります。 snmpuser=''
を使用すると、すべてのSNMPユーザーが削除されます。snmpuser.name=''
を使用すると、指定のユーザーのみが削除されます。SNMPユーザーは、V3 SnmpSubscriberによって参照されている間は削除できません。
それぞれの方法で、次の形式のuser_clauseを使用します。
(([name=user1,] authProtocol=auth_type, authPassword=*, \ privProtocol=priv_type, privPassword=*) , \ (name=user2, authProtocol=auth_type, authPassword=*, \ privProtocol=priv_type, privPassword=*, ), ...)
単一のユーザーを更新する場合は、user_clauseにフレーズ
name=user1,
を含めないでください。これは、すでにsnmpuser.name
の一部として名前を指定しているためです。-
name
はユーザー名です。 -
コマンド内のパスワード値には
*
のみが使用可能です。パスワードは格納または表示されません。セキュア・ハッシュ・キーが計算され、トラップの認証および暗号化用として使用されます。 -
authProtocol
は認証プロトコルです。オプションはMD5
またはSHA
です。snmpUser
属性にはauthProtocol
を指定する必要があります。認証パスワードの入力が求められます。認証パスワードは、8から12文字の英数字にする必要があります。
-
privProtocol
は暗号化プロトコルです。オプションはnone
、AES
またはDES
です。privProtocol
属性を指定しない場合、デフォルトのnone
を使用します。暗号化プロトコルが指定されている場合、暗号化パスワードの入力が求められます。パスワードは正確に8文字の英数字であり、大文字小文字が区別されます。
smtpUseSSL
属性では、属性をtrue
に設定すると、電子メール通知でSecure Socket Layer(SSL)暗号化が有効になります。notificationPolicy
属性の値は、none
、またはcritical
、warning
、clear
の組合せ(notificationPolicy='warning,clear'
など)が可能です。critical
値は、ハードウェア生成のアラートか、自動診断リポジトリ(ADR)またはベースボード管理コントローラ(BMC)で生成されるアラートを示します。また、critical
値は、メトリック定義で指定したcriticalのしきい値を超えた場合のメトリック・アラートも示します。warning
値は、メトリック定義で指定したwarningのしきい値を超えた場合のメトリック・アラートを示します。clear
値は、値がwarningまたはcriticalのしきい値を超えた後に、そのしきい値の境界を下回った場合のメトリック・アラートを示します。maintenance
値は、ハードウェア関連のすべてのエラーを示します。ハードウェア・エラーは、電子メール・メッセージの件名の行に"Maintenance"としてレポートされます。
-
各サブスクライバのホストは、ドメイン名またはIPアドレスとして指定する必要があります。英数字以外の文字が含まれる場合は、ホスト名またはIPアドレスは引用符で囲みます。ポート値およびコミュニティ値はオプションです。ポート値のデフォルトは
162
です。コミュニティのデフォルト値はpublic
です。タイプ値はオプションです。タイプのデフォルト値はNULL
です。サポートされているNULL以外の値は、ASR
、V3
およびv3ASR
タイプのみです。 -
Management Server (MS)を起動すると、
ASR
またはv3ASR
タイプのsnmpSubscriber
リストのエントリは、データベース・サーバーのILOMに追加されます。これにより、ILOMが置き換えられると、エントリは新しいILOMに設定されます。エントリがILOMから削除された場合は、ALTER DBSERVER ... snmpUser=
コマンドを使用して、それらのエントリを手動でILOMに追加する必要があります。 -
type=asr
またはtype=v3ASR
のsnmpSubscriber
はOracle ASR Managerの指定のみに構成する必要があります。 -
データベース・サーバー・アラートまたはイベントの電子メール・メッセージが正常に送信されるかどうかを検証するには、
ALTER
コマンドにVALIDATE MAIL
オプションを指定します。検証プロセスにより、設定した受信先にテスト用の電子メール・メッセージが送信されます。テスト用の電子メール・メッセージが受信されない場合は、電子メール構成の設定が有効になっていません。 -
emailFormat
属性はhtml
またはtext
です。デフォルトでは、電子メール通知はHTML形式で送信されます。プレーン・テキストの電子メール通知を受信するには、値をtext
に変更します。 -
ALTER DBSERVER snmpEngineID
コマンドをSNMPマネージャで使用すると、アラートがデータベース・サーバーからサブスクライブされます。snmpEngineID
パラメータは、最大20文字まで設定できます。これは、データ・センター内のターゲットごとに一意である必要があります。デフォルトは、サーバー名です。SNMPユーザーが定義される前にsnmpEngineID
属性が設定されていない場合、このデフォルト値が使用されます。SNMPユーザーが定義された後は、エンジン識別子を変更しないでください。エンジン識別子を変更すると、ユーザー・キーが再計算されるため、ユーザーのパスワードを再入力する必要があります。
- データベース・サーバー名を変更する場合、一意のデータベース・サーバー名を選択する必要があります。
ipaddressN
属性の1つを変更すると、ネットワーク構成ファイル/etc/oracle/cell/network-config/cellinit.ora
が変更されます。ALTER DBSERVER snmpSubscriber
コマンドは、Oracle ASRサブスクライバを構成し、トラップを送信します。-
ALTER DBSERVER emailSubscriber
コマンドは、特定の型のアラートのアラート通知の受信先のカンマ区切りの電子メール・アドレス・リストを設定します。この構文の例を次に示します。ALTER DBSERVER emailSubscriber = ((email="email_address1", \ alertType="alert_type") \ [, (email="email_address2",alertType="alert_type"), ...])
電子メール・アドレスは有効な電子メール・アドレスである必要があります。
email
パラメータは必須です。alertType
パラメータは、アラートのタイプを指定します。このパラメータはオプションです。アラート・タイプは、HARDWARE
、SOFTWARE
、METRIC
またはADR
です。アラート・タイプを指定しない場合、すべてのアラート・タイプがサブスクリプションの対象になります。入力文字列を空にすると、現在の一連のサブスクライバが削除されます。
アラート通知を受信するには、通知ポリシーを設定する必要があります。ポリシーは、すべての電子メール・サブスクライバに適用されます。これらのアラートの通知ポリシーは、
snmpSubscriber
アラートの場合と同じです。 -
syslogconf
属性によってデータベース・サーバーのsyslogルールが拡張されます。この属性を使用すると、指定した管理サーバーに対象のsyslogメッセージが転送されるように指定できます。管理サーバーでは、管理サーバーのsyslog構成に応じて、転送されたメッセージがファイル、コンソールまたは管理アプリケーションに渡されます。この属性の構文を次に示します。syslogconf = ('selector @node' [, 'selector @node']... )
この構文のselectorはメッセージ・タイプで、nodeは指定したサーバーです。どちらの変数も
syslog.conf
の標準構文規則に準拠します。-
syslogconf
属性のfacility
オプションは、auth
、authpriv
、cron
、daemon
、ftp
、kern
、lpr
、mail
、mark
、news
、security
、syslog
、user
、uucp
、local0
、local1
、local2
、local3
、local4
、local5
、local6
、local7
、none
、*
のいずれかである必要があります。 -
syslogconf
属性のpriority
オプションは、alert
、crit
、debug
、emerg
、err
、error
、info
、notice
、panic
、warn
、warning
、none
または*
(アスタリスク)のいずれかである必要があります。
-
-
ALTER DBSERVER VALIDATE syslogconf selector
コマンドでは、テスト・ログ・メッセージを送信します。テスト・メッセージの送信先は、/etc/syslog.conf
ファイルのルールによって指定されます。syslogconfの割当てによりsyslogのルールが拡張される場合は、指定の管理サーバーにテスト・メッセージが転送されます。 -
Oracle Exadata System Softwareリリース19.1.0以降では、
syslogFormat
属性を使用して、必要なフォーマット文字列に値を設定することでsyslogの標準フォーマットを任意のフォーマットに変更できます。syslogFormat
属性を空の文字列に設定すると、フォーマットの変更が削除され、syslogフォーマットがデフォルト・フォーマットに戻されます。フォーマット文字列に制御文字が含まれている場合は、コマンドの入力時にバックスラッシュを前に付ける必要があります。例は、例9-24を参照してください。
-
Oracle Exadata System Softwareリリース19.3.0以降では、
syslogFormat
属性を使用すると、暗号化形式でsyslogを送信できます。完全な構成ステップは、システム・ログ情報の暗号化を参照してください。 -
電子メールへの診断パッケージの添付をオフにするには、次のコマンドを実行します。
ALTER DBSERVER diagPackEmailAttach=FALSE
-
Oracle Exadata System Softwareリリース19.1.0以降では、
httpsAccess
属性を使用して、HTTPを介してRESTfulサービスにアクセスできるユーザーを制御するIPアドレスまたはIPサブネット・マスクのリストを指定できます。httpsAccess
に指定する値は、以前の値を上書きします。httpsAccess
に次の値を使用できます。ALL
— すべてのホストへのアクセスを許可します(デフォルト)NONE
— HTTPsポートを完全に無効化しますIP1, IP2,..., IPn
— IPアドレスIP1、IP2...、IPnを持つホストへのアクセスのみを許可します。IPnはIPv4、IPv4サブネット、IPv6またはIPv4埋込みIPv6形式の有効なIPアドレスです。アクセス制御リストには、最大512個のIPアドレスを指定できます。
また、1つのIPアドレスのかわりに、
/
文字を使用してサブネット・マスクでIPアドレスの範囲を指定できます。たとえば、範囲'192.168.10.0/24'
は、192.168.10.1から192.168.10.255のIPアドレスを持つホストに対応します。IPアドレス範囲を指定する場合は、IPアドレス文字列を引用符で囲む必要があります。 -
ExaCLIで使用するためにセル上にCA認証のセキュリティ証明書を設定するには、次の属性を使用します。
ノート:
次の属性は、ExaCLIからALTER CELL
コマンドを実行する場合にのみ使用できます。-
securityPubKey
- 公開キー・ファイルのURLを指定します。 -
securityPrivKey
- 秘密キー・ファイルのURLを指定します。 -
securityPrivKeyPW
- 秘密キー・ファイルが暗号化されている場合に使用するパスワードを指定します。
次に例を示します。
ExaCLI> alter cell securityPubKey="http://www.example.com/security/newkey.crt", - securityPrivKey="http://www.example.com/security/newkey.key", - securityPrivKeyPW=* password=****************
CA認証済セキュリティ証明書をアップロードした後、新しいセキュリティ証明書を表示するには、MSを再起動する必要があります。
CellCLI> alter cell restart services ms
関連項目:
CA認証済セキュリティ証明書の使用 -
-
Oracle Exadata System Softwareリリース21.2.0以降、
ilomSyslogClients
属性は、Integrated Lights Out Manager (ILOM)サービス・プロセッサ(SP)からsyslogメッセージを転送するリモート宛先を指定します。ilomSyslogClients
属性には、最大2つのloghostサーバーのカンマ区切りリストを指定できます。loghostサーバーごとに、有効なホスト名またはIPアドレスを指定する必要があります。次に例を示します。
DBMCLI> ALTER DBSERVER ilomSyslogClients="192.0.2.101,192.0.2.201"
ノート:
ILOM syslogメッセージを受信するには、指定された
ilomSyslogClients
がポート514でリスニングする必要があります。
例
例9-8は、snmpSubscriber
のasrmPort
フィールドを設定する方法を示しています。
例9-9は、自動診断パックのアップロード機能を有効および無効にする方法を示しています。
例9-10は、データベース・サーバーに電子メール通知を設定する方法を示しています。
例9-11は、データベース・サーバー上の電子メール設定を確認する方法を示しています。
例9-12は、電子メールのメッセージの形式の変更方法を示しています。
例9-13は、データベース・サーバー上のSNMP設定を確認する方法を示しています。
例9-14は、電子メール・アラートのタイプの指定方法を示しています。この例では、1つのサブスクライバがハードウェアおよびソフトウェアを取得し、もう1つのサブスクライバがADRアラートを取得します。
例9-15は、SNMPユーザーを変更する方法を示しています。
例9-16は、単一のSNMPユーザーを変更する方法を示しています。
例9-17は、データベース・サーバー・サービスを起動および停止する方法を示しています。
例9-18は、データベース・サーバー上にLEDを設定する方法を示しています。
例9-19は、キャパシティ・オンデマンドの保留中のコア数を示しています。新しいコア数をアクティブにするために、サーバーを再起動する必要があります。
例9-20は、syslogconf
属性を使用してルールを追加する方法を示しています。
例9-21は、テスト・メッセージを使用してルールを追加および検証する方法を示しています。
例9-22は、syslog.conf
のルールを削除する方法を示しています。
例9-23は、Exadata RESTfulサービスへのHTTPSアクセスを特定のIPアドレスの範囲に制限する方法を示しています。
例9-8 snmpSubscriberのasrmPortの設定
DBMCLI> ALTER DBSERVER snmpSubscriber=((host=host1,port=162,community=public,type=asr,asrmPort=16161))
例9-9 自動診断パックのアップロードの有効化と無効化
dbserver
オブジェクトのdiagPackUploadEnabled
属性を設定すると、この機能を有効化または無効化できます。
この機能を無効にする場合は属性をfalse
に、有効にする場合はtrue
に設定します。デフォルトはtrue
です。
DBMCLI> ALTER DBSERVER diagPackUploadEnabled=FALSE
例9-10 データベース・サーバーへの電子メール通知の構成
DBMCLI> ALTER DBSERVER mailServer='mail_relay.example.com', -
smtpFromAddr='john.doe@example.com', -
smtpFrom='John Doe', -
smtpToAddr='jane.smith@example.com', -
snmpSubscriber=((host=host1),(host=host2)), -
notificationPolicy='clear', -
notificationMethod='mail,snmp'
例9-11 データベース・サーバー上の電子メール設定の確認
DBMCLI> ALTER DBSERVER VALIDATE MAIL
例9-12 電子メールのメッセージの形式の変更
DBMCLI> ALTER DBSERVER emailFormat='text'
DBMCLI> ALTER DBSERVER emailFormat='html'
例9-13 データベース・サーバー上のSNMP設定の確認
DBMCLI> ALTER DBSERVER VALIDATE SNMP
例9-14 電子メール・アラートのタイプの指定
ALTER DBSERVER emailSubscriber= \
((email="email1@example.com",alertType="HARDWARE,SOFTWARE"), \
(email="email2@example.com",alertType="ADR"))
例9-15 SNMPユーザーの変更
この例は、単一のSNMPユーザーの初期構成を示しています。ここでは、管理者がパスワードの入力を求められます。
CellCLI> ALTER CELL snmpuser = ((name=ASR, authprotocol=md5, authpassword=*, \
privprotocol=AES, privpassword=*))
snmpUser ASR authpassword: password
Confirm snmpUser ASR authpassword: password
snmpUser ASR privpassword: password
Confirm snmpUser ASR privpassword: password
例9-16 単一のSNMPユーザーの変更
次のコード例は、SNMPユーザーの追加、そのユーザーのパスワードの変更、そのユーザーの削除を示しています。
## adding users individually
CellCLI> ALTER CELL snmpuser.user2=(authprotocol=SHA,authpassword=*)
snmpUser user2 authpassword: password
Confirm snmpUser user2 authpassword: password
snmpUser ((name=user1, authProtocol=SHA, privProtocol=AES)) has been replaced with
((name=user1, authProtocol=SHA, privProtocol=AES),(name=user2, authProtocol=SHA)).
Cell cel01 successfully altered
## changing a password of an existing user
CellCLI> ALTER CELL snmpuser.user2 = (authprotocol=SHA,authpassword=password)
Cell cel01 successfully altered
## delete a user individually
CellCLI> ALTER CELL snmpuser.user2=''
snmpUser ((name=user1, authProtocol=SHA, privProtocol=AES),(name=user2, authProtocol=SHA)) has
been replaced with ((name=user1, authProtocol=SHA, privProtocol=AES)).
Cell cel01 successfully altered
例9-17 データベース・サーバー・サービスの起動および停止
DBMCLI> ALTER DBSERVER SHUTDOWN SERVICES MS
DBMCLI> ALTER DBSERVER RESTART SERVICES MS
表9-18 データベース・サーバーLEDの設定
DBMCLI> ALTER DBSERVER LED OFF
DBMCLI> ALTER DBSERVER LED ON
例9-19 保留コア数の設定
この例は、サーバーを再起動する前にデータベース・サーバーのアクティブな物理コアの数を増やす方法を示しています。正しい値が設定されていることを確認するには、LIST DBSERVER
コマンドを使用します。
DBMCLI> ALTER DBSERVER pendingCoreCount=20
例9-20 syslogconf属性の使用
DBMCLI> ALTER DBSERVER syslogconf=('*.err;authpriv.none @loghost', -
'*.emerg @loghost')
例9-21 ルールの追加および検証
DBMCLI> ALTER DBSERVER syslogconf=('kern.crit @loghost')
DBMCLI> ALTER DBSERVER VALIDATE syslogconf 'kern.crit'
例9-22 すべてのsyslog.confルールの削除
DBMCLI> ALTER DBSERVER syslogconf=''
例9-23 Exadata RESTfulサービスへのHTTPSアクセスの制限
次のコマンドは、192.168.10.1から192.168.10.255までの範囲でIPアドレスを持つホストへのHTTPsポート・アクセスを許可します。
DBMCLI> ALTER DBSERVER httpsAccess="192.168.10.0/24"
例9-24 Syslogフォーマットをカスタム文字列に設定してデフォルト・フォーマットに戻す
DBMCLI> ALTER DBSERVER syslogformat="%TIMESTAMP:::date-rfc3339% %HOSTNAME%%syslogtag%
%syslogseverity-text%:%msg:::sp-if-no-1st-sp%%msg:::drop-last-lf%\\n"
DBMCLI> ALTER DBSERVER syslogformat="%TIMESTAMP% %HOSTNAME% %msg%\\n"
DBMCLI> ALTER DBSERVER syslogformat=""
9.7.1.2.1 リアルタイム・インサイトの属性
Oracle Exadata System Software 22.1.0以降では、リアルタイム・インサイト機能を使用して、Exadataシステムをリアルタイムで監視できます。
ファイングレイン・メトリック収集
metricFGCollIntvlInSec
属性により、ファイングレイン・メトリック収集を制御します。
-
ファイングレイン・メトリック収集を有効にするには、収集間隔を1から60秒までの値に設定する必要があります。
次に例を示します。
DBMCLI> ALTER DBSERVER metricFGCollIntvlInSec=1
ファイングレイン・メトリック収集の収集間隔は、
metricStreamIntvlInSec
属性で指定された自動アップロード頻度に関連しています。自動アップロードが有効になっている場合、metricStreamIntvlInSec
をmetricFGCollIntvlInSec
の5倍から30倍にする必要があり、metricFGCollIntvlInSec
を変更する際にはこの関係を順守する必要があります。たとえば、metricStreamIntvlInSec
が60に設定されている場合、metricFGCollIntvlInSec
は2から12までである必要があります。 -
サーバーでファイングレイン・メトリック収集を無効にするには、
metricFGCollIntvlInSec=0
に設定します。次に例を示します。
DBMCLI> ALTER DBSERVER metricFGCollIntvlInSec=0
metricStreamIntvlInSec
属性を使用して自動メトリック・アップロードを有効にしてある場合は、ファイングレイン・メトリック収集を無効にできません。
自動メトリック・アップロード
metricStreamIntvlInSec
属性により、metricStreamEndPoint
属性で指定されたメトリック・ストリーミング・エンドポイントへの自動アップロードのアップロード間隔(秒)を設定します。
-
自動アップロードを有効にするには、
metricStreamIntvlInSec
値を、metricFGCollIntvlInSec
属性で指定された収集間隔の5倍から30倍にする必要があります。たとえば、metricFGCollIntvlInSec
が5に設定されている場合、metricStreamIntvlInSec
は25から150までである必要があります。次に例を示します。
DBMCLI> ALTER DBSERVER metricStreamIntvlInSec=25
ファイングレイン・メトリック収集が無効になっている(
metricFGCollIntvlInSec=0
)場合は、自動アップロードを有効にできません。 -
サーバーで自動メトリック・アップロードを無効にするには、
metricStreamIntvlInSec=0
に設定します。次に例を示します。
DBMCLI> ALTER DBSERVER metricStreamIntvlInSec=0
メトリック・アップロード・エンドポイント
metricStreamEndPoint
属性により、メトリック・ストリームを自動的に受信する1つ以上の収集エンドポイントを指定します。metricStreamEndPoint
は次のように設定できます。
metricStreamEndPoint[+]=((host="endpoint-URL"[,type="stream-format"][,token="authentication-token"][,{httpProxy|httpsProxy}="proxy-server"])
[,(host="endpoint-URL"[,type="stream-format"][,token="authentication-token"][,{httpProxy|httpsProxy}="proxy-server"])]...)
metricStreamEndPoint
定義の内容:
-
host
: 収集エンドポイントのURLを指定します。このURLでは、HTTPまたはHTTPSを使用できます。 -
type
: オプションで、ストリームの形式を指定します。サポートされている値は次のとおりです。-
JSON
: ストリームをJSON形式で提供します。 -
plaintext
: ストリームをプレーン・テキスト形式で提供します。
デフォルト値は
json
です。 -
-
token
: オプションで、収集エンドポイントの認証トークンを指定します。トークンの生成の詳細は、メトリック収集プラットフォームを参照してください。 -
httpProxy
またはhttpsProxy
: オプションで、収集エンドポイントへのネットワーク接続を容易にするためのプロキシ・サーバーを指定します。Exadataシステムと収集エンドポイントの間にファイアウォールが存在する場合は、プロキシ・サーバーが必要です。
オプションの+=
演算子を使用すると、収集エンドポイントを既存のmetricStreamEndPoint
定義に追加できます。それ以外の場合は、=
演算子を使用すると前の属性値が上書きされます。
メトリック・タグ
metricStreamTags
属性により、サーバーによって生成されるすべてのメトリック観測データに含める、一連のメトリック・タグを定義します。これらのタグは、多数のExadataサーバーによって生成された観測データを整理およびグループ化するために役立ちます。
metricStreamTags
属性は、次のような、タグと値のペアを含む有効なJSON文字列に設定できます。
metricStreamTags='{"tag1":"value1"[,"tag2":"value2"]...}'
次に例を示します。
DBMCLI> ALTER DBSERVER metricStreamTags='{"application":"personnel","department":"HR"}'
親トピック: ALTER DBSERVER
9.7.1.3 ALTER IBPORT
用途
ALTER IBPORT
コマンドは、すべてのInfiniBandネットワーク・ファブリック・ポートまたは特定のポートに対するアクションを実行します。
ノート:
このコマンドは、RoCEネットワーク・ファブリックを使用するExadata Database Machineサーバーでは機能しません。構文
ALTER IBPORT {ALL | ibport_name [, ibport_name] ...} RESET COUNTERS
使用上のノート
RESET COUNTERS
オプションは、InfiniBandネットワーク・ファブリック・ポート上のすべてのカウンタをリセットします。
例9-25 IBPORT属性の変更
この例は、すべてのポートまたは特定のポートのIBPORT
カウンタのリセット方法を示しています。
DBMCLI> ALTER IBPORT ALL RESET COUNTERS
InfiniBand Port HCA-1:1 successfully altered.
InfiniBand Port HCA-1:2 successfully altered.
DBMCLI> ALTER IBPORT "HCA-1:1" RESET COUNTERS
InfiniBand Port HCA-1:1 successfully altered.
親トピック: ALTER
9.7.1.4 ALTER METRICDEFINITION
用途
ALTER METRICDEFINITION
コマンドにより、メトリックのファイングレイン収集を有効または無効にします。
構文
ALTER METRICDEFINITION [ metric_name [, metric_name ]... ] finegrained={enabled|disabled} [ attribute_filters ]
使用上のノート
-
コマンドで次のようにします。
-
metric_name: 変更する特定のメトリック定義を指定します。
-
attribute_filters: 属性値に従ってフィルタ処理することで、変更するメトリック定義を指定します。
-
-
デフォルトで、ファイングレイン収集に対して自動的に一連のキー・パフォーマンス・メトリックが有効になります。ただし、特定のメトリックを有効または無効にすることで、ファイングレイン・メトリック収集をカスタマイズできます。
-
ファイングレイン収集が有効になっているメトリックを表示するには、
LIST METRICDEFINITION
コマンドを使用し、finegrained
属性値を確認します。
例9-26 特定のメトリック定義の変更
この例では、イーサネット・ネットワーク・インタフェース転送速度(N_NIC_KB_TRANS_SEC
)を示すメトリックのファイングレイン・メトリック収集を有効にするコマンドを示します。
DBMCLI> ALTER METRICDEFINITION N_NIC_KB_TRANS_SEC finegrained=enabled
例9-27 メトリック定義のリストの変更
この例では、リストした一連のメトリックのファイングレイン・メトリック収集を無効にするコマンドを示します。
DBMCLI> ALTER METRICDEFINITION N_MB_SENT,N_MB_RECEIVED finegrained=disabled
例9-28 フィルタの使用によるメトリック定義の変更
この例では、属性フィルタで指定したすべてのメトリックのファイングレイン・メトリック収集を有効にするコマンドを示します。
DBMCLI> ALTER METRICDEFINITION finegrained=enabled WHERE name LIKE 'N_NIC.*'
親トピック: ALTER
9.7.1.5 ALTER SOFTWAREUPDATE
Oracle Exadata System Softwareリリース19.3.0以降では、SoftwareUpdate
属性を設定することで、データベース・サーバーのソフトウェア更新をスケジュールできます。
用途
ALTER SOFTWAREUPDATE
コマンドでは、変更可能なソフトウェア更新属性を変更して、ソフトウェア更新の前提条件を検証したり、アップグレードを即座に開始できます。
dcli
またはexacli
を使用してALTER SOFTWAREUPDATE
コマンドを実行することもできます。
ノート:
現在、データベース・ノードのローリング・アップグレードの自動化はサポートされていないため、サービス停止による停止時間を回避するためにアップグレードを計画する必要があります。構文
ALTER SOFTWAREUPDATE {VALIDATE PREREQ [FORCE] | UPGRADE [FORCE] | attribute = attribute value
[,attribute = attribute value...]}
ALTER SOFTWAREUPDATEコマンドのオプション
-
VALIDATE PREREQ [FORCE]
ソフトウェア更新の前提条件チェック・ステップを実行します。これにより、
store
属性で指定された更新に対して、ソフトウェア更新の前提条件コードがダウンロードされます。これらのチェックは、更新の一部として自動的に実行されます。事前要件チェックを明示的に実行する場合にのみ、このオプションを使用します。検出されたエラーが表示されます。VALIDATE PREREQ
コマンドでエラーが検出された場合、ステートフル・アラートが発生します。FORCE
オプションを指定すると、dbnodeupdate
コマンドは-modify_on_prereq
オプションを指定して実行されます。 -
UPGRADE [FORCE]
ソフトウェア更新の
store
属性で指定されたソフトウェアの場所を使用して、ソフトウェア更新(前提条件ステップを含む)を実行します。ソフトウェア更新のtime
属性で指定された時間待機するのではなく、即座に更新を実行する場合、このコマンドを使用します。FORCE
を指定した場合、前提条件チェックでエラーが検出されても、アップグレードは続行します。 -
attribute = attribute value
指定したソフトウェア更新属性を指定した値に変更します。
SOFTWAREUPDATEの属性
ALTER SOFTWAREUPDATE
コマンドの次の属性は変更可能です。
frequency
:frequency
属性を必要な頻度に設定すると、データベース・サーバーの定期更新が自動的に実行されます。{none | daily | weekly | biweekly }
のいずれかの値を指定できます。frequency
に指定された値が''
またはnone
の場合、スケジュールされた更新は1回のみ実行されます。-
name
: 更新で使用するパッチの名前。これには、19.3.1.0.0.190918などのソフトウェア・バージョンの文字列が含まれています。名前は、ISOファイルを含むARU形式のファイル名(たとえば、p28802069_193000
またはp28802067_193000
)にすることも、ラベルベースの名前(たとえば、exadata_ovs_19.3.0.0.0.190913
またはexadata_ol7_19.3.0.0.0.190913
)にすることもできます。これらのISO zipファイルをダウンロードすると、データベース・サーバー更新ソフトウェアが同じストアの場所から自動的にダウンロードされます。name
が設定されていない場合(unknown
の値が設定されている場合)、UPGRADE
またはVALIDATE PREREQ
が指定されていると、ストアから最新バージョンのexadata_oxx_...zip
パッチが選択されます。名前
が設定されていない場合(値がunknown
の場合)、ALTER SOFTWAREUPDATE UPGRADE
またはALTER SOFTWAREUPDATE VALIDATE PREREQ
コマンドを使用するときに、ソフトウェア・ストアがチェックされ、name
属性が(まだ設定されていない場合は)ソフトウェア・ストア内の使用可能な最新バージョンに自動的に設定されます。ストア・サイトで複数のソフトウェア・バージョンが存在する場合、この属性を使用して、使用するバージョンを指定できます。 -
store
: ソフトウェア・ストアの場所のURL。ネットワーク・ストアの場所の指定に、
HTTP
またはHTTPS
プロトコルを使用する場合:-
管理ネットワークまたはRDMAネットワーク・ファブリックを使用して、URLにアクセスできることが必要です。
-
MSによって、必要なソフトウェア更新ファイルが自動的に検出されてダウンロードされます。
-
ダウンロードされたソフトウェア更新ファイルのローカル・ステージングの場所は、システム構成によって異なります。
-
Oracle Exadata Database Machineが仮想マシン(VM)なしで構成されている場合(ベア・メタル構成とも呼ばれます)、ダウンロードされたソフトウェア更新ファイルのローカル・ステージングの場所は
/u01/swupdate
になります。 -
Oracle Exadata Database Machineが仮想マシン(VM)で構成されている場合、ダウンロードされたソフトウェア更新ファイルのローカル・ステージングの場所は次のとおりです。
-
VMサーバー(KVMホストまたはOracle VM管理ドメイン)内の
/EXAVMIMAGES/swupdate
。 -
各VM (KVMゲストまたはOracle VMユーザー・ドメイン)内の
/u01/swupdate
。
-
-
また、
FILE
プロトコルを使用して、ローカル・ストアのURLを指定することもできます。ローカル・ストアを使用する場合:-
MSでは、パッチzipファイルのダウンロードや関連する領域チェックの実行は必要ありません。
-
MSでは、ローカルのソフトウェア・ストアのコンテンツが管理されません。パッチ適用前に必要なパッチ・ファイルをダウンロードして、その後でファイルを削除して領域を解放する必要があります。
-
ファイルURLには、次のいずれかの形式を使用する必要があります。
file:///localpath
file:/localpath
-
-
time
: ソフトウェア更新を実行する未来の日時。時間は、"1 AM, next Tuesday"
などのローカルの非公式な日時として指定できます。日時が有効な場合、この属性の設定による出力では、タイムゾーン・オフセットを使用した標準形式(2017-08-22T01:00:00-08:00
など)で解釈された時間を表示します。この属性を空の文字列
""
に設定した場合、スケジュールされたソフトウェア更新は取り消されます。 timeLimitInMinutes
: 更新は、ディスク・グループの冗長性を維持するために、他のデータベース・サーバーで更新が完了するのを待機する場合があります。デフォルトでは、更新の待機に費やすことができる時間に制限はありません。この属性には、データベース・サーバーが更新の待機に費やす時間(分)を表す正の最大整数を設定できます。更新が制限によって指定された時間内に開始しない場合、更新は取り消され、更新のアラートがレポートされます。
使用上のノート
- 現在、ISOファイル・リポジトリのダウンロードのみがサポートされています。
- ソフトウェアがダウンロードされると、前提条件チェックがスケジュールされた更新時間の前の週までに開始されます。
- 更新の進行状況は、変更できないソフトウェア更新の
status
属性を表示することにより監視できます。 - アップグレード・ソフトウェアがすでにインストールされている場合、ソフトウェア更新は行われません
dcli
またはexacli
を使用して、ALTER SOFTWAREUPDATE
コマンドで更新をスケジュールおよびインストールできます。-
ソフトウェア更新では、ソフトウェアのダウンロード用にHTTPSトランスポートの使用をサポートしています。HTTPSを使用している場合、デフォルトでTLS証明書チェックが実行されます。リモート・サーバーの証明書を検証できない場合、次のエラーがレポートされます。
CELL-00076: An error occurred during download of software update: source https://hostname:port is not available. CELL-00092: The store's TLS certificate cannot be authenticated with known CA certificates.
これは、リモート・サーバーが自己署名した証明書を使用している場合、またはデータベース・サーバーのCAストアに含まれていない認証局(CA)によって署名された証明書をリモート・サーバーが使用している場合、発生する可能性があります。次の手順を使用して、CA証明書をデータベース・サーバーのCAストアに追加できます。これは、データベース・サーバーで
root
としてシェルにアクセスする必要があるセキュリティ設定ステップです。- リモート・サーバーを検証できるCA証明書を取得します。証明書は、PEMまたはDERファイル形式で格納する必要があります。
- このファイルをデータベース・サーバーの
/etc/pki/ca-trust/source/anchors/
ディレクトリにコピーします。 - 次のコマンドを実行します。
update-ca-trust enable update-ca-trust extract
man
を使用して、update-ca-trust
コマンドの詳細情報を取得します。
例
例9-29 ソフトウェア更新のtime属性の変更
スケジュールした次回のソフトウェア更新の時間を2019年12月27日の午前12時30分に変更します。
ALTER SOFTWAREUPDATE time="2019-12-27T00:30"
例9-30 ソフトウェア更新のstore属性の設定
この例は、HTTPSプロトコルを使用する場所にstore属性を設定する方法を示しています。
ALTER SOFTWAREUPDATE store="https://my-exa-store/compute"
例9-31 ソフトウェア更新の即時起動
この例は、前提条件のチェックの実行後に、すでに指定した属性値を使用してソフトウェア更新を即座に開始する方法を示しています。
ALTER SOFTWAREUPDATE VALIDATE PREREQ
ALTER SOFTWAREUPDATE UPGRADE FORCE
親トピック: ALTER
9.7.1.6 ALTER THRESHOLD
用途
ALTER THRESHOLD
コマンドは、すべてのしきい値または指定したしきい値の属性値を更新します。
構文
ALTER THRESHOLD { ALL |threshold_name
[,threshold_name
...] }attribute_name
=attribute_value
[,attribute_name
=attribute_value
]...
使用上のノート
ALTER
コマンドで変更可能な属性は、例9-53でmodifiable
として示されます。
例
例9-32は、しきい値の属性を変更する方法を示しています。
例9-32 しきい値の属性の変更
DBMCLI> ALTER THRESHOLD temp warning=30 DBMCLI> ALTER THRESHOLD ALL occurrences=3
9.7.1.7 ALTER USER
用途
ALTER USER
コマンドは、ユーザーの属性を変更します。
構文
ALTER USER username attribute_name = attribute_value \
[, attribute_name = attribute_value, ...]
使用上のノート
-
usernameを
root
、dbmadmin
またはdbmmonitor
にすることはできません。これらは予約されています。 -
ユーザー名は一意である必要があります。
-
新しいユーザーのパスワードの入力が求められます。パスワードには、少なくとも1つの数字、1つの小文字および1つの大文字を使用した、12から40文字の英数字または特殊文字!@#$%^&*()である必要があります。Oracle Exadata System Softwareリリース18.1.0.0.0以降、パスワードの長さは8から40文字にすることができ、特殊文字(-および_)を使用することもできます。
-
新しいパスワードをユーザーの現在のパスワードと同じにすることはできません。
例9-33 ALTER USERコマンドの使用
DBMCLI> ALTER USER scott password=TOPsecret2345
親トピック: ALTER
9.7.2 CREATE
用途
CREATE
コマンドは、新規のオブジェクトを作成し、初期属性をオブジェクトに割り当てます。
構文
CREATE object_type [name] [attributename=attribute_value [, attributename=attribute_value]...]
使用上のノート
-
object_typeは次のとおりです。
-
DBSERVER
-
DIAGPACK
-
ROLE
-
THRESHOLD
-
USER
-
-
nameは、新規オブジェクトの名前です。
-
attribute_valueは、object_typeの変更可能な属性の名前です。
-
attribute_valueは、属性の初期設定です。
-
複数のオブジェクトが
CREATE
コマンドのターゲットとして有効な場合は、正常に実行されない場合があります。エラーが発生するとコマンドが中断され、残りのオブジェクトは作成されません。
関連トピック
親トピック: DBMCLIコマンド・リファレンス
9.7.2.1 CREATE DBSERVER
用途
CREATE DBSERVER
コマンドは、DBSERVER
オブジェクト・タイプを作成します。
構文
CREATE DBSERVER [name
]
[interconnect1=intValue1 [, interconnect2=intValue2 ...]]
[ { , ipaddress1=ipValue1 [, ipaddress2=ipValue2 ...] }]
[, attributeName = attributeValue ...]
使用上のノート
設定可能な属性は、DESCRIBE DBSERVER
でmodifiable
として示されます。
-
このコマンドを使用すると、ASR値を
snmpSubscriber
属性に割当てできます。 -
名前を指定しない場合、デフォルトにより、データベース・サーバー名は、ネットワーク名のハイフンをアンダースコアで置換したサーバーのネットワーク・ホスト名に設定されます。ネットワーク名は、
uname -n
コマンドで表示できます。データベース・サーバー名を変更する場合、一意のデータベース・サーバー名を選択する必要があります。名前を指定する場合は、名前がガイドラインを満たしていることを確認します。
-
1から4つのインターコネクトを指定できます。
interconnect2
属性が指定されている場合は、interconnect1
属性を指定する必要があります。interconnect3
が指定されている場合は、interconnect1
属性とinterconnect2
属性を指定する必要があります。 -
interconnectn
とipaddressn
を指定すると、ipaddressn
エントリが自動的に/etc/oracle/cell/network-config/cellinit.ora
ファイルに書き込まれます。 -
インターコネクトには、RDMAネットワーク・ファブリック(
ibN
またはreN
)が使用されます。 -
Oracle Exadata System Softwareリリース19.1.0以降では、
httpsAccess
属性を使用して、HTTPを介してRESTfulサービスにアクセスできるユーザーを制御するIPアドレスまたはIPサブネット・マスクのリストを指定できます。httpsAccess
に指定する値は、以前の値を上書きします。httpsAccess
に次の値を使用できます。ALL
— すべてのホストへのアクセスを許可します(デフォルト)NONE
— HTTPsポートを完全に無効化しますIP1, IP2,..., IPn
— IPアドレスIP1、IP2...、IPnを持つホストへのアクセスのみを許可します。IPnはIPv4、IPv4サブネット、IPv6またはIPv4埋込みIPv6形式の有効なIPアドレスです。アクセス制御リストには、最大512個のIPアドレスを指定できます。
また、1つのIPアドレスのかわりに、
/
文字を使用してサブネット・マスクでIPアドレスの範囲を指定できます。たとえば、範囲'192.168.10.0/24'
は、192.168.10.1から192.168.10.255のIPアドレスを持つホストに対応します。IPアドレス範囲を指定する場合は、IPアドレス文字列を引用符で囲む必要があります。
例
例9-34は、interconnectn
属性を指定したCREATE DBSERVER
コマンドを示しています。
例9-35は、RESTfulサーバーへのHTTPsアクセスを一連のホストに制限するDBSERVER
オブジェクトを作成する方法を示しています。
例9-34 DBサーバーの作成とDBSERVERオブジェクトのinterconnectn属性の設定
InfiniBandネットワーク・ファブリックを使用するラックの場合:
DBMCLI> CREATE DBSERVER interconnect1=ib0, interconnect2=ib1
RoCEネットワーク・ファブリックを使用するラックの場合:
DBMCLI> CREATE DBSERVER interconnect1=re0, interconnect2=re1
例9-35 制限されたHTTPsアクセスによるDBServerの作成
この例は、192.168.10.1から192.168.10.255までの範囲でIPアドレスを持つホストからのみHTTPsポート・アクセスを許可するDBSERVER
オブジェクトを作成する方法を示しています。
InfiniBandネットワーク・ファブリックを使用するラックの場合:
DBMCLI> CREATE DBSERVER interconnect1=ib0, httpsAccess="192.168.10.0/24"
RoCEネットワーク・ファブリックを使用するラックの場合:
DBMCLI> CREATE DBSERVER interconnect1=re0, httpsAccess="192.168.10.0/24"
親トピック: CREATE
9.7.2.2 CREATE DIAGPACK
用途
CREATE DIAGPACK
コマンドは、診断パッケージを作成し、これにはシステムの問題のトラブルシューティングに使用できるログおよびトレースが含まれます。必要に応じて、このパッケージをOracleサポートに送信することもできます。
構文
CREATE DIAGPACK packStartTime=time, [durationInHrs=duration]
または
CREATE DIAGPACK alertName=alertName
使用上のノート
アラートが発生した場合、診断パッケージは自動的に作成されます。このパッケージには、アラートに関連するログおよびトレースが含まれます。
CREATE DIAGPACK
コマンドを使用して、手動で診断パッケージを生成できます。
-
packStartTime
パラメータは、ログおよびトレースの収集を開始する時間を指定します。packStartTime
の書式は次のとおりです。yyyy_MM_ddTHH_mm_ss
たとえば:
2015_07_07T09_00_00
packStartTime
にキーワードnow
を指定することもできます。packStartTime
には、将来の時間および7日より前の時間は指定できません。packStartTime
の値は、診断パッケージの名前の一部として使用されます。 -
durationInHrs
パラメータは、診断パッケージに含めるログおよびトレースの時間数を指定します。有効な値は、1
(デフォルト)から6
です。すべての診断パッケージには、
packStartTime
の1時間前および1時間後のログが含まれます。たとえば、時間として12_00_00を指定した場合、終了時間が将来でなければ、11_00_00から13_00_00のログが収集されます。 -
alertName
パラメータで、診断パッケージを作成するアラート名を指定します。LIST ALERTHISTORY
コマンドを実行して、アラート名を表示できます。
診断パッケージの名前
診断パッケージの名前は、次の形式になります。
hostname + packStartTime + unique package ID
たとえば: scaqab04adm08_2016_05_17T11_58_54_5_1.tar.bz2
アラートの場合、診断パッケージの名前は次の形式になります。
hostname + timestamp of when the package was created + alert ID
たとえば: scaqab04adm08_2016_05_17T11_58_54_5_1.tar.bz
診断パッケージの場所
診断パッケージの場所は/opt/oracle/dbserver/dbms/deploy/log
です。
診断パッケージのステータス
LIST DIAGPACKコマンドを実行して、システム内の診断パッケージのリストおよびそのステータスを取得できます。
診断パッケージの作成、リストおよびダウンロードに必要な権限
診断パッケージをダウンロードするには、事前にユーザーにロールを付与する必要があります。DBMCLIを使用して、次の権限をロールに付与します。-
診断パッケージを作成する権限:
grant privilege CREATE ON DIAGPACK to ROLE role
-
診断パッケージをリストし、そのステータスをチェックする権限:
grant privilege LIST ON DIAGPACK to ROLE role
-
診断パッケージをダウンロードする権限:
grant privilege DOWNLOAD ON DIAGPACK to ROLE role
その後、このロールをユーザーに付与できます。たとえば、ロールにdiagpack_role
,という名前を付けた場合、次のコマンドでユーザーfred
にロールを付与します。
DBMCLI> GRANT ROLE diagpack_role TO USER fred
デプロイ中、Oracle Exadata Deployment Assistant (OEDA)によってCELLDIAGという名前のExadataストレージ・ソフトウェア・ユーザーが作成されます。このユーザーを使用して、ExaCLIまたはREST API経由でリモートからセルに接続できます。このユーザーには診断パッケージの作成、表示およびダウンロードの権限があります。
診断パッケージのダウンロード
次のいずれかの方法で診断パッケージをダウンロードできます。診断パッケージをダウンロードする前に、DOWNLOAD ON DIAGPACK権限が必要であることに注意してください。-
REST APIの使用
-
名前によって診断パッケージをダウンロードするには、次のURLを使用します。ここで、hostnameにはサーバーのホスト名を、diagpacknameには診断パッケージの名前を指定します。URLは、セキュアなソケット・ポート(デフォルトは7879)を指している必要があります。
https://hostname:7879/diagpack/download?name=diagpackname
ユーザーがまだログインしていない場合、このURLでは、ユーザー名とパスワードの入力を求めるプロンプトが表示されます。
診断パッケージには、次のようにアクセスすることもできます
https://hostname:7879/diagpack
次に例を示します。
https://dbnode01.example.com:7879/diagpack
このページでは、次のようにログインするユーザー名を要求されます。
User: fred Password: *******
ユーザーの権限に基づいて、このページの異なるセクションが非表示になります。ユーザーがCREATE ON DIAGPACK権限を持っていない場合は、新しいdiagpackを作成するためのフォームが表示されません。同様に、ユーザーがLIST ON DIAGPACK権限を持っていない場合は、アラートおよびその診断パッケージのリストが表示されません。
アラート名によって診断パッケージをダウンロードするには、次のURLを使用します。ここで、hostnameにはサーバーのホスト名を、alertNameには診断パッケージのアラート名を指定します。
https://hostname:7879/diagpack/download?alert=alertName
これは、AlertHistoryで使用されるものと同じアラート名です。ステートレス・アラートでは1、2、3、ステートフル・アラートでは1_1、2_1、3_1、3_2のようになります。
-
-
ExaCLIの
download
コマンドを使用するExaCLIにより、計算ノードからリモートでストレージ・ノード上のCellCLIコマンドを実行できます。
download
コマンドを実行するには、計算ノードで次のコマンドを実行します。-
ExaCLIを起動し、診断パックが含まれるセルに接続します。次のようなコマンドを使用します。ここで、hostnameにはセルのホスト名を指定します。
exacli -l celladministrator -c hostname Password=********
-
download
コマンドを実行します。次のようなコマンドを使用します。ここで、nameにはダウンロードする診断パッケージの名前を、destinationFolderには、ダウンロードされる診断パッケージを保存するディレクトリを指定します。exacli> download diagpack name destinationFolder
-
-
アラートの電子メールから診断パッケージを取得する
アラートの電子メールには、INFO、CLEARおよびWARNINGを除く、すべてのアラートの診断パッケージが含まれています。診断パッケージは、クリティカル・アラートのみに生成されます。
電子メールへの診断パッケージの添付をオフにする
電子メールへの診断パッケージの添付をオフにするには、コマンド alter dbserver diagPackEmailAttach=FALSE
を使用します。診断パッケージは引き続き生成され、システムに格納されます。診断パッケージをダウンロードするには、「診断パッケージのダウンロード」の項を参照してください。
例
例9-36 packStartTimeでの「now」の使用
この例では、開始時間としてNOW
を使用し、デフォルトの継続時間の1時間で診断パッケージを作成します。
出力は、ディレクトリ/opt/oracle/dbserver/dbms/deploy/log
の単一の圧縮ファイルです。
DBMCLI> create diagpack packStartTime="now"
Processing: dm01db01_diag_2015_07_08T17_53_58_1
Use 'list diagPack' to check its status.
例9-37 継続時間の指定
この例では、/opt/oracle/dbserver/dbms/deploy/log
に3つの診断パッケージが作成されます。
-
最初のパッケージの開始時間は
2015_07_07T09_00_00
です。 -
第2のパッケージの開始時間は
2015_07_07T10_00_00
です。 -
第3のパッケージの開始時間は
2015_07_07T11_00_00
です。
DBMCLI> create diagpack packStartTime="2015_07_07T09_00_00", durationInHrs=3
Processing: dm01db01_diag_2015_07_07T09_00_00_1
dm01db01_diag_2015_07_07T10_00_00_1 (In queue...)
dm01db01_diag_2015_07_07T11_00_00_1 (In queue...)
Use 'list diagPack' to check its status.
親トピック: CREATE
9.7.2.3 CREATE ROLE
用途
CREATE ROLE
コマンドは、データベース・サーバーにアクセスするユーザーのロールを作成します。
構文
CREATE ROLErole_name
1 [,role_name2
, ...]
使用上のノート
ロールは一意である必要があります。
例
例9-38は、ロールの作成方法を示しています。
例9-38 ロールの作成
DBMCLI> CREATE ROLE dbmonitor
親トピック: CREATE
9.7.2.4 CREATE THRESHOLD
用途
CREATE THRESHOLD
コマンドは、メトリック・アラートの生成条件を指定するしきい値オブジェクトを作成します。
構文
CREATE THRESHOLD name attributename=value [, attributename=value]...
使用上のノート
指定可能な属性は、comparison
、critical
、occurrences
、observation
およびwarning
です。
-
name引数は必須です。名前はメトリック名とオブジェクト名で構成され、書式は
metricName.objectName
(db_io_rq_sm_sec.db123
やct_io_wt_rq.interactive
など)になります。LIST METRICCURRENT
metric
コマンドを使用して、メトリックの使用可能なオブジェクト名を表示します。オブジェクト名はオプションです。 -
オブジェクト名が指定されない場合、指定のメトリックのすべてのメトリック・オブジェクトにしきい値が適用されます。
-
comparison
属性は必須で、条件値が付きます。値は、'<'
、'<='
、'='
、'>='
または'>'
にする必要があります。 -
occurrences
属性では、状態変更をトリガーするしきい値を超える測定値の連続する数を指定します。発生および観測件数を指定する場合は、サンプル平均数の連続する発生数を、アラートの原因となった観測件数より多く指定する必要があります。たとえば、次の5つの観測(
observations=5
)がデータベース・サーバー上で発生した場合、連続する発生件数(occurrences=2
)の値が5および15のため、平均サンプル数は10になります。Observation 1: 0 Observation 2: 30 Observation 3: 0 Observation 4: 5 Observation 5: 15
-
observation
属性は、測定値の平均を計算するために使用される測定値の数です。 -
warning
またはcritical
に設定される値の状態変更により、ステートフル・アラートが生成されます。
例9-39 しきい値の作成
この例は、しきい値を作成する方法を示しています。
DBMCLI> CREATE THRESHOLD temp comparison='>', critical=30
関連項目:
-
メトリックの詳細は、Oracle Exadata System Softwareユーザーズ・ガイドを参照してください
-
メトリックおよびしきい値の詳細は、「LIST ALERTDEFINITION」を参照してください。
親トピック: CREATE
9.7.2.5 CREATE USER
用途
CREATE USER
コマンドは、ユーザーを作成します。
構文
CREATE USER name PASSWORD = *
使用上のノート
-
ユーザー名は一意である必要があります。
-
usernameを
root
、dbmadmin
またはdbmmonitor
にすることはできません。これらは予約されています。 -
新しいユーザーのパスワードの入力が求められます。パスワードには、少なくとも1つの数字、1つの小文字および1つの大文字を使用した、12から40文字の英数字または特殊文字!@#$%^&*()である必要があります。Oracle Exadata System Softwareリリース18.1.0.0.0以降、パスワードの長さは8から40文字にすることができ、特殊文字(-および_)を使用することもできます。
-
新しいパスワードをユーザーの現在のパスワードと同じにすることはできません。
例9-40 ユーザーの作成
DBMCLI> CREATE USER jdoe PASSWORD = *
password:
Confirm password: password
User jdoe successfully created.
親トピック: CREATE
9.7.3 DESCRIBE
用途
DESCRIBE
コマンドは、引数として指定されるオブジェクト・タイプの属性のリストを表示します。modifiable
というタグは、ALTERコマンドを使用して属性を変更できるかどうかを示しています。
構文
DESCRIBE object_type
使用上のノート
-
object_typeは、サポートされるオブジェクト・タイプの1つです。
-
属性のリストは、
LIST
コマンドで引数として使用できます。 -
DESCRIBE
では、オブジェクトのすべての属性は表示されません。
- DESCRIBE ALERTDEFINITION
- DESCRIBE ALERTHISTORY
- DESCRIBE DBSERVER
- DESCRIBE IBPORT
- DESCRIBE LUN
- DESCRIBE METRICCURRENT
- DESCRIBE METRICDEFINITION
- DESCRIBE METRICHISTORY
- DESCRIBE PHYSICALDISK
- DESCRIBE ROLE
- DESCRIBE SOFTWAREHISTORY
- DESCRIBE SOFTWAREUPDATE
- DESCRIBE THRESHOLD
- DESCRIBE USER
関連トピック
親トピック: DBMCLIコマンド・リファレンス
9.7.3.1 DESCRIBE ALERTDEFINITION
用途
DESCRIBE ALERTDEFINITION
コマンドは、ALERTDEFINITION
オブジェクト・タイプの属性のリストを表示します。
構文
DESCRIBE ALERTDEFINITION
使用上のノート
表9-2は、DESCRIBE ALERTDEFINITION
コマンドの属性を示しています。
表9-2 DESCRIBE ALERTDEFINITIONの属性
属性 | 説明 |
---|---|
alertShortName |
アラートの省略名。アラートの基準がメトリックの場合、省略名は対応するメトリックの |
alertSource |
アラートのソース( |
alertType |
アラートのタイプ。値はステートフルまたはステートレスです。 |
description |
アラートの説明。 |
metricName |
アラートの基準がメトリックの場合のメトリック名。 |
name |
アラートの識別子。 |
例
例9-41は、ALERTDEFINITION
オブジェクトを指定したDESCRIBE
コマンドを示しています。
例9-41 ALERTDEFINITIONオブジェクトの説明
DBMCLI> DESCRIBE ALERTDEFINITION name alertShortName alertSource alertType description metricName
親トピック: DESCRIBE
9.7.3.2 DESCRIBE ALERTHISTORY
用途
DESCRIBE ALERTHISTORY
コマンドは、ALERTHISTORY
オブジェクト・タイプの属性のリストを表示します。
構文
DESCRIBE ALERTHISTORY
使用上のノート
次の表は、DESCRIBE ALERTHISTORY
コマンドの属性を示しています。
表9-3 DESCRIBE ALERTHISTORYの属性
属性 | 説明 |
---|---|
alertAction |
このアラートで実行する推奨操作。 |
alertMessage |
アラートの簡単な説明。 |
alertSequenceID |
アラートの一意の順序ID。 |
alertShortName |
アラートの省略名。アラートの基準がメトリックの場合、省略名は対応するメトリックの |
alertType |
アラートのタイプ。値はステートフルまたはステートレスです。
|
beginTime |
アラートによる状態変更が開始された時点のタイム・スタンプ。 |
endTime |
アラートによる状態変更が終了した時点のタイプ・スタンプ。 |
examinedBy |
アラートを確認した管理者。 |
failedMail |
通知が失敗した場合に送信する電子メールの受信者。 |
failedSNMP |
通知が失敗した場合に送信するSNMPサブスクライバ。 |
metricObjectName |
メトリックしきい値にアラートを発生させるデータベース・サーバー・ディスクなどのオブジェクト。 |
metricValue |
アラートを生成するメトリックの値。 |
name |
アラートの一意の識別子。 |
notificationState |
サブスクライバにアラート・メッセージを通知する場合の状況を示す番号。
|
sequenceBeginTime |
アラートの順序IDが最初に作成された時点のタイム・スタンプ。 |
severity |
重大度のレベル。値は |
例
例9-42は、ALERTHISTORY
オブジェクトを指定したDESCRIBE
コマンドを示しています。
例9-42 ALERTHISTORYオブジェクトの説明
DBMCLI> DESCRIBE ALERTHISTORY
name
alertAction
alertMessage
alertSequenceID
alertShortName
alertType
beginTime
endTime
examinedBy modifiable
failedMail
failedSNMP
metricObjectName
metricValue
notificationState
sequenceBeginTime
severity
関連トピック
親トピック: DESCRIBE
9.7.3.3 DESCRIBE DBSERVER
用途
DESCRIBE DBSERVER
コマンドは、DBSERVER
オブジェクト・タイプの属性のリストを表示します。
構文
DESCRIBE DBSERVER
使用上のノート
次の表は、DESCRIBE DBSERVER
コマンドの属性を示しています。
表9-4 DESCRIBE DBSERVERの属性
属性 | 説明 |
---|---|
accountLockInDays |
パスワードが期限切れになってからユーザー・アカウントがロックされるまでの日数。 |
|
ハード・ディスク・コントローラのバッテリ・バックアップ・ユニット(BBU)のステータス。 |
|
ユーザー指定のテキスト文字列。 |
|
データベース・サーバー上のCPUコアの数。
|
|
オペレーティング・システムによって この値はハイパー・スレッドに影響するため、常に
|
|
ADRファイルの保存日数。デフォルト値は7日間です。 |
|
診断パッケージをアラート電子メールの添付として含めるかどうか。デフォルトは |
|
診断パッケージの自動アップロード機能を有効にするかどうか。デフォルトは |
|
電子メール・メッセージのファイル形式。値はHTMLまたはtextです。 |
|
動作中のファンの数およびファンの合計数。working/totalとして表示されます。 |
|
ファンのステータス。値は |
|
Exadata RESTfulサービスへのHTTPsポート・アクセス用のIPアドレスの制御リスト |
|
ハードウェア・ベンダーによって提供されるグローバル一意識別子(GUID)。 |
|
データベース・サーバーの1から4までのインターコネクト。たとえば、bondeth0です。 |
|
ネットワーク・インターコネクトの数。 |
|
データベース・サーバーの1から4までのIPアドレス。 |
|
ホスト・カーネル・ソフトウェアのバージョン。 |
|
ユーザーが指定するセル・ハードウェアの物理ロケーション。 |
|
セルLOCATE LEDのステータス。値はonまたはoffです。 |
|
アラート通知の送信に使用される電子メール・リレー・サーバーの完全修飾ドメイン名。この属性は、DNSによって、 |
|
ベンダーにより提供されるセル・ハードウェアの型およびモデル。 |
|
管理サーバーがメトリック収集を実行するかどうかを示すインジケータ。値は |
|
メトリック履歴ファイルの保存日数。デフォルト値は7日間です。 |
|
管理サーバーのバージョン。 |
|
データベース・サーバーの名前。 |
|
アラートの通知メソッド。値は |
|
サブスクライバに送信する重大度アラートのインジケータ。notificationPolicyの値は、none、または |
|
電源数。working/totalとして表示されます。 |
|
電源のステータス。値は |
|
ユーザーのパスワードが期限切れになるまでの日数。 |
|
ユーザーのパスワードが期限切れになる前に、ログイン時に警告メッセージが発行される日数。 |
|
イメージングが成功したかどうかを判断するためのインジケータ。 |
|
セル・ソフトウェアのパッチ番号(11223344など)。 |
|
セル・ソフトウェアのリリース番号(11.2.2.3.0など)。 |
|
RESTサービスを介してリモートでユーザー・パスワードを変更できるかどうか。 |
|
しきい値や通知などの設定を最後の既知の値にリストアするサーバー・レスキューの後で実行できるコマンドのリスト。 |
|
アラート通知の |
|
アラート通知の |
|
アラート通知の送信に使用される電子メール・サーバーのポート。 |
|
SNMPアラート通知をサブスクライブするホストのリスト。 |
|
電子メールの送信先のアドレス。電子メール・アドレスは、複数のサブスクライバにアラートを通知できるように、引用符で囲んだカンマ区切りのリストにできます。 |
|
アラート通知にSecure Socket Layer (SSL)暗号化を使用するための仕様。 |
|
データベース・サーバーのステータス。 |
|
システム・ログイン・ユーティリティsyslogdのルール。 |
|
BMCから取得されるセルの現在の温度(摂氏)。 |
|
温度のステータス。値は |
|
トレース・メッセージの書込みレベル。このレベルは、有効なJavaロギング・レベル( |
|
システムが再起動してからの時間(days,hours:minutes)。 |
例
例9-43 DBSERVERオブジェクトの説明
DBMCLI> DESCRIBE DBSERVER
name modifiable
bbuStatus
comment modifiable
coreCount
cpuCount
diagHistoryDays modifiable
diagPackEmailAttach modifiable
diagPackUploadEnabled modifiable
emailFormat modifiable
emailSubscriber modifiable
fanCount
fanStatus
httpsAccess modifiable
iaasIdleInUse modifiable
iaasMode modifiable
iaasReason modifiable
id
interconnectCount
interconnect1 modifiable
interconnect2 modifiable
interconnect3 modifiable
interconnect4 modifiable
interconnect5 modifiable
interconnect6 modifiable
interconnect7 modifiable
interconnect8 modifiable
ipaddress1
ipaddress2
ipaddress3
ipaddress4
ipaddress5
ipaddress6
ipaddress7
ipaddress8
kernelVersion
locatorLEDStatus
location modifiable
mailServer modifiable
makeModel
metricCollection modifiable
metricHistoryDays modifiable
msVersion
notificationMethod modifiable
notificationPolicy modifiable
pendingCoreCount modifiable
powerCount
powerStatus
releaseImageStatus
releaseVersion
releaseTrackingBug
securityCert modifiable
smtpFrom modifiable
smtpFromAddr modifiable
smtpPort modifiable
smtpToAddr modifiable
smtpUseSSL modifiable
snmpSubscriber modifiable
snmpUser modifiable
status
syslogConf modifiable
temperatureReading
temperatureStatus
traceLevel modifiable
upTime
msStatus
rsStatus
親トピック: DESCRIBE
9.7.3.4 DESCRIBE IBPORT
用途
DESCRIBE IBPORT
コマンドは、IBPORTオブジェクト・タイプの属性のリストを表示します。
ノート:
このコマンドは、RoCEネットワーク・ファブリックを使用するExadata Database Machineサーバーでは機能しません。構文
DESCRIBE IBPORT
使用上のノート
表9-5 DESCRIBE IBPORTの属性
属性 | 説明 |
---|---|
activeSlave |
対象のポートが、ボンディングされたIPの現在アクティブなポートかどうかを示すインジケータ。 |
dataRate |
InfiniBandネットワーク・ファブリック・ポートのデータ率。 |
hcaFWVersion |
ホスト・チャネル・アダプタのファームウェアのバージョン。 |
id |
InfiniBandネットワーク・ファブリック・ポートのグローバル一意識別子(GUID)。 |
lid |
InfiniBandネットワーク・ファブリック・ポートのローカル識別子。サブネット内で一意であり、スイッチによって16ビットの識別子がネットワーク内のルーティングに使用されます。 |
linkDowned |
ポートのトレーニング・ステート・マシンがリンク・エラーのリカバリ処理に失敗し、リンクがダウンした回数。 |
linkIntegrityErrs |
リンク完全性エラーの数。 |
linkRecovers |
ポートのトレーニング・ステート・マシンがリンク・エラーのリカバリ処理を正常に完了した回数。 |
name |
InfiniBandネットワーク・ファブリック・ポートの名前。 |
physLinkState |
物理リンクの状態。 |
portNumber |
InfiniBandネットワーク・ファブリック・ポートのポート番号。 |
rcvConstraintErrs |
InfiniBandネットワーク・ファブリック・ポートで発生した受信制約エラーの数。 |
rcvData |
InfiniBandネットワーク・ファブリック・ポートで受信した32ビット・データのワード数。 |
rcvErrs |
InfiniBandネットワーク・ファブリック・ポートで受信した、エラーを含むパケットの数。 |
rcvRemotePhysErrs |
InfiniBandネットワーク・ファブリック・ポートで発生した物理エラーの数。 |
状態 |
リンクの状態。 |
symbolErrs |
InfiniBandネットワーク・ファブリック・ポートで発生した軽度なリンク・エラーの数。 |
vl15Dropped |
リソースの制約(バッファ不足など)が原因で、InfiniBandネットワーク・ファブリック・ポートによって廃棄された着信のVL15パケットの数。 |
xmtConstraintErrs |
InfiniBandネットワーク・ファブリック・ポートで発生した送信制約エラーの数。 |
xmtData |
InfiniBandネットワーク・ファブリック・ポート上で送信した32ビット・データのワード数。 |
xmtDiscards |
ポートのダウンまたは輻輳によってInfiniBandネットワーク・ファブリック・ポートで破棄されたアウトバンド・パケットの数。 |
例9-44 IBPORTオブジェクトの説明
この例は、DESCRIBE IBPORT
コマンドで得られる可能性のある出力を示しています。
DBMCLI> DESCRIBE IBPORT
name
activeSlave
dataRate
hcaFWVersion
id
lid
linkDowned
linkIntegrityErrs
linkRecovers
physLinkState
portNumber
rcvConstraintErrs
rcvData
rcvErrs
rcvRemotePhysErrs
status
symbolErrs
vl15Dropped
xmtConstraintErrs
xmtData
xmtDiscards
親トピック: DESCRIBE
9.7.3.5 DESCRIBE LUN
用途
DESCRIBE LUN
コマンドは、LUN
オブジェクト・タイプの属性のリストを表示します。
構文
DESCRIBE LUN
使用上のノート
表9-6 DESCRIBE LUNの属性
属性 | 説明 |
---|---|
deviceName |
LUNのオペレーティング・システム・デバイス名。たとえば、 |
diskType |
ディスクのタイプ。 |
errorCount |
このLUNでのエラー数。 |
id |
システムによって割り当てられる識別子。 |
lunSize |
データベース・サーバー・ディスクに変換される前の、LUNのRawサイズ。 |
lunUID |
システムによって割り当てられる一意の識別子。 |
name |
LUNに割り当てられる一意の名前。IDが一意でない場合は、異なる(拡張形式)LUN IDになる場合があります。 |
overProvisioning |
フラッシュ・ストレージ内のブロックうち、特定のLUNで今後も使用できるようにオーバー・プロビジョニングされたブロックの割合を示すインジケータ。この属性は、フラッシュ・ディスク専用です。 |
raidLevel |
LUNで使用されるRAIDレベルの値。たとえば、 |
状態 |
LUNのステータス。値は |
例9-45 LUNオブジェクトの説明
この例は、LUN
オブジェクトを指定したDESCRIBE
コマンドを示しています。
DBMCLI> DESCRIBE LUN
name
deviceName
diskType
errorCount
id
lunSize
lunUID
overProvisioning
raidLevel
status
親トピック: DESCRIBE
9.7.3.6 DESCRIBE METRICCURRENT
用途
DESCRIBE METRICCURRENT
コマンドは、METRICCURRENT
オブジェクト・タイプの属性のリストを表示します。
構文
DESCRIBE METRICCURRENT
使用上のノート
表9-7 DESCRIBE METRICCURRENTの属性
属性 | 説明 |
---|---|
alertState |
アラート状態のインジケータ。値は |
collectionTime |
メトリック値が収集された時点のタイム・スタンプ。 |
metricObjectName |
計測中のデータベース・サーバーなど、オブジェクトの名前。 |
metricType |
統計がどのように作成または定義されたかを示す仕様。 |
metricValue |
メトリックが収集された時点の値。 |
name |
現在のメトリックの一意の名前。 |
objectType |
オプションは、 |
例9-46 METRICCURRENTオブジェクトの説明
この例は、METRICCURRENT
オブジェクトを指定したDESCRIBE
コマンドを示しています。
DBMCLI> DESCRIBE METRICCURRENT
name
alertState
collectionTime
metricObjectName
metricType
metricValue
objectType
関連トピック
親トピック: DESCRIBE
9.7.3.7 DESCRIBE METRICDEFINITION
用途
DESCRIBE METRICDEFINITION
コマンドは、METRICDEFINITION
オブジェクト・タイプの属性のリストを表示します。
構文
DESCRIBE METRICDEFINITION
使用上のノート
表9-8は、DESCRIBE METRICDEFINITION
コマンドの属性を示しています。
表9-8 DESCRIBE METRICDEFINITIONの属性
例9-47 METRICDEFINITIONオブジェクトの説明
この例は、METRICDEFINITION
オブジェクトを指定したDESCRIBE
コマンドを示しています。
DBMCLI> DESCRIBE METRICDEFINITION
name
description
metricType
objectType
persistencePolicy
unit
親トピック: DESCRIBE
9.7.3.8 DESCRIBE METRICHISTORY
用途
DESCRIBE METRICHISTORY
コマンドは、METRICHISTORY
オブジェクト・タイプの属性のリストを表示します。
構文
DESCRIBE METRICHISTORY
使用上のノート
表9-9は、DESCRIBE METRICHISTORY
コマンドの属性を示しています。
表9-9 DESCRIBE METRICHISTORYの属性
属性 | 説明 |
---|---|
alertState |
アラート状態のインジケータ。値は |
collectionTime |
メトリック値が収集された時点のタイム・スタンプ。 |
memory |
管理サーバー・メモリーのメトリック。この属性は、収集時間が1時間未満の場合に、 |
metricObjectName |
計測中のデータベース・サーバー・ディスクなど、オブジェクトの名前。 |
metricType |
統計がどのように作成または定義されたかを示す仕様。 |
metricValue |
メトリックが収集された時点の値。 |
metricValueAvg |
メトリックの平均値。 |
metricValueMax |
メトリックの最大値。 |
metricValueMin |
メトリックの最小値。 |
name |
現在のメトリックの一意の名前。 |
objectType |
オプションは、 |
over |
集計用の時間の指定(分単位)。この属性は、 |
例9-48 METRICHISTORYオブジェクトの説明
この例は、METRICHISTORY
オブジェクトを指定したDESCRIBE
コマンドを示しています。
DBMCLI> DESCRIBE METRICHISTORY
name
alertState
collectionTime
memory
metricObjectName
metricType
metricValue
metricValueAvg
metricValueMax
metricValueMin
objectType
over
親トピック: DESCRIBE
9.7.3.9 DESCRIBE PHYSICALDISK
用途
DESCRIBE PHYSICALDISK
コマンドは、PHYSICALDISK
オブジェクト・タイプの属性のリストを表示します。
構文
DESCRIBE PHYSICALDISK
使用上のノート
次の表は、DESCRIBE PHYSICALDISK
コマンドの属性を示しています。
表9-10 DESCRIBE PHYSICALDISKの属性
属性 | 説明 |
---|---|
|
コントローラのバージョン。この属性は、HP Oracle Database Machine上のOracle Exadata System Softwareにのみ適用されます。 |
|
ディスクのタイプ( |
|
ハード・ディスク・エンクロージャの識別子。この属性は、Oracle Exadata Storage Server上のOracle Exadata System Softwareにのみ適用されます。 |
|
ディスクでのコマンド・タイムアウトSCSIエラーの数。この属性は、HP Oracle Database Machine上のOracle Exadata System Softwareにのみ適用されます。 |
|
ディスクでのハード読取りエラーの数。この属性は、HP Oracle Database Machine上のOracle Exadata System Softwareにのみ適用されます。 |
|
ディスクでのハード書込みエラーの数。この属性は、HP Oracle Database Machine上のOracle Exadata System Softwareにのみ適用されます。 |
|
ハード・ディスクでのメディア・エラーの数。この属性は、Oracle Exadata Storage Server上のOracle Exadata System Softwareにのみ適用されます。 |
|
ハード・ディスクでの未分類エラーの数。この属性は、HP Oracle Database Machine上のOracle Exadata System Softwareにのみ適用されます。 |
|
ディスクでのSCSIシーク・エラーの数。この属性は、HP Oracle Database Machine上のOracle Exadata System Softwareにのみ適用されます。 |
|
ディスクがラックに挿入された回数。この属性は、HP Oracle Database Machine上のOracle Exadata System Softwareにのみ適用されます。 |
|
ディスクでの最新のエラーのタイプ。この属性は、HP Oracle Database Machine上のOracle Exadata System Softwareにのみ適用されます。 |
|
このディスクから変換されたLUNのリスト。 |
|
システムによって提供されるモデルの説明。 |
|
物理ディスクの一意の名前。 |
|
ディスクのファームウェアのシステム割当て名。この属性は、HP Oracle Database Machine上のOracle Exadata System Softwareにのみ適用されます。 |
|
ディスクが挿入された時刻。 |
|
ハード・ディスクで使用されているインタフェース・タイプ。たとえば、 |
|
このディスクのコントローラのポート。この属性は、HP Oracle Database Machine上のOracle Exadata System Softwareにのみ適用されます。 |
|
ディスクの回転数(毎分)。この属性は、HP Oracle Database Machine上のOracle Exadata System Softwareにのみ適用されます。 |
|
システムで割り当てられた一意のID。 |
|
ディスクのサイズ(バイト単位)。 |
|
ディスクの用途。たとえば、 |
|
物理ディスクのすべてのセクター再マップ操作の回数。この属性は、HP Oracle Database Machine上のOracle Exadata System Softwareにのみ適用されます。 |
|
ディスクの物理的な場所。 |
|
物理ディスクのステータス。値は次のとおりです。
|
例9-49 データベース・サーバーのハード・ドライブ上のPHYSICALDISKオブジェクトの説明
この例は、Oracle Exadata Storage Server上のPHYSICALDISK
オブジェクトを指定したDESCRIBE
コマンドを示しています。
DBMCLI> DESCRIBE PHYSICALDISK
name
ctrlFirmware
diskType
enclosureDeviceId
errMediaCount
errOtherCount
luns
makeModel
physicalFirmware
physicalInsertTime
physicalInterface
physicalSerial
physicalSize
slotNumber
status
親トピック: DESCRIBE
9.7.3.10 DESCRIBE ROLE
用途
DESCRIBE ROLE
コマンドは、ROLE
オブジェクト・タイプの属性のリストを表示します。
構文
DESCRIBE ROLE
使用上のノート
表9-11 DESCRIBE ROLEの属性
属性 | 説明 |
---|---|
|
ロールを割り当てられたユーザーの一意の名前。 |
|
ロールに付与されている権限。 |
例
例9-50 ROLEオブジェクトの説明
この例は、ROLE
オブジェクトを指定したDESCRIBE
コマンドを示しています。
DBMCLI> DESCRIBE ROLE
name
privileges
親トピック: DESCRIBE
9.7.3.11 DESCRIBE SOFTWAREHISTORY
用途
DESCRIBE SOFTWAREHISTORY
コマンドは、ALERTHISTORY
オブジェクト・タイプの属性のリストを表示します。
構文
DESCRIBE SOFTWAREHISTORY
使用上のノート
DESCRIBE SOFTWAREHISTORY
コマンドの属性には、次のものがあります。
-
name
: ソフトウェア更新の名前 -
status
: ソフトウェア更新のステータス
例9-51 SOFTWAREHISTORYオブジェクトの説明
CellCLI> DESCRIBE SOFTWAREHISTORY
name
status
親トピック: DESCRIBE
9.7.3.12 DESCRIBE SOFTWAREUPDATE
用途
DESCRIBE SOFTWAREUPDATE
コマンドは、SOFTWAREUPDATE
オブジェクト・タイプの属性のリストを表示します。
構文
DESCRIBE SOFTWAREUPDATE
使用上のノート
DESCRIBE SOFTWAREUPDATE
コマンドの属性には、次のものがあります。
frequency
: このソフトウェア更新が自動的に実行される期間。値には、none
、daily
、weekly
またはbiweekly
を指定できます。値none
は、Oracle Exadata System Softwareリリース19.1.0以降で使用できます。name
: 更新に使用するパッチの名前またはunknown
。名前がunknown
にデフォルト設定された場合、ソフトウェアのアップデートが実行されたときに、最新のパッチがアップグレード用に選択されます。status
: このソフトウェア更新のステータス。store
: ソフトウェア更新ファイルの場所のURLtime
: ソフトウェア更新を実行する特定の日時timeLimitInMinutes
: アラートを取り消して発行するまでにセルがソフトウェアの更新を待機する分数。
例9-52 SOFTWAREUPDATEオブジェクトの説明
CellCLI> DESCRIBE SOFTWAREUPDATE
name modifiable
status
store modifiable
time modifiable
timeLimitInMinutes modifiable
親トピック: DESCRIBE
9.7.3.13 DESCRIBE THRESHOLD
用途
DESCRIBE THRESHOLD
コマンドは、THRESHOLD
オブジェクト・タイプの属性のリストを表示します。
構文
DESCRIBE THRESHOLD
使用上のノート
表9-12は、DESCRIBE THRESHOLD
コマンドの属性を示しています。
表9-12 DESCRIBE THRESHOLDの属性
属性 | 説明 |
---|---|
comparison |
メトリック値としきい値を比較して、値がしきい値に違反しているかどうかを確認する演算子(>、>=、=、<、<=)。 |
critical |
メトリック値がクリティカルの状態であるとみなされる上限値。この値を超えるとアラートが生成されます。 |
name |
しきい値の一意の名前。 |
observation |
測定値の数。この数の測定値で率メトリックを平均し、しきい値と比較されます。 |
occurrences |
メトリック値がしきい値を連続して超えた場合の上限数。この上限数を超えると指定したアラートが発行されます。 |
warning |
メトリック値が警告の状態であるとみなされる上限値。この値を超えるとアラートが生成されます。 |
例9-53 THRESHOLDオブジェクトの説明
この例は、THRESHOLD
オブジェクトを指定したDESCRIBE
コマンドを示しています。
DBMCLI> DESCRIBE THRESHOLD
name
comparison modifiable
critical modifiable
observation modifiable
occurrences modifiable
warning modifiable
親トピック: DESCRIBE
9.7.3.14 DESCRIBE USER
用途
DESCRIBE USER
コマンドは、USER
オブジェクト・タイプの属性のリストを表示します。
構文
DESCRIBE USER
使用上のノート
次の表は、DESCRIBE USER
コマンドの属性を示しています。
表9-13 DESCRIBE USERの属性
属性 | 説明 |
---|---|
|
ユーザーの一意の名前。 |
|
ユーザーに割り当てられたロール。 |
例9-54 USERオブジェクトの説明
この例は、USER
オブジェクトを指定したDESCRIBE
コマンドを示しています。
DBMCLI> DESCRIBE USER
name
roles
親トピック: DESCRIBE
9.7.4 DROP
用途
DROP
コマンドは、名前を指定したオブジェクトをデータベース・サーバーから削除するか、データベース・サーバーをリセットします。
構文
DROP object_type [object_name [, object_name]...] [options]
使用上のノート
-
object_typeは次のいずれかです。
-
ALERTHISTORY
-
DBSERVER
-
ROLE
-
THRESHOLD
-
USER
-
-
object_nameは、データベース・サーバー・ディスク、ロール、しきい値またはユーザーの名前です。
-
複数のオブジェクトが
DROP
コマンドのターゲットの場合は、正常に実行されない場合があります。エラーが発生するとコマンドが中断され、残りのオブジェクトは削除されません。
関連トピック
親トピック: DBMCLIコマンド・リファレンス
9.7.4.1 DROP ALERTHISTORY
用途
DROP ALERTHISTORY
コマンドは、データベース・サーバーのアラート履歴からアラートを削除します。
構文
DROP ALERTHISTORY {ALL | alert1
{, alert2
}, ...}
使用上のノート
-
このコマンドのalertNは、履歴から削除されるアラートの名前です。
-
ステートフル・アラートを削除する場合は、同時にアラートの順序のメンバーをすべて削除する必要があります。すべてのメンバーを削除しないと、システムによりエラーが発行されます。
例9-55 データベース・サーバーのアラート履歴の削除
DBMCLI> DROP ALERTHISTORY 1, 2_1, 2_2
親トピック: DROP
9.7.4.2 DROP DBSERVER
用途
DROP DBSERVER
は、データベース・サーバー上のMSを元の状態にリセットします。
構文
DROP DBSERVER
使用上のノート
-
データベース・サーバーに設定されたいずれのしきい値も、データベース・サーバーから削除されます。
-
DBSERVER
属性はデフォルト値に設定されます。
例9-56 データベース・サーバーの削除
DBMCLI> DROP DBSERVER
親トピック: DROP
9.7.4.3 DROP ROLE
用途
DROP ROLE
コマンドは、セルからユーザー・ロールを削除します。
構文
DROP ROLE { ALL | role_name1 [, role_name2, ...]} [FORCE]
使用上のノート
FORCE
オプションは、ユーザーにロールが付与されている場合でもロールを削除します。
例9-57 ロールの削除
DBMCLI> DROP ROLE r1,r2
親トピック: DROP
9.7.4.4 DROP SOFTWAREHISTORY
用途
DROP SOFTWAREHISTORY
コマンドは、すべての履歴または個々の更新履歴を削除します。
構文
DROP SOFTWAREHISTORY { ALL | 'update_name[,update_name...]'}
例9-58 スケジュール済ソフトウェア更新の履歴の削除
CellCLI> DROP SOFTWAREHISTORY '12.2.1.2.0.170509,12.2.1.2.0.17052'
CellCLI> DROP SOFTWAREHISTORY ALL
親トピック: DROP
9.7.4.5 DROP THRESHOLD
用途
DROP THRESHOLD
コマンドは、データベース・サーバーからすべてのしきい値または指定したしきい値を削除します。
構文
DROP THRESHOLD { ALL |threshold_name [, threshold_name ...] }
例9-59 しきい値の削除
DBMCLI> DROP THRESHOLD temp
親トピック: DROP
9.7.4.6 DROP USER
用途
DROP USER
コマンドは、データベース・サーバーからユーザーを削除します。
構文
DROP USER { ALL | user1 [, user2]... }
使用上のノート
-
user(n)は削除するユーザーの名前です。
例9-60 ユーザーの削除
DBMCLI>DROP USER jdoe
親トピック: DROP
9.7.5 GRANT
用途
GRANT
コマンドは、権限およびロールの属性を設定します。
構文
GRANT object_type [name] TO sub_object_type [sub_object_name]
使用上のノート
-
object_typeは次のとおりです。
PRIVILEGE
ROLE
-
PRIVILEGE
オブジェクト・タイプには次の値を使用できます。-
nameの書式は、次のとおりです。
{ ALL ACTIONS | action } ON { ALL OBJECTS | object } \ [{ ALL ATTRIBUTES | ATTRIBUTES attribute1 [, attribute2, ...] }] \ [{ WITH ALL OPTIONS | WITH OPTIONS option1 [, option2, ...] }]
-
sub_object_typeは
ROLE
である必要があります。 -
sub_object_nameはロールの名前です。
-
-
ROLE
オブジェクト・タイプには次を使用できます。-
nameはユーザー名です。
-
sub_object_typeは
USER
である必要があります。 -
sub_object_nameはユーザーの名前です。
-
9.7.5.1 GRANT PRIVILEGE
用途
GRANT PRIVILEGE
コマンドは、ロールにアクセス権限を設定します。
構文
GRANT PRIVILEGE { ALL ACTIONS | action } ON { ALL OBJECTS | object } \
{ ALL ATTRIBUTES | ATTRIBUTES attribute1 [, attribute2, ...] } \
{ WITH ALL OPTIONS | WITH OPTIONS option1 [, option2, ...] } \
TO ROLE { ALL | role1 [, role2, ...] }
使用上のノート
-
actionはコマンドです。例:
ALTER
、CREATE
、DESCRIBE
、DROP
、EXPORT
、IMPORT
、LIST
。ノート:
GRANT
およびREVOKE
コマンドは付与できません。-
CREATE USER
およびDROP USER
は付与できません。 -
CREATE ROLE
およびDROP ROLE
は付与できません。
-
objectはアクションのオブジェクト・タイプです。これは、任意のDBMCLIオブジェクトを指定可能です。例:
DBSERVER
、THRESHOLD
、PHYSICALDISK
、ALERTHISTORY
、ROLE
。 -
attributeはオブジェクトの属性です。オブジェクトの属性リストを取得するには、
LIST object_type
コマンドを実行します。 -
optionはオブジェクトのオプションです。例:
DETAIL
、LIMIT
、ORDER BY
、WHERE
。 -
roleは、権限を付与するロールの名前です。
-
ALL ACTIONS
引数は、すべてのアクションの権限を付与します。 -
ALL OBJECTS
引数は、すべてのオブジェクトの権限を付与します。 -
ALL ATTRIBUTES
引数は、すべての属性の権限を付与します。 -
WITH ALL OPTIONS
引数は、すべてのオプションの権限を付与します。 -
属性と
WITH OPTIONS
の指定はオプションです。これらが指定されない場合、すべての属性とオプションの権限を付与します。
例
例9-61 ロールへの権限の付与
この例は、ロールに権限を付与する方法を示しています。
DBMCLI> GRANT PRIVILEGE list on alerthistory ATTRIBUTES alertAction,alertMessage \
WITH OPTIONS detail TO ROLE dbmonitor
例9-62 すべての属性とオプションのロールへの付与
この例は、指定されたアクションとオブジェクトのすべての属性およびオプションをロールに付与する方法を示します。
DBMCLI> GRANT PRIVILEGE { ALL ACTIONS | action } ON { ALL OBJECTS | object } to ROLE role1
例9-63 指定のアクション、オブジェクトおよび属性のすべてのオプションの付与
この例は、指定されたアクション、オブジェクトおよび属性のすべてのオプションをロールに付与する方法を示します。
DBMCLI> GRANT PRIVILEGE { ALL ACTIONS | action } ON { ALL OBJECTS | object } \
ATTRIBUTES attribute1 [, attribute2, ...] to ROLE role1
例9-64 指定のアクション、オブジェクトおよびオプションのすべての属性の付与
この例は、指定されたアクション、オブジェクトおよびオプションのすべての属性をロールに付与する方法を示します。
DBMCLI> GRANT PRIVILEGE { ALL ACTIONS | action } ON { ALL OBJECTS | object } \
WITH OPTIONS option1 [, option, ...] to ROLE role1
親トピック: GRANT
9.7.5.2 GRANT ROLE
用途
GRANT ROLE
コマンドは、ユーザーにロールを設定します。
構文
GRANT ROLE { ALL | role1 [, role2, ...] } TO USER { ALL | user1 [, user2...] }
使用上のノート
-
roleはロールの名前です。
-
ALL
引数は、ユーザーにすべてのロールを付与します。 -
TO USER ALL
引数は、すべてのユーザーにロールを付与します。
例9-65 ユーザーへのロールの付与
この例は、ユーザーにロールを付与する方法を示しています。
DBMCLI> GRANT ROLE dbmonitor TO USER agarcia
親トピック: GRANT
9.7.6 HELP
用途
HELP
コマンドは、すべてのDBMCLIコマンドの構文および使用方法に関する説明を表示します。
構文
HELP [help_topic
]
HELP
でトピック引数を指定しない場合は、用意されているすべてのトピックの名前が表示されます。トピックを指定した場合は、そのトピックの詳細なヘルプ・テキストが表示されます。
例9-66は、HELP
コマンドの例を示しています。
例9-66 HELPコマンドを使用したヘルプ・テキストの表示
DBMCLI> HELP DBMCLI> HELP ALTER DBMCLI> HELP DROP ALERTHISTORY
親トピック: DBMCLIコマンド・リファレンス
9.7.7 LIST
用途
LIST
コマンドは、データベース・サーバー・オブジェクトの属性のリストを表示します。表示されるオブジェクトは、名前またはフィルタで識別されます。表示される各オブジェクトの属性は、指定した属性リストで決定されます。
構文
LIST object_type [ name | attribute_filters] [attribute_list]
[DETAIL] [ORDER BY order_by_attribute_list] [LIMIT integer]
使用上のノート
-
object_typeは次のとおりです。
ALERTDEFINITION
ALERTHISTORY
DBSERVER
IBPORT
(ユーザー・ドメイン(domU)環境では使用できません)LUN
(ユーザー・ドメイン(domU)環境では使用できません)METRICCURRRENT
METRICDEFINITION
METRICHISTORY
PHYSICALDISK
(ユーザー・ドメイン(domU)環境では使用できません)ROLE
THRESHOLD
USER
-
DETAIL
オプションまたは属性リストを指定せずにobject_typeのみを指定してLIST
を使用すると、このタイプの既存のオブジェクトの名前または属性のデフォルト・リストが表示されます。status
属性を持つオブジェクト・タイプの場合は、オブジェクト名およびステータスが表示されます。METRICHISTORY
オブジェクト・タイプの場合は、収集時間、オブジェクト名および値が表示されます。PHYSICALDISK
およびLUN
オブジェクト・タイプの場合は、ID属性が表示されます。ALERTHISTORY
オブジェクト・タイプの場合は、時間およびアラート・メッセージが表示されます。KEY
オブジェクト・タイプの場合は、キー値が表示されます。
-
表示される各オブジェクトの属性は、指定した属性リストで決定されます。空白またはタブを含む文字列である属性値は、引用符で囲む必要があります。
-
表示されるオブジェクトは、属性フィルタにより決定されます。メトリックの数は多いため、コマンドの出力を絞り込む場合は
LIST METRICCURRENT
またはLIST METRICHISTORY
コマンドの使用時にフィルタを使用してください。 -
DETAIL
オプションのないデフォルトの書式では、各オブジェクトが個別の行に表示され、指定した属性リストの順にタブで区切られた属性値が続きます。 -
DETAIL
を使用した書式の場合は、特定のオブジェクトの各属性が個別の行に表示され、属性名の後に値が表示されます。属性リストが指定されていない場合は、値を持つすべての属性が表示されます。表示される各オブジェクトは、空白行で区切られます。DETAIL
はATTRIBUTES ALL
オプションに似ていますが、書式のみが異なります。 -
設定されていない属性は、
DETAIL
オプションでは表示されません。これに対し、空の値に設定されている属性はDETAIL
オプションで表示されます。 -
ORDER BY
により、属性の昇順または降順でオブジェクトに順序が付けられます。デフォルトは昇順です。 -
LIMIT
により、表示するオブジェクト数の制限が設定されます。
- LIST ALERTDEFINITION
- LIST ALERTHISTORY
- LIST DBSERVER
- LIST DIAGPACK
- LIST IBPORT
- LIST LUN
- LIST METRICCURRENT
- LIST METRICDEFINITION
- LIST METRICHISTORY
- LIST METRICSTREAM
- LIST PHYSICALDISK
- LIST ROLE
- LIST SOFTWAREHISTORY
- LIST SOFTWAREUPDATE
- LIST THRESHOLD
- LIST USER
親トピック: DBMCLIコマンド・リファレンス
9.7.7.1 LIST ALERTDEFINITION
構文
LIST ALERTDEFINITION [name
|attribute_filters
] [attribute_list
] [DETAIL]
使用上のノート
表示可能な属性のリストは、例9-41に示されています。
例
例9-67は、ALERTDEFINITION
オブジェクトを指定したLIST
コマンドを示しています。
例9-67 ALERTDEFINITIONの属性の表示
DBMCLI> LIST ALERTDEFINITION HardwareAlert DETAIL name: HardwareAlert alertShortName: Hardware alertSource: Hardware alertType: Stateless description: "Hardware Alert" metricName:
親トピック: LIST
9.7.7.2 LIST ALERTHISTORY
構文
LIST ALERTHISTORY [name
|attribute_filters
] [attribute_list
] [DETAIL]
使用上のノート
表示可能な属性のリストは、例9-42に示されています。
WHERE
句にageInMInutes
属性を追加すると、経過時間が指定範囲内のアラートのみをリスト表示するように指定できます。たとえば、次のコマンドでは、直前の15分間に作成されたアラートが表示されます。
DBMCLI> LIST ALERTHISTORY WHERE ageInMinutes < 15
例
例9-68は、ALERTHISTORY
オブジェクトを指定したLIST
コマンドを示しています。
例9-68 ALERTHISTORYの属性の表示
DBMCLI> LIST ALERTHISTORY 1_1 DETAIL name: 1_1 alertDescription: "Data hard disk of size 300GB in slot 3 entered predictive failure status" alertMessage: "Data hard disk entered predictive failure status. Status : WARNING - PREDICTIVE FAILURE Manufacturer : HITACHI Model Number : H103030SCSUN300G Size : 300GB Serial Number : 1026GZKMDE Firmware : A2A8 Slot Number : 3" alertSequenceID: 1 alertShortName: Hardware alertType: Stateful beginTime: 2014-09-22T20:18:23-05:00 examinedBy: metricObjectName: 252:3 notificationState: 0 sequenceBeginTime: 2014-09-22T20:18:23-05:00 severity: critical alertAction: "Informational. The hard disk has entered predictive failure status. A white DB server locator LED has been turned on to help locate the affected cell, and an amber service action LED has been lit on the drive to help locate the affected drive. Detailed information on this problem can be found at https://support.oracle.com/CSP/main/article?cmd=show&type=NOT&id=1112995.1 Automatic Service Request has been notified with Unique Identifier: c84839be-e8d8-4e5e-b315-e145ccd7cbc8."
親トピック: LIST
9.7.7.3 LIST DBSERVER
用途
LIST DBSERVER
コマンドは、データベース・サーバーで発生したすべてのアラートを表示します。
構文
LIST DBSERVER [ name | attribute_filters ] [attribute_list] [DETAIL]
使用上のノート
表示可能な属性のリストは、例9-43に示されています。
例
例9-69は、LIST DBSERVER DETAIL
コマンドの出力を示しています。
例9-70は、rescuePlan
属性の値を表示する方法を示しています。
例9-71は、httpsAccess
属性の値を取得する方法を示しています。
例9-69 DBSERVERの属性の表示
DDBMCLI> LIST DBSERVER DETAIL
name: myexadb03
bbuStatus: normal
cpuCount: 24
diagHistoryDays: 7
fanCount: 16/16
fanStatus: normal
httpsAccess ALL
id: 1029FMM085
interconnectCount: 2
ipaddress1: 192.168.10.25/22
kernelVersion: 2.6.39-400.220.0.el6uek.x86_64
locatorLEDStatus: on
makeModel: Oracle Corporation SUN FIRE X4170 M2 SERVER
metricHistoryDays: 7
msVersion: OSS_MAIN_LINUX.X64_140921
powerCount: 2/2
powerStatus: normal
releaseImageStatus: success
releaseVersion: 12.1.2.1.0.140728
releaseTrackingBug: 17885582
snmpSubscriber:
host=10.133.131.130,port=162,community=public,type=asr
status: online
temperatureReading: 20.0
temperatureStatus: normal
upTime: 55 days, 5:12
msStatus: running
rsStatus: running
DBMCLI> LIST DBSERVER ATTRIBUTES status,uptime
online 161 days, 3:11
例9-70 rescuePlan属性の表示
DBMCLI> LIST DBSERVER ATTRIBUTES rescuePlan
CREATE ROLE "listdbserverattrs"
GRANT PRIVILEGE list ON DBSERVER ATTRIBUTES bbuStatus, coreCount WITH ALL OPTIONS TO ROLE "listdbserverattrs"
ALTER DBSERVER diagHistoryDays="7", metricHistoryDays="7", bbuLearnSchedule="MONTH 1 DATE 17 HOUR 2 MINUTE 0", alertSummaryStartTime="2016-09-26T08:00:00-07:00", alertSummaryInterval=weekly, pendingCoreCount="128" force
例9-71 HTTPsアクセス制御リストの表示
この例は、Exadata RESTfulサービスのHTTPsアクセス制御リストを表示する方法を示しています。
DBMCLI> LIST DBSERVER ATTRIBUTES httpsAccesss
ALL
ALL
の値はデフォルト値で、すべてのホストへのアクセスを許可します。
親トピック: LIST
9.7.7.4 LIST DIAGPACK
用途
LIST DIAGPACK
コマンドは、システムの診断パッケージをそのステータスとともにリストします。
構文
LIST DIAGPACK [DETAIL]
使用上のノート
診断パッケージの場所は/opt/oracle/dbserver/dbms/deploy/log
です。
例
例9-72 LIST DIAGPACKコマンドの出力
この例は、LIST DIAGPACK
コマンドの出力を示します。
DBMCLI> LIST DIAGPACK
dbm04adm01_2016_06_07T12_28_23_17_1.tar.bz2
dbm04adm01_2016_04_11T12_51_05_16_1.tar.bz2
例9-73 DETAILオプション付きのLIST DIAGPACKコマンドの出力
この例は、DETAIL
オプション付きのLIST DIAGPACK
コマンドの出力を示します。
DBMCLI> LIST DIAGPACK DETAIL
name: dbm04adm01_2019_08_07T12_28_23_17_1.tar.bz2
alertDescription: "Hard disk of size 600GB in slot 5 failed"
alertName: 17_1
diagPackHostName: dbm04adm01
packStartTime: 2016-06-07T12:28:23-07:00
name: dbm04adm01_2019_08_11T12_51_05_16_1.tar.bz2
alertDescription: "InfiniBand Port HCA-4:1 may require attention. State:Down, Physical State:Disabled."
alertName: 16_1
diagPackHostName: dbm04adm01
packStartTime: 2016-04-11T12:51:05-07:00
name: dbm04adm01_diag_2019_08_12T18_37_30_1
alertDescription: Processing...
関連トピック
親トピック: LIST
9.7.7.5 LIST IBPORT
用途
LIST IBPORT
コマンドは、指定した属性およびフィルタで決定されるInfiniBandネットワーク・ファブリック・ポートの属性を表示します。
ノート:
このコマンドは、RoCEネットワーク・ファブリックを使用するExadata Database Machineサーバーでは機能しません。構文
LIST IBPORT [ name | attribute_filters ] [attribute_list] [DETAIL]
使用上のノート
表示可能な属性のリストは、例9-44に示されています。
サーバー上の両方のInfiniBandネットワーク・ファブリック・ポートのactiveSlave
属性が一覧表示されない場合は、アクティブ-アクティブ・ボンディングが使用されています。activeSlave
属性がTRUE
の場合は、アクティブ-パッシブ・ボンディングが使用されています。
例9-74 IBPORTの属性の表示
この例は、LIST IBPORT
コマンドから得られる可能性のある出力を示しています。
DBMCLI> LIST IBPORT
HCA-1:1 Active
HCA-1:2 Active
DBMCLI> LIST IBPORT DETAIL
name: HCA-1:1
activeSlave: TRUE
dataRate: "40 Gbps"
hcaFWVersion: 2.7.0
id: 0x00212800013e8c67
lid: 20
linkDowned: 0
linkIntegrityErrs: 0
linkRecovers: 0
physLinkState: LinkUp
portNumber: 1
rcvConstraintErrs: 0
rcvData: 84653709
rcvErrs: 0
rcvRemotePhysErrs: 0
status: Active
symbolErrs: 0
vl15Dropped: 0
xmtConstraintErrs: 0
xmtData: 84572496
xmtDiscards: 0
name: HCA-1:2
activeSlave: FALSE
dataRate: "40 Gbps"
hcaFWVersion: 2.7.0
id: 0x00212800013e8c68
lid: 21
linkDowned: 0
linkIntegrityErrs: 0
linkRecovers: 0
physLinkState: LinkUp
portNumber: 2
rcvConstraintErrs: 0
rcvData: 79355427
rcvErrs: 0
rcvRemotePhysErrs: 0
status: Active
symbolErrs: 0
vl15Dropped: 0
xmtConstraintErrs: 0
xmtData: 79274016
xmtDiscards: 0
親トピック: LIST
9.7.7.6 LIST LUN
用途
LIST LUNコマンドは、指定した属性およびフィルタで決定されるLUNの属性を表示します。
構文
LIST LUN [ name | attribute_filters ] [attribute_list] [DETAIL]
使用上のノート
表示可能な属性のリストは、例9-45に示されています。
例
例9-75は、LUNオブジェクトを指定したLISTコマンドおよび対応する出力を示しています。
例9-75 LUNの属性の表示
DBMCLI> LIST LUN
0_0 0_0 normal
DBMCLI> LIST LUN 0_0 DETAIL
name: 0_0
diskType: HardDisk
id: 0_0
lunSize: 556.9289999008179G
lunUID: 0_0
raidLevel: 5
lunWriteCacheMode: "WriteBack, ReadAheadNone, Direct, \
No Write Cache if Bad BBU"
status: normal
親トピック: LIST
9.7.7.7 LIST METRICCURRENT
用途
LIST METRICCURRENT
コマンドは、すべてのメトリックを収集したリストを表示します。
構文
LIST METRICCURRENT [ name | attribute_filters ] [attribute_list] [DETAIL]
使用上のノート
-
表示可能な属性のリストは、例9-46に示されています。
-
LIST METRICCURRENT
コマンドの実行時の出力サイズを減らすには、フィルタを使用します。
例
例9-76は、METRICCURRRENT
オブジェクトの情報を表示するため、フィルタを指定したLIST
コマンドおよび対応する出力を示しています。
例9-76 METRICCURRENTの属性の表示
DBMCLI> LIST METRICCURRENT attributes name, objecttype
DS_BBU_CHARGE DBSERVER
DS_BBU_TEMP DBSERVER
DS_CPUT DBSERVER
DS_CPUT_MS DBSERVER
DS_FANS DBSERVER
DS_FSUT DBSERVER_FILESYSTEM
DS_FSUT DBSERVER_FILESYSTEM
DS_FSUT DBSERVER_FILESYSTEM
DS_MEMUT DBSERVER
DS_MEMUT_MS DBSERVER
DS_RUNQ DBSERVER
DS_SWAP_IN_BY_SEC DBSERVER
DS_SWAP_OUT_BY_SEC DBSERVER
DS_SWAP_USAGE DBSERVER
DS_TEMP DBSERVER
DS_VIRTMEM_MS DBSERVER
N_HCA_MB_RCV_SEC DBSERVER
N_HCA_MB_TRANS_SEC DBSERVER
N_IB_MB_RCV_SEC IBPORT
N_IB_MB_RCV_SEC IBPORT
N_IB_MB_TRANS_SEC IBPORT
N_IB_MB_TRANS_SEC IBPORT
N_IB_UTIL_RCV IBPORT
N_IB_UTIL_RCV IBPORT
N_IB_UTIL_TRANS IBPORT
N_IB_UTIL_TRANS IBPORT
N_NIC_KB_RCV_SEC DBSERVER
N_NIC_KB_TRANS_SEC DBSERVER
N_NIC_NW DBSERVER
DBMCLI> LIST METRICCURRENT where objectType='IBPORT'
N_IB_MB_RCV_SEC HCA-1:1 0.026 MB/sec
N_IB_MB_RCV_SEC HCA-1:2 0.009 MB/sec
N_IB_MB_TRANS_SEC HCA-1:1 0.021 MB/sec
N_IB_MB_TRANS_SEC HCA-1:2 0.004 MB/sec
N_IB_UTIL_RCV HCA-1:1 0.0 %
N_IB_UTIL_RCV HCA-1:2 0.0 %
N_IB_UTIL_TRANS HCA-1:1 0.0 %
N_IB_UTIL_TRANS HCA-1:2 0.0 %
DBMCLI> LIST METRICCURRENT where name = DS_CPUT and metricobjectname= myexadb04 detail
name: DS_CPUT
alertState: normal
collectionTime: 2014-03-13T16:15:25-05:00
metricObjectName: myexadb04
metricType: Instantaneous
metricValue: 0.9 %
objectType: DBSERVER
DBMCLI> LIST METRICCURRENT DS_FSUT
DS_FSUT / 50 %
DS_FSUT /boot 18 %
DS_FSUT /u01 82 %
関連トピック
親トピック: LIST
9.7.7.8 LIST METRICDEFINITION
構文
LIST METRICDEFINITION [name
|attribute_filters
] [attribute_list
] [DETAIL]
使用上のノート
表示可能な属性のリストは、例9-47に示されています。
例
例9-77は、METRICDEFINITION
オブジェクトを指定したLIST
コマンドおよび対応する出力を示しています。
例9-77 METRICDEFINITIONの属性の表示
DBMCLI> LIST METRICDEFINITION DS_BBU_CHARGE DS_BBU_TEMP DS_CPUT DS_CPUT_MS DS_FANS DS_FSUT DS_MEMUT DS_MEMUT_MS DS_RUNQ DS_SWAP_IN_BY_SEC DS_SWAP_OUT_BY_SEC DS_SWAP_USAGE DS_TEMP DS_VIRTMEM_MS N_HCA_MB_RCV_SEC N_HCA_MB_TRANS_SEC N_IB_MB_RCV_SEC N_IB_MB_TRANS_SEC N_IB_UTIL_RCV N_IB_UTIL_TRANS N_NIC_KB_RCV_SEC N_NIC_KB_TRANS_SEC N_NIC_NW
親トピック: LIST
9.7.7.9 LIST METRICHISTORY
用途
LIST METRICHISTORY
コマンドは、各メトリックのリストを表示します。
構文
LIST METRICHISTORY [name
|attribute_filters
] [attribute_list
] {over_specification
] [MEMORY] [DETAIL]
使用上のノート
-
表示可能な属性のリストは、例9-48に示されています。
-
メトリック履歴エントリ・ファイルの保存期間は、
metricHistoryDays
データベース・サーバー属性で指定されます。この設定は、DBMCLIのALTER DBSERVER
コマンドで変更できます。 -
over_specificationの構文は次のとおりです。
OVER
number
[aggregation_type
[aggregation_type
]...]この構文で、numberは集計のための時間(分単位)です。aggregation_typeには、
max
、min
またはavg
を指定できます。 -
WHERE
句にageInMinutes
属性を追加すると、経過時間が指定範囲内のメトリックのみをリスト表示するように指定できます。たとえば、次のコマンドでは、直前の15分間に作成されたメトリックが表示されます。DBMCLI> LIST METRICHISTORY WHERE ageInMinutes < 15
例
例9-78は、name
およびcollectionTime
属性を指定したLIST METRICHISTORY
コマンドを示しています。
例9-79は、ds_cput
属性を指定したLIST METRICHISTORY
コマンドを示しています。
例9-78 NameおよびCollectionTime属性を使用したMETRICHISTORYの表示
DBMCLI> LIST METRICHISTORY WHERE name LIKE 'DS_.*' AND collectionTime > '2014-03-27T17:48:16-05:00' DS_FANS myexadb03 16 2014-03-27T17:49:15-05:00 DS_TEMP myexadb03 20.0 C 2014-03-27T17:49:15-05:00 DS_BBU_CHARGE myexadb03 52.0 % 2014-03-27T17:49:16-05:00 DS_BBU_TEMP myexadb03 45.0 C 2014-03-27T17:49:16-05:00 DS_CPUT myexadb03 0.3 % 2014-03-27T17:49:16-05:00 DS_CPUT_MS myexadb03 0.0 % 2014-03-27T17:49:16-05:00 DS_FSUT / 73 % 2014-03-27T17:49:16-05:00 DS_FSUT /boot 18 % 2014-03-27T17:49:16-05:00 DS_FSUT /u01 43 % 2014-03-27T17:49:16-05:00 DS_MEMUT myexadb03 42 % 2014-03-27T17:49:16-05:00 DS_MEMUT_MS myexadb03 0.3 % 2014-03-27T17:49:16-05:00 DS_MEMUT_MS myexadb03 0.3 % 2014-03-27T17:49:16-05:00 DS_RUNQ myexadb03 0.2 2014-03-27T17:49:16-05:00 DS_SWAP_IN_BY_SEC myexadb03 0.0 KB/sec 2014-03-27T17:49:16-05:00 DS_SWAP_OUT_BY_SEC myexadb03 0.0 KB/sec 2014-03-27T17:49:16-05:00 DS_SWAP_USAGE myexadb03 0 % 2014-03-27T17:49:16-05:00 DS_VIRTMEM_MS myexadb03 981 MB 2014-03-27T17:49:16-05:00 DS_VIRTMEM_MS myexadb03 981 MB 2014-03-27T17:49:16-05:00
例9-79 ds_cput属性のMETRICHISTORYの表示
DBMCLI> LIST METRICHISTORY ds_cput OVER 10 MIN MAX MEMORY DS_CPUT myexadb03 1.0 % 2014-03-27T16:59:16-05:00 0.3 % 1.0 % DS_CPUT myexadb03 0.7 % 2014-03-27T17:09:16-05:00 0.2 % 0.8 % DS_CPUT myexadb03 0.7 % 2014-03-27T17:19:16-05:00 0.3 % 1.1 % DS_CPUT myexadb03 0.7 % 2014-03-27T17:29:16-05:00 0.3 % 0.9 % DS_CPUT myexadb03 0.7 % 2014-03-27T17:39:16-05:00 0.2 % 0.8 % DS_CPUT myexadb03 0.8 % 2014-03-27T17:49:16-05:00 0.3 % 0.8 %
親トピック: LIST
9.7.7.10 LIST METRICSTREAM
用途
LIST METRICSTREAM
コマンドでは、リアルタイム・メトリック・ストリーム内のメトリックが表示されます。
構文
LIST METRICSTREAM [ name | attribute_filters ] [attribute_list] [DETAIL]
使用上のノート
-
LIST METRICSTREAM
コマンドは、LIST METRICCURRENT
コマンドと機能的に同等ですが、LIST METRICSTREAM
では、リアルタイム・メトリック・ストリーミングが有効になっているメトリックのみが表示されます。
例9-80 METRICSTREAMの属性の表示
この例では、セル・ディスク属性を表示するフィルタを使用したLIST METRICSTREAM
コマンドを示します。
DBMCLI> LIST METRICSTREAM WHERE name LIKE 'N_NIC.*'
親トピック: LIST
9.7.7.11 LIST PHYSICALDISK
用途
LIST PHYSICALDISK
コマンドは、指定した属性およびフィルタで決定される1つ以上の物理ディスクの属性を表示します。
構文
LIST PHYSICALDISK [name
|attribute_filters
] [attribute_list
] [DETAIL]
使用上のノート
表示可能な属性のリストは、例9-49に示されています。
例
例9-81は、PHYSICALDISK
オブジェクトを指定したLIST
コマンドおよび対応する出力を示しています。
例9-81 物理ディスクの属性の表示
DBMCLI> LIST PHYSICALDISK 252:0 G08VKE normal 252:1 GYVAXE normal 252:2 G07Z5E normal 252:3 G0889E normal
親トピック: LIST
9.7.7.12 LIST ROLE
用途
LIST ROLE
コマンドは、ロールに指定した属性を表示します。
構文
LIST ROLE [name | filters] [attribute_list] [DETAIL]
使用上のノート
-
nameはロールの名前です。
-
filtersは、表示するロールを決定する式です。
-
attribute_listは、表示する属性です。
ALL
オプションを使用して、すべての属性を表示できます。 -
DETAIL
オプションは、各値の前に属性ディスクリプタを付けて、各行で出力を属性としてフォーマットします。
例
例9-82は、LIST ROLE
コマンドを示しています。
例9-82 ロールの表示
DBMCLI> LIST ROLE DETAIL
DBMCLI> LIST ROLE where name like 'db_*'
親トピック: LIST
9.7.7.13 LIST SOFTWAREHISTORY
用途
LIST SOFTWAREHISTORY
は、過去のソフトウェア更新の最終ステータスのリストを表示します。
構文
LIST SOFTWAREHISTORY [attribute_filters] [attribute_list] [DETAIL]
例9-83 スケジュール済ソフトウェア更新の履歴の表示
デフォルトでは、更新名とステータスのみが表示されます。
CellCLI> LIST SOFTWAREHISTORY
12.2.1.2.0.170509 Last update completed at: 2017-05-20T08:00:57-07:00
12.2.1.2.0.170520 Last update completed at: 2017-05-21T06:39:54-07:00
12.2.1.2.0.17052 Last update completed at: 2017-06-08T08:56:45-07:00
12.2.1.2.0.170603 Last update completed at: 2017-06-08T16:03:17-07:00
例9-84 特定のソフトウェア更新の詳細な履歴の表示
この例は、名前で参照される特定の更新の詳細なソフトウェア更新履歴を示しています。
CellCLI> LIST SOFTWAREHISTORY WHERE name='12.2.1.2.0.170808.1' DETAIL
name: 12.2.1.2.0.170808.1
status: Upgrade failed. See alerts at: 2017-08-10T10:56:15-07:00
親トピック: LIST
9.7.7.14 LIST SOFTWAREUPDATE
用途
LIST SOFTWAREUPDATE
コマンドは、最近スケジュールされた更新のステータスを表示します。
構文
LIST SOFTWAREUPDATE [attribute_list] [DETAIL]
使用上のノート
ソフトウェア更新で想定される状態は、次のとおりです。
-
Ready to update at: update_time
-
Downloading
-
Checking prerequisites
-
Prerequisites failed. See alerts.
-
Last update completed at: update_time
-
Running
-
Upgrade failed. See alerts.
例9-85 スケジュール済ソフトウェア更新のステータスの表示
デフォルトでは、更新名とステータスのみが表示されます。
CellCLI> LIST SOFTWAREUPDATE
12.2.1.2.0.170603 Last update completed at: 2017-06-08 16:03:17 -0700
例9-86 スケジュール済ソフトウェア更新の詳細ステータスの表示
デフォルトでは、更新名とステータスのみが表示されます。
CellCLI> LIST SOFTWAREUPDATE DETAIL
name: 12.2.1.2.0.170808.1
status: Upgrade failed. See alerts
store: https://mystore_url:4443
time: 2017-08-10T10:35:00-07:00
親トピック: LIST
9.7.7.15 LIST THRESHOLD
用途
LIST THRESHOLD
コマンドは、指定した属性およびフィルタで決定される1つ以上のしきい値の属性を表示します。
構文
LIST THRESHOLD [name
|attribute_filters
] [attribute_list
] [DETAIL]
使用上のノート
表示可能な属性のリストは、例9-53に示されています。
例
例9-87は、THRESHOLD
オブジェクトを指定したLIST
コマンドおよび対応する出力を示しています。
例9-87 しきい値の属性の表示
DBMCLI> LIST THRESHOLD DS_CPUT.myexadb04 DS_TEMP.myexadb04 DBMCLI> LIST THRESHOLD DS_CPUT.myexadb04 detail name: DS_CPUT.myexadb04 comparison: > warning: 90.0 DBMCLI> LIST THRESHOLD DS_TEMP.myexadb04 detail name: DS_TEMP.myexadb04 comparison: > critical: 30.0
親トピック: LIST
9.7.7.16 LIST USER
用途
LIST USER
コマンドは、ユーザーに指定した属性を表示します。
構文
LIST USER [name | filters] [attribute_list] [DETAIL]
使用上のノート
-
nameはユーザー名です。
-
filtersは、表示するユーザーを決定する式です。
-
attribute_listは、表示する属性です。
ALL
オプションを使用して、すべての属性を表示できます。 -
DETAIL
オプションは、各値の前に属性ディスクリプタを付けて、各行で出力を属性としてフォーマットします。
例
例9-88は、LIST USER
コマンドを示しています。
例9-88 LIST USERコマンドの使用
DBMCLI> LIST USER DETAIL
DBMCLI> LIST USER where name like 'jdoe' DETAIL
name: jdoe
roles: role=db_monitor
Privileges: object=dbserver
verb=list
attributes=all attributes
options= all options
親トピック: LIST
9.7.8 REVOKE
用途
REVOKE
コマンドは、権限およびロールを削除します。
構文
REVOKE object_type [name] FROM sub_object_type [sub_object_name]
使用上のノート
-
object_typeは次のとおりです。
-
PRIVILEGE
-
ROLE
-
-
PRIVILEGE
オブジェクト・タイプには次を使用できます。-
nameの書式は、次のとおりです。
{ ALL ACTIONS | action } ON { ALL OBJECTS | object } { ALL ATTRIBUTES | \ ATTRIBUTES attribute1 [, attribute2, ...] } { WITH ALL OPTIONS | \ WITH OPTIONS option1 [, option2, ...] }
-
sub_object_typeは
ROLE
である必要があります。 -
sub_object_nameは、ロール名、ロール名のカンマ区切りのリストまたはキーワード
ALL
です。
-
-
ROLE
オブジェクト・タイプには次を使用できます。-
nameは、ロール名、ロール名のカンマ区切りのリストまたはキーワード
ALL
です。 -
sub_object_typeは
USER
である必要があります。 -
sub_object_nameは、ユーザー名、ユーザー名のカンマ区切りのリストまたはキーワード
ALL
です。
-
9.7.8.1 REVOKE PRIVILEGE
用途
REVOKE PRIVILEGE
コマンドは、ロールから権限を取り消します。
構文
REVOKE PRIVILEGE { ALL ACTIONS | action } ON { ALL OBJECTS | object } { ALL ATTRIBUTES | ATTRIBUTES attribute1 [, attribute2...] } { WITH ALL OPTIONS | WITH OPTIONS option1 [, option2, ...] } FROM ROLE { ALL | role1 [, role2, ...] }
使用上のノート
-
actionはコマンドです。
-
objectはアクションのオブジェクト・タイプです。
-
attributeはオブジェクトの属性です。
-
optionはオブジェクトのオプションです。
-
roleは、権限を取り消すロールの名前です。
-
ALL ACTIONS
引数は、すべてのアクションの権限を取り消します。 -
ALL OBJECTS
引数は、すべてのオブジェクトの権限を取り消します。 -
ALL ATTRIBUTES
引数は、すべての属性の権限を取り消します。 -
WITH ALL OPTIONS
引数は、すべてのオプションの権限を取り消します。
例
例9-89は、REVOKE PRIVILEGE
コマンドを示しています。
例9-89 権限の取消し
DBMCLI> REVOKE PRIVILEGE ALL ACTIONS ON ALL OBJECTS ALL ATTRIBUTES -
WITH ALL OPTIONS FROM ROLE ALL
DBMCLI> REVOKE PRIVILEGE list ON dbserver ATTRIBUTES name -
WITH OPTIONS detail FROM ROLE db_monitor
親トピック: REVOKE
9.7.8.2 REVOKE ROLE
用途
REVOKE ROLE
コマンドは、ユーザーのロールを取り消します。
構文
REVOKE ROLE { ALL | role1 [, role2, ...] } FROM USER { ALL | user1 [, user2...] }
使用上のノート
-
role1とrole2はロールの名前です。
-
user1とuser2はユーザーの名前です。
-
ALL
引数は、ユーザーのすべてのロールを取り消します。 -
FROM USER ALL
引数は、すべてのユーザーのロールを取り消します。
例
例9-90は、ユーザーからロールを取り消す方法を示しています。
例9-90 ユーザーのロールの取消し
DBMCLI> REVOKE ROLE db_monitor FROM USER jdoe
親トピック: REVOKE
9.7.9 SET
用途
SET
コマンドは、現行のセッションに対するDBMCLI環境を変更する変数を設定します。
構文
SET DATEFORMAT {LOCAL | STANDARD}
SET ECHO [ON | OFF]
使用上のノート
SET DATEFORMAT
コマンドでは、表示される日付形式を制御します。日付を受け入れるコマンドでは、standardの日時形式をお薦めします。local形式も受け入れられます。スクリプトでstandard形式が推奨される理由は、この形式がスクリプトの実行時に発生する可能性があるタイムゾーン、地域およびロケールの変更に依存しないためです。
SET ECHO
コマンドでは、@
またはSTART
で実行されるスクリプトのコマンドにエコーを設定するかどうかを制御します。ON
オプションを指定すると、コマンドが画面に表示されます。OFF
オプションを指定すると非表示になります。対話的に入力したコマンドやオペレーティング・システムからリダイレクトされたコマンドの表示は、SET ECHO
コマンドによって影響を受けません。
例9-91 SETコマンドを使用した日付形式の設定
SET DATEFORMAT STANDARD
親トピック: DBMCLIコマンド・リファレンス
9.7.10 SPOOL
用途
SPOOL
コマンドは、コマンドの結果を指定したファイルに書き込み(スプール)ます。
構文
SPO[OL] [file_name [ CRE[ATE] | REP[LACE] | APP[END] ] | OFF]
使用上のノート
オプションを指定せずにSPOOL file_name
を発行すると、ファイルの有無に関係なく、指定したファイルに出力がスプールされます。デフォルトの動作はREPLACE
オプションです。
表9-14 SPOOLオプション
オプション | 説明 |
---|---|
|
指定したファイルの最後に結果を追加します。 |
|
指定した名前で新しいファイルを作成し、このファイルが存在する場合、エラーが発生します。 |
|
結果が書き込まれるファイルの名前です。この名前は、完全修飾のパス名で指定できますが、現行ディレクトリの相対パスになる部分修飾のパス名で指定することもできます。 |
オプションなし |
現在のスプールのターゲット・ファイルがある場合は、その名前を表示します。 |
|
ファイルへの書込み(スプール)出力を停止します。 |
|
指定した既存のファイルの内容を置き換えます。ファイルが存在しない場合は、 |
親トピック: DBMCLIコマンド・リファレンス
9.7.11 START
用途
START
コマンドは、指定したスクリプト・ファイルでDBMCLIコマンドを実行します。
構文
STA[RT] file_name
使用上のノート
START
オプションはfile_nameです。このオプションは、DBMCLIコマンドを含むスクリプト・ファイルの名前になります。ファイル名に完全修飾パスが含まれていない場合は、現行ディレクトリの相対パスが含まれるファイルがDBMCLIユーティリティによって検索されます。
START
コマンドは、長いDBMCLIコマンドを入力する場合や、DBMCLIコマンドを複数入力する場合に便利です。たとえば、alter_dbserver
が現行ディレクトリにある場合は、alter_dbserver
という名前のテキスト・ファイルに例9-10のすべてのコマンドを入力して、次のように実行します。
START alter_dbserver
親トピック: DBMCLIコマンド・リファレンス