Informations de référence sur les utilitaires OCI

Syntaxe

oci-compartmentid [-h | --help]

Syntaxe

Extension de la partition racine d'une instance

Pour développer la partition racine de l'instance :

1. Utilisez la commande lsblk pour confirmer que le système d'exploitation a identifié la nouvelle taille du volume de démarrage.

   Par exemple :

   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
   

   Si la taille du volume de disque n'est pas celle attendue, exécutez les commandes pour rebalayer le volume de démarrage. Voir Rebalayage du disque pour les volumes attachés à des instances Linux.

2. Exécutez l'utilitaire oci-growfs avec l'option y pour répondre "oui" à toutes les invites.

   sudo /usr/libexec/oci-growfs -y

   Par exemple :

   $ 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.
   

Pour plus d'informations sur les options de l'utilitaire oci-growfs, voir Options communes de l'utilitaire OCI.

Conditions requises :

Installez les utilitaires OCI sur l'instance minimale. Pour plus d'informations, voir Installation des utilitaires OCI.

Types de conversion

L'utilitaire oci-image-expand fournit deux types de conversion d'instance minimale Oracle Linux :

• Valeur par défaut : Restaure les services systemd de plate-forme Oracle Linux par défaut, les ensembles de diagnostic, les paramètres de configuration en nuage, et configure et active le swap sur l'instance. La restauration de la fonctionnalité de plate-forme par défaut n'augmente pas le temps de démarrage de l'instance. Ce type de conversion est toujours appliqué par l'utilitaire oci-image-expand.

• Redémarrage requis : Restaure la fonctionnalité de plate-forme Oracle Linux par défaut, comme décrit dans le type de conversion par défaut, et restaure une ou plusieurs des fonctions sélectionnées par l'utilisateur suivantes :

  • Activer SELinux - Restaure le mode d'application SELinux.
  • Activer Kdump - Ajoute la capacité kdump et la régénération de kdump initramfs.
  • Activer Ksplice - Installe Ksplice et active le service Ksplice. Pour plus d'informations, voir Oracle Ksplice et Oracle Linux Ksplice User's Guide.

  Le choix de l'une de ces fonctions sélectionnables augmente le temps de démarrage de l'instance et nécessite un redémarrage pour prendre effet.

Les fichiers journaux de l'utilitaire oci-image-expand se trouvent à l'adresse : /var/log/oci-image-expand.log

Syntaxe

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

Restauration de la fonctionnalité d'image de plate-forme par défaut

Pour restaurer la fonctionnalité d'image de plate-forme Oracle Linux par défaut dans l'instance minimale Oracle Linux :

Exécutez l'utilitaire oci-image-expand et appuyez sur Entrée à l'invite, sans effectuer de sélection.

Par exemple :

$ /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

Restauration de la fonctionnalité d'image de plate-forme requise pour le redémarrage

Pour restaurer la fonctionnalité d'image de plate-forme Oracle Linux qui nécessite un redémarrage d'instance pour prendre effet :

Syntaxe

oci-instanceid [-h | --help]

Syntaxe

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

Sous-commandes

L'utilitaire oci-iscsi-config comporte les sous-commandes suivantes.

Pour une vidéo de formation qui explique comment utiliser l'utilitaire oci-iscsi-config, voir Utilisation des utilitaires OCI pour la gestion des instances iSCSI pour Oracle Cloud Infrastructure dans le centre d'apprentissage pour Oracle Linux.

Pour plus d'informations sur l'option de l'utilitaire oci-iscsi-config, voir Options communes de l'utilitaire OCI.

Affichage des configurations iSCSI

La sous-commande oci-iscsi-config show répertorie les appareils iSCSI et les informations iSCSI pour l'instance. Cette sous-commande fonctionne avec le démon ocid pour surveiller la création et la suppression de périphériques au moyen de la console, de l'interface de ligne de commande ou de l'API, et détecte automatiquement ces modifications.

Si le démon ocid n'est pas en cours d'exécution, la sous-commande nécessite des privilèges racine.

Syntaxe

Pour afficher la liste de tous les appareils attachés à l'instance :

1. Exécutez la sous-commande oci-iscsi-config show.

   sudo oci-iscsi-config show

   Par exemple :

   $ 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. Facultativement, utilisez les options --details et --no-truncate avec la sous-commande oci-iscsi-config show pour afficher des informations plus détaillées qui ne sont pas abrégées dans la sortie :

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

   Par exemple :

   $ 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. Facultativement, modifiez la présentation de sortie pour qu'elle soit plus lisible à l'aide de l'option --output-mode avec la sous-commande oci-iscsi-config show :

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

   Par exemple, pour afficher la présentation de sortie en mode texte :

   $ 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

Détails de l'option

Le tableau suivant fournit des informations détaillées sur les options propres à cet utilitaire ou à cette sous-commande. Pour plus d'informations sur les options communes utilisées dans les utilitaires OCI, voir Options communes de l'utilitaire OCI.

Création et attachement d'un nouveau volume

Utilisez la sous-commande oci-iscsi-config create pour créer et attacher un volume par blocs à une instance. Cette sous-commande nécessite l'installation et la configuration de la trousse SDK OCI pour Python. Pour plus d'informations sur la trousse SDK OCI, voir Titres de développement de logiciels et interface de ligne de commande.

Cette sous-commande nécessite des privilèges racine.

Syntaxe

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

Pour créer et attacher un volume, utilisez l'utilitaire oci-iscsi-config create avec les options -S, --volume-name et --attach-volume :

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

Par exemple, pour créer et attacher un volume d'une taille de 70 Go à l'instance, avec le nom de volume 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

Détails de l'option

Le tableau suivant fournit des informations détaillées sur les options propres à cet utilitaire ou à cette sous-commande. Pour plus d'informations sur les options communes utilisées dans les utilitaires OCI, voir Options communes de l'utilitaire OCI.

Attachement d'un volume existant

Utilisez la sous-commande oci-iscsi-config attach pour attacher un volume par blocs existant à l'instance et rendre le volume disponible pour le système. La trousse SDK OCI pour Python est obligatoire pour la sélection des volumes à l'aide de leur OCID. Pour plus d'informations sur la trousse SDK OCI, voir Titres de développement de logiciels et interface de ligne de commande.

Cette sous-commande nécessite des privilèges racine.

Syntaxe

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

Pour attacher un volume par blocs spécifique à l'instance :

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

Détails de l'option

Le tableau suivant fournit des informations détaillées sur les options propres à cet utilitaire ou à cette sous-commande. Pour plus d'informations sur les options communes utilisées dans les utilitaires OCI, voir Options communes de l'utilitaire OCI.

Synchronisation d'un volume

Utilisez la sous-commande oci-iscsi-config sync pour attacher les périphériques de traitement par blocs disponibles à l'instance et effectuer des opérations de synchronisation. La sous-commande nécessite des privilèges racine.

Syntaxe

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

Pour attacher les périphériques de traitement par blocs disponibles à l'instance et synchroniser les modifications avec OCI, utilisez la sous-commande oci-iscsi-config sync avec l'option --apply :

sudo oci-iscsi-config sync --apply

Par exemple :

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

Détails de l'option

Le tableau suivant fournit des informations détaillées sur les options propres à cet utilitaire ou à cette sous-commande. Pour plus d'informations sur les options communes utilisées dans les utilitaires OCI, voir Options communes de l'utilitaire OCI.

Détachement d'un volume

Utilisez la sous-commande oci-iscsi-config detach pour détacher un appareil ayant l'IQN indiqué (ID unique affecté à un appareil). Si le volume (ou toute partition du volume) est monté, cette option tente d'abord de le démonter.

Cette sous-commande nécessite des privilèges racine.

Syntaxe

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

Pour détacher un appareil spécifique de l'instance, utilisez la sous-commande oci-iscsi-config detach avec l'option -I :

sudo oci-iscsi-config detach -I IQN

Par exemple :

$ 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']

Pour voir l'IQN ou l'OCID du volume à détacher, utilisez la sous-commande oci-iscsi-config show. Pour plus d'informations, voir Affichage des configurations iSCSI.

Détails de l'option

Le tableau suivant fournit des informations détaillées sur les options propres à cet utilitaire ou à cette sous-commande. Pour plus d'informations sur les options communes utilisées dans les utilitaires OCI, voir Options communes de l'utilitaire OCI.

Suppression d'un volume

Pour supprimer un volume de stockage par blocs ayant l'OCID indiqué, utilisez la sous-commande oci-iscsi-config destroy.

Syntaxe

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

Pour supprimer un volume par blocs spécifique de l'instance, utilisez la sous-commande oci-iscsi-config-destroy avec l'option -O :

sudo oci-iscsi-config destroy -O OCID

Par exemple :

$ 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

Vous pouvez voir l'OCID du volume à l'aide de la sous-commande de l'utilitaire oci-iscsi-config show. Pour plus d'informations, voir Affichage des configurations iSCSI.

Détails de l'option

Le tableau suivant fournit des informations détaillées sur les options propres à cet utilitaire ou à cette sous-commande. Pour plus d'informations sur les options communes utilisées dans les utilitaires OCI, voir Options communes de l'utilitaire OCI.

Syntaxe

Obtention de toutes les métadonnées pour l'instance

Pour voir toutes les métadonnées de l'instance, exécutez l'utilitaire oci-metadata sans options :

sudo oci-metadata

Par exemple :

$ 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

Obtention de métadonnées spécifiques pour l'instance

Pour voir les métadonnées d'instance pour une clé spécifiée, utilisez l'option --get avec l'utilitaire oci-metadata :

sudo oci-metadata --get key

Par exemple, pour afficher uniquement l'état de l'instance de calcul :

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

Détails de l'option

Le tableau suivant fournit des informations détaillées sur les options propres à cet utilitaire ou à cette sous-commande. Pour plus d'informations sur les options communes utilisées dans les utilitaires OCI, voir Options communes de l'utilitaire OCI.

Syntaxe

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

Sous-commandes

L'utilitaire oci-network-config comporte les sous-commandes suivantes.

Affichage de la configuration réseau courante

La sous-commande oci-network-config show affiche des informations sur les cartes vNIC configurées sur l'instance. Vous pouvez voir la configuration réseau courante, telle que les cartes vNIC provisionnées et les configurations IP courantes de l'instance. Les cartes VNIC qui n'ont pas encore été configurées ont le marqueur ADD et les configurations IP qui n'ont plus de carte VNIC associée ont le marqueur DELETE.

La sortie de cette commande est l'action par défaut si l'utilitaire oci-network-config est entré sans option.

Syntaxe

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

Pour afficher la configuration réseau courante :

sudo oci-network-config show

Par exemple :

$ 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  

Pour configurer les cartes vNIC qui ne sont pas encore configurées (étiquetées ADD) et supprimer les adresses IP qui n'ont aucune carte vNIC associée, utilisez la sous-commande oci-network-config config. Pour plus d'informations, voir Configuration des cartes vNIC.

Détails de l'option

Le tableau suivant fournit des informations détaillées sur les options propres à cet utilitaire ou à cette sous-commande. Pour plus d'informations sur les options communes utilisées dans les utilitaires OCI, voir Options communes de l'utilitaire OCI.

Création et attachement d'une carte VNIC

Utilisez la sous-commande oci-network-config attach-vnic pour créer et attacher une carte VNIC à une instance. Vous pouvez affecter une adresse IP publique ou privée à la nouvelle carte VNIC à l'aide de cette sous-commande.

Syntaxe

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]

Pour créer une carte VNIC et l'attacher à une instance, utilisez la sous-commande oci-network-config attach-vnic avec l'option -n :

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

Par exemple, pour créer une carte VNIC nommée ex-demo-inst-10 et l'attacher à l'instance :

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

Détails de l'option

Le tableau suivant fournit des informations détaillées sur les options propres à cet utilitaire ou à cette sous-commande. Pour plus d'informations sur les options communes utilisées dans les utilitaires OCI, voir Options communes de l'utilitaire OCI.

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

Configuration de cartes vNIC

La sous-commande oci-network-config configure ajoute une configuration d'adresse IP pour les cartes vNIC qui ne sont pas configurées et supprime la configuration d'adresse IP des cartes vNIC qui ne sont plus provisionnées. Cette commande synchronise la configuration IP de l'instance avec le provisionnement OCI courant.

Syntaxe

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

Pour configurer toutes les cartes vNIC de l'instance :

sudo oci-network-config configure

Par exemple :

$ sudo oci-network-config configure
Configured 

Pour configurer les cartes VNIC sur l'instance, à l'exception d'une carte VNIC spécifique, utilisez la sous-commande oci-network-config configure avec l'option -X :

sudo oci-network-config configure -X VNIC_OCID

Par exemple :

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

Vous pouvez vérifier que les cartes vNIC sont configurées en exécutant la sous-commande oci-network-config show. Après la configuration, aucune étiquette ADD ou DELETE ne sera affichée dans la sortie, sauf si vous avez choisi d'exclure une carte VNIC de la configuration. Pour plus d'informations, voir Affichage de la configuration réseau courante.

Détails de l'option

Le tableau suivant fournit des informations détaillées sur les options propres à cet utilitaire ou à cette sous-commande. Pour plus d'informations sur les options communes utilisées dans les utilitaires OCI, voir Options communes de l'utilitaire OCI.

Affichage des cartes vNIC configurées

La sous-commande oci-network-config show-vnics affiche les informations sur les cartes vNIC configurées dans l'instance.

Syntaxe

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

Pour afficher des informations sur les cartes vNIC configurées dans l'instance :

sudo oci-network-config show-vnics

Par exemple :

$ 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|

Détails de l'option

Le tableau suivant fournit des informations détaillées sur les options propres à cet utilitaire ou à cette sous-commande. Pour plus d'informations sur les options communes utilisées dans les utilitaires OCI, voir Options communes de l'utilitaire OCI.

Affichage de toutes les cartes vNIC configurées

Utilisez la sous-commande oci-network-config show-vnics-all pour voir des informations détaillées sur toutes les cartes vNIC configurées sur cette instance.

Syntaxe

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

Pour afficher toutes les cartes vNIC configurées sur l'instance :

sudo oci-network-config show-vnics-all

Par exemple :

# 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    |      

Pour plus d'informations sur les options oci-network-config show-vnics-all, voir Options communes de l'utilitaire OCI.

Ajout d'une adresse secondaire

Utilisez l'utilitaire oci-network-config add-secondary-addr pour ajouter une adresse IP privée secondaire avec l'adresse IPv4 ou IPv6 spécifiée à une carte VNIC existante.

Syntaxe

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

Pour ajouter une adresse IP secondaire privée, dans ce cas une adresse IPv6, à une carte VNIC existante, utilisez la sous-commande oci-network-config add-secondary-addr avec les options --ipv6 et --ocid :

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

Par exemple :

$ 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

Détails de l'option

Le tableau suivant fournit des informations détaillées sur les options propres à cet utilitaire ou à cette sous-commande. Pour plus d'informations sur les options communes utilisées dans les utilitaires OCI, voir Options communes de l'utilitaire OCI.

Suppression de la configuration d'adresse IP pour les cartes virtuelles secondaires provisionnées

Utilisez la sous-commande oci-network-config unconfigure pour supprimer toute la configuration IP des cartes vNIC secondaires provisionnées (à l'exception de celles explicitement exclues). La carte VNIC principale ne peut pas être supprimée.

Syntaxe

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

Pour supprimer toute la configuration IP des cartes vNIC secondaires provisionnées, utilisez la sous-commande oci-network-config unconfigure :

sudo oci-network-config unconfigure

Par exemple :

$ sudo oci-network-config unconfigure
Unconfigured 

Détails de l'option

Le tableau suivant fournit des informations détaillées sur les options propres à cet utilitaire ou à cette sous-commande. Pour plus d'informations sur les options communes utilisées dans les utilitaires OCI, voir Options communes de l'utilitaire OCI.

Suppression d'une adresse IPv6 secondaire

Utilisez la sous-commande oci-network-config remove-secondary-addr pour supprimer d'une carte VNIC existante une adresse IP privée secondaire avec l'adresse IPv4 ou IPv6 spécifiée.

Syntaxe

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

Pour supprimer une adresse IPv6 secondaire privée d'une carte VNIC existante, utilisez la sous-commande oci-network-config remove-secondary-addr avec l'option -I :

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

Par exemple, pour supprimer l'adresse IPv6 secondaire, 2603:c020:c003:3a10:b64c:8f35:7f9e:7e87, d'une carte VNIC existante :

$ 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

Détails de l'option

Le tableau suivant fournit des informations détaillées sur les options propres à cet utilitaire ou à cette sous-commande. Pour plus d'informations sur les options communes utilisées dans les utilitaires OCI, voir Options communes de l'utilitaire OCI.

Détachement d'une carte vNIC

Utilisez la sous-commande oci-network-config detach-vnic pour détacher et supprimer la carte VNIC ayant l'OCID ou l'adresse IP spécifique de l'instance. Cette sous-commande peut être utilisée pour supprimer l'adresse IP affectée à une carte VNIC existante. Toutefois, la carte VNIC principale ne peut pas être détachée. Toute adresse IP privée secondaire associée à la carte vNIC est également supprimée.

Syntaxe

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

Pour détacher une carte VNIC de l'instance, utilisez la sous-commande oci-network-config detach-vnic avec l'option --ocid :

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

Par exemple, pour détacher une carte VNIC ayant un OCID de carte VNIC spécifique de l'instance :

$ 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.

Détails de l'option

Le tableau suivant fournit des informations détaillées sur les options propres à cet utilitaire ou à cette sous-commande. Pour plus d'informations sur les options communes utilisées dans les utilitaires OCI, voir Options communes de l'utilitaire OCI.

Syntaxe

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

Affichage d'un rapport détaillé pour un VCN spécifique

Pour afficher un rapport détaillé pour un VCN spécifique, exécutez l'utilitaire oci-network-inspector et utilisez l'option -N pour spécifier l'OCID du VCN :

sudo oci-network-inspector -N OCID

Par exemple :

$ 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

      ...

Affichage d'un rapport détaillé pour un compartiment spécifique

Pour voir un rapport de réseau détaillé pour un compartiment spécifique, exécutez l'utilitaire oci-network-inspector et utilisez l'option -C pour spécifier un OCID de compartiment :

sudo oci-network-inspector -C OCID

Par exemple :

$ 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:-

     ...

Syntaxe

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

Sous-commandes

L'utilitaire oci-notify comporte les sous-commandes suivantes.

Configuration d'un sujet du service d'avis sur une instance

Utilisez la sous-commande oci-notify config pour écrire l'OCID du sujet du service d'avis dans le fichier oci.conf. Une fois configuré, vous pouvez publier des messages pour ce sujet.

Par défaut, le chemin d'accès au fichier de configuration est /etc/oci-utils/oci.conf. Vous pouvez remplacer le chemin du fichier de configuration à l'aide de la variable d'environnement OCI_CONFIG_DIR.

Syntaxe

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

Pour écrire l'OCID d'un sujet du service d'avis configuré dans le fichier oci.conf, utilisez la sous-commande oci-notify config et spécifiez l'OCID du sujet du service d'avis.

Par exemple :

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

Pour plus d'informations sur l'option de l'utilitaire oci-notify-config, voir Options communes de l'utilitaire OCI.

Publication d'un message pour un sujet

Avec la sous-commande oci-notify message, vous pouvez publier le contenu d'un fichier ou d'une chaîne de texte avec le titre spécifié pour le sujet configuré.

Note : Lorsque le message est publié, l'utilitaire oci-notify ajoute au préalable le nom de l'instance à l'objet du message. Par exemple : instance_name:log messages

Syntaxe

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

Pour envoyer le contenu du fichier /var/log/messages avec le titre 'logging messages' au sujet configuré, utilisez les options --title et --file avec la sous-commande oci-notify-message.

Par exemple :

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

Pour envoyer une chaîne de texte au sujet configuré, entrez une ligne de texte entre apostrophes pour la valeur de l'option --file.

Par exemple :

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

Détails de l'option

Le tableau suivant fournit des informations détaillées sur les options propres à cet utilitaire ou à cette sous-commande. Pour plus d'informations sur les options communes utilisées dans les utilitaires OCI, voir Options communes de l'utilitaire OCI.

Syntaxe

Affichage de l'adresse IP de l'instance courante

Exécutez la commande oci-public-ip sans option pour retourner l'adresse IP de l'instance courante :

sudo oci-public-ip

Par exemple :

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

Affichage de l'adresse IP d'une autre instance

Pour voir l'adresse IP publique d'une autre instance que l'instance courante, utilisez l'utilitaire oci-public-ip avec l'option --instance-id.

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

Par exemple :

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

Affichage d'une liste de serveurs STUN

Pour afficher la liste des serveurs STUN, utilisez l'utilitaire oci-public-ip avec l'option --list-servers :

sudo oci-public-ip --list-servers

Par exemple :

$ 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

Détails de l'option

Le tableau suivant fournit des informations détaillées sur les options propres à cet utilitaire ou à cette sous-commande. Pour plus d'informations sur les options communes utilisées dans les utilitaires OCI, voir Options communes de l'utilitaire OCI.

Syntaxe

Affichage de toutes les données à propos d'un volume iSCSI attaché

Pour voir toutes les données concernant un volume iSCSI attaché à l'instance de calcul :

sudo oci-volume-data -k OCID

Par exemple :

$ 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

Affichage de données spécifiques à propos d'un volume iSCSI attaché

Facultativement, utilisez les options -k, -p et -v (valeur seule) avec l'utilitaire oci-volume-data pour préciser ce que vous voulez afficher pour le volume iSCSI :

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

Par exemple, pour afficher uniquement la taille d'un volume iSCSI, dans ce cas, 70 Go :

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

Détails de l'option

Le tableau suivant fournit des informations détaillées sur les options propres à cet utilitaire ou à cette sous-commande. Pour plus d'informations sur les options communes utilisées dans les utilitaires OCI, voir Options communes de l'utilitaire OCI.