OCIユーティリティ

使用法

oci-compartmentid [-h | --help]

使用法

インスタンスのルート・パーティションの拡張

インスタンスのルート・パーティションを展開するには:

1. lsblkコマンドを使用して、OSがブート・ボリュームの新しいサイズを識別したことを確認します。

   例:

   lsblk
   NAME               MAJ:MIN RM  SIZE RO TYPE MOUNTPOINT
   sda                  8:0    0  100G  0 disk
   ├─sda1               8:1    0  100M  0 part /boot/efi
   ├─sda2               8:2    0    1G  0 part /boot
   └─sda3               8:3    0 98.9G  0 part
     ├─ocivolume-root 252:0    0 88.9G  0 lvm  /
     └─ocivolume-oled 252:1    0   10G  0 lvm  /var/oled
   sdb                  8:16   0   70G  0 disk
   

   ディスク・ボリュームが予想サイズでない場合は、コマンドを実行してブート・ボリュームを再スキャンします。「Linuxベースのインスタンスにアタッチされたボリュームのディスクの再スキャン」を参照してください。

2. yオプションを指定してoci-growfsユーティリティを実行し、すべてのプロンプトに対して「yes」と回答します。

   sudo /usr/libexec/oci-growfs -y

   例:

   $ sudo /usr/libexec/oci-growfs -y
   Volume Group: ocivolume 
   Mountpoint Data
   
   ---------------
   
   mountpoint: /
   
   source: /dev/mapper/ocivolume-root
   
   filesystem type: xfs
   
   source size: 58.9G
   
   type: lvm
   
   size: 58.9G
   
   physical devices: ['/dev/sda3']
   
   physical volumes: ['/dev/sda', '/dev/sda']
   
   partition number: ['3']
   
   volume group name: ocivolume
   
   volume group path: /dev/ocivolume/root
   
   Partition dry run expansion "/dev/sda3" succeeded.
   
   CHANGE: partition=3 start=2304000 old: size=144496607 end=146800606 new: size=207411167 end=209715166 
   
   Partition expand expansion "/dev/sda3" succeeded.
   update-partition set to true
   FLOCK: try exec open fd 9, on failure exec exits this program
   FLOCK: /dev/sda: obtained exclusive lock
   resizing 3 on /dev/sda using resize_sfdisk_gpt
   209715200 sectors of 512. total size=107374182400 bytes
   ## sfdisk --unit=S --dump /dev/sda
   label: gpt
   label-id: DEC7F1D7-BEBD-4622-9B47-8ADF594E82FD
   device: /dev/sda
   unit: sectors
   first-lba: 34
   last-lba: 209715166
   
   /dev/sda1 : start=        2048, size=      204800, type=C12A7328-F81F-11D2-BA4B-00A0C93EC93B, uuid=CEB6C9AA-4543-4CBF-A44E-D75D7BDDC644, name="EFI System Partition"
   /dev/sda2 : start=      206848, size=     2097152, type=0FC63DAF-8483-4772-8E79-3D69D8477DE4, uuid=340A48CC-18ED-4C1A-AAD7-90CDB8E0B600
   /dev/sda3 : start=     2304000, size=   144496607, type=E6D6D379-F507-44C2-A23C-238F2A3DF928, uuid=8BB84AB7-F5DF-47F1-B630-21442C9102C1
   padding 33 sectors for gpt secondary header
   max_end=209715166 tot=209715200 pt_end=146800606 pt_start=2304000 pt_size=144496607
   resize of /dev/sda returned 0.
   FLOCK: /dev/sda: releasing exclusive lock
   
   CHANGED: partition=3 start=2304000 old: size=144496607 end=146800606 new: size=207411167 end=209715166
   
   Extending /dev/sda3 succeeded.
   Device /dev/sda3 extended successfully.
   Logical volume /dev/ocivolume/root extended successfully.
   

OCI-growfsユーティリティ・オプションの詳細は、共通OCIユーティリティ・オプションを参照してください。

前提条件

最小インスタンスでOCIユーティリティをインストールします。詳細は、OCIユーティリティのインストールを参照してください。

変換タイプ

oci-image-expandユーティリティには、2つのタイプのOracle Linux最小インスタンス変換が用意されています。

• デフォルト: デフォルトのOracle Linuxプラットフォームsystemdサービス、診断パッケージ、クラウド構成設定をリストアし、インスタンスでのスワップを構成および有効化します。デフォルトのプラットフォーム機能をリストアしても、インスタンスの起動時間は長くなりません。この変換タイプは、常にoci-image-expandユーティリティによって適用されます。

• 再起動が必要: デフォルトの変換タイプの説明に従って、デフォルトのOracle Linuxプラットフォーム機能をリストアし、次のユーザーが選択可能な機能の1つ以上を復元します。

  • SELinuxの有効化 - SELinuxの強制モードをリストアします。
  • Kdumpの有効化 - kdump機能を追加し、kdump initramfsを再生成します。
  • Kspliceの有効化 - Kspliceをインストールし、Kspliceサービスを有効にします。Kspliceの使用の詳細は、Oracle Kspliceによる停止時間なしの更新およびOracle Linux Kspliceユーザーズ・ガイドを参照してください。

  これらの選択可能な機能のいずれかを選択すると、インスタンスの起動時間が長くなり、再起動が有効になります。

oci-image-expandユーティリティのログ・ファイルは、/var/log/oci-image-expand.logにあります。

使用法

oci-image-expand [-h | --help]

デフォルトのプラットフォーム・イメージ機能のリストア

Oracle Linuxプラットフォーム・イメージのデフォルトの機能をOracle Linux最小インスタンスに戻すには:

oci-image-expandユーティリティを実行し、何も選択せずにプロンプトで[Enter]を押します。

例:

$ /usr/libexec/oci-image-expand
Please select the set of reboot required functions, if any
Selecting a function transitions from not selected [ ] to selected [+] or vice versa
 
[ ] 0) All reboot options

[ ] 1) Enable SELinux

[ ] 2) Enable Kdump

[ ] 3) Enable Ksplice
  
Select the desired options using their number (again to uncheck, ENTER when done):
ENTER

再起動に必要なプラットフォーム・イメージ機能のリストア

インスタンスの再起動を有効にする必要があるOracle Linuxプラットフォーム・イメージ機能をリストアするには:

使用法

oci-instanceid [-h | --help]

使用法

oci-iscsi-config [subcommand] [-h | --help]

サブコマンド

oci-iscsi-configユーティリティには、次のサブコマンドがあります。

oci-iscsi-configユーティリティの使用方法を示すトレーニング・ビデオは、Oracle Linuxトレーニング・ステーションのOCIユーティリティを使用したOracle Cloud InfrastructureインスタンスのiSCSIストレージの管理を参照してください。

OCI-iscsi-configユーティリティ・オプションの詳細は、共通OCIユーティリティ・オプションを参照してください。

iSCSI構成の表示

oci-iscsi-config showサブコマンドは、インスタンスのiSCSIデバイスおよびiSCSI情報をリストします。このサブコマンドは、ocidデーモンと連携して、コンソール、CLIまたはAPIを介してデバイスの作成および削除を監視し、それらの変更を自動的に検出します。

ocidデーモンが実行されていない場合、サブコマンドにはルート権限が必要です。

使用状況

インスタンスにアタッチされているすべてのデバイスのリストを表示するには:

1. oci-iscsi-config showサブコマンドを実行します。

   sudo oci-iscsi-config show

   例:

   $ sudo oci-iscsi-config show
   Currently attached iSCSI devices:
             Volume name           |Attached device| Size |
   --------------------------------------------------------
            mor-demo-bv20          |      sdb      | 50G  |
   Block volumes information:
                 Name              | Size |          Attached to           |              OCID              |
   ----------------------------------------------------------------------------------------------------------
            mor-demo-bv30          | 50GB |               -                |ocid1.volume.oc1.OCID|
   

2. オプションで、--detailsおよび--no-truncateオプションをoci-iscsi-config showサブコマンドとともに使用して、出力で短縮されていない詳細情報を表示します。

   sudo oci-iscsi-config show --details --no-truncate

   例:

   $ sudo oci-iscsi-config show --details --no-truncate
   Currently attached iSCSI devices:
                Target                       |          Volume name           |          Volume OCID                       | Persistent portal  |   Current portal   |Session State|Attached device| Size |
   ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------
   iqn.2015-12.com.oracleiaas:exampleuniqueID|         mor-demo-bv20          |ocid1.volume.oc1.iad.OCID  |  172.16.10.4:3260  |  172.16.10.4:3260  |  LOGGED_IN  |      sdb      | 50G  |
   
   Block volumes information:
                 Name              | Size |          Attached to           |              OCID                        |     IQN      | Compartment |Availability domain|
   ------------------------------------------------------------------------------------------------------------------------------------------------------------
            mor-demo-bv30          | 50GB |               -                |ocid1.volume.oc1.iad.OCID|      -       | virtdoc.dev  |DSdu:US-ASHBURN-AD-3|
   

3. オプションで、oci-iscsi-config showサブコマンドで--output-modeオプションを使用して、出力プレゼンテーションをより読みやすく変更します。

   sudo oci-iscsi-config show --output-mode mode

   たとえば、出力プレゼンテーションをテキスト・モードで表示するには:

   $ sudo oci-iscsi-config show --output-mode text
   Currently attached iSCSI devices
   Volume name: mor-demo-bv20
   Attached device: sdb
   Size: 50G
   
   Block volumes information
   Name: mor-demo-bv30
   Size: 50GB
   Attached to: -
   OCID: ocid1.volume.oc1.iad..OCID

オプション詳細

次の表に、このユーティリティーまたはサブコマンドに固有のオプションに関する詳細情報を示します。OCIユーティリティ全体で使用される共通オプションの詳細は、一般的なOCIユーティリティ・オプションを参照してください。

新規ボリュームの作成およびアタッチ

oci-iscsi-config createサブコマンドを使用して、ブロック・ボリュームを作成し、インスタンスにアタッチします。このサブコマンドでは、OCI SDK for Pythonがインストールおよび構成されている必要があります。OCI SDKの詳細は、ソフトウェア開発キットとコマンドライン・インタフェースを参照してください。

このサブコマンドには、ルート権限が必要です。

使用状況

oci-iscsi-config create [-S | --size size] [-v | --volume-name name] [--attach-volume] [-c | --chap] [-h | --help]

ボリュームを作成およびアタッチするには、oci-iscsi-config createユーティリティを-S、--volume-nameおよび--attach-volumeオプションとともに使用します。

sudo oci-iscsi-config create -S size --volume-name=name --attach-volume

たとえば、サイズが70 GBのボリュームを作成してインスタンスにアタッチするには、ボリューム名をmor-demo-by70にします。

$ sudo oci-iscsi-config create -S 70 --volume-name=mor-demo-by70 --attach-volume
Creating a new 70 GB volume
Volume name=mor-demo-by70 created
Attaching the volume to this instance
Attaching iSCSI device
iscsiadm attach Result: command executed successfully

オプション詳細

次の表に、このユーティリティーまたはサブコマンドに固有のオプションに関する詳細情報を示します。OCIユーティリティ全体で使用される共通オプションの詳細は、一般的なOCIユーティリティ・オプションを参照してください。

既存のボリュームの接続

oci-iscsi-config attachサブコマンドを使用して、既存のブロック・ボリュームをインスタンスにアタッチし、ボリュームをシステムで使用できるようにします。OCIDを使用してボリュームを選択するには、OCI SDK for Pythonが必要です。OCI SDKの詳細は、ソフトウェア開発キットとコマンドライン・インタフェースを参照してください。

このサブコマンドには、ルート権限が必要です。

使用状況

oci-iscsi-config attach [-I | --iqns IQN] [-O | --ocids OCID] [-u | --username name] [-p | --password password] [-c | --chap] [-h | --help]

特定のブロック・ボリュームをインスタンスにアタッチするには:

$ sudo oci-iscsi-config attach --iqns iqn.2015-12.com.oracleiaas:IQN

オプション詳細

次の表に、このユーティリティーまたはサブコマンドに固有のオプションに関する詳細情報を示します。OCIユーティリティ全体で使用される共通オプションの詳細は、一般的なOCIユーティリティ・オプションを参照してください。

ボリュームの同期

oci-iscsi-config syncサブコマンドを使用して、使用可能なブロック・デバイスをインスタンスにアタッチし、同期操作を実行します。このサブコマンドにはルート権限が必要です。

使用状況

oci-iscsi-config sync [-a | --apply] [-y | --yes] [-h | --help]

使用可能なブロック・デバイスをインスタンスにアタッチし、変更をOCIと同期するには、oci-iscsi-config syncサブコマンドを--applyオプションとともに使用します:

sudo oci-iscsi-config sync --apply

例:

$ sudo oci-iscsi-config sync --apply
Attaching the volume to this instance
Attaching iSCSI device
iscsiadm attach Result: command executed successfully

オプション詳細

次の表に、このユーティリティーまたはサブコマンドに固有のオプションに関する詳細情報を示します。OCIユーティリティ全体で使用される共通オプションの詳細は、一般的なOCIユーティリティ・オプションを参照してください。

ボリュームのデタッチ

oci-iscsi-config detachサブコマンドを使用して、指定されたIQN (デバイスに割り当てられた一意ID)のデバイスをデタッチします。ボリューム(またはボリュームの任意のパーティション)がマウントされている場合、このオプションでは最初にそのアンマウントが試行されます。

このサブコマンドには、ルート権限が必要です。

使用状況

oci-iscsi-config detach [-I | --iqns IQN] [-f | --force] [-h | --help]

インスタンスから特定のデバイスをデタッチするには、oci-iscsi-config detachサブコマンドを-Iオプションとともに使用します。

sudo oci-iscsi-config detach -I IQN

例:

$ sudo oci-iscsi-config detach -I  iqn.2015-12.com.oracleiaas:IQN
Detaching volume mor-demo-bv70 (iqn.2015-12.com.oracleiaas:IQN)
Volume [iqn.2015-12.com.oracleiaas:oracleiaas:IQN] is detached
Updating detached volume cache file: ['iqn.2015-12.com.oracleiaas:oracleiaas:IQN']

デタッチするボリュームのIQNまたはOCIDを表示するには、oci-iscsi-config showサブコマンドを使用します。詳細は、Displaying iSCSI Configurationsを参照してください。

オプション詳細

次の表に、このユーティリティーまたはサブコマンドに固有のオプションに関する詳細情報を示します。OCIユーティリティ全体で使用される共通オプションの詳細は、一般的なOCIユーティリティ・オプションを参照してください。

ボリュームの削除

指定されたOCIDのブロック・ストレージ・ボリュームを削除するには、oci-iscsi-config destroyサブコマンドを使用します。

使用状況

oci-iscsi-config destroy [-O | --ocids OCID] [-y | --yes] [-h | --help]

インスタンスから特定のブロック・ボリュームを削除するには、oci-iscsi-config-destroyサブコマンドを-Oオプションとともに使用します:

sudo oci-iscsi-config destroy -O OCID

例:

$ sudo oci-iscsi-config destroy -O ocid1.volume.oc1.OCID
WARNING: the volume(s) will be destroyed.  This is irreversible.  Continue?
y
Volume [ocid1.volume.oc1.iad.OCID] is destroyed

oci-iscsi-config showユーティリティ・サブコマンドを使用して、ボリュームのOCIDを表示できます。詳細は、Displaying iSCSI Configurationsを参照してください。

オプション詳細

次の表に、このユーティリティーまたはサブコマンドに固有のオプションに関する詳細情報を示します。OCIユーティリティ全体で使用される共通オプションの詳細は、一般的なOCIユーティリティ・オプションを参照してください。

使用法

インスタンスのすべてのメタデータの取得

インスタンスのすべてのメタデータを表示するには、オプションなしでoci-metadataユーティリティを実行します:

sudo oci-metadata

例:

$ sudo oci-metadata
Instance details:
  Display Name: my-example-instance
  Region: phx - us-phoenix-1 (Phoenix, AZ, USA)
  Canonical Region Name: us-phoenix-1
  Availability Domain: cumS:PHX-AD-1
  Fault domain: FAULT-DOMAIN-3
  OCID: ocid1.instance.oc1.phx.OCID
  Compartment OCID: ocid.compartment.oc1..OCID
  Instance shape: VM.Standard2.1
  Image ID: ocid1.image.oc1.phx.OCID
  Created at: 1569529065596
  state: Running
  agentConfig:
    managementDisabled: False
    monitoringDisabled: False
  Instance Metadata:
    ssh_authorized_keys: example-key
Networking details:
  VNIC OCID: ocid1.vnic.oc1.phx.OCID
  VLAN Tag: 2392
  Private IP address: 10.0.0.16
  MAC address: 02:00:17:03:D8:FE
  Subnet CIDR block: 10.0.0.0/24
  Virtual router IP address: 10.0.0.1

インスタンスの特定のメタデータの取得

指定したキーのインスタンス・メタデータを表示するには、oci-metadataユーティリティで--getオプションを使用します:

sudo oci-metadata --get key

たとえば、コンピュート・インスタンスの状態のみを表示するには:

$ sudo oci-metadata --get state
Instance details:
Instance state: Running

オプション詳細

次の表に、このユーティリティーまたはサブコマンドに固有のオプションに関する詳細情報を示します。OCIユーティリティ全体で使用される共通オプションの詳細は、一般的なOCIユーティリティ・オプションを参照してください。

使用法

oci-network-config [subcommand] [-q | --quiet] [-h | --help]

サブコマンド

oci-network-configユーティリティには、次のサブコマンドがあります。

現在のネットワーク構成の表示

oci-network-config showサブコマンドは、インスタンスで構成されているVNICに関する情報を表示します。現在のネットワーク構成(プロビジョニングされたVNICやインスタンスの現在のIP構成など)を表示できます。まだ構成されていないVNICは ADDでマークされ、関連付けられた VNICがなくなったIP構成は DELETEでマークされます。

oci-network-configユーティリティをオプションなしで入力した場合、このコマンドの出力がデフォルトのアクションです。

使用状況

oci-network-config show [--output-mode mode] [-I | --include item] [-X | --exclude item] [--details] [--no-truncate] [-h | --help]

現在のネットワーク構成を表示するには:

sudo oci-network-config show

例:

$ sudo oci-network-config show 
Network configuration
 State | Link | Status |  IP address |        VNIC        |        MAC        |
------------------------------------------------------------------------------
   -   | ens3 |   UP   | 10.2.20.254 |  hostname_ipv6_01  | 02:00:17:01:30:D5 |
  ADD  | ens4 |   UP   | 10.2.10.121 | vnic20220912090629 | 02:00:17:01:A9:0E |


Operating System level network configuration:
CONFIG      ADDR          SUBNET     BITS   VIRTROUTER      NS    IND      IFACE     VLTAG     VLAN    STATE        MAC                                                VNIC ID                                          
-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------
  -     10.2.20.254     10.2.20.0     24    10.2.20.1       -      2        ens3      3181      -        UP  02:00:17:01:30:D5 ocid1.vnic.oc1.uk-london-1.VNIC_OCID  
 ADD    10.2.10.121     10.2.10.0     24    10.2.10.1       -      3        ens4      1435      -        UP  02:00:17:01:A9:0E ocid1.vnic.oc1.uk-london-1.VNIC_OCID  

まだ構成されていないVNIC (ADDというラベル)を構成し、VNICが関連付けられていないIPアドレスを削除するには、oci-network-config configサブコマンドを使用します。詳細は、Configuring VNICsを参照してください。

オプション詳細

次の表に、このユーティリティーまたはサブコマンドに固有のオプションに関する詳細情報を示します。OCIユーティリティ全体で使用される共通オプションの詳細は、一般的なOCIユーティリティ・オプションを参照してください。

VNICの作成およびアタッチ

oci-network-config attach-VNICサブコマンドを使用して、VNICを作成してインスタンスにアタッチします。このサブコマンドを使用して、パブリックまたはプライベートIPアドレスを新しいVNICに割り当てることができます。

使用方法

oci-network-config attach-vnic [-I | --ip-address ip_address] [-ipv4 | --ipv4] [-ipv6 | --ipv6] [-i | --nic-index index] [--subnet subnet] [-n | --name name] [--assign-public-ip] [-h | --help]

VNICを作成し、VNICをインスタンスにアタッチするには、oci-network-config attach-VNICサブコマンドを-nオプションとともに使用します:

sudo oci-network-config attach-vnic -n name

たとえば、ex-demo-inst-10という名前のVNICを作成し、VNICをインスタンスにアタッチするには:

$ sudo oci-network-config attach-vnic -n ex-demo-inst-10
creating VNIC: 10.102.119.140

オプション詳細

次の表に、このユーティリティーまたはサブコマンドに固有のオプションに関する詳細情報を示します。OCIユーティリティ全体で使用される共通オプションの詳細は、一般的なOCIユーティリティ・オプションを参照してください。

# sudo oci-network-config attach-vnic --ipv6
Attaching a vnic with a primary ipv6 address is not yet supported by OCI.

VNICの構成

oci-network-config configureサブコマンドは、構成されていないVNICのIP構成を追加し、プロビジョニングされなくなったVNICのIP構成を削除します。このコマンドは、インスタンスのIP構成を現在のOCIプロビジョニングと同期します。

使用方法

oci-network-config configure [-n | --namespace format] [-r | --start-sshd] [-I | --include item] [-X | --exclude item] [-h | --help]

インスタンス上のすべてのVNICを構成するには:

sudo oci-network-config configure

例:

$ sudo oci-network-config configure
Configured 

特定のVNICを除き、インスタンスにVNICを構成するには、oci-network-config configureサブコマンドを-Xオプションとともに使用します:

sudo oci-network-config configure -X VNIC_OCID

例:

$ sudo oci-network-config configure -X VNIC_OCID
Configured 

VNICが構成されていることを確認するには、oci-network-config showサブコマンドを実行します。構成後は、VNICを構成から除外することを選択しないかぎり、ADDまたはDELETEラベルは出力に表示されません。詳細は、Displaying the Current Network Configurationを参照してください。

オプション詳細

次の表に、このユーティリティーまたはサブコマンドに固有のオプションに関する詳細情報を示します。OCIユーティリティ全体で使用される共通オプションの詳細は、一般的なOCIユーティリティ・オプションを参照してください。

構成済みVNICの表示

oci-network-config show-VNICsサブコマンドは、インスタンス上に構成されているVNICに関する情報を表示します。

使用方法

oci-network-config show-vnics [--output-mode mode] [--details] [--ocid OCID] [--name name] [--ip-address primary_ip] [--no-truncate] [-h | --help]

インスタンスに構成されているVNICに関する情報を表示するには:

sudo oci-network-config show-vnics

例:

$ sudo oci-network-config show-vnics
VNICs Information:
              Name              |   Private IP  |                                           OCID                                           |       MAC       |
--------------------------------------------------------------------------------------------------------------------------------------------------------------
        ex-demo-inst-10         |10.102.119.140|     ocid1.vnic.oc1.iad.OCID                                                    |00:00:17:02:CC:CB|
        mor-demoinst-10         |10.102.118.251|     ocid1.vnic.oc1.iad.OCID                                                    |02:00:17:02:C6:B2|

オプション詳細

次の表に、このユーティリティーまたはサブコマンドに固有のオプションに関する詳細情報を示します。OCIユーティリティ全体で使用される共通オプションの詳細は、一般的なOCIユーティリティ・オプションを参照してください。

すべての構成済みVNICSの表示

oci-network-config show-VNICs-allサブコマンドを使用して、このインスタンスで構成されているすべてのVNICに関する詳細情報を表示します。

使用方法

oci-network-config show-vnics-all [--output-mode mode] [-h | --help]

インスタンスに構成されているすべてのVNICを表示するには:

sudo oci-network-config show-vnics-all

例:

# sudo oci-network-config show-vnics-all
Virtual Network Interface Information:
        Name        |  Private IP |        MAC        | Config |                                           OCID                                          | Primary  |      Subnet      | Subnet cidr  |       State        | NIC  |   Public IP    |
---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------
  hostname_ipv6_01  | 10.2.20.254 | 02:00:17:01:30:D5 |   -    | ocid1.vnic.oc1.iad.OCID                                                |   True   | hostname_uk02_02 | 10.2.20.0/24 | AVAILABLE-ATTACHED |  -   | 140.238.76.113 |
      IP address details      
                      Private IP               |                                             OCID                                             |      
      ----------------------------------------------------------------------------------------------------------------------------------------      
                     10.2.20.254               | ocid1.privateip.oc1.iad.OCID |      
      
      
 vnic20220912090629 | 10.2.10.121 | 02:00:17:01:A9:0E |   -    | ocid1.vnic.oc1.iad.OCID                                               |    -     | hostname_uk02_01 | 10.2.10.0/24 | AVAILABLE-ATTACHED |  -   |       -        |
      IP address details      
                      Private IP               |                                             OCID                                             |      
      ----------------------------------------------------------------------------------------------------------------------------------------      
                     10.2.10.121               | ocid1.privateip.oc1.iad.OCID |      
       2603:c020:c003:3a10:b64c:8f35:7f9e:7e87 |   ocid1.ipv6.oc1.iad.OCID    |      

OCI-network-config show-vnics-allオプションの詳細は、共通OCIユーティリティ・オプションを参照してください。

第2アドレスの追加

oci-network-config add-secondary-addrユーティリティを使用して、指定されたIPv4またはIPv6アドレスのセカンダリ・プライベートIPアドレスを既存のVNICに追加します。

使用方法

oci-network-config add-secondary-addr [-ipv4 | --ipv4] [-ipv6 | --ipv6] [-I | --ip-address ip_address] [-O | --ocid OCID] [-h | --help]

プライベート・セカンダリIPアドレス(この場合はIPv6アドレス)を既存のVNICに追加するには、oci-network-config add-secondary-addrサブコマンドを--ipv6および--ocidオプションとともに使用します:

sudo oci-network-config add-secondary-addr --ipv6 --ocid OCID

例:

$ sudo oci-network-config add-secondary-addr --ipv6 --ocid ocid1.vnic.oc1.iad.OCID
Provisioning secondary private IPv6: 2603:c020:c003:3a10:b64c:8f35:7f9e:7e87
IP 2603:c020:c003:3a10:b64c:8f35:7f9e:7e87 has been assigned to vnic ocid1.vnic.oc1.iad.OCID

オプション詳細

次の表に、このユーティリティーまたはサブコマンドに固有のオプションに関する詳細情報を示します。OCIユーティリティ全体で使用される共通オプションの詳細は、一般的なOCIユーティリティ・オプションを参照してください。

プロビジョニングされたセカンダリVNICのIP構成の削除

プロビジョニングされたセカンダリVNIC (明示的に除外されたものを除く)のすべてのIP構成を削除するには、oci-network-config unconfigureサブコマンドを使用します。プライマリVNICは削除できません。

使用状況

oci-network-config unconfigure [-I | --include item] [-X | --exclude item] [-h | --help]

プロビジョニングされたセカンダリVNICのすべてのIP構成を削除するには、oci-network-config unconfigureサブコマンドを使用します。

sudo oci-network-config unconfigure

例:

$ sudo oci-network-config unconfigure
Unconfigured 

オプション詳細

次の表に、このユーティリティーまたはサブコマンドに固有のオプションに関する詳細情報を示します。OCIユーティリティ全体で使用される共通オプションの詳細は、一般的なOCIユーティリティ・オプションを参照してください。

セカンダリIPv6アドレスの削除

oci-network-config remove-secondary-addrサブコマンドを使用して、指定されたIPv4またはIPv6アドレスのセカンダリ・プライベートIPアドレスを既存のVNICから削除します。

使用状況

oci-network-config remove-secondary-addr [-I | --ip-address ip_address] [-h | --help]

既存のVNICからプライベート・セカンダリIPv6アドレスを削除するには、oci-network-config remove-secondary-addrサブコマンドを-Iオプションとともに使用します:

sudo oci-network-config remove-secondary-addr -I ip_address

たとえば、セカンダリIPv6アドレス2603:c020:c003:3a10:b64c:8f35:7f9e:7e87を既存のVNICから削除するには:

$ sudo oci-network-config remove-secondary-addr -I 2603:c020:c003:3a10:b64c:8f35:7f9e:7e87
Deconfigure secondary private IP 2603:c020:c003:3a10:b64c:8f35:7f9e:7e87

オプション詳細

次の表に、このユーティリティーまたはサブコマンドに固有のオプションに関する詳細情報を示します。OCIユーティリティ全体で使用される共通オプションの詳細は、一般的なOCIユーティリティ・オプションを参照してください。

VNICのデタッチ

oci-network-config detach-vnicサブコマンドを使用して、特定のOCIDまたはIPアドレスを持つVNICをインスタンスからデタッチおよび削除します。このサブコマンドを使用して、割り当てられたIPアドレスを既存のVNICから削除できます。ただし、プライマリVNICはデタッチできません。VNICに関連付けられたセカンダリ・プライベートIPアドレスも削除されます。

使用状況

oci-network-config detach-vnic [-I | --ip-address ip_address] [-O | --ocid OCID] [-h | --help]

インスタンスからVNICをデタッチするには、oci-network-config detach-VNICサブコマンドを--ocidオプションとともに使用します:

sudo oci-network-config detach-vnic --ocid OCID

たとえば、特定のVNIC OCIDを持つVNICをインスタンスからデタッチするには:

$ sudo oci-network-config detach-vnic --ocid ocid1.vnic.oc1.iad.OCID
Detaching VNIC 10.2.10.121 [ocid1.vnic.oc1.iad.OCID]
VNIC [ocid1.vnic.oc1.iad.OCID] is detached.

オプション詳細

次の表に、このユーティリティーまたはサブコマンドに固有のオプションに関する詳細情報を示します。OCIユーティリティ全体で使用される共通オプションの詳細は、一般的なOCIユーティリティ・オプションを参照してください。

使用法

oci-network-inspector [-C | --compartment OCID] [-N | --vcn OCID] [-h | --help]

特定のVCNの詳細レポートの表示

特定のVCNの詳細レポートを表示するには、oci-network-inspectorユーティリティを実行し、-Nオプションを使用してVCN OCIDを指定します:

sudo oci-network-inspector -N OCID

例:

$ sudo oci-network-inspector -N ocid1.compartment.oc1..OCID

Compartment: KVM_workspace (ocid1.compartment.oc1..OCID)

  vcn  : uk_02 (ocid1.vcn.oc1..OCID)
    Security List: Default Security List for uk_02
      Ingress: tcp              0.0.0.0/0:-                       ---:22
      Ingress: icmp             0.0.0.0/0:-                    code-4:type-3
      Ingress: icmp           10.2.0.0/16:-                 code-None:type-3
      Ingress: tcp                   ::/0:-                       ---:22
      Ingress: 58                    ::/0:-                       ---:-
      Egress : all                    ---:-                 0.0.0.0/0:-
      Egress : all                    ---:-                      ::/0:-

    Subnet  : uk02_02 (ocid1.subnet.oc1..OCID)
      ipv4 cidr block : 10.2.20.0/24
      ipv6 cidr block : 2603:c020:c003:3a20::/64
      DNS domain name : gtijskenuk0202.gtijskenuk02.oraclevcn.com
       Security List: Default Security List for uk_02
         Ingress: tcp              0.0.0.0/0:-                       ---:22
         Ingress: icmp             0.0.0.0/0:-                    code-4:type-3
         Ingress: icmp           10.2.0.0/16:-                 code-None:type-3
         Ingress: tcp                   ::/0:-                       ---:22
         Ingress: 58                    ::/0:-                       ---:-
         Egress : all                    ---:-                 0.0.0.0/0:-
         Egress : all                    ---:-                      ::/0:-

      Private IP      : 10.2.20.42(primary)  Host: gtijsken-amd-kvm-lon-flex3-vnicb752
        Vnic            : ocid1.vnic.oc1..OCID (AVAILABLE-ATTACHED)
        Vnic PublicIP   : None
        Instance        : amd_kvm_lon_flex3
          Instance State  : RUNNING
          Instance ocid   : ocid1.instance.oc1..OCID

      ...

特定のコンパートメントの詳細レポートの表示

特定のコンパートメントの詳細なネットワーク・レポートを表示するには、oci-network-inspectorユーティリティを実行し、-Cオプションを使用してコンパートメントOCIDを指定します:

sudo oci-network-inspector -C OCID

例:

$ sudo oci-network-inspector -C ocid1.compartment.oc1..OCID

Compartment: scottb_sandbox (ocid1.compartment.oc1..OCID)

  vcn: scottb_vcn
    Security List: Default Security List for scottb_vcn
      Ingress: tcp              0.0.0.0/0:-                       ---:22
      Ingress: icmp             0.0.0.0/0:-                    code-4:type-3
      Ingress: icmp           10.0.0.0/16:-                 code-None:type-3
      Ingress: tcp              0.0.0.0/0:80                      ---:80
      Ingress: tcp              0.0.0.0/0:43                      ---:43
      Ingress: tcp              0.0.0.0/0:-                       ---:-
      Egress : all                    ---:-                 0.0.0.0/0:-

     Subnet: Public Subnet cumS:PHX-AD-3 Avalibility domain: cumS:PHX-AD-3
         Cidr_block: 10.0.2.0/24 Domain name: sub99999999999.scottbvcn.oraclevcn.com
       Security List: Default Security List for scottb_vcn
         Ingress: tcp              0.0.0.0/0:-                       ---:22
         Ingress: icmp             0.0.0.0/0:-                    code-4:type-3
         Ingress: icmp           10.0.0.0/16:-                 code-None:type-3
         Ingress: tcp              0.0.0.0/0:80                      ---:80
         Ingress: tcp              0.0.0.0/0:43                      ---:43
         Ingress: tcp              0.0.0.0/0:-                       ---:-
         Egress : all                    ---:-                 0.0.0.0/0:-

     ...

使用法

oci-notify [subcommand] [-h | --help]

サブコマンド

oci-notifyユーティリティには、次のサブコマンドがあります。

インスタンスでの通知サービス・トピックの構成

oci-notify configサブコマンドを使用して、通知サービス・トピックOCIDをoci.confファイルに書き込みます。構成されると、この構成済のトピックにメッセージを公開できます。

デフォルトでは、構成ファイルへのパスは/etc/oci-utils/oci.confです。OCI_CONFIG_DIR環境変数を使用して、構成ファイル・パスをオーバーライドできます。

使用状況

oci-notify config notifications_topic_OCID [-h | --help]

構成済の通知サービス・トピックのOCIDをoci.confファイルに書き込むには、oci-notify configサブコマンドを使用して、通知サービス・トピックOCIDを指定します。

例:

$ sudo oci-notify config ocid1.onstopic.oc1..OCID

OCI-notify-configユーティリティ・オプションの詳細は、共通OCIユーティリティ・オプションを参照してください。

トピックへのメッセージの公開

oci-notify messageサブコマンドを使用すると、指定したタイトルのファイルまたはテキスト文字列の内容を構成済のトピックに公開できます。

ノート:メッセージが公開されると、oci-notifyユーティリティによって、メッセージの件名にインスタンス名が付加されます。たとえば: instance_name:log messages

使用状況

oci-notify message [-t | --title 'message_title'] [-f | --file message_file] [-h | --help]

'logging messages'というタイトルの/var/log/messagesファイルの内容を構成済のトピックに送信するには、--titleおよび--fileオプションをoci-notify-messageサブコマンドとともに使用します。

例:

$ sudo oci-notify message --title 'logging messages' --file /var/log/messages

構成されたトピックにテキスト文字列を送信するには、--fileオプションの値に一重引用符でテキスト行を入力します。

例:

$ sudo oci-notify message --title 'sending a text' --file 'Today is a beautiful day'

オプション詳細

次の表に、このユーティリティーまたはサブコマンドに固有のオプションに関する詳細情報を示します。OCIユーティリティ全体で使用される共通オプションの詳細は、一般的なOCIユーティリティ・オプションを参照してください。

使用法

現在のインスタンスのIPアドレスの表示

オプションなしでoci-public-IPコマンドを実行して、現在のインスタンスのIPアドレスを返します:

sudo oci-public-ip

例:

$ sudo oci-public-ip
Public IP address: 203.0.113.2

別のインスタンスのIPアドレスの表示

現在のインスタンス以外の別のインスタンスのパブリックIPアドレスを表示するには、oci-public-IPユーティリティを--instance-idオプションとともに使用します。

sudo oci-public-ip --instance-id OCID

例:

$ sudo oci-public-ip --instance-id ocid1.instance.oc1.phx.OCID
Public IP address: 203.0.113.2

STUNサーバーのリストの表示

STUNサーバーのリストを表示するには、oci-public-ipユーティリティを--list-serversオプションとともに使用します:

sudo oci-public-ip --list-servers

例:

$ sudo oci-public-ip --list-servers
stun.stunprotocol.org
stun.counterpath.net
stun.voxgratia.org
stun.callwithus.com
stun.ekiga.net
stun.ideasip.com
stun.voipbuster.com
stun.voiparound.com
stun.voipstunt.com

オプション詳細

次の表に、このユーティリティーまたはサブコマンドに固有のオプションに関する詳細情報を示します。OCIユーティリティ全体で使用される共通オプションの詳細は、一般的なOCIユーティリティ・オプションを参照してください。

使用法

アタッチされたiSCSIボリュームに関するすべてのデータの表示

コンピュート・インスタンスにアタッチされたiSCSIボリュームに関するすべてのデータを表示するには:

sudo oci-volume-data -k OCID

例:

$ sudo oci-volume-data -k OCID
             display name: name=oci1-iscsi-volume-1
                     ocid: ocid1.volume.oc1.OCID
                      iqn: iqn.2122-45.com.oracleiaas:IQN
                portal ip: 123.245.6.7
              portal port: 1234
                chap user: None
            chap password: None
      availability domain: DSdu:US-EAST-DOMAIN
              compartment: comparment1
           compartment id: ocid1.compartment.OCID
              attached to: oci-utils-instance
         attachment state: --
                     size: 70GB
                    state: AVAILABLE

アタッチされたiSCSIボリュームに関する特定のデータの表示

オプションで、oci-volume-dataユーティリティーで -k、-p、および -v (値のみ)オプションを使用して、iSCSIボリュームに表示する内容を絞り込みます。

oci-volume-data -k OCID -p size -v

たとえば、iSCSIボリュームのサイズ(この場合は70 GB)のみを表示するには:

$ oci-volume-data -k ocid1.volume.OCID -p size -v
70GB

オプション詳細

次の表に、このユーティリティーまたはサブコマンドに固有のオプションに関する詳細情報を示します。OCIユーティリティ全体で使用される共通オプションの詳細は、一般的なOCIユーティリティ・オプションを参照してください。