Utilitaires OCI

Syntaxe

oci-compartmentid [-h | --help]

Syntaxe

Développer la partition racine d'une instance

Pour développer la partition racine de l'instance, procédez comme suit :

1. Utilisez la commande lsblk pour vérifier que le système d'exploitation a identifié la nouvelle taille du volume d'initialisation.

   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 réanalyser le volume d'initialisation. Reportez-vous à Nouvelle analyse du disque pour des volumes attachés à des instances Linux.

2. Exécutez l'utilitaire oci-growfs avec l'option y pour répondre "yes" à 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, reportez-vous à Options courantes de l'utilitaire OCI.

Prérequis

Installez les utilitaires OCI sur l'instance minimale. Pour plus d'informations, reportez-vous à Installation des utilitaires OCI.

Types de conversion

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

• Par défaut : restaure les services systemd par défaut de la plate-forme Oracle Linux, les packages de diagnostic et les paramètres de configuration cloud, 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 d'initialisation de l'instance. Ce type de conversion est toujours appliqué par l'utilitaire oci-image-expand.

• Réinitialisation requise : 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 fonctionnalités suivantes pouvant être sélectionnées par l'utilisateur :

  • Activer SELinux : restaure le mode d'application SELinux.
  • Activer Kdump : ajoute la fonctionnalité kdump et la régénération de kdump initramfs.
  • Activer Ksplice : installe Ksplice et active le service Ksplice. Pour plus d'informations sur l'utilisation de Ksplice, reportez-vous à Oracle Ksplice for Zero-Downtime Updates et au Guide de l'utilisateur Ksplice Oracle Linux.

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

Les fichiers journaux de l'utilitaire oci-image-expand se trouvent à l'emplacement suivant : /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 sur l'instance minimale Oracle Linux, procédez comme suit :

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 voir une vidéo de formation expliquant comment utiliser l'utilitaire oci-iscsi-config, reportez-vous à Utilisation des utilitaires OCI afin de gérer le stockage iSCSI pour les instances Oracle Cloud Infrastructure dans le centre de formation Oracle Linux.

Pour plus d'informations sur l'option de l'utilitaire oci-iscsi-config, reportez-vous à Options courantes de l'utilitaire OCI.

Affichage des configurations iSCSI

La sous-commande oci-iscsi-config show répertorie les périphériques iSCSI et les informations iSCSI de l'instance. Cette sous-commande fonctionne avec le démon ocid pour surveiller la création et la suppression de périphériques via la console, la CLI ou l'API, et repère automatiquement ces modifications.

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

Utilisation

Pour afficher la liste de tous les périphériques attachés à l'instance, procédez comme suit :

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. Utilisez éventuellement 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 raccourcies 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. Vous pouvez éventuellement modifier 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 d'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 courantes utilisées dans les utilitaires OCI, reportez-vous à Options courantes de l'utilitaire OCI.

Création et attachement d'un nouveau volume

Utilisez la sous-commande oci-iscsi-config create pour créer un volume de blocs et l'attacher à une instance. Cette sous-commande nécessite l'installation et la configuration du kit SDK OCI pour Python. Pour plus d'informations sur le kit SDK OCI, reportez-vous à Kits SDK et interface de ligne de commande.

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

Utilisation

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 d'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 courantes utilisées dans les utilitaires OCI, reportez-vous à Options courantes de l'utilitaire OCI.

Attachement d'un volume existant

Utilisez la sous-commande oci-iscsi-config attach pour attacher un volume de blocs existant à l'instance et le mettre à disposition du système. Le kit SDK OCI pour Python est requis pour sélectionner des volumes à l'aide de leur OCID. Pour plus d'informations sur le kit SDK OCI, reportez-vous à Kits SDK et interface de ligne de commande.

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

Utilisation

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

Pour associer un volume de blocs spécifique à l'instance, procédez comme suit :

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

Détails d'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 courantes utilisées dans les utilitaires OCI, reportez-vous à Options courantes de l'utilitaire OCI.

Synchronisation d'un volume

Utilisez la sous-commande oci-iscsi-config sync pour attacher des unités de blocs disponibles à l'instance et effectuer des opérations de synchronisation. La sous-commande nécessite des privilèges root.

Utilisation

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

Pour attacher les unités de 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 d'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 courantes utilisées dans les utilitaires OCI, reportez-vous à Options courantes de l'utilitaire OCI.

Détachement d'un volume

Utilisez la sous-commande oci-iscsi-config detach pour détacher un périphérique avec l'IQN donné (ID unique affecté à un périphérique). Si le volume (ou une partition du volume) est monté, cette option tente tout d'abord de le démonter.

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

Utilisation

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

Pour détacher un périphérique 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 afficher l'IQN ou l'OCID du volume à détacher, utilisez la sous-commande oci-iscsi-config show. Pour plus d'informations, reportez-vous à la section Displaying iSCSI Configurations.

Détails d'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 courantes utilisées dans les utilitaires OCI, reportez-vous à Options courantes de l'utilitaire OCI.

Suppression d'un volume

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

Utilisation

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

Pour supprimer un volume de 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 afficher l'OCID du volume à l'aide de la sous-commande de l'utilitaire oci-iscsi-config show. Pour plus d'informations, reportez-vous à la section Displaying iSCSI Configurations.

Détails d'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 courantes utilisées dans les utilitaires OCI, reportez-vous à Options courantes de l'utilitaire OCI.

Syntaxe

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

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

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 afficher les métadonnées d'instance d'une clé indiqué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 d'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 courantes utilisées dans les utilitaires OCI, reportez-vous à Options courantes 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 en cours

La sous-commande oci-network-config show affiche des informations sur les VNIC configurées sur l'instance. Vous pouvez visualiser la configuration réseau en cours, telle que les cartes d'interface réseau virtuelles provisionnées et les configurations d'adresse IP en cours pour l'instance. Les cartes d'interface réseau virtuelles qui ne sont pas encore configurées ont l'indicateur ADD et les configurations d'adresse IP qui n'ont plus de carte d'interface réseau virtuelle associée ont l'indicateur DELETE.

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

Utilisation

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

Pour afficher la configuration réseau actuelle :

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 des cartes d'interface réseau virtuelles qui ne sont pas encore configurées (libellées ADD) et supprimer des adresses IP auxquelles aucune carte d'interface réseau virtuelle n'est associée, utilisez la sous-commande oci-network-config config. Pour plus d'informations, reportez-vous à la section Configuring VNICs.

Détails d'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 courantes utilisées dans les utilitaires OCI, reportez-vous à Options courantes de l'utilitaire OCI.

Création et attachement d'une VNIC

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

Syntaxe

oci-network-config attach-vnic [-I | --ip-address adresse_ip] [-ipv4 | --ipv4] [-ipv6 | --ipv6] [-i | --nic-index index] [--subnet sous-réseau] [-n | --name nom] [--assign-public-ip] [-h | --help]

Pour créer une carte d'interface réseau virtuelle 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 d'interface réseau virtuelle nommée ex-demo-inst-10 et l'attacher à l'instance, procédez comme suit :

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

Détails d'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 courantes utilisées dans les utilitaires OCI, reportez-vous à Options courantes 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 VNIC

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

Syntaxe

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

Pour configurer toutes les cartes d'interface réseau virtuelles sur l'instance, procédez comme suit :

sudo oci-network-config configure

Par exemple :

$ sudo oci-network-config configure
Configured 

Pour configurer les cartes d'interface réseau virtuelles sur l'instance, à l'exception d'une carte d'interface réseau virtuelle 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 d'interface réseau virtuelles 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 d'interface réseau virtuelle de la configuration. Pour plus d'informations, reportez-vous à la section Displaying the Current Network Configuration.

Détails d'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 courantes utilisées dans les utilitaires OCI, reportez-vous à Options courantes de l'utilitaire OCI.

Affichage des VNIC configurées

La sous-commande oci-network-config show-VNICs affiche des informations sur les VNIC configurées sur 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 VNIC configurées sur l'instance, procédez comme suit :

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 d'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 courantes utilisées dans les utilitaires OCI, reportez-vous à Options courantes de l'utilitaire OCI.

Affichage de toutes les cartes VNIC configurées

Utilisez la sous-commande oci-network-config show-VNICs-all pour visualiser des informations détaillées sur toutes les cartes d'interface réseau virtuelles configurées sur cette instance.

Syntaxe

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

Pour afficher toutes les cartes d'interface réseau virtuelles configurées sur l'instance, procédez comme suit :

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, reportez-vous à Options courantes de l'utilitaire OCI.

Ajout d'une adresse secondaire

Utilisez l'utilitaire oci-network-config add-secondary-addr pour ajouter à une carte d'interface réseau virtuelle existante une adresse IP privée secondaire avec l'adresse IPv4 ou IPv6 indiquée.

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, en l'occurrence une adresse IPv6, à une carte d'interface réseau virtuelle 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 d'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 courantes utilisées dans les utilitaires OCI, reportez-vous à Options courantes de l'utilitaire OCI.

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

Utilisez la sous-commande oci-network-config unconfigure afin de supprimer l'ensemble de la configuration d'adresse IP pour les VNIC secondaires provisionnées (à l'exception de celles explicitement exclues). La VNIC principale ne peut pas être supprimée.

Utilisation

oci-network-config unconfigure [-I | --include élément] [-X | --exclude élément] [-h | --help]

Afin de supprimer toutes les configurations d'adresse IP pour les cartes d'interface réseau virtuelles 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 d'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 courantes utilisées dans les utilitaires OCI, reportez-vous à Options courantes de l'utilitaire OCI.

Suppression d'une adresse IPv6 secondaire

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

Utilisation

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

Pour enlever une adresse IPv6 secondaire privée d'une carte d'interface réseau virtuelle 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 enlever l'adresse IPv6 secondaire 2603:c020:c003:3a10:b64c:8f35:7f9e:7e87 d'une carte d'interface réseau virtuelle existante, procédez comme suit :

$ 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 d'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 courantes utilisées dans les utilitaires OCI, reportez-vous à Options courantes de l'utilitaire OCI.

Détachement d'une carte d'interface réseau virtuelle

Utilisez la sous-commande oci-network-config detach-vnic pour détacher et supprimer la carte d'interface réseau virtuelle avec l'OCID ou l'adresse IP spécifique de l'instance. Cette sous-commande peut être utilisée pour enlever l'adresse IP affectée d'une VNIC existante. Cependant, la VNIC principale ne peut pas être détachée. Toutes les adresses IP privées secondaires associées à la carte d'interface réseau virtuelle sont également supprimées.

Utilisation

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

Pour détacher une carte d'interface réseau virtuelle 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 d'interface réseau virtuelle avec un OCID de carte d'interface réseau virtuelle spécifique de l'instance, procédez comme suit :

$ 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 d'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 courantes utilisées dans les utilitaires OCI, reportez-vous à Options courantes 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

Afin d'afficher un rapport réseau détaillé pour un compartiment spécifique, exécutez l'utilitaire oci-network-inspector et utilisez l'option -C pour indiquer 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 Notifications sur une instance

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

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 OCID_sujet_notifications [-h | --help]

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

Par exemple :

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

Pour plus d'informations sur l'option de l'utilitaire oci-notify-config, reportez-vous à Options courantes de l'utilitaire OCI.

Publication d'un message dans 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 indiqué sur le sujet configuré.

Remarque : lorsque le message est publié, l'utilitaire oci-notify ajoute le nom de l'instance au début de 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 d'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 courantes utilisées dans les utilitaires OCI, reportez-vous à Options courantes de l'utilitaire OCI.

Syntaxe

Affichage de l'adresse IP de l'instance en cours

Exécutez la commande oci-public-ip sans option pour renvoyer l'adresse IP de l'instance en cours :

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 afficher l'adresse IP publique d'une autre instance que l'instance en cours, 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 de la liste des 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 d'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 courantes utilisées dans les utilitaires OCI, reportez-vous à Options courantes de l'utilitaire OCI.

Syntaxe

Affichage de toutes les données relatives à un volume iSCSI attaché

Pour afficher toutes les données relatives à un volume iSCSI attaché à l'instance de calcul, procédez comme suit :

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 concernant un volume iSCSI attaché

Vous pouvez éventuellement utiliser les options -k, -p et -v (valeur uniquement) avec l'utilitaire oci-volume-data pour affiner les informations à 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 d'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 courantes utilisées dans les utilitaires OCI, reportez-vous à Options courantes de l'utilitaire OCI.