この付録では、Oracle Database Applianceコマンドライン・インタフェース(OAKCLI)・ユーティリティを使用してOracle Database Applianceを管理する方法について説明します。この付録では、次の項目について説明します。
この項には次のOAKCLIのトピックが含まれます。
OAKCLIを使用して、コア・キーの構成、パッチの適用、アプライアンスのデプロイなどのOracle Database Appliance管理タスクを実行します。OAKCLIでは次のタスクを実行できます。
コア構成キーの適用
Oracle Database Applianceデプロイメント用のネットワークの構成
デプロイメント構成ファイルのコピー
Oracle Database Applianceのデプロイ
Oracle Database Applianceへのディスクの配置
Oracle Database Applianceリポジトリの管理
Oracle Database Appliance診断収集結果の管理
Oracle Database Applianceの更新
OAKCLIリポジトリへのパッケージの解凍
Oracle Database Applianceの検証
使用方法
OAKCLIユーティリティは、次のディレクトリにあります。
/opt/oracle/oak/bin/oakcli
Oracle Database Applianceでは完了したOAKCLIコマンド実行のログが、次のディレクトリに保管されます。
/opt/oracle/oak/log/<hostname>/client/oakcli.log
OAKCLIヘルプの使用方法
OAKCLIの使用方法を表示するには、次のコマンドを実行します。
oakcli -h
特定のOAKCLIコマンドに関する詳細なヘルプを表示するには、次のコマンドを実行します。
oakcli command -h
特定のOAKCLIコマンドのオブジェクトおよびそのオプションに関する詳細なヘルプを表示するには、次のコマンドを実行します。
oakcli command object -h
権限およびセキュリティ
rootユーザーとしてログインすることでOAKCLIを使用します。root以外のユーザーでログインしている場合、ストレージ情報を表示できますが、構成を変更できません。
OAKCLIのコマンド構文およびオプション
OAKCLIのコマンド、オブジェクト名およびオプションでは、大/小文字が区別されます。OAKCLIでは次のコマンド構文を使用します。
oakcli command object [parameters]
OAKCLI構文では次のようになります。
commandは、show、locate、applyなどの動詞です。
object (名詞とも呼びます)はディスクやコントローラなどの、oakcliが操作を実行する対象のターゲットまたはオブジェクトです。オブジェクトの短縮形も使用できます。
parametersは、コマンドの追加オプションを使用できるようにすぐ前のコマンドの組合せの使用範囲を拡大します。
表D-1 OAKCLIユーティリティのコマンド
| コマンド | 説明 |
|---|---|
|
|
Oracle Database Applianceコア容量を再構成します。 |
|
|
仮想マシン・テンプレートをクローニングします。 |
|
|
Oracle Database Applianceコンポーネントを構成します。 |
|
|
デプロイ中に使用する構成ファイルのコピーを用意します。 |
|
|
新規Oracleデータベースを作成します。 |
|
|
仮想マシンを削除します。 |
|
|
仮想マシン・テンプレートを削除します。 |
|
|
Oracle Database Applianceをデプロイします。 |
|
|
仮想マシン・テンプレートをインポートします。 |
|
|
ディスクを配置します。 |
|
|
OAKCLIリポジトリの管理や、診断の収集などを行います。 |
|
|
各種のOracle Database Applianceコンポーネントに関する情報を表示します。 |
|
|
仮想マシンを起動します。 |
|
|
仮想マシンを停止します。 |
|
|
指定されたパッケージをOAKCLIリポジトリへ解凍します。 |
|
|
Oracle Database Applianceを更新します。 |
|
|
Oracle Database Applianceを検証します。 |
oakcli applyコマンドを使用して、Oracle Database Applianceコア容量を再構成します。
次の構文を使用します。core_config_keyは構成キー・ファイルで、key fileは出力構成キー・ファイル名です。
oakcli apply core_config_key key file
oakcli cloneコマンドを使用して、仮想マシン・テンプレートをクローニングします。
oakcli configureコマンドを使用して、Oracle Database Applianceでコンポーネントを構成します。
表D-4 oakcli configureコマンド・サマリー
| コマンド | 説明 |
|---|---|
|
|
asr情報を構成します。 |
|
|
CPUプールを構成します。 |
|
|
初期ネットワーク情報を構成します。 |
|
|
仮想マシンを構成します。 |
|
|
仮想マシン・テンプレートを構成します。 |
oakcli configure asrコマンドを使用して、Oracle Database ApplianceでAuto Service Request (ASR)を構成します。
このコマンドを使用して、1つのOracle Database Appliance仮想化プラットフォーム・ノードにCPUプールを構成します。
oakcli configure firstnetコマンドを使用して、デプロイメント・ソフトウェアをダウンロードするための初期ネットワークをOracle Database Applianceに構成します。
次のコマンドは、新しいベア・メタルOracle Database Applianceでの初期ネットワークの作成を開始します。使用される対話型スクリプトも次に示します。
oakcli configure firstnet
Select the interface to configure network on [bond0 bond1 bond2 xbond0]:bond0
Configure DHCP on bond0?(yes/no):no
INFO: Static configuration selected
Enter the IP address to configure:192.0.2.18
Enter the netmask address to configure:255.255.252.0
Enter the gateway address to configure:192.0.2.1
Plumbing the IPs now
Restarting the network
:::::::::::::::::
oakcli configure vmコマンドを使用して、Oracle Database Appliance仮想化プラットフォームで仮想マシンを構成します。
oakcli configure vm name [-vcpu cpucount -maxvcpu maxcpu -cpuprio priority -cpucap cap -memory memsize -maxmemory max_memsize -os sys -keyboard lang -mouse mouse_type -domain dom -network netlist -autostart astart -disk disks -bootoption bootstrap -cpupool pool]
表D-6 oakcli configure vmコマンド・パラメータ
| パラメータ | 説明 |
|---|---|
|
|
仮想マシンに割り当てられる名前。 |
|
|
仮想マシンに割り当てられるノード数(1~24)。 |
|
|
仮想マシンが使用できるCPUの最大数(1~24)。 |
|
|
CPU使用の優先度。値が大きいほど優先度が高くなります(1~256)。 |
|
|
仮想マシンが利用できるCPUのパーセンテージ(1~100)。 |
|
|
仮想マシンに与えられるメモリー容量(1 GB~88 GBまたは1 MB~90112 MB)。 |
|
|
仮想マシンで使用できるメモリー容量。 |
|
|
仮想マシンで使用されるオペレーティング・システム(WIN_2003、WIN_2008、WIN_7、WIN_VISTA、OTHER_WIN、OL_4、OL_5、OL_6、RHL_4、RHL_5、RHL_6、LINUX_RECOVERY、OTHER_LINUX、SOLARIS_10、SOLARIS_11、OTHER_SOLARISまたはNONE)。 |
|
|
仮想マシンで使用されるキーボード(en-us、ar、da、de、de-ch、en-gb、es、et、fi、fo、fr、fr-be、fr-ca、hr、hu、is、it、ja、lt、lv、mk、nl、n--be、no、pl、pt、pt-br、ru、sl、sv、thまたはtr)。 |
|
|
仮想マシンで使用されるマウス・タイプ(OS_DEFAULT、PS2_MOUSE、USB_MOUSEまたはUSB_TABLET)。 |
|
|
ドメイン・タイプ(次のオプション):
|
|
|
仮想マシンによって使用されるMACアドレスとネットワークのリスト。 |
|
|
仮想マシンの起動オプション(always、restoreまたはnever)。 |
|
|
仮想マシンによって使用されるディスク(スロット、ディスクタイプおよび内容)のリスト。 |
|
|
仮想マシンのブートストラップに使用されるブート・オプション(PXE、DISKまたはCDROM)。 |
|
|
指定したCPUプールを仮想マシンに割り当てます。 |
oakcli configure vmtemplateコマンドを使用して、Oracle Database Appliance仮想化プラットフォームで仮想マシン・テンプレートを構成します。
oakcli configure vmtemplate name [-vcpu cpucount -maxvcpu maxcpu -cpuprio priority -cpucap cap -memory memsize -maxmemory max_memsize -os sys -keyboard lang -mouse mouse_type -domain dom -network netlist -disk disks]
表D-7 oakcli configure vmコマンド・パラメータ
| パラメータ | 説明 |
|---|---|
|
|
仮想マシンに割り当てられる名前。 |
|
|
仮想マシンに割り当てられるノード数(1~24)。 |
|
|
仮想マシンが使用できるCPUの最大数(1~24)。 |
|
|
CPU使用の優先度。値が大きいほど優先度が高くなります(1~256)。 |
|
|
仮想マシンが利用できるCPUのパーセンテージ(1~100)。 |
|
|
仮想マシンに与えられるメモリー容量(1 GB~88 GBまたは1 MB~90112 MB)。 |
|
|
仮想マシンで使用できるメモリー容量。 |
|
|
仮想マシンで使用されるオペレーティング・システム(WIN_2003、WIN_2008、WIN_7、WIN_VISTA、OTHER_WIN、OL_4、OL_5、OL_6、RHL_4、RHL_5、RHL_6、LINUX_RECOVERY、OTHER_LINUX、SOLARIS_10、SOLARIS_11、OTHER_SOLARISまたはNONE)。 |
|
|
仮想マシンで使用されるキーボード(en-us、ar、da、de、de-ch、en-gb、es、et、fi、fo、fr、fr-be、fr-ca、hr、hu、is、it、ja、lt、lv、mk、nl、n--be、no、pl、pt、pt-br、ru、sl、sv、thまたはtr)。 |
|
|
仮想マシンで使用されるマウス・タイプ(OS_DEFAULT、PS2_MOUSE、USB_MOUSEまたはUSB_TABLET)。 |
|
|
ドメイン・タイプ(次のオプション):
|
|
|
仮想マシンによって使用されるMACアドレスとネットワークのリスト。 |
|
|
仮想マシンによって使用されるディスク(スロット、ディスクタイプおよび内容)のリスト。 |
oakcli copyコマンドを使用して、Oracle Database Applianceの構成中に使用する構成ファイルのコピーを用意します。
oakcli copyコマンドを次のように実行します。absolute_conf_fileは既存の構成ファイルのフル・パス名です。
oakcli copy -conf absolute_conf_file [-h]
oakcli create databaseコマンドを使用して、Oracle Database Applianceでデータベースを追加作成します。
表D-9 oakcli create databaseコマンド・パラメータ
| パラメータ | 説明 |
|---|---|
|
|
|
|
|
|
|
|
|
|
|
|
次のコマンドでは、バージョン11.2.0.3.3を使用するsales1というデータベースがsales1 Oracleホーム内に作成されます。
oakcli create database -db sales1 -oh sales1 -version 11.2.0.3.3
次のコマンドでは、sales2というデータベースがsalesdbtemplated.outファイルから作成されます。
oakcli create database -db sales2 -params salesdbtemplate.out
oakcli delete vmtemplateコマンドを使用して、仮想マシン・テンプレートを削除します。
oakcli delete vmtemplateコマンドでは次の構文を使用します。
oakcli delete vmtemplatetemplate_name[-server=node_number][-h]
oakcli deployコマンドを使用して、Oracle Grid InfrastructureをOracle Database Appliance上のクラスタに対してデプロイします。
oakcli import vmtemplateコマンドを使用して、仮想マシン・テンプレートをインポートします。
oakcli locateコマンドでは、Oracle ASM disknameパラメータに対して指定するOracle Automatic Storage Management (Oracle ASM)ディスクと関連付けられているディスクが配置されます。
oakcli manageコマンドを使用して、Oracle Database Applianceリポジトリを管理します。
表D-15 oakcli manageコマンド・サマリー
| コマンド | 説明 |
|---|---|
|
|
特定のコンポーネントに対するリポジトリ情報を消去します。 |
|
|
Oracle Database Applianceの診断情報を収集します。 |
oakcli manage cleanrepoコマンドを使用して、特定のコンポーネントまたはバージョンに対するリポジトリ情報を消去します。
oakcli manage diagcollectコマンドを使用して、トラブルシューティングやOracle Supportとの連携のために、Oracle Database Applianceに関する診断情報を収集します。
oakcli manage diagcollect [--all | --crs [--crshome crs_home_dir] [--core] | --install | --chmos [--incidenttime time [--incidentduration time] | --adr adr_location [--afterdate date] [--aftertime time] [--beforetime time] ] [excl comp1,comp2,...] [--clean]
表D-17 oakcli manage diagcollectコマンド・パラメータ
| パラメータ | 説明 |
|---|---|
|
|
自動診断リポジトリ(ADR)およびクラスタ状態モニター(OS)を除くすべての診断情報の収集。これがデフォルトのオプションです。 |
|
|
Oracle Clusterware診断情報の収集。 |
|
|
Oracle Clusterwareホーム・ディレクトリの場所を指定します。 |
|
|
コア・ファイルとOracle Clusterware診断データとのパッケージ化。 |
|
|
スクリプト |
|
|
ADRの診断情報の収集。 |
|
|
指定された日付からアーカイブを収集します。日付を |
|
|
|
|
|
|
|
|
クラスタ状態モニター(OS)・データの収集。 |
|
|
指定された時刻からクラスタ状態モニター(OS)・データを収集します。時刻を
|
|
|
指定された時刻後の期間のクラスタ状態モニター(OS)・データを収集します。時刻をHH:MM形式で入力します。期間を指定しない場合、OAKCLIは指定されたインシデント時刻後のすべてのクラスタ状態モニター(OS)・データを収集します。 |
|
|
指定されたコンポーネント・ログを除外します。有効なコンポーネントは |
|
|
このコマンドで集められた診断関連情報を削除しました。 |
oakcli showコマンドを使用して、各種のOracle Database Applianceコンポーネントのプロパティを表示します。
表D-18 oakcli showコマンド・サマリー
| コマンド | 説明 |
|---|---|
|
|
ディスク・コントローラに関する情報を表示します。 |
|
|
コア・デプロイメントに関する情報を表示します。 |
|
|
コアと仮想マシンのマッピング情報を表示します。 |
|
|
データベースに関する情報を表示します。 |
|
|
データベース・ホームに関する情報を表示します。 |
|
|
共有またはローカルのディスクに関する情報を表示します。 |
|
|
Oracle ASMディスク・グループに関する情報を表示します。 |
|
|
エクスパンダに関する情報を表示します。 |
|
|
ストレージに関する情報を表示します。 |
|
|
ソフトウェアおよびファームウェアのバージョン情報を表示します。 |
|
|
仮想マシンのバージョン情報を表示します。 |
|
|
仮想マシン・テンプレートのバージョン情報を表示します。 |
このコマンドを使用してコントローラに関する情報を表示します。
oakcli show core_config_keyコマンドを使用して、Oracle Database Applianceコアのデプロイ方法に関する情報を表示します。
oakcli show cpupoolコマンドを使用して、仮想マシン・マッピングのコア割当てを表示します。
ノード0のコア・マッピング情報を表示します。
oakcli show cpupool -node 0
Pool Cpu List VM List
default-unpinned-pool [14, 15, 16, 17, ['test1_odarepo1','sample5_odarepo1',
18, 19, 20, 21, 'vm_very_long_name_sample1_odarepo1',
22, 23] 'win_vm1']
twocpu [12, 13] ['vm1_odarepo1']
odaBaseCpuPool [0, 1, 2, 3, 10 ['oakDom1']
, 11]
このコマンドを使用して、データベース名、データベース・タイプ、データベース・ホームの名前および場所、データベース・バージョンなどの各既存データベースに関する情報を表示します。
このコマンドを使用して、ホームの名前、ホームの場所、データベース・バージョンなどの各既存Oracleデータベース・ホームに関する情報を表示します。
oakcli show diskgroupコマンドを使用して、Oracle ASMディスク・グループ情報を表示します。
oakcli show expanderコマンドを使用して、エクスパンダに関する情報を表示します。
oakcli show storageコマンドを使用して、ストレージ・ハードウェアに関する情報を表示します。
oakcli show versionコマンドを使用して、Oracle Database Applianceソフトウェアおよびファームウェアのパッチ・バージョンを表示します。
oakcli show vmコマンドを使用して、仮想マシンの情報を表示します。
すべての仮想マシンの仮想マシン名、メモリーとvCPUの割当て、ステータスおよびリポジトリ名を表示します。
oakcli show vm
NAME MEMORY VCPU STATE REPOSITORY sample5_odarepo1 2048 2 OFFLINE odarepo1 sample6_odarepo1 2048 2 OFFLINE odarepo2 test1_odarepo1 2048 2 OFFLINE odarepo1 test2_odarepo2 2048 2 OFFLINE odarepo2 vm1_odarepo1 4096 4 ONLINE odarepo1 vm2_odarepo2 2048 2 OFFLINE odarepo2 win_vm1 1500 1 ONLINE odarepo1
次のコマンドは、vm1_odarepo1仮想マシンの情報を表示します。
oakcli show vm vm1_odarepo1
Resource: vm1_odarepo1
AutoStart : restore
CPUPriority : 100
Disks : |file:/OVS/Repositories/odarepo1/Vi
rtualMachines/vm1_odarepo1/System.i
mg,xvda,w||file:/OVS/Repositories/o
darepo1/VirtualMachines/vm1_odarepo
1/u01.img,xvdb,w|
Domain : XEN_PVM
ExpectedState : offline
Keyboard : en-us
MaxMemory : 3000
MaxVcpu : 4
Memory : 4096
Mouse : OS_DEFAULT
Name : vm1_odarepo1
Networks : |bridge=priv1||bridge=net1||bridge=
net2|
NodeNum : 0
OS : OL_5
PrivateIP : None
ProcessorCap : 100
RepoName : odarepo1
State : Online
TemplateName : otml_sample1_odarepo1
Vcpu : 4
cpupool : twocpu
vncport : 0
oakcli show vm templateコマンドを使用して、仮想マシン・テンプレートの情報を表示します。
次のコマンドは、sample1_odarepo1仮想テンプレートの情報を表示します。
oakcli show vmtemplate sample_odarepo1
Resource: sample1_odarepo1
CPUPriority : 100
Disks : |file:/OVS/Repositories/odarepo1/Te
mplates/otml_sample1_odarepo1/Syste
m.img,xvda,w||file:/OVS/Repositorie
s/odarepo1/Templates/otml_sample1_o
darepo1/u01.img,xvdb,w|
Domain : XEN_PVM
Keyboard : en-us
MaxMemory : 2048
MaxVcpu : 2
Memory : 2048
Mouse : OS_DEFAULT
Name : sample1_odarepo1
Networks : |bridge=priv1||bridge=net1||bridge=
net2|
NodeNum : 0
OS : OL_5
ProcessorCap : 100
RepoName : odarepo1
Vcpu : 2
oakcli startコマンドを使用して、仮想マシンを起動します。
oakcli unpackコマンドを使用して、パッケージをOAKCLIリポジトリに解凍します。
oakcli updateコマンドを使用して、Oracle Database Applianceパッチを適用します。
oakcli update -patch version [[--infra] | [[--gi][--database]]] [--noreboot] | [--clean] | [--verify]
表D-27 oakcli updateコマンド・パラメータ
| パラメータ | 説明 |
|---|---|
|
|
インストールするパッチ更新を指定します。 |
|
|
パッチ適用対象のインフラストラクチャ(ファームウェア、OS、ASR、HMP、OAKなど)を指定します。これがデフォルトのオプションです。 |
|
|
パッチ適用対象のGrid Infrastructureを指定します。 |
|
--database |
パッチ適用対象のデータベース・ホームを指定します。 |
|
--noreboot |
パッチ適用後にノードが再起動しません。 |
|
--clean |
ローカル・ノード上の一時ファイルをすべてクリーンアップします。 |
|
--verify |
ノード上のパッチ適用可能なコンポーネントを表示します。 |