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ユーティリティを実行し、すべてのプロンプトに対して「はい」と答えます。

   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 Minimalインスタンス変換が用意されています。

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

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

  • SELinuxの有効化 - SELinux強制モードをリストアします。
  • Kdumpの有効化 - kdump機能およびkdump initramfsの再生成を追加します。
  • 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 Minimalインスタンスにリストアするには:

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デーモンが実行されていない場合、サブコマンドにはroot権限が必要です。

使用方法

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

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の詳細は、ソフトウェア開発キットとコマンドライン・インタフェースに関する項を参照してください。

このサブコマンドにはroot権限が必要です。

使用方法

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の詳細は、ソフトウェア開発キットとコマンドライン・インタフェースに関する項を参照してください。

このサブコマンドにはroot権限が必要です。

使用方法

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サブコマンドを使用して、使用可能なブロック・デバイスをインスタンスにアタッチし、同期操作を実行します。このサブコマンドにはroot権限が必要です。

使用方法

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)を持つデバイスをデタッチしてください。ボリューム(またはボリュームの任意のパーティション)がマウントされている場合、このオプションは最初にそのアンマウントを試行します。

このサブコマンドにはroot権限が必要です。

使用方法

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 

oci-network-config showサブコマンドを実行して、VNICが構成されていることを確認できます。構成後に、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ユーティリティ・オプション」を参照してください。

セカンダリ住所の追加

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構成の削除

oci-network-config unconfigureサブコマンドを使用して、プロビジョニングされたセカンダリVNICのすべてのIP構成を削除します(明示的に除外されたものを除く)。プライマリ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をインスタンスからデタッチするには、--ocidオプションを指定してoci-network-config detach-vnicサブコマンドを使用します:

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ファイルの内容を構成済トピックに送信するには、oci-notify-messageサブコマンドで--titleおよび--fileオプションを使用します。

例:

$ 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ユーティリティ・オプション」を参照してください。