機械翻訳について

16 KVM用のOracle Database Applianceコマンドライン・インタフェース

odacliコマンドを使用して、Oracle Database ApplianceでOracle Linuxカーネル・ベースの仮想マシン(KVM)を管理します。

カーネル・ベースの仮想マシン(KVM)のコマンドライン・インタフェースについて

odacliコマンドは、Oracle Database Applianceカーネル・ベース仮想マシン(KVM)上でデータベースおよびシステム管理を実行するための主要なメソッドです。

カーネル・ベースの仮想マシン(KVM)でODACLIコマンドを使用して、次のタスクを実行できます:
  • VMインスタンスの管理

  • VMストレージの管理

  • 仮想ディスクの管理

  • 仮想ネットワークの管理

  • CPUプールの管理

ODACLIコマンドの場所およびパスの構成

odacliコマンドライン・インタフェースは、次のディレクトリにあります:

/opt/oracle/dcs/bin/odacli

Oracle Database Applianceサーバーでrootユーザー・アカウントを構成して、パス/opt/oracle/dcs/bin/odacliでodacliコマンドを検索するようにPATH変数を定義します。

ODACLIの構文

Oracle Appliance Managerコマンドライン・インタフェースのコマンドおよびパラメータでは大文字と小文字を区別しません。

odacliコマンドでは、次のコマンド構文を使用します:

odacli command object [options]
  • commandは、アプライアンスで実行するアクションです。 たとえば、showlocateapplyなどです。

  • objectは、odacliコマンドが操作を実行するターゲットまたはオブジェクトです。 たとえば、仮想ディスクまたはネットワークを作成または構成するコマンドを発行したり、他のシステムまたはソフトウェア管理を実行します。 オブジェクトの短縮形も使用できます。

  • optionsは、odacliコマンドのオプション部分です。 オプションは、オブジェクトに対して実行されるodacliコマンドの使用を拡張する1つ以上のオプションで構成されます。 オプションには、オブジェクトで実行するアクションに関する追加情報が含まれます。 オプションの名前には、前にダッシュをつけます。 必要なアクションをコマンドが実行するために、多数のオプションでオブジェクトの名前を必要とします。 ヘルプ・オプション(-h)は、すべてのコマンドで利用できるオプションです。 -hオプションを含める場合に、実行するコマンドの追加情報を取得できます。

Oracle Appliance Managerコマンドライン・インタフェースのヘルプ

次のコマンドを実行して、Oracle Database Applianceで使用可能なすべてのodacliコマンドの使用状況情報を表示します:

odacli -h

特定のodacliコマンドの詳細なヘルプを表示するには、次のコマンドを実行します:

odacli command -h

次のコマンドを実行して、オブジェクトで実行される特定のodacliコマンドに関する詳細なヘルプと、そのオブジェクトで使用できるオプションを表示します。

odacli command object -h

Oracle KVMデータベース・システムでサポートされるODACLIコマンドについて

このリリースのOracle Database Appliance Kernel-Based Virtual Machine (KVM)データベース・システムでサポートされているodacliコマンドを理解します。

このリリースのOracle Database Applianceでは、odacli create-dbsystemまたはブラウザ・ユーザー・インタフェースを介したOracle KVMデータベース・システムのプロビジョニングがサポートされています。 Oracle Database Appliance上のOracle KVM Database Systemでは、次のODACLIコマンドがサポートされています:
  • odacli ping-agent

  • odacli list-jobs

  • odacli describe-job

  • odacli list-networks

  • odacli describe-networks

  • odacli list-networkinterfaces

  • odacli describe-networkinterfaces

  • odacli list-dbhomes

  • odacli describe-dbhome

  • odacli list-databases

  • odacli describe-database

ノート:

このリリースでは、前述のODACLIコマンド以外のODACLIコマンドはOracle Database Appliance KVM Database Systemでサポートされていません。

KVMのodacliデータベース・システム・コマンド

odacli database systemコマンドを使用して、Oracle Database Appliance for Oracle KVM上のデータベースを管理します。

odacli create-dbsystem

odacli create-dbsystemコマンドを使用して、Oracle Database Applianceカーネル・ベースの仮想マシン(KVM)に新しいデータベース・システムを作成します。

構文

 odacli create-dbsystem -p json_payload_path [-j] [-h]

パラメータ

パラメータ 説明

--params, -p

(必須) DBシステム作成の入力パラメータ・ファイル・パス。

--json-j

(オプション)出力をJSON形式で表示します。

--help-h

(オプション)コマンドの使用方法に関するヘルプを表示します。

入力パラメータにJSONファイルを使用してKVMデータベース・システムを作成します。
# odacli create-dbsystem -p example_system.json

Job details
----------------------------------------------------------------
                     ID:  fcfe305c-3e75-4af4-8702-992aa15619d0
            Description:  DB System example_system creation
                 Status:  Created
                Created:  January 5, 2021 9:28:03 AM CST
                Message:

Task Name                                Start Time                          End Time                            Status
---------------------------------------- ----------------------------------- ----------------------------------- ----------

odacli list-dbsystems

odacli list-dbsystemsコマンドを使用して、Oracle Database Appliance Kernel-based Virtual Machine (KVM)上のデータベース・システムを表示します。

構文

 odacli list-dbsystems [-j] [-h]

パラメータ

パラメータ 説明

--json-j

(オプション)出力をJSON形式で表示します。

--help-h

(オプション)コマンドの使用方法に関するヘルプを表示します。

KVMデータベース・システムをリストします。
# odacli list-dbsystems
Name                  Shape       Cores  Memory    Status     Created                  Updated
--------------------  ----------  -----  --------- –------    -----------------------  -----------------------
dbsystem1             odb4        4      32.00 GB  CONFIGURED  2020-12-08 17:39:00 CST  2020-12-08 17:39:00 CST
dbsystem2             odb2        2      16.00 GB  CREATING    2020-12-16 09:28:03 CST  2020-12-16 09:28:03 CST

odacli describe-dbsystem

odacli describe-dbsystemコマンドを使用して、Oracle Database Appliance Kernel-based Virtual Machine (KVM)上のデータベース・システムを記述します。

構文

 odacli describe-dbsystem -n db_system_name [-j] [-h]

パラメータ

パラメータ 説明

--name, -n

(必須) DBシステムの名前を示します。

--json-j

(オプション)出力をJSON形式で表示します。

--help-h

(オプション)コマンドの使用方法に関するヘルプを表示します。

単一ノード・システムのKVMデータベース・システムの詳細を表示します。
# odacli describe-dbsystem -n example_system1

DB System details                                                               
--------------------------------------------------------------------------------
                       ID:  0656fe7b-111a-4bd3-b1f0-b3832812d328
                     Name:  scaoda8m018c4
                    Shape:  odb2
                   Memory:  16.00 GB
                   Status:  CONFIGURED
                  Created:  2021-01-19 00:07:20 UTC
                  Updated:  2021-01-19 00:39:16 UTC

 CPU Pool                 
--------------------------
                     Name:  cpu_pool1
          Number of cores:  2
                     Node:  node1
        Effective CPU set:  14-15,46-47
              Online CPUs:  14, 15, 46, 47
             Offline CPUs:  NONE


 VM Storage               
--------------------------
               Disk group:  DATA
              Volume name:  SC0E8DB73A
            Volume device:  /dev/asm/sc0e8db73a-250
                     Size:  200.00 GB
              Mount Point:  /u05/app/sharedrepo/example_system
 

 VMs                      
--------------------------
                     Host:  host_name
                  VM Name:  vm_name
             VM Host Name:  vm_host_name
             Target State:  ONLINE
            Current State:  ONLINE
 

 VNetworks                
--------------------------
                     Host:  vm_host_name
                  VM Name:  vm_name
                   Public:  xxx.xxx.xxx.xxx   / xxx.xxx.xxx.xxx  / ens3 / BRIDGE(pubnet) 
                      ASM:  xxx.xxx.xxx.xxx  / xxx.xxx.xxxx.xxx / ens4 / BRIDGE(privasm) VLAN(priv0.100)

Databases
--------------------------
                     Name:  c1kdb
              Resource ID:  a98ea0d7-ec75-4dd7-a6b3-f72e0b644e3f
              Unique name:  c1kdb
              Database ID:  1053377603
              Domain name:  domain_name
               DB Home ID:  5ea6c0a1-d2ae-4b7f-96e9-109a569cd09b
                    Shape:  odb1
                  Version:  19.10.0.0.210119
                  Edition:  EE
                     Type:  SI
                     Role:  PRIMARY
                    Class:  OLTP
                  Storage:  ASM
               Redundancy:
         Target node name:
            Character set:  AL32UTF8
        NLS character set:
                 Language:  AMERICAN
                Territory:  AMERICA
          Console enabled:  false
             SEHA enabled:  false
      Associated networks:  NONE
         Backup config ID:
       Level 0 Backup Day:  sunday
       Autobackup enabled:  true
              TDE enabled:  true
                 CDB type:  true
                 PDB name:  pdb1
           PDB admin user:  pdbadmin
InfiniBandを使用しない高可用性システム上のKVMデータベース・システムの詳細を表示します。
# odacli describe-dbsystem -n example_system2

DB System details
--------------------------------------------------------------------------------
                       ID:  04f718f8-ddc9-4b45-8e8e-07d14165eb9c
                     Name:  example_system2
                    Shape:  odb2
                   Memory:  16.00 GB
                   Status:  CONFIGURED
                  Created:  2021-01-19 10:00:08 UTC
                  Updated:  2021-01-19 10:04:02 UTC

CPU Pool
--------------------------
                     Name:  c4bfa26faa
          Number of cores:  2
                     Node:  n1
        Effective CPU set:  0-1,20-21
              Online CPUs:  0, 1, 20, 21
             Offline CPUs:  NONE


                     Node:  n2
        Effective CPU set:  0-1,20-21
              Online CPUs:  0, 1, 20, 21
             Offline CPUs:  NONE
 

 VM Storage
--------------------------
               Disk group:  DATA
              Volume name:  S4BFA26FAA
            Volume device:  /dev/asm/s4bfa26faa-497
                     Size:  400.00 GB
              Mount Point:  /u05/app/sharedrepo/example_system

 VMs
--------------------------
                     Host:  host1
                  VM Name:  x4bfa26faa
             VM Host Name:  example_domain1
             Target State:  ONLINE
            Current State:  ONLINE
 

                     Host:  host2
                  VM Name:  y4bfa26faa
             VM Host Name:  example_domain2
             Target State:  ONLINE
            Current State:  ONLINE
 
 VNetworks
--------------------------
                     Host:  example_domain1
                  VM Name:  x4bfa26faa
                   Public:  xxx.xxx.xxx.xxx   / xxx.xxx.xxx.xxx  / ens3 / BRIDGE(pubnet)
                      ASM:  xxx.xxx.xxx.xxx  / xxx.xxx.xxx.xxx / ens4 / BRIDGE(privasm) VLAN(icbond0.100)
             Interconnect:  xxx.xxx.xxx.xxx  / xxx.xxx.xxx.xxx / ens5 /
 

                     Host:  example_domain2
                  VM Name:  y4bfa26faa
                   Public:  xxx.xxx.xxx.xxx    / xxx.xxx.xxx.xxx  / ens3 / BRIDGE(pubnet)
                      ASM:  xxx.xxx.xxx.xxx    / xxx.xxx.xxx.xxx / ens4 / BRIDGE(privasm) VLAN(icbond0.100)
             Interconnect:  xxx.xxx.xxx.xxx  / xxx.xxx.xxx.xxx / ens5 /

Databases
--------------------------
                     Name:  flashvm
              Resource ID:  350b72f7-2351-49e7-ada3-4051af9594f0
              Unique name:  flashvmU
              Database ID:
              Domain name:  domain_name
               DB Home ID:  617664f6-0a16-4922-8346-9eeb3d7256ee
                    Shape:  odb2
                  Version:  19.0.0.0
                  Edition:  EE
                     Type:  SI
                     Role:  PRIMARY
                    Class:  OLTP
                  Storage:  ASM
               Redundancy:
         Target node name:
            Character set:  AL32UTF8
        NLS character set:
                 Language:  AMERICAN
                Territory:  AMERICA
          Console enabled:  false
             SEHA enabled:  false
      Associated networks:  NONE
         Backup config ID:
       Level 0 Backup Day:  sunday
       Autobackup enabled:  true
              TDE enabled:  true
                 CDB type:  false
                 PDB name:
           PDB admin user:
InfiniBandを使用して、高可用性システムのKVMデータベース・システムの詳細を表示します。
# odacli describe-dbsystem -n example_system3
DDB System details
--------------------------------------------------------------------------------
                       ID:  0c5280a1-3ee1-438e-ad11-1cee23de17fd
                     Name:  example_system3
                    Shape:  odb2
                   Status:  CONFIGURED
                   Memory:  16.00 GB
                 Created:  2020-12-10 02:11:11 UTC
                  Updated:  2020-12-10 02:11:11 UTC

 CPU Pool
--------------------------
                     Name:  ce2ab55255
          Number of cores:  2
                     Node:  node1
        Effective CPU set:  4-5,24-25
              Online CPUs:  4, 5, 24, 25
             Offline CPUs:  NONE


                     Node:  node2
        Effective CPU set:  4-5,24-25
              Online CPUs:  4, 5, 24, 25
             Offline CPUs:  NONE

 VM Storage
--------------------------
               Disk group:  DATA
              Volume name:  SE2AB55255
            Volume device:  /dev/asm/se2ab55255-187
                     Size:  400.00 GB
              Mount Point:  /u05/app/sharedrepo/example_system

 VMs
--------------------------
                     Host:  host1
                  VM Name:  xe2ab55255
             VM Host Name:  host_name1
             Target State:  ONLINE
            Current State:  ONLINE
 

                     Host:  host2
                  VM Name:  ye2ab55255
             VM Host Name:  host_name2
             Target State:  ONLINE
            Current State:  ONLINE
 

 VNetworks
--------------------------
                     Host:  node1
                  VM Name:  xe2ab55255                
                   Public:  xxx.xxx.xxx.xxx    /xxx.xxx.xxx.xxx   / ens3 / BRIDGE(pubnet)
                      ASM:  xxx.xxx.xxx.xxx    / xxx.xxx.xxx.xxx   / ibbond0 / VF(90:03.5)
             Interconnect:  xxx.xxx.xxx.xxx  / xxx.xxx.xxx.xxx / ibbond1 / VF(90:01.7)
 
                     Host:  node2
                  VM Name:  ye2ab55255
                   Public:  xxx.xxx.xxx.xxx    / xxx.xxx.xxx.xxx   / ens3 / BRIDGE(pubnet)
                      ASM:  xxx.xxx.xxx.xxx    / xxx.xxx.xxx.xxx   / ibbond0 / VF(90:01.0)
             Interconnect:  xxx.xxx.xxx.xxx  / xxx.xxx.xxx.xxx / ibbond1 / VF(90:01.6)

Databases
--------------------------
                     Name:  datavm
              Resource ID:  6aac341a-3c73-46eb-af2a-1eada9b57661
              Unique name:  datavmU
              Database ID:  3806144946
              Domain name:  domain_name
               DB Home ID:  dcc928f1-5eb3-477b-875d-050640b7f68c
                    Shape:  odb2
                  Version:  19.10.0.0.210119
                  Edition:  EE
                     Type:  RAC
                     Role:  PRIMARY
                    Class:  OLTP
                  Storage:  ASM
               Redundancy:
         Target node name:
            Character set:  AL32UTF8
        NLS character set:
                 Language:  AMERICAN
                Territory:  AMERICA
          Console enabled:  false
             SEHA enabled:  false
      Associated networks:  NONE
         Backup config ID:
       Level 0 Backup Day:  sunday
       Autobackup enabled:  true
              TDE enabled:  true
                 CDB type:  false
                 PDB name:
           PDB admin user:

odacli describe-dbsystem-image

odacli describe-dbsystem-imageコマンドを使用して、Oracle Database ApplianceシステムでサポートされているOracle Grid InfrastructureおよびOracle Databaseのバージョンと、クローン・ファイルおよびデータベース・システムKVMイメージの可用性を表示します。

構文

 odacli describe-dbsystem-image [-j] [-h]

パラメータ

パラメータ 説明

--json-j

(オプション)出力をJSON形式で表示します。

--help-h

(オプション)コマンドの使用方法に関するヘルプを表示します。

KVMデータベース・システム・イメージの詳細の表示

# odacli describe-dbsystem-image
DB System Image details
--------------------------------------------------------------------------------
Component Name Supported Versions Available Versions
-------------------- -------------------- --------------------
DBVM            19.10.0.0.0        19.10.0.0.0
GI              19.10.0.0.210119   19.10.0.0.210119
DB              19.10.0.0.210119   19.10.0.0.210119

KVMデータベース・システム・イメージが使用できないシステムの詳細の表示

# odacli describe-dbsystem-image
DB System Image details
--------------------------------------------------------------------------------
Component Name Supported Versions Available Versions
-------------------- -------------------- --------------------
DBVM            19.10.0.0.0        not-available
GI              19.10.0.0.210119   19.10.0.0.210119
DB              19.10.0.0.210119   19.10.0.0.210119

出力には、KVMデータベース・システム・イメージがシステムでまだ使用できないことが示されています。 イメージをダウンロードし、odacli update-repositoryを実行してイメージをリポジトリにインポートします。 出力には、Oracle Grid InfrastructureおよびOracle Databaseクローンがシステムですでに使用可能であることが示されています。

odacli start-dbsystem

odacli start-dbsystemコマンドを使用して、Oracle Database Appliance Kernel-based Virtual Machine (KVM)でデータベース・システムを起動します。

構文

 odacli start-dbsystem -n dbsystem_name [-nn node_name] [-j] [-h]

パラメータ

パラメータ 説明

--name, -n

(必須) DBシステムの名前を示します。

--node-name, -nn

(オプション) DBシステムVMを起動するベア・メタル・システム・ノード名を指定します。

--json-j

(オプション)出力をJSON形式で表示します。

--help-h

(オプション)コマンドの使用方法に関するヘルプを表示します。

KVMデータベース・システムを起動します。
# odacli start-dbsystem -n example_system

Job details
----------------------------------------------------------------
                     ID:  68044afa-d3cc-4024-9dc8-50fcf847642c
            Description:  DB System scaoda8s008c4 start
                 Status:  Success
                Created:  December 16, 2020 9:12:51 AM UTC
                Message:
Task Name                                Start Time                          End Time                            Status
---------------------------------------- ----------------------------------- ----------------------------------- ----------
Start DB System                          December 16, 2020 9:12:51 AM UTC    December 16, 2020 9:12:52 AM UTC    Success

odacli stop-dbsystem

odacli stop-dbsystemコマンドを使用して、Oracle Database Appliance Kernel-based Virtual Machine (KVM)上のデータベース・システムを停止します。

構文

 odacli stop-dbsystem -n dbsystem_name [-nn node_name] [-f] [-j] [-h]

パラメータ

パラメータ 説明

--name, -n

(必須) DBシステムの名前を示します。

--force, -f

(オプション) DBシステムを強制的に停止します。

--node-name, -nn

(オプション) DBシステムVMを停止するベア・メタル・システム・ノード名を指定します。

--json-j

(オプション)出力をJSON形式で表示します。

--help-h

(オプション)コマンドの使用方法に関するヘルプを表示します。

KVMデータベース・システムを停止します。
# odacli stop-dbsystem -n example_system

Job details
----------------------------------------------------------------
                     ID:  68044afa-d3cc-4024-9dc8-50fcf847642c
            Description:  DB System scaoda8s008c4 start
                 Status:  Success
                Created:  December 16, 2020 9:12:51 AM UTC
                Message:
Task Name                                Start Time                          End Time                            Status
---------------------------------------- ----------------------------------- ----------------------------------- ----------
Stop DB System                          December 16, 2020 9:12:51 AM UTC    December 16, 2020 9:12:52 AM UTC    Success

odacli delete-dbsystem

odacli delete-dbsystemコマンドを使用して、Oracle Database Appliance Kernel-based Virtual Machine (KVM)上のデータベース・システムを削除します。

構文

 odacli delete-dbsystem -n dbsystem_name [-f] [-j] [-h]

パラメータ

パラメータ 説明

--name, -n

(必須) DBシステムの名前を示します。

--force, -f

(オプション) DBシステムを強制的に削除します。

--json-j

(オプション)出力をJSON形式で表示します。

--help-h

(オプション)コマンドの使用方法に関するヘルプを表示します。

重要:

DROP DATABASE文を使用してデータベースを削除し、データベース・システムを削除する前にデータベース・システム内のOracle DatabaseおよびOracle Grid Infrastructureコンポーネントを削除します。 Oracle DatabaseおよびOracle Grid Infrastructureをアンインストールする手順は、Oracle Databaseドキュメント・ライブラリの「『Oracle Databaseインストレーション・ガイド』」および「『Oracle Grid Infrastructureインストレーション・ガイド』」を参照してください。

KVMデータベース・システムを削除します。
# odacli delete-dbsystem -n example_system
WARNING: please ensure GI and *all* databases within the DB system are properly deinstalled before proceeding.
Do you confirm delete DB System 'example_system'? (Options: y/n, default: n):

Job details
----------------------------------------------------------------
                    ID:  4d70e75d-1bc0-4917-a50a-63cd6a108d1e
            Description:  DB System example_system deletion
                 Status:  Success
                Created:  January 16, 2021 9:19:54 AM UTC
                Message:
 
Task Name                                Start Time                          End Time                            Status
---------------------------------------- ----------------------------------- ----------------------------------- ----------

# odacli describe-job -i 4d70e75d-1bc0-4917-a50a-63cd6a108d1e

Job details
----------------------------------------------------------------
                     ID:  4d70e75d-1bc0-4917-a50a-63cd6a108d1e
            Description:  DB System example_system deletion
                 Status:  Success
                Created:  January 16, 2021 9:19:54 AM UTC
                Message:

Task Name                                Start Time                          End Time                            Status
---------------------------------------- ----------------------------------- ----------------------------------- ----------
Remove DB System from Clusterware        January 16, 2021 9:19:54 AM UTC    January 16, 2021 9:19:54 AM UTC    Success
Deprovision DB System VM(s)              January 16, 2021 9:19:54 AM UTC    January 16, 2021 9:19:54 AM UTC    Success
Delete DB System ACFS filesystem         January 16, 2021 9:19:54 AM UTC    January 16, 2021 9:20:04 AM UTC    Success
Delete DB System ASM volume              January 16, 2021 9:20:04 AM UTC    January 16, 2021 9:20:11 AM UTC    Success
Delete DB System VNetworks               January 16, 2021 9:20:04 AM UTC    January 16, 2021 9:20:11 AM UTC    Success
Delete DB System metadata                January 16, 2021 9:20:11 AM UTC    January 16, 2021 9:20:11 AM UTC    Success

odacli VMストレージ・コマンドfor KVM

odacli仮想マシン・ストレージ・コマンドを使用して、Oracle KVM用のOracle Database Applianceのストレージを管理します。

odacli create-vmstorage

odacli create-vmstorageコマンドを使用して、Oracle Database Applianceカーネル・ベースの仮想マシン(KVM)に新しいVMストレージを作成します。

構文

 odacli create-vmstorage -n name -s size -dg disk_group [-j] [-h]

パラメータ

パラメータ 説明

--name, -n

VMストレージに割り当てられる名前。

--size, -s

ストレージ・サイズを指定します。 形式はK|M|G|Tです。 最小サイズは1024M (1G)

--diskgroup, -dg

(オプション) VMストレージのASMディスク・グループを定義します(デフォルト): DATA).

--json-j

(オプション)出力をJSON形式で表示します。

--help-h

(オプション)コマンドの使用方法に関するヘルプを表示します。

8 GBのshare1という名前のVMストレージを作成します。
# odacli create-vmstorage -n share1 -s 8G

odacli list-vmstorages

odacli list-vmstoragesコマンドを使用して、Oracle Database Applianceカーネル・ベースの仮想マシン(KVM)上のすべてのVMストレージをリストします。

構文

 odacli list-vmstorages [-j] [-h]

パラメータ

パラメータ 説明

--json-j

(オプション)出力をJSON形式で表示します。

--help-h

(オプション)コマンドの使用方法に関するヘルプを表示します。

# odacli list-vmstorages

odacli describe-vmstorage

odacli describe-vmstorageコマンドを使用して、Oracle Database Applianceカーネル・ベースの仮想マシン(KVM)上のVMストレージを記述します。

構文

 odacli describe-vmstorage -n name [-j] [-h]

パラメータ

パラメータ 説明

--name, -n

VMストレージの名前を指定します。

--json-j

(オプション)出力をJSON形式で表示します。

--help-h

(オプション)コマンドの使用方法に関するヘルプを表示します。

例: share1という名前のVMストレージの記述

# odacli describe-vmstorage -n share1

odacli modify-vmstorage

odacli modify-vmstorageコマンドを使用して、Oracle Database Applianceカーネル・ベース仮想マシン(KVM)のVMストレージ構成を変更します。

構文

 odacli modify-vmstorage -n name -i increment [-j] [-h]

パラメータ

パラメータ 説明

--name, -n

仮想ディスク名を指定

--increment, -i

変更する増分ストレージ・サイズ。 形式はK|M|G|Tです。

--json-j

(オプション)出力をJSON形式で表示します。

--help-h

(オプション)コマンドの使用方法に関するヘルプを表示します。

share1という名前のVMストレージのサイズを10ギガバイト増やします。

# odacli modify-vmstorage -n share1 -i 10G

odacli delete-vmstorage

odacli delete-vmstorageコマンドを使用して、Oracle Database Applianceカーネル・ベース仮想マシン(KVM)のvmstorage構成を削除します。

構文

 odacli delete-vmstorage -n name [-f] [-j] [-h]

パラメータ

パラメータ 説明

--name, -n

削除するvmstorage名を指定

--force, -f

(オプション)強制オプションを指定

--json-j

(オプション)出力をJSON形式で表示します。

--help-h

(オプション)コマンドの使用方法に関するヘルプを表示します。

share1という名前のVMストレージを削除します。

odacli delete-vmstorage -n share1

Oracle KVMのodacli仮想ディスク・コマンド

Oracle KVMのOracle Database Applianceで仮想ディスクを管理するには、odacli仮想ディスク・コマンドを使用します。

odacli create-vdisk

odacli create-vdiskコマンドを使用して、Oracle Database Applianceカーネル・ベース仮想マシン(KVM)上のVMストレージに新しい仮想ディスクを作成します。

構文

 odacli create-vdisk -n name -vms vmstorage_name -s size -sh -sp [-j] [-h]

パラメータ

パラメータ 説明

--name, -n

名前リポジトリ内で一意である仮想ディスクに割り当てる名前

--vmstorage, -vms

仮想ディスクが作成されるVMストレージの名前

--size, -s

共有リポジトリから共有ディスクに割り当てられる記憶域容量。 デフォルトの単位はG (ギガバイト)で、最小のサイズは500 M (メガバイト)です。 形式はK|M|G|Tです。

--shareable, -sh

(オプション)複数の仮想マシン(shared)で仮想ディスクを共有できるようにするオプションを設定

--sparse, -sp

(オプション)スパースvdiskを作成

--json-j

(オプション)出力をJSON形式で表示します。

--help-h

(オプション)コマンドの使用方法に関するヘルプを表示します。

VMストレージvms1内に、vdisk1という名前の2 GBの非解析共有および共有可能な仮想ディスクを作成します。

odacli create-vdisk -n vdisk1 -vms vms1 -s 2G -sh

odacli list-vdisks

odacli list-vdisksコマンドを使用して、Oracle Database Applianceカーネル・ベース仮想マシン(KVM)上のすべての仮想ディスクをリストします。

構文

 odacli list-vdisks [-j] [-h]

パラメータ

パラメータ 説明

--json-j

(オプション)出力をJSON形式で表示します。

--help-h

(オプション)コマンドの使用方法に関するヘルプを表示します。

odacli list-vdisks

odacli describe-vdisk

odacli describe-vdiskコマンドを使用して、Oracle Database Applianceカーネル・ベースの仮想マシン(KVM)上の仮想ディスクを記述します。

構文

 odacli describe-vdisk -n name [-j] [-h]

パラメータ

パラメータ 説明

--name, -n

仮想ディスクの名前を指定します。

--json-j

(オプション)出力をJSON形式で表示します。

--help-h

(オプション)コマンドの使用方法に関するヘルプを表示します。

例: vdisk1という名前の仮想ディスクの記述

odacli describe-vdisk -n vdisk1

odacli modify-vdisk

odacli modify-vdiskコマンドを使用して、Oracle Database Applianceカーネル・ベースの仮想マシン(KVM)の仮想ディスクを変更します。

構文

 odacli modify-vdisk -n name -i [-no-s|-s] [-j] [-h]

パラメータ

パラメータ 説明

--name, -n

仮想ディスク名を指定

--increment, -i

仮想ディスクを増やすサイズを定義します。 形式は「値単位」で、単位はk | m | g | tです

-no-shareable, --no-s

(オプション)仮想ディスクを共有不可能として設定

--shareable, -s

(オプション)仮想ディスクを共有可能として設定

--json-j

(オプション)出力をJSON形式で表示します。

--help-h

(オプション)コマンドの使用方法に関するヘルプを表示します。

vdisk1という名前の仮想ディスクのサイズを4ギガバイト増やします。

# odacli modify-vdisk -n vdisk1 -i 4G

odacli clone-vdisk

odacli clone-vdiskコマンドを使用して、Oracle Database Applianceカーネル・ベースの仮想マシン(KVM)で仮想ディスクをクローニングします。

構文

 odacli clone-vdisk -n name -cn clone_name [-j] [-h]

パラメータ

パラメータ 説明

--name, -n

クローニングする仮想ディスク名を指定

--clone-name, -cn

クローニングされた仮想ディスクの名前を指定

--json-j

(オプション)出力をJSON形式で表示します。

--help-h

(オプション)コマンドの使用方法に関するヘルプを表示します。

vdisk1という名前の仮想ディスクのクローンを、vdisk1_cloneという名前で作成します。 クローニングされたディスクは、vdisk1と同じストレージに作成されます。

# odacli clone-vdisk -n vdisk1 -cn vdisk1_clone

odacli delete-vdisk

odacli delete-vdiskコマンドを使用して、Oracle Database Applianceカーネル・ベースの仮想マシン(KVM)の仮想ディスクを削除します。

構文

 odacli delete-vdisk -n name [-f] [-j] [-h]

パラメータ

パラメータ 説明

--name, -n

削除する仮想ディスク名を指定

--force, -f

(オプション)強制オプションを指定

--json-j

(オプション)出力をJSON形式で表示します。

--help-h

(オプション)コマンドの使用方法に関するヘルプを表示します。

vdisk1という名前の仮想ディスクを削除します。

# odacli delete-vdisk -n vdisk1

ベア・メタルおよびKVMのodacli CPUプール・コマンド

ベア・メタルおよびKVMデプロイメント用にOracle Database Applianceでリソース割当てを管理するには、odacliコマンドを使用します。

CPUプールを使用すると、ベア・メタル環境とKVM環境の両方でCPUリソースを管理できます。 CPUプールには、BMとVMの2タイプがあります。

BM CPUプールを使用して、ベア・メタル・ホスト上のデータベースがCPUプールで指定されたCPUのみで確実に実行されるようにします。

VM CPUプールを使用して、仮想マシンのワークロードへのCPUリソース割当てをケージおよび管理します。 ワークロードは、CPUプールを作成し、仮想マシンを特定のCPUプールに割り当てるか固定することで分離されます。 CPUプールに仮想マシンをピン留めすると、仮想マシンがそのCPUプールのCPUのみを使用するようになります。

CPUプール内のリソースはオー・バー・ラップできません。つまり、CPUプールはCPUを共有できません。

odacli create-cpupool

odacli create-cpupoolコマンドを使用して、Oracle Database Applianceベア・メタルまたはカーネル・ベースの仮想マシン(KVM)デプロイメントに新しいCPUプールを作成します。

構文

 odacli create-cpupool -n name -c {-bm|-vm} -nn node_name [-j] [-h]

パラメータ

パラメータ 説明

--name, -n

CPUプール名を指定します。

--cores-c

CPUプール・コアを指定

--bm, -bm

CPUプールをベア・メタルとして指定

--vm, -vm

CPUプールを仮想マシンとして指定します。

--node-name, -nn

(オプション) CPUプールが作成されるノードを指定します。 高可用性デプロイメントでは、このオプションを指定しない場合、CPUプールは両方のノードに作成されます。

--json-j

(オプション)出力をJSON形式で表示します。

--help-h

(オプション)コマンドの使用方法に関するヘルプを表示します。

使用上のノート

  • BM CPUプールをデータベースにアタッチします。 ベア・メタルCPUプールは、複数のデータベースに割り当てることができます。
  • VM CPUプールVMゲスト・マシンをアタッチします。 VM CPUプールは複数のVMに割り当てることができます。
  • CPUプール内のリソースはオー・バー・ラップできません。つまり、CPUプールはCPUを共有できません。
  • BM CPUプールを作成したら、create-databaseまたはmodify-databaseコマンドを使用してこのCPUプールをデータベースに関連付けることができます。
  • VM CPUプールを作成した後、create-vmまたはmodify-vmコマンドを使用してこのCPUプールをVMに関連付けることができます。
  • コアの数は、2からシステムで使用可能なコアの合計数までの偶数で構成されます。

6つのコアが関連付けられたcpupool1という名前のBM CPUプールを作成します。
# odacli create-cpupool -n cpupool1 -c 6 -bm
6つのコアが関連付けられたcpupool2という名前のVM CPUプールを作成します。
# odacli create-cpupool -n cpupool2 -c 6 -vm

odacli list-cpupools

odacli list-cpupoolsコマンドを使用して、Oracle Database Applianceベア・メタルまたはカーネル・ベースの仮想マシン(KVM)デプロイメント上のすべてのCPUプールをリストします。

構文

 odacli list-cpupools [-j] [-h]

パラメータ

パラメータ 説明

--json-j

(オプション)出力をJSON形式で表示します。

--help-h

(オプション)コマンドの使用方法に関するヘルプを表示します。

# odacli list-cpupools

odacli describe-cpupool

odacli describe-cpupoolコマンドを使用して、Oracle Database Applianceベア・メタルまたはカーネル・ベースの仮想マシン(KVM)デプロイメント上のCPUプールを記述します。

構文

 odacli describe-cpupool -n name [-j] [-h]

パラメータ

パラメータ 説明

--name, -n

CPUプールの名前を指定します。

--json-j

(オプション)出力をJSON形式で表示します。

--help-h

(オプション)コマンドの使用方法に関するヘルプを表示します。

例: cpupool1という名前のCPUプールの説明

# odacli describe-cpupool -n cpupool1

odacli modify-cpupool

odacli modify-cpupoolコマンドを使用して、Oracle Database Applianceベア・メタルまたはカーネル・ベースの仮想マシン(KVM)デプロイメントでCPUプール構成を変更します。

構文

 odacli modify-cpupool -n name -c cores -f -l [-j] [-h]

パラメータ

パラメータ 説明

--name, -n

CPUプール名を指定

--cores-c

CPUコアの新しい数を指定

--force, -f

(オプション)操作を強制

--live, -l

(オプション)実行中のVMに変更を適用

--json-j

(オプション)出力をJSON形式で表示します。

--help-h

(オプション)コマンドの使用方法に関するヘルプを表示します。

使用上のノート

VM CPUプールでは、--liveが指定されていない場合、変更はVM構成ファイルに適用され、VMの次回起動時にアクティブ化されます。 --liveが指定されている場合、変更はVM構成ファイルと実行中のVMの両方に適用されます。

CPUプールcpupool1のサイズを10に設定します。 --liveが指定されていない場合、変更はVM構成ファイルに適用され、VMの次回起動時にアクティブになります。

# odacli modify-cpupool -n cpupool1 -c 10

odacli delete-cpupool

odacli delete-cpupoolコマンドを使用して、Oracle Database Applianceカーネル・ベースの仮想マシン(KVM)のCPUプール構成を削除します。

構文

 odacli delete-cpupool -n name -f [-j] [-h]

パラメータ

パラメータ 説明

--name, -n

削除するCPUプール名を指定

--force, -f

(オプション)削除を強制します。

--json-j

(オプション)出力をJSON形式で表示します。

--help-h

(オプション)コマンドの使用方法に関するヘルプを表示します。

cpupool1という名前のCPUプールを削除します。

# odacli delete-cpupool -n cpupool1

odacli list-auditrecords

odacli list-auditrecordsコマンドを使用して、Oracle Database Applianceベア・メタルまたはカーネル・ベースの仮想マシン(KVM)デプロイメントでのCPUプールの監査レコードをリストします。

構文

 odacli list-auditrecords -du dcs-username -f from_date-range -l latest -n node_ID -ot operation_type -ou OS_username -rn resource_name -rt resource_type -t to_date-range [-j] [-h]

パラメータ

パラメータ 説明

--dcs-user, -du

(オプション) DCSユーザー名を指定します。

--from, -f

(オプション) CPUプール監査レコードの日付範囲内のfrom日付を指定します。

--latest, -l

(オプション)最新のCPUプール監査レコード数を指定します。

--node-id, -n

(オプション)ノードIDを指定します。

--op-type, -ot

(オプション)操作のタイプを指定します。

--os-user, -ou

(オプション)オペレーティング・システム・ユーザーを指定します。

--rsc-name, -rn

(オプション)リソース名を指定します。

--rsc-type, -rt

(オプション)リソース・タイプを指定します。

--to, -t

(オプション) CPUプール監査レコードの日付範囲内のto日付を指定します。

--json-j

(オプション)出力をJSON形式で表示します。

--help-h

(オプション)コマンドの使用方法に関するヘルプを表示します。

# odacli list-auditrecords
ID                                    Resource type         Resource name         Operation type   DCS username     OS username      Timestamp              
------------------------------------  --------------------  --------------------  ---------------  ---------------  ---------------  -----------------------
41295d99-f263-4284-b6d9-2aff1ae0f850  BM_CPU_POOL           testbmpool            CREATE           oda-admin        root             2020-10-08 13:27:05 UTC
0f07a013-5bb4-4cd8-bd49-04dc61fcd454  BM_CPU_POOL           pool_9f74a8e9-        DELETE           oda-admin        root             2020-10-08 12:26:30 UTC
d858269b-6c28-4bc2-af71-79004f3561e6  BM_CPU_POOL           pool_9f74a8e9-        CREATE           oda-admin        root             2020-10-08 12:24:36 UTC
9d7852c1-93fb-410e-9e0c-8c0a95ed3f0c  VM_CPU_POOL           pool_d48e81e4-        DELETE           oda-admin        root             2020-10-08 12:06:45 UTC
0235cc84-9345-40bc-ac4f-7de3f63202e2  VM_CPU_POOL           pool_4fe0b4f4-        DELETE           oda-admin        root             2020-10-08 12:06:45 UTC
762f7263-7bd9-4b12-b891-48305165bf36  VM_CPU_POOL           pool_4fe0b4f4-        MODIFY           oda-admin        root             2020-10-08 12:06:22 UTC
0bd2a25d-2327-4918-bd47-8c00f7406f92  VM_CPU_POOL           pool_4fe0b4f4-        MODIFY           

odacli describe-auditrecord

odacli describe-auditrecordコマンドを使用して、Oracle Database Applianceベア・メタルまたはカーネル・ベースの仮想マシン(KVM)デプロイメントでのCPUプールの監査レコードを記述します。

構文

 odacli describe-auditrecord -i [-j] [-h]

パラメータ

パラメータ 説明

--id-i

監査レコードのIDを記述します。

--json-j

(オプション)出力をJSON形式で表示します。

--help-h

(オプション)コマンドの使用方法に関するヘルプを表示します。

# odacli describe-auditrecord -i 41295d99-f263-4284-b6d9-2aff1ae0f850
Audit Record details                                                            
--------------------------------------------------------------------------------
 Event details            
--------------------------
                Record ID:  41295d99-f263-4284-b6d9-2aff1ae0f850
         Record timestamp:  2020-10-08 13:27:05 UTC
             DCS username:  oda-admin
              OS username:  root
               Cluster ID:  test_cluster-c
                  Node ID:  test_cluster

 Resource/Operation       
--------------------------
            Resource type:  BM_CPU_POOL
              Resource ID:  b17cb623-bf79-491f-86d8-d8502987e26c
            Resource name:  testbmpool
           Operation type:  CREATE
    Operation description:  Created with '2' cores and allocation 'test_cluster:1-2,17-18'

odacli VMネットワーク・コマンドfor KVM

odacli仮想マシン・ネットワーク・コマンドを使用して、Oracle Database Appliance for Oracle KVMでネットワークを管理します。

odacli create-vnetwork

odacli create-vnetworkコマンドを使用して、Oracle Database Applianceカーネル・ベースの仮想マシン(KVM)に新しいネットワークを作成します。

構文

 odacli create-vnetwork -n name -if interface-name -t type -br bridge -g gateway -ip IP-address -nm netmask -u uniform -vlan VLAN-network ID [-j] [-h]

パラメータ

パラメータ 説明

--name, -n

仮想ネットワーク名を指定します。

--interface-name, -if

ホスト上のネットワーク・インタフェースを指定します。 これは、物理インタフェースまたは結合インタフェースです。

--type, -t

仮想ネットワーク・タイプを指定します。 値はbridgeまたはbridged-vlanです。

--bridge, -br

(任意)ブリッジの名前を指定します。

--gateway, -gw

(オプション)仮想ネットワーク・ゲートウェイを指定

--ip, -ip

(オプション)仮想ネットワーク・アドレスを指定します。 複数のアドレスを指定する場合は、"node0_ip,node1_ip,..."の形式を使用

--netmask, -nm

(オプション)仮想ネットワークのネットマスクを指定

--uniform, -u

(オプション)高可用性デプロイメントの両方のノードで仮想ネットワークを作成するかどうかを指定

--vlan-id, -vlan

(オプション) VLANネットワークIDを指定

--json-j

(オプション)出力をJSON形式で表示します。

--help-h

(オプション)コマンドの使用方法に関するヘルプを表示します。

使用上のノート

vnetworkの作成時にIPアドレス、ネットマスク、またはゲートウェイを指定しなかった場合は、あとでodacli modify-vnetworkコマンドを使用して追加できます。

インタフェースbtbond2を使用して、タイプがbridgedのVMネットワークを作成します。
# odacli create-vnetwork -n vnet1 -if btbond2 -type bridged

odacli list-vnetworks

odacli list-vnetworksコマンドを使用して、Oracle Database Applianceカーネル・ベース仮想マシン(KVM)上のすべての仮想ネットワークをリストします。

構文

 odacli list-vnetworks [-j] [-h]

パラメータ

パラメータ 説明

--json-j

(オプション)出力をJSON形式で表示します。

--help-h

(オプション)コマンドの使用方法に関するヘルプを表示します。

# odacli list-vnetworks

odacli describe-vnetwork

odacli describe-vnetworkコマンドを使用して、Oracle Database Applianceカーネル・ベースの仮想マシン(KVM)上の仮想ネットワークを記述します。

構文

 odacli describe-vnetwork -n [-j] [-h]

パラメータ

パラメータ 説明

--name, -n

仮想ネットワークの名前を指定します。

--json-j

(オプション)出力をJSON形式で表示します。

--help-h

(オプション)コマンドの使用方法に関するヘルプを表示します。

例: vnet1という名前のVMネットワークの説明

# odacli describe-vnetwork -n vnet1

odacli start-vnetwork

odacli start-vnetworkコマンドを使用して、Oracle Database Applianceカーネル・ベースの仮想マシン(KVM)で仮想ネットワークを起動します。

構文

 odacli start-vnetwork -n name [-j] [-h]

パラメータ

パラメータ 説明

--name, -n

停止する仮想マシン名を指定

--json-j

(オプション)出力をJSON形式で表示します。

--help-h

(オプション)コマンドの使用方法に関するヘルプを表示します。

vnet1という名前の仮想ネットワークを起動します。

# odacli start-vnetwork -n vnet1

odacli stop-vnetwork

odacli stop-vnetworkコマンドを使用して、Oracle Database Applianceカーネル・ベースの仮想マシン(KVM)で仮想ネットワークを停止します。

構文

 odacli stop-vnetwork -n name [-j] [-h]

パラメータ

パラメータ 説明

--name, -n

停止する仮想ネットワークを指定

--json-j

(オプション)出力をJSON形式で表示します。

--help-h

(オプション)コマンドの使用方法に関するヘルプを表示します。

vnet1という名前の仮想ネットワークを停止します。

# odacli stop-vnetwork -n vnet1

odacli modify-vnetwork

odacli modify-vnetworkコマンドを使用して、Oracle Database Applianceカーネル・ベースの仮想マシン(KVM)でネットワークを変更します。

構文

 odacli modify-vnetwork -n name -if -t -br -gw -ip -nm -u -vlan [-j] [-h]

パラメータ

パラメータ 説明

--name, -n

仮想ネットワーク名を指定します。

--gateway, -gw

(オプション)仮想ネットワーク・ゲートウェイを指定

--ip, -ip

(オプション)仮想ネットワーク・アドレスを指定します。 複数のアドレスを指定する場合は、"node0_ip,node1_ip,..."の形式を使用

--netmask, -nm

(オプション)仮想ネットワークのネットマスクを指定

--json-j

(オプション)出力をJSON形式で表示します。

--help-h

(オプション)コマンドの使用方法に関するヘルプを表示します。

VMネットワークを変更してゲートウェイを指定します。
# odacli modify-vnetwork -n vnet1 -g 10.11.44.41

odacli delete-vnetwork

odacli delete-vnetworkコマンドを使用して、Oracle Database Applianceカーネル・ベース仮想マシン(KVM)上の仮想ネットワーク構成を削除します。

構文

 odacli delete-vnetwork -n name [-j] [-h]

パラメータ

パラメータ 説明

--name, -n

削除するvnetwork名を指定

--json-j

(オプション)出力をJSON形式で表示します。

--help-h

(オプション)コマンドの使用方法に関するヘルプを表示します。

vnet1という名前のVMネットワークを削除します。

# odacli delete-vnetwork -n vnet1

Oracle KVMのodacli仮想マシン・コマンド

odacli仮想マシン・コマンドを使用して、Oracle Database Appliance for Oracle KVMで仮想マシンを管理します。

odacli create-vm

odacli create-vmコマンドを使用して、Oracle Database Applianceカーネル・ベースの仮想マシン(KVM)に新しい仮想マシンを作成します。

構文

 odacli create-vm -n name -m memory -src source -vc vcpus -vms vmstorage -cp cpupool -d description -g graphics
-mm max-mem-size -mvc max-vcpu-count -ost os-type -osv os_variant -pn preferred_node -s disk_size -vd vdisks
-vn virtual_networks [-j] [-h]

パラメータ

パラメータ 説明

--name, -n

VM名を指定

--memory, -st

VMメモリーのサイズを指定します。 形式は「value_unit」です。 単位はM | gです。

--source, -src

ソース・インストールを指定します。 localの場合は、ISOまたはブート可能なディスク・イメージになります。 リモートの場合は、HTTP、HTTPS、FTPまたはNFSを介してリモートでホストされているインストール・ツリーを示すURIになります。

--vcpus, -vc

使用するvCPUsの数を指定します。

--vmstorage, -vms

VMストレージ名を指定

--cpupool, -cp

(オプション) CPUプール名を指定

--description, -d

(オプション) VMの説明を指定

--extra-args, -ea

(オプション) VMインストーラの追加の引数を指定します。

--graphics, -g

(オプション) VMのグラフィック設定を指定

--max-memory, -mm

(オプション) VMメモリーの最大サイズを指定します。 形式は「value_unit」です。 単位はM | gです。

--max-vcpus, -mvc

(オプション) VCPUの最大数を指定

--os-type, -ost

(オプション)オペレーティング・システムのタイプを指定

--os-variant, -osv

(オプション)オペレーティング・システムのバリアントを指定

--pref-node, -pn

(オプション) VMを実行する優先ノードを指定

--size, -s

(オプション) VMのサイズを指定します。 形式は「value_unit」です。 単位はK | m | g | tです。

--vdisks, -vd

(オプション)使用するvdiskの名前を指定

--vnetworks, -vn

(オプション)使用する仮想ネットワークの名前を指定

--json-j

(オプション)出力をJSON形式で表示します。

--help-h

(オプション)コマンドの使用方法に関するヘルプを表示します。

使用上のノート

--extra-argsパラメータを使用して、kickstart構成ファイル、カーネル・パラメータ(シリアル・コンソールなど)を追加します。 例えば : --extra-args "console=tty0 console=ttyS0,115200 ks=http://192.168.122.100:80/ks.txt"

8個のvcpusと8 GBのメモリーを持つvm1という名前のVMを作成します。 VMはVMストレージvms1に格納されます。 インストールに使用されるソースは、/u01/OL7.isoにあります。

# odacli create-vm -n vm1 -vc 8 -m 8G -vms vs1 -src /u01/OL7.iso

odacli list-vms

odacli list-vmsコマンドを使用して、Oracle Database Applianceカーネル・ベース仮想マシン(KVM)上のすべての仮想マシンをリストします。

構文

 odacli list-vms [-j] [-h]

パラメータ

パラメータ 説明

--json-j

(オプション)出力をJSON形式で表示します。

--help-h

(オプション)コマンドの使用方法に関するヘルプを表示します。

# odacli list-vms

odacli describe-vm

odacli describe-vmコマンドを使用して、Oracle Database Applianceカーネル・ベースの仮想マシン(KVM)上の仮想マシンを記述します。

構文

 odacli describe-vm -n name [-j] [-h]

パラメータ

パラメータ 説明

--name, -n

仮想マシンの名前を指定します。

--json-j

(オプション)出力をJSON形式で表示します。

--help-h

(オプション)コマンドの使用方法に関するヘルプを表示します。

例: vm1という名前の仮想マシンの記述

# odacli describe-vm -n vm1

odacli modify-vm

odacli modify-vmコマンドを使用して、Oracle Database Applianceカーネル・ベースの仮想マシン(KVM)で仮想マシンを変更します。

構文

 odacli modify-vm -n name -as -b boot_option -cfg -avd attach_vdisks -avn attach_vnetworks -d description -dvd detach-vdisk -dvn detach-vnetworks -mm max-memory -mvc max-vcpuc -m memory -no-cp -pn preferred-node -vc vcpu -di disk-increment [-j] [-h]

パラメータ

パラメータ 説明

--name, -n

VM名を指定

--autostart, -as

(オプション)自動起動オプションをVMに設定する必要があるかどうかを指定

--no-autostart, -no-as

(オプション) VMの自動起動オプションを無効にします

--boot-option, -bo

(オプション)使用するブート・オプションを指定

--config, -cfg

(オプション)変更を持続させるかどうかを指定します。

--live, -l

(オプション)指定した変更が有効になるか(true)、次回のブート後に行われるか(false)を示します。 デフォルトはfalseです

--cpu-pool, -cp

(オプション) CPUプール名を指定

--description, -d

(オプション) VMの説明を指定

--failover, -fo

(オプション)フェイルオーバーの構成を指定

--no-failover, -no-fo

(オプション)フェイルオーバーの構成を指定

--vcpus, -vc

(オプション) vCPUsの数を指定します。

--memory, -m

(オプション) VMのメモリー・サイズを指定します。 形式は「value_unit」です。 単位はM | gです。

--max-memory, -mm

(オプション) VMの最大メモリー・サイズを指定します。 形式は「value_unit」です。 単位はM | gです。

--max-vcpus, -mvc

(オプション) vCPUsの最大数を指定します。

--no-cpupool, -no-cp

(オプション)関連付けられたCPUプールを圧縮解除

--detach-vdisk, -dvd

(オプション)切り離す仮想ディスクの名前を指定

--detach-vnetworks, -dvn

(オプション)切り離す仮想ネットワークの名前を指定

--pref-node, -pn

(オプション) VMを実行する優先ノードを指定

--disk-increment, -di

VMのサイズの変更を指定します。 形式は「value_unit」です。 単位はK | m | g | tです。

--attach-vdisks, -avd

(任意)アタッチするvdiskの名前を指定

--attach-vnetworks, -avn

(オプション)アタッチする仮想ネットワークの名前を指定

--json-j

(オプション)出力をJSON形式で表示します。

--help-h

(オプション)コマンドの使用方法に関するヘルプを表示します。

使用上のヒント

  • --live: 変更は実行中のVMインスタンスに適用されますが、VMの停止後は保持されません。
  • --config: 変更はVMインスタンスの構成内に保持され、以降のリブート時に有効になります。
  • --live--configのどちらも指定されていない場合、デフォルトの動作は--configです。
  • 変更をすぐに有効にし、その後のブートで有効にする場合は、--liveオプションと--configオプションの両方を指定できます。

vm1という名前のVMの構成を更新し、実行中のVMとその後のブートの両方で、CPU数を2に設定して最大メモリーを2ギガバイトに設定します。

# odacli modify-vm -n vm1 -vc 6 -mm 6G --live --config

odacli start-vm

odacli start-vmコマンドを使用して、Oracle Database Applianceカーネル・ベースの仮想マシン(KVM)で仮想マシンを起動します。

構文

 odacli start-vm -n name -nn [-j] [-h]

パラメータ

パラメータ 説明

--name, -n

停止する仮想マシン名を指定

--node-name, -nn

(オプション)仮想マシンが起動されるノード名を指定

--json-j

(オプション)出力をJSON形式で表示します。

--help-h

(オプション)コマンドの使用方法に関するヘルプを表示します。

使用上のノート

  • VMにpref-nodeが定義されている場合、VMはpref-nodeで起動します。 VMにpref-nodeが定義されていない場合、VMは高可用性デプロイメントの任意のノードで起動できます。
  • -nというノード名を指定すると、優先ノードが定義されていても、指定されたノードでVMが起動します。

vm1という名前の仮想マシンを起動します。

# odacli start-vm -n vm1

odacli stop-vm

odacli stop-vmコマンドを使用して、Oracle Database Applianceカーネル・ベースの仮想マシン(KVM)で仮想マシンを停止します。

構文

 odacli stop-vm -n name [-f] [-j] [-h]

パラメータ

パラメータ 説明

--name, -n

停止する仮想マシン名を指定

--force, -f

(オプション)強制オプションを指定

--json-j

(オプション)出力をJSON形式で表示します。

--help-h

(オプション)コマンドの使用方法に関するヘルプを表示します。

vm1という名前の仮想マシンを停止します。

# odacli stop-vm -n vm1

odacli migrate-vm

odacli migrate-vmコマンドを使用して、Oracle Database Applianceカーネル・ベース仮想マシン(KVM)上の仮想マシンを移行します。

構文

 odacli migrate-vm -n name -to node [-j] [-h]

パラメータ

パラメータ 説明

--name, -n

移行する仮想マシン名を指定

--target-node, -to

宛先ノードを指定

--json-j

(オプション)出力をJSON形式で表示します。

--help-h

(オプション)コマンドの使用方法に関するヘルプを表示します。

vm1という名前の仮想マシンをノードn1に移行します。

odacli migrate-vm -n vm1 -to n1

odacli clone-vm

odacli clone-vmコマンドを使用して、Oracle Database Applianceカーネル・ベースの仮想マシン(KVM)で仮想マシン構成をクローニングします。

構文

# odacli clone-vm -n name_of_vm_to_clone_from -cn clone_name [-j] [-h]

パラメータ

パラメータ 説明

--name, -n

クローニングする仮想マシン名を指定

--clone-name, -cn

クローニングされた仮想マシンの名前を指定

--description, -d

(オプション)仮想マシンの説明を指定

--json-j

(オプション)出力をJSON形式で表示します。

--help-h

(オプション)コマンドの使用方法に関するヘルプを表示します。

vm1という名前の仮想マシンのクローンを、vm1_cloneという名前で作成します。 クローニングされたVMは、vm1と同じストレージに作成されます。

# odacli clone-vm -n vm1 -cn vm1_clone

odacli delete-vm

odacli delete-vmコマンドを使用して、Oracle Database Applianceカーネル・ベース仮想マシン(KVM)の仮想マシン構成を削除します。

構文

 odacli delete-vm -n name [-f] [-j] [-h]

パラメータ

パラメータ 説明

--name, -n

削除する仮想マシン名を指定

--force, -f

(オプション)強制オプションを指定

--json-j

(オプション)出力をJSON形式で表示します。

--help-h

(オプション)コマンドの使用方法に関するヘルプを表示します。

vm1という名前の仮想マシンを削除します。

odacli delete-vm -n vm1