Référence des 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 le volume de disque n'est pas la taille attendue, exécutez les commandes permettant de réanalyser le volume d'initialisation. Reportez-vous à Nouvelle analyse du disque pour des volumes attachés à des instances de 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 Oracle Linux Minimal :

• Par défaut : restaure les services systemd de la plate-forme Oracle Linux par défaut, les packages de diagnostic, 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 de 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, reportez-vous aux manuels Oracle Ksplice et Oracle Linux Ksplice User's Guide.

  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.

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 sur l'instance Oracle Linux Minimal :

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 la réinitialisation

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 d'entraînement expliquant comment utiliser l'utilitaire oci-iscsi-config, reportez-vous à Utilisation des utilitaire OCI afin de gérer l'espace de stockage iSCSI pour les instances Oracle Cloud Infrastructure dans Oracle Linux Training Station.

Pour plus d'informations sur l'option d'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 pour 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. Vous pouvez éventuellement utiliser 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. Modifiez éventuellement 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 spécifiques à 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 volume

Utilisez la sous-commande oci-iscsi-config create pour créer un volume de blocs et l'associer à une instance. Cette sous-commande nécessite que le kit SDK OCI pour Python soit installé et configuré. Pour plus d'informations sur le kit SDK OCI, reportez-vous à l'interface de ligne de commande et kits de développement logiciel.

Cette sous-commande requiert 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 de 70 Go à l'instance, le nom de volume mor-demo-by70 est le suivant :

$ 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 spécifiques à 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 rendre disponible pour le 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 à l'interface de ligne de commande et kits de développement logiciel.

Cette sous-commande requiert 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 attacher 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 spécifiques à 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.

Synchroniser un volume

Utilisez la sous-commande oci-iscsi-config sync pour attacher les périphériques en mode bloc disponibles à l'instance et effectuer des opérations de synchronisation. La sous-commande requiert 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 spécifiques à 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 (ID unique affecté à un périphérique) donné. Si le volume (ou une partition du volume) est monté, cette option essaie d'abord de le démonter.

Cette sous-commande requiert 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 spécifiques à 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 visualiser 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 spécifiques à 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 pour l'instance

Pour visualiser 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 visualiser 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 spécifiques à 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 actuelle

La sous-commande oci-network-config show affiche des informations sur les cartes d'interface réseau virtuelles 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 n'ont pas encore été configurées sont marquées avec l'indicateur ADD et les configurations d'adresse IP qui n'ont plus de cartes d'interface réseau virtuelles associées 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 à Configuration de cartes d'interface réseau virtuelles.

Détails d'option

Le tableau suivant fournit des informations détaillées sur les options spécifiques à 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éer et attacher une carte d'interface réseau virtuelle

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.

Utilisation

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 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 spécifiques à 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 cartes d'interface réseau virtuelles

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

Utilisation

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

Pour configurer toutes les cartes d'interface réseau virtuelles sur l'instance :

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 VNIC sont configurées en exécutant la sous-commande oci-network-config show. Après la configuration, aucun libellé ADD ou DELETE ne sera affiché 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 spécifiques à 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 cartes VNIC configurées

La sous-commande oci-network-config show-vnics affiche des informations sur les cartes d'interface réseau virtuelles configurées sur l'instance.

Utilisation

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 d'interfaces réseau virtuelles configurées sur 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 d'option

Le tableau suivant fournit des informations détaillées sur les options spécifiques à 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 afficher des informations détaillées sur toutes les cartes d'interface réseau virtuelles configurées sur cette instance.

Utilisation

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 :

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 adresse IP privée secondaire avec l'adresse IPv4 ou IPv6 indiquée à une VNIC existante.

Utilisation

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 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 spécifiques à 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 cartes d'interfaces réseau virtuelles secondaires provisiquées

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

Utilisation

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

Pour 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 spécifiques à 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 une adresse IP privée secondaire avec l'adresse IPv4 ou IPv6 indiquée d'une carte d'interface réseau virtuelle existante.

Utilisation

oci-network-config remove-secondary-addr [-I | --ip-address ip_address] [-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 :

$ 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 spécifiques à 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 spécifiques à 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 de visualiser 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'une rubrique de 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. Après 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.

Utilisation

oci-notify config notifications_topic_OCID [-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 d'utilitaire oci-notify-config, reportez-vous à Options courantes de l'utilitaire OCI.

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

Remarque : lorsque le message est publié, l'utilitaire oci-notify ajoute le nom à l'objet du message. Par exemple : instance_name:log messages

Utilisation

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' à la rubrique configurée, 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 à la rubrique configurée, 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 spécifiques à 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 occurrence

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 spécifiques à 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 d'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 sur un volume iSCSI attaché

Vous pouvez éventuellement utiliser les options -k, -p et -v (valeur uniquement) avec l'utilitaire oci-volume-data pour restreindre 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 d'option

Le tableau suivant fournit des informations détaillées sur les options spécifiques à 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.