Informazioni di riferimento su OCI Utilities

Ulteriori dettagli su ogni utility, tra cui una descrizione, esempi di utilizzo e opzioni.

Volumi

Networking

Informazioni sulla configurazione

Notifiche

oci-notify

Espansione dell'immagine minima

espansione oci-image

È inoltre possibile visualizzare l'opzione della utility OCI e informazioni dettagliate accedendo alle pagine man della utility OCI. Per informazioni su come accedere alle pagine man della utility OCI, vedere Common OCI Utility Options.

Utility

oci-compartmentid

Utilizzare la utility oci-compartmentid per visualizzare l'OCID (Oracle Cloud Identifier) del compartimento in cui è in esecuzione l'istanza.

Uso

oci-compartmentid [-h | --help]

Per visualizzare l'OCID compartimento dell'istanza:

sudo oci-compartmentid

Ad esempio:

$ sudo oci-compartmentid
ocid1.compartment1.oc1..OCID

Per informazioni sull'opzione della utility oci-compartmentid, vedere Common OCI Utility Options.

oci-crescita

Se espandi il volume di avvio di un'istanza basata su Linux di Oracle Cloud Infrastructure (OCI), puoi quindi utilizzare la utility oci-growfs per espandere la partizione radice dell'istanza. Ciò consente di utilizzare completamente il volume di avvio appena espanso.

Nota

sono supportati solo i file system XFS e ext4.

Per impostazione predefinita, un'istanza basata su Linux non utilizza automaticamente l'intero volume di avvio se il volume di avvio è maggiore o uguale a 50 GB. Se il volume di avvio collegato all'istanza è inferiore a 50 GB, non vengono apportate modifiche al sistema quando si utilizza la utility oci-growfs.

Uso

/usr/libexec/oci-growfs [-y] [-n] [-h | --help]

Espansione della partizione radice di un'istanza

Per espandere la partizione radice dell'istanza:

Usare il comando lsblk per confermare che il sistema operativo ha identificato la nuova dimensione del volume di avvio.

Ad esempio:

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

Se il volume disco non corrisponde alla dimensione prevista, eseguire i comandi per rieseguire la scansione del volume di avvio. See Rescanning the Disk for Volumes Attached to Linux-Based Instances.

Eseguire la utility oci-growfs con l'opzione y per rispondere "sì" a tutti i prompt.

sudo /usr/libexec/oci-growfs -y

Ad esempio:

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

Per informazioni sulle opzioni della utility oci-growfs, vedere Common OCI Utility Options.

espansione oci-image

Utilizzare la utility oci-image-expand per convertire l'istanza Oracle Linux Minimal per aggiungere servizi e pacchetti di un'immagine standard della piattaforma Oracle Linux. Con questa utility, l'istanza minima può ripristinare quasi le stesse funzionalità di un'immagine standard della piattaforma Oracle Linux.

Per informazioni sulla più recente immagine di Oracle Linux Minimal, vedere Oracle Linux 9.x Images.

La utility oci-image-expand richiede privilegi root.

Requisito

Installare OCI Utilities nell'istanza minima. Per ulteriori informazioni, vedere Installazione di OCI Utilities.

Tipi di conversione

La utility oci-image-expand fornisce due tipi di conversioni dell'istanza minima di Oracle Linux:

Predefinito: ripristina i servizi systemd della piattaforma Oracle Linux predefinita, i package di diagnostica, le impostazioni di configurazione cloud e configura e abilita lo swap sull'istanza. Il ripristino della funzionalità di piattaforma predefinita non aumenta il tempo di avvio dell'istanza. Questo tipo di conversione viene sempre applicato dalla utility oci-image-expand.
Riavvio richiesto: ripristina la funzionalità predefinita della piattaforma Oracle Linux, come descritto nel tipo di conversione predefinito, e ripristina una o più delle seguenti funzioni selezionabili dall'utente:
- Abilita SELinux: ripristina la modalità di applicazione di SELinux.
- Abilita Kdump: aggiunge la capacità kdump e la rigenerazione di kdump initramfs.
- Abilita Ksplice: installa Ksplice e abilita il servizio Ksplice. Per informazioni sull'uso di Ksplice, vedere Oracle Ksplice for Zero-Downtime Updates e Oracle Linux Ksplice User's Guide.
La scelta di una di queste funzioni selezionabili aumenta il tempo di avvio dell'istanza e richiede un riavvio per renderla effettiva.

Nota

L'esecuzione della utility oci-instance-expand influisce sulle impostazioni configurate dall'utente nell'istanza. Ad esempio, la utility ripristina cloud-init config nelle impostazioni predefinite dell'immagine della piattaforma Oracle Linux, sovrascrivendo in questo modo qualsiasi modifica cloud-config configurata dall'utente. Inoltre, se si sceglie di ripristinare Ksplice, l'utility reinstalla il pacchetto oci-linux-config in modo che la nuova chiave di accesso venga memorizzata nel file di configurazione appropriato. Non eseguire la utility su istanze diverse da quelle minime.

I file di log della utility oci-image-expand si trovano all'indirizzo: /var/log/oci-image-expand.log

Uso

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

Ripristino della funzionalità predefinita dell'immagine della piattaforma

Per ripristinare la funzionalità predefinita dell'immagine della piattaforma Oracle Linux nell'istanza minima di Oracle Linux, effettuare le operazioni riportate di seguito.

Eseguire la utility oci-image-expand e premere Invio al prompt, senza effettuare alcuna selezione.

Ad esempio:

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

Ripristino della funzionalità di immagine della piattaforma richiesta di riavvio

Per ripristinare la funzionalità dell'immagine della piattaforma Oracle Linux che richiede l'attivazione di un riavvio dell'istanza:

Eseguire la utility oci-image-expand.
```
/usr/libexec/oci-image-expand
```
Al prompt, eseguire una delle operazioni riportate di seguito, quindi premere Invio.
- Immettere zero per ripristinare tutte le funzioni dell'elenco (SELinux, Kdump e Ksplice).
- Immettere un numero singolo, compreso tra uno e tre, per ripristinare una delle funzioni dell'elenco.
- Immettere due numeri, compresi tra uno e tre, per ripristinare due delle funzionalità dell'elenco.
Ad esempio, per ripristinare le funzionalità SELinux e Ksplice nell'istanza minima di Oracle Linux:
```
$ /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):
 1 3
The following options were selected:
    Enable SELinux
    Enable Ksplice
The chosen options will now be applied. Press any key to continue (within 10 seconds)
```
Nota

Se si cambia idea su una funzione selezionata, digitare di nuovo il numero prima di premere Invio per deselezionare la funzione. Se si è già premuto Invio, premere Ctrl+C per annullare l'operazione.

Al prompt, immettere y per riavviare l'istanza.

A reboot is required to enable and activate all restored services. 
Do you wish to reboot now? (y/n)y

Per informazioni sull'opzione della utility oci-image-expand, vedere Common OCI Utility Options.

oci-instanceid

Utilizzare la utility oci-instanceid per visualizzare l'OCID (Oracle Cloud Identifier) dell'istanza.

Uso

oci-instanceid [-h | --help]

Per visualizzare l'OCID dell'istanza di computazione:

sudo oci-instanceid

Ad esempio:

$ sudo oci-instanceid
ocid1.instance1.oc1.iad1.OCID

Per informazioni sull'opzione della utility oci-instanceid, vedere Common OCI Utility Options.

oci-iscsi-config

Utilizzare la utility oci-iscsi-config per elencare e configurare i dispositivi iSCSI collegati a un'istanza basata su Linux di Oracle Cloud Infrastructure (OCI). Se eseguito senza alcuna opzione della riga di comando, oci-iscsi-config elenca i dispositivi che richiedono attenzione.

Attenzione

Evitare di immettere informazioni riservate quando si assegnano descrizioni, tag o nomi descrittivi alle risorse cloud tramite la console, l'API o l'interfaccia CLI.

Uso

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

Comandi secondari

La utility oci-iscsi-config include i seguenti comandi secondari.

Comandi secondari della utility oci-iscsi-config
Comando secondario	Per ulteriori informazioni vedere...
`show`	Visualizzazione delle configurazioni iSCSI
`sync`	Sincronizzazione di un volume
`create`	Creazione e collegamento di un nuovo volume
`attach`	Collegamento di un volume esistente
`detach`	Scollegamento di un Volume
`destroy`	Eliminazione di un Volume

Per un video di formazione che mostra come utilizzare la utility oci-iscsi-config, vedere Using OCI Utilities for Managing iSCSI Storage for Oracle Cloud Infrastructure Instances nella Training Station di Oracle Linux.

Per informazioni sull'opzione della utility oci-iscsi-config, vedere Common OCI Utility Options.

Visualizzazione delle configurazioni iSCSI

Il comando secondario oci-iscsi-config show elenca i dispositivi iSCSI e le informazioni iSCSI per l'istanza. Questo sottocomando funziona con il daemon ocid per monitorare la creazione e l'eliminazione dei dispositivi tramite la console, l'interfaccia CLI o l'API e rileva automaticamente tali modifiche.

Se il daemon ocid non è in esecuzione, il comando secondario richiede privilegi root.

Uso

oci-iscsi-config show [-C | --compartments name] [-A | --all] [--output-mode mode] [--details] [--no-truncate] [-h | --help]

Per visualizzare una lista di tutti i dispositivi collegati all'istanza:

Eseguire il comando secondario oci-iscsi-config show.

sudo oci-iscsi-config show

Ad esempio:

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

Facoltativamente, utilizzare le opzioni --details e --no-truncate con il comando secondario oci-iscsi-config show per visualizzare informazioni più dettagliate che non vengono abbreviate nell'output:

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

Ad esempio:

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

Facoltativamente, modificare la presentazione di output in modo che sia più leggibile utilizzando l'opzione --output-mode con il comando secondario oci-iscsi-config show:

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

Ad esempio, per visualizzare la presentazione di output in modalità testo:

$ 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

Dettagli opzione

La tabella seguente fornisce informazioni dettagliate sulle opzioni specifiche di questa utility o sottocomando. Per informazioni sulle opzioni comuni utilizzate nelle utility OCI, vedere Common OCI Utility Options.

oci-iscsi-config show Dettagli opzione
Opzione	Descrizione
`-A \| --all`	Visualizza tutti i dispositivi iSCSI. Per impostazione predefinita, vengono elencati solo i dispositivi non collegati a un'istanza.
`-C \| --compartments name`	Visualizza i dispositivi iSCSI nel compartimento specificato o in tutti i compartimenti (se `all` è specificato per `name`).

Creazione e collegamento di un nuovo volume

Utilizzare il comando secondario oci-iscsi-config create per creare e collegare un volume a blocchi a un'istanza. Questo comando secondario richiede l'installazione e la configurazione dell'SDK OCI per Python. Per ulteriori informazioni sull'SDK OCI, vedere Software Development Kit and Command Line Interface.

Questo comando secondario richiede privilegi root.

Uso

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

Per creare e collegare un volume, utilizzare la utility oci-iscsi-config create con le opzioni -S, --volume-name e --attach-volume:

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

Ad esempio, per creare e collegare un volume di 70 GB di dimensione all'istanza, con il nome del 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

Dettagli opzione

oci-iscsi-config - Crea dettagli opzione
Opzione	Descrizione
`-v \| --volume-name name`	Imposta il nome visualizzato per il volume. Evitare di fornire informazioni riservate per il nome visualizzato.
`-c \| --chap`	Collega il dispositivo con il flag Richiedi credenziali CHAP.

Collegamento di un volume esistente

Utilizzare il comando secondario oci-iscsi-config attach per collegare un volume a blocchi esistente all'istanza e rendere il volume disponibile al sistema. L'SDK OCI per Python è necessario per selezionare i volumi utilizzando il proprio OCID. Per ulteriori informazioni sull'SDK OCI, vedere Software Development Kit and Command Line Interface.

Questo comando secondario richiede privilegi root.

Nota

Quando si utilizza un numero IQN, il volume deve essere già collegato (assegnato) all'istanza nella console. Questa opzione può essere utilizzata per collegare più dispositivi contemporaneamente fornendo una lista separata da virgole di IQN.

Uso

Per collegare un volume a blocchi specifico all'istanza:

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

Dettagli opzione

oci-iscsi-config attach Dettagli opzione
Opzione	Descrizione
`-I \| --iqns IQN`	Lista separata da virgole dei nomi qualificati iSCSI (iqns) del dispositivo o dei dispositivi iSCSI da collegare all'istanza.
`-O \| --ocids` `OCID`	Lista separata da virgole degli OCID del dispositivo o dei dispositivi iSCSI da collegare all'istanza.
`-u \| --username name`	Utilizzare il nome utente specificato come nome utente CHAP quando l'autenticazione è necessaria per collegare un dispositivo. Questa opzione non è necessaria quando l'SDK OCI per Python è disponibile.
`-p \| --password password`	Utilizzare la password fornita come password CHAP quando è necessaria l'autenticazione per collegare un dispositivo. Questo argomento non è necessario quando l'SDK OCI per Python è disponibile.
`-c \| --chap`	Collegare il dispositivo al flag Richiedi credenziali CHAP.

Sincronizzazione di un volume

Utilizzare il comando secondario oci-iscsi-config sync per collegare i dispositivi a blocchi disponibili all'istanza ed eseguire operazioni di sincronizzazione. Il comando secondario richiede privilegi root.

Uso

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

Per collegare i dispositivi a blocchi disponibili all'istanza e sincronizzare le modifiche con OCI, utilizzare il comando secondario oci-iscsi-config sync con l'opzione --apply:

sudo oci-iscsi-config sync --apply

Ad esempio:

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

Dettagli opzione

Dettagli opzione di sincronizzazione oci-iscsi-config
Opzione	Descrizione
`-a \| --apply`	Eseguire le operazioni di sincronizzazione.

Scollegamento di un Volume

Utilizzare il comando secondario oci-iscsi-config detach per scollegare un dispositivo con l'IQN specificato (un ID univoco assegnato a un dispositivo). Se il volume (o qualsiasi partizione del volume) viene attivato, questa opzione cerca di disinstallarlo per primo.

Questo comando secondario richiede privilegi root.

Nota

È possibile scollegare più dispositivi contemporaneamente fornendo un elenco separato da virgole di numeri IQN.

Uso

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

Per scollegare un dispositivo specifico dall'istanza, utilizzare il comando secondario oci-iscsi-config detach con l'opzione -I:

sudo oci-iscsi-config detach -I IQN

Ad esempio:

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

Per visualizzare l'IQN o l'OCID del volume che si desidera scollegare, utilizzare il comando secondario oci-iscsi-config show. Per informazioni, vedere Visualizzazione delle configurazioni iSCSI.

Dettagli opzione

oci-iscsi-config detach Dettagli opzione
Opzione	Descrizione
`-f \| --force`	Continua lo scollegamento anche se il dispositivo non può essere disinstallato.
`-I \| --iqns IQN`	Lista separata da virgole dei nomi qualificati iSCSI (iqns) del dispositivo o dei dispositivi iSCSI da scollegare dall'istanza.

Eliminazione di un Volume

Per eliminare un volume di storage a blocchi con l'OCID specificato, utilizzare il comando secondario oci-iscsi-config destroy.

Nota

È possibile eliminare più dispositivi contemporaneamente fornendo una lista separata da virgole di OCID.

Uso

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

Per eliminare un volume a blocchi specifico dall'istanza, utilizzare il comando secondario oci-iscsi-config-destroy con l'opzione -O:

sudo oci-iscsi-config destroy -O OCID

Ad esempio:

$ 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

È possibile visualizzare l'OCID del volume utilizzando il comando secondario della utility oci-iscsi-config show. Per informazioni, vedere Visualizzazione delle configurazioni iSCSI.

Dettagli opzione

oci-iscsi-config destroy Dettagli opzione
Opzione	Descrizione
`-O \| --ocids OCID`	Lista separata da virgole degli OCID del volume a blocchi da eliminare.

oci-metadati

Utilizzare la utility oci-metadata per visualizzare o impostare i metadati per un'istanza di computazione basata su Oracle Linux. Se eseguito senza alcuna opzione della riga di comando, oci-metadata elenca tutti i metadati disponibili.

Per ulteriori informazioni sui metadati delle istanze, vedere Recupero dei metadati delle istanze.

Uso

oci-metadata [-h | --human-readable] [-j | --json] [-g | --get key] [--export] [--trim] [--value-only] [-u key_value] [-i | --instance-id OCID] [--help]

Recupero di tutti i metadati per l'istanza

Per visualizzare tutti i metadati per l'istanza, eseguire la utility oci-metadata senza opzioni:

sudo oci-metadata

Ad esempio:

$ 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

Recupero di metadati specifici per l'istanza

Per visualizzare i metadati dell'istanza per una chiave specificata, utilizzare l'opzione --get con la utility oci-metadata:

sudo oci-metadata --get key

Ad esempio, per visualizzare solo lo stato dell'istanza di computazione:

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

Dettagli opzione

Dettagli opzione oci-metadata
Opzione	Descrizione
`-g key \| --get key`	Recupera i dati solo per la chiave specificata. Le chiavi di metadati per un'istanza possono essere definite da Compute oppure puoi creare chiavi personalizzate. Per ulteriori informazioni, vedere Modifiche alle chiavi metadati.
`--export`	Utilizzato con l'opzione `-g` o `--get`, visualizza un comando shell per esportare la chiave come variabile d'ambiente.
`--trim`	Utilizzato con l'opzione `-g` o `--get`, tagliare il percorso chiave all'ultimo componente per rendere l'output più conciso. Ad esempio, da `instance/metadata/ssh_authorized_keys` a `ssh_authorized_keys`. Se la chiave corrisponde a più chiavi, viene visualizzata solo la prima chiave corrispondente.
`--value-only`	Utilizzato con l'opzione `-g` o `--get`, visualizza solo i valori corrispondenti alla chiave get.
`-u key_value`	Aggiornare il valore per la chiave o le chiavi specifiche. Per `key_value`, specificare una stringa, un valore JSON o un puntatore a un file con contenuto JSON nel seguente formato: `key=file:/path/to/file`
`-i \| --instance-id OCID`	Recupera o aggiorna i metadati dell'istanza con l'OCID specifico. Per impostazione predefinita, `oci-metadata` funziona con i metadati dell'istanza a cui è stato eseguito il login.

oci-network-config

La utility oci-network-config consente di configurare le interfacce di rete per l'istanza. Questa utility deve essere eseguita come utente root.

La utility oci-network-config mostra le schede VNIC (Virtual Network Interface Card) correnti di cui è stato eseguito il provisioning in Oracle Cloud Infrastructure (OCI) e configurate per questa istanza. Quando viene eseguito il provisioning di una VNIC secondaria in OCI, deve essere configurata in modo esplicito sull'istanza utilizzando la utility oci-network-config.

Le interfacce di rete da configurare possono essere posizionate all'interno di spazi di nomi di rete separati. Questa separazione è necessaria quando le VNIC si trovano in subnet (diverse VCN) con blocchi di indirizzi sovrapposti e le applicazioni di rete non sono associate direttamente alle interfacce. Gli spazi di nomi di rete richiedono che le applicazioni vengano avviate esplicitamente negli spazi di nomi (con il comando ip netns exec ns) per stabilire l'associazione con l'interfaccia. Quando gli spazi di nomi non vengono utilizzati, l'instradamento basato su criteri è configurato per fornire un instradamento predefinito al router virtuale della VNIC secondaria (gateway predefinito) quando l'indirizzo della VNIC è l'indirizzo di origine.

Le VNIC secondarie Bare Metal vengono configurate utilizzando le VLAN (in cui non è presente alcuna interfaccia fisica corrispondente). Queste VNIC vengono visualizzate come due interfacce aggiuntive quando vengono visualizzati i collegamenti IP, con i nomi in MACVLAN_FORMAT per la VLAN MAC e VLAN_FORMAT per la VLAN IP.

Uso

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

Comandi secondari

La utility oci-network-config include i seguenti comandi secondari.

Comandi secondari della utility oci-network-config
Comando secondario	Per ulteriori informazioni vedere...
`show`	Visualizzazione della configurazione di rete corrente
`show-vnics`	Visualizzazione delle VNIC configurate
`show-vnics-all`	Visualizzazione di tutte le VNICS configurate
`show-vcns`	Visualizzazione delle informazioni sulla VCN
`show-subnets`	Visualizzazione delle informazioni sulla subnet
`configure`	Configurazione delle VNIC
`unconfigure`	Eliminazione della configurazione IP per le VNIC secondarie di cui è stato eseguito il provisioning
`attach-vnic`	Creazione e collegamento di una VNIC
`detach-vnic`	Scollegamento di una VNIC
`add-secondary-addr`	Aggiunta di un indirizzo secondario
`remove-secondary-addr`	Rimozione di un indirizzo IPv6 secondario

Per un video di formazione che mostra come utilizzare la utility oci-network-config, vedere Network Interface Management Using OCI Utilities on Oracle Linux Instances nella Training Station di Oracle Linux.

Per informazioni sulle opzioni della utility oci-network-config, vedere Common OCI Utility Options.

Visualizzazione della configurazione di rete corrente

Il comando secondario oci-network-config show mostra informazioni sulle VNIC configurate nell'istanza. È possibile visualizzare la configurazione di rete corrente, ad esempio le VNIC di cui è stato eseguito il provisioning e le configurazioni IP correnti per l'istanza. Le VNIC non ancora configurate vengono contrassegnate con ADD e le configurazioni IP che non dispongono più di una VNIC associata vengono contrassegnate con DELETE.

L'output di questo comando è l'azione predefinita se la utility oci-network-config viene immessa senza alcuna opzione.

Uso

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

Per visualizzare la configurazione di rete corrente:

sudo oci-network-config show

Ad esempio:

$ 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

Per configurare le VNIC non ancora configurate (con etichetta ADD) ed eliminare gli indirizzi IP a cui non sono associate VNIC, utilizzare il comando secondario oci-network-config config. Per ulteriori informazioni, vedere Configurazione delle schede VNIC.

Dettagli opzione

oci-network-config show Dettagli opzione
Opzione	Descrizione
`-I \| --include item`	Includere un indirizzo IP o un'interfaccia VLAN precedentemente esclusa utilizzando l'opzione `--exclude` nella configurazione/deconfigurazione automatica. Per `item`, è possibile specificare un OCID VNIC, un indirizzo IP o un nome di interfaccia VLAN.
`-X \| --exclude item`	Escludere in modo persistente un indirizzo IP o un'interfaccia VLAN dalla configurazione/deconfigurazione automatica. Per `item`, è possibile specificare un OCID VNIC, un indirizzo IP o un nome di interfaccia VLAN. Utilizzare l'opzione `--include` per includere nuovamente l'indirizzo IP o l'interfaccia VLAN.

Creazione e collegamento di una VNIC

Utilizzare il comando secondario oci-network-config attach-vnic per creare e collegare una VNIC a un'istanza. Questo comando secondario consente di assegnare un indirizzo IP pubblico o privato alla nuova VNIC.

Importante

Il collegamento di una VNIC con un indirizzo IPv6 primario non è supportato da OCI.

Uso

Per creare una VNIC e collegare la VNIC a un'istanza, utilizzare il comando secondario oci-network-config attach-vnic con l'opzione -n:

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

Ad esempio, per creare una VNIC denominata ex-demo-inst-10 e collegare la VNIC all'istanza:

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

Dettagli opzione

oci-network-config attach-vnic Dettagli opzione
Opzione	Descrizione
`-I \| --ip-address ip_address`	Assegnare l'indirizzo IP privato specificato alla VNIC. Se questa opzione non viene utilizzata, un indirizzo IP non utilizzato dalla subnet viene assegnato automaticamente alla VNIC.
`-ipv4 \| --ipv4`	Assegnare un indirizzo IPv4 alla VNIC. Se si utilizza l'opzione `--ipv4`, alla VNIC viene assegnato un indirizzo IPv4 non utilizzato dalla sottorete. Se l'opzione `--ip-address` viene specificata con questa opzione, le opzioni `--ipv4` e `--ipv6` vengono ignorate.
`-ipv6 \| --ipv6`	Assegnare un indirizzo IPv6 alla VNIC. Se si utilizza l'opzione `--ipv6`, alla VNIC viene assegnato un indirizzo IPv6 non utilizzato dalla sottorete. Se invece si utilizza l'opzione `--ip-address`, le opzioni `--ipv4` e `--ipv6` vengono ignorate. Importante: il collegamento di una VNIC con un indirizzo IPv6 primario non è supportato da OCI. Quando si esegue `oci-network-config attach-vnic` con l'opzione `--ipv6`, viene visualizzato il messaggio seguente. # sudo oci-network-config attach-vnic --ipv6 Attaching a vnic with a primary ipv6 address is not yet supported by OCI.
`-i \| --nic-index index`	Assegnare la VNIC alla scheda NIC fisica specificata. Per `index`, specificare il numero di indice assegnato alla scheda NIC fisica. Il valore predefinito è zero. Questa opzione viene utilizzata solo per le istanze Bare Metal.
`--subnet subnet`	Connettere la VNIC alla subnet specificata. Per `subnet`, specificare un OCID o un'espressione regolare corrispondente al nome visualizzato di tutte le subnet disponibili. Quando si utilizza `--ip-address`, la subnet viene derivata dall'indirizzo IP o viene utilizzata per impostazione predefinita la subnet della VNIC primaria.
`-n \| --name name`	Impostare il nome visualizzato per la VNIC. Evitare di fornire informazioni riservate.
`--assign-public-ip`	Assegna un indirizzo IP pubblico alla VNIC. Per impostazione predefinita, viene assegnato solo un indirizzo IP privato.

Configurazione delle VNIC

Il comando secondario oci-network-config configure aggiunge la configurazione IP per le VNIC non configurate ed elimina la configurazione IP delle VNIC di cui non è più stato eseguito il provisioning. Questo comando sincronizza la configurazione IP dell'istanza con il provisioning OCI corrente.

Uso

Per configurare tutte le VNIC sull'istanza, effettuare le operazioni riportate di seguito.

sudo oci-network-config configure

Ad esempio:

$ sudo oci-network-config configure
Configured

Per configurare le VNIC sull'istanza, ad eccezione di una VNIC specifica, utilizzare il comando secondario oci-network-config configure con l'opzione -X:

sudo oci-network-config configure -X VNIC_OCID

Ad esempio:

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

È possibile confermare che le VNIC sono configurate eseguendo il comando secondario oci-network-config show. Dopo la configurazione, nell'output non verrà visualizzata alcuna etichetta ADD o DELETE, a meno che non si scelga di escludere una VNIC dalla configurazione. Per ulteriori informazioni, vedere Visualizzazione della configurazione di rete corrente.

Dettagli opzione

oci-network-config configure Dettagli opzione
Opzione	Descrizione
`-n \| --namespace format`	Durante la configurazione, posizionare le interfacce nello spazio di nomi identificato dal formato specificato. Il formato può includere variabili `$nic` e `$vltag`. Per impostazione predefinita, il nome è `DEF_NS_FORMAT_BM` per BMs e `DEF_NS_FORMAT_VM` per VM. Quando si configurano più VNIC, assicurarsi che gli spazi di nomi siano univoci.
`-r \| --start-sshd`	Avviare `sshd` nello spazio di nomi (se è presente `-n`).
`-I \| --include item`	Includere un indirizzo IP o un'interfaccia VLAN precedentemente esclusa utilizzando l'opzione `--exclude` nella configurazione/deconfigurazione automatica. Per `item`, è possibile specificare un OCID VNIC, un indirizzo IP o un nome di interfaccia VLAN.
`-X \| --exclude item`	Escludere in modo persistente un indirizzo IP o un'interfaccia VLAN dalla configurazione/deconfigurazione automatica. Per `item`, è possibile specificare un OCID VNIC, un indirizzo IP o un nome di interfaccia VLAN. Utilizzare l'opzione `--include` per includere nuovamente l'indirizzo IP o l'interfaccia VLAN.

Visualizzazione delle VNIC configurate

Il comando secondario oci-network-config show-vnics mostra informazioni sulle VNIC configurate nell'istanza.

Uso

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

Per visualizzare informazioni sulle VNIC configurate nell'istanza, effettuare le operazioni riportate di seguito.

sudo oci-network-config show-vnics

Ad esempio:

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

Dettagli opzione

oci-network-config show-vnics Dettagli opzione
Opzione	Descrizione
`--ocid OCID`	Mostra informazioni sulla VNIC che corrisponde all'OCID (Oracle Cloud Identifier) specificato.
`--name name`	Mostra informazioni sulla VNIC associata al nome specificato.
`--ip-address primary_IP`	Mostra informazioni sulla VNIC associata all'indirizzo IP primario specificato.

Visualizzazione di tutte le VNICS configurate

Utilizzare il comando secondario oci-network-config show-vnics-all per visualizzare informazioni dettagliate su tutte le VNIC configurate in questa istanza.

Uso

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

Per visualizzare tutte le VNIC configurate nell'istanza:

sudo oci-network-config show-vnics-all

Ad esempio:

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

Per informazioni sulle opzioni oci-network-config show-vnics-all, vedere Common OCI Utility Options.

Aggiunta di un indirizzo secondario

Utilizzare la utility oci-network-config add-secondary-addr per aggiungere un indirizzo IP privato secondario con l'indirizzo IPv4 o IPv6 specificato a una VNIC esistente.

Uso

Per aggiungere un indirizzo IP secondario privato, in questo caso un indirizzo IPv6, a una VNIC esistente, utilizzare il comando secondario oci-network-config add-secondary-addr con le opzioni --ipv6 e --ocid:

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

Ad esempio:

$ 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

Dettagli opzione

oci-network-config add-secondary-addr Dettagli sull'opzione
Opzione	Descrizione
`-ipv4 \| --ipv4`	Specificare che un indirizzo secondario privato IPv4 deve essere aggiunto a una VNIC esistente. Questa opzione è quella predefinita se il comando viene immesso senza alcuna opzione.
`-ipv6 \| --ipv6`	Specificare che un indirizzo secondario privato IPv6 deve essere aggiunto a una VNIC esistente.
`-I ip_address \| --ip-address ip_address`	Specificare l'indirizzo IP privato secondario da aggiungere alla VNIC.
`-O \| --ocid OCID`	Assegnare l'indirizzo secondario alla VNIC associata all'OCID specifico.

Eliminazione della configurazione IP per le VNIC secondarie di cui è stato eseguito il provisioning

Utilizzare il comando secondario oci-network-config unconfigure per eliminare tutta la configurazione IP per le VNIC secondarie di cui è stato eseguito il provisioning (ad eccezione di quelle escluse in modo esplicito). Impossibile eliminare la VNIC primaria.

Uso

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

Per eliminare tutta la configurazione IP per le VNIC secondarie di cui è stato eseguito il provisioning, utilizzare il comando secondario oci-network-config unconfigure:

sudo oci-network-config unconfigure

Ad esempio:

$ sudo oci-network-config unconfigure
Unconfigured

Dettagli opzione

oci-network-config deconfigura dettagli opzione
Opzione	Descrizione
`-I \| --include item`	Includere un indirizzo IP o un'interfaccia VLAN precedentemente esclusa utilizzando l'opzione `--exclude` nella configurazione/deconfigurazione automatica. Per `item`, è possibile specificare un OCID VNIC, un indirizzo IP o un nome di interfaccia VLAN.
`-X \| --exclude item`	Escludere in modo persistente un elemento (indirizzo IP o interfaccia VLAN) dalla configurazione/deconfigurazione automatica. Per `item`, è possibile specificare un OCID VNIC, un indirizzo IP o un nome di interfaccia VLAN. Utilizzare l'opzione `--include` per includere nuovamente l'indirizzo IP o l'interfaccia VLAN.

Rimozione di un indirizzo IPv6 secondario

Utilizzare il comando secondario oci-network-config remove-secondary-addr per rimuovere un indirizzo IP privato secondario con l'indirizzo IPv4 o IPv6 specificato da una VNIC esistente.

Uso

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

Per rimuovere un indirizzo IPv6 secondario privato da una VNIC esistente, utilizzare il comando secondario oci-network-config remove-secondary-addr con l'opzione -I:

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

Ad esempio, per rimuovere l'indirizzo IPv6 secondario, 2603:c020:c003:3a10:b64c:8f35:7f9e:7e87, da una VNIC esistente:

$ 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

Dettagli opzione

oci-network-config remove-secondary-addr Dettagli sull'opzione
Opzione	Descrizione
`-I \| --ip-address ip_address`	Specificare l'indirizzo IP privato secondario da rimuovere dalla VNIC.

Scollegamento di una VNIC

Utilizzare il comando secondario oci-network-config detach-vnic per scollegare ed eliminare la VNIC con l'OCID o l'indirizzo IP specifici dall'istanza. Questo comando secondario può essere utilizzato per rimuovere l'indirizzo IP assegnato da una VNIC esistente. Tuttavia, la VNIC primaria non può essere scollegata. Vengono eliminati anche tutti gli indirizzi IP privati secondari associati alla VNIC.

Uso

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

Per scollegare una VNIC dall'istanza, utilizzare il comando secondario oci-network-config detach-vnic con l'opzione --ocid:

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

Ad esempio, per scollegare una VNIC con un OCID VNIC specifico dall'istanza:

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

Dettagli opzione

oci-network-config detach-vnic Dettagli opzione
Opzione	Descrizione
`-I \| --ip-address ip_address`	Scollegare la VNIC dall'indirizzo IP specificato.
`--ocid OCID`	Scollegare la VNIC con l'OCID specificato.

Visualizzazione delle informazioni sulla VCN

Il comando secondario oci-network-config show-vcns visualizza le informazioni sulla rete cloud virtuale (VCN) nel compartimento in cui risiede l'istanza.

Uso

oci-network-config show-vcns [--output-mode mode] [--details] [--ocid OCID] [--name name] [--no-truncate] [-h | --help]

Per visualizzare informazioni dettagliate sulla VCN in formato di output di testo, utilizzare il comando secondario oci-network-config show-vcns con le opzioni --details e --output-mode text:

sudo oci-network-config show-vcns --details --output-mode text

Ad esempio:

$ sudo oci-network-config show-vcns --details --output-mode text
Virtual Cloud Network Information:

Name: hostname_uk_01
IPv4 cidr block: 10.0.0.0/16
IPv6 cidr block: 2603:c020:c003:6c00::/56
OCID: ocid1.vcn.oc1..example_OCID
IPv4 cidr blocks: 10.0.0.0/16
DNS label: gtijskenuk01
State: AVAILABLE
Lifecycle state: AVAILABLE

Name: hostname_uk_02
IPv4 cidr block: 10.2.0.0/16
IPv6 cidr block: 2603:c020:c003:3a00::/56
OCID: ocid1.vcn.oc1..example_OCID
IPv4 cidr blocks: 10.2.0.0/16
DNS label: gtijskenuk02
State: AVAILABLE
Lifecycle state: AVAILABLE

Name: hostname_uk_ref
IPv4 cidr block: 10.253.0.0/16
IPv6 cidr block: 2603:c020:c007:9f00::/56
OCID: ocid1.vcn.oc1..example_OCID
IPv4 cidr blocks: 10.253.0.0/16
DNS label: gtijskenukref
State: AVAILABLE
Lifecycle state: AVAILABLE

Dettagli opzione

oci-network-config show-vcns Dettagli opzione
Opzione	Descrizione
`--ocid OCID`	Visualizzare la VCN con l'OCID specificato.
`--name name`	Visualizza la VCN con il nome specificato.

Visualizzazione delle informazioni sulla subnet

Il comando secondario oci-network-config show-subnets mostra le informazioni sulla subnet nel compartimento in cui risiede questa istanza.

Uso

oci-network-config show-subnets [--output-mode mode] [--details] [--ocid OCID] [--name name] [--no-truncate] [-h | --help]

Per visualizzare informazioni dettagliate sulla subnet nel formato di output JSON, utilizzare il comando secondario oci-network-config show-subnets con le opzioni --details e --output-mode json:

sudo oci-network-config show-subnets --details --output-mode json

Ad esempio:

$ sudo oci-network-config show-subnets --details --output-mode json
[
  {
    "Name": "Public Subnet-hostname_uk_01",
    "ipv4 cidr block": "10.0.0.0/24",
    "ipv6 cidr block": "2603:c020:c003:6c00::/64",
    "OCID": "ocid1.subnet.oc1..OCID",
    "VCN name": "hostname_uk_01",
    "VCN ocid": "ocid1.vcn.oc1..OCID",
    "Public": true,
    "Public ingress": true,
    "DNS label": "sub06230933270",
    "Domain name": "sub06230933270.gtijskenuk01.oraclevcn.com",
    "Lifecycle state": "AVAILABLE"
  },
  {
    "Name": "hostname_uk_ref_02",
    "ipv4 cidr block": "10.253.20.0/24",
    "ipv6 cidr block": "2603:c020:c007:9f20::/64",
    "OCID": "ocid1.subnet.oc1..OCID",
    "VCN name": "hostname_uk_ref",
    "VCN ocid": "ocid1.vcn.oc1..OCID",
    "Public": true,
    "Public ingress": true,
    "DNS label": "gtijskenukref02",
    "Domain name": "gtijskenukref02.gtijskenukref.oraclevcn.com",
    "Lifecycle state": "AVAILABLE"
  },
  {
    "Name": "hostname_uk_ref_01",
    "ipv4 cidr block": "10.253.10.0/24",
    "ipv6 cidr block": "2603:c020:c007:9f10::/64",
    "OCID": "ocid1.subnet.oc1..OCID",
    "VCN name": "hostname_uk_ref",
    "VCN ocid": "ocid1.vcn.oc1..OCID",
    "Public": true,
    "Public ingress": true,
    "DNS label": "gtijskenukref01",
    "Domain name": "gtijskenukref01.gtijskenukref.oraclevcn.com",
    "Lifecycle state": "AVAILABLE"
  },
]

Dettagli opzione

oci-network-config show-subnets Dettagli opzione
Opzione	Descrizione
`--ocid OCID`	Mostra informazioni sulla subnet che corrisponde all'OCID (Oracle Cloud Identifier) specificato.
`--name name`	Mostra informazioni sulla subnet associata al nome specificato.

oci-network-inspector

La utility oci-network inspector visualizza un report di rete dettagliato per un compartimento o una rete specifici configurati per l'istanza.

Uso

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

Visualizzazione di un report dettagliato per una VCN specifica

Per visualizzare un report dettagliato per una VCN specifica, eseguire la utility oci-network-inspector e utilizzare l'opzione -N per specificare l'OCID della VCN:

sudo oci-network-inspector -N OCID

Ad esempio:

$ 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

      ...

Visualizzazione di un report dettagliato per un compartimento specifico

Per visualizzare un report di rete dettagliato per un compartimento specifico, eseguire la utility oci-network-inspector e utilizzare l'opzione -C per specificare un OCID compartimento:

sudo oci-network-inspector -C OCID

Ad esempio:

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

     ...

Per informazioni sull'opzione della utility oci-network-inspector, vedere Common OCI Utility Options.

oci-notify

La utility oci-notify invia un messaggio a un argomento del servizio Notifiche. Questa utility deve essere eseguita come utente root.

Un messaggio è composto da un'intestazione di messaggio (titolo) e un file. La configurazione del servizio Notifiche per l'argomento determina dove e come vengono consegnati i messaggi. Gli argomenti vengono configurati utilizzando la console, l'API o l'interfaccia CLI di Oracle Cloud Infrastructure (OCI).

Per ulteriori informazioni sul servizio Notifiche, incluse le modalità di creazione degli argomenti, vedere Panoramica delle notifiche.

Uso

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

Comandi secondari

La utility oci-notify include i seguenti comandi secondari.

Comandi secondari della utility oci-notify
Comando secondario	Per ulteriori informazioni vedere...
`config`	Configurazione di un argomento del servizio di notifiche in un'istanza
`message`	Pubblicazione di un Messaggio in un argomento

Per informazioni sull'opzione della utility oci-notify, vedere Common OCI Utility Options.

Configurazione di un argomento del servizio di notifiche in un'istanza

Utilizzare il comando secondario oci-notify config per scrivere l'OCID dell'argomento del servizio Notifiche nel file oci.conf. Dopo la configurazione, è possibile pubblicare i messaggi in questo argomento configurato.

Il percorso del file di configurazione è /etc/oci-utils/oci.conf per impostazione predefinita. È possibile sostituire il percorso del file di configurazione utilizzando la variabile di ambiente OCI_CONFIG_DIR.

Uso

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

Per scrivere l'OCID di un argomento del servizio di notifiche configurato nel file oci.conf, utilizzare il comando secondario oci-notify config e specificare l'OCID dell'argomento del servizio di notifiche.

Ad esempio:

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

Per informazioni sull'opzione della utility oci-notify-config, vedere Common OCI Utility Options.

Pubblicazione di un Messaggio in un argomento

Con il comando secondario oci-notify message, è possibile pubblicare il contenuto di un file o una stringa di testo con il titolo specificato nell'argomento configurato.

Nota: quando il messaggio viene pubblicato, la utility oci-notify anticipa il nome dell'istanza all'oggetto del messaggio. Ad esempio: instance_name:log messages

Uso

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

Per inviare il contenuto del file /var/log/messages con il titolo 'logging messages' all'argomento configurato, utilizzare le opzioni --title e --file con il comando secondario oci-notify-message.

Ad esempio:

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

Per inviare una stringa di testo all'argomento configurato, immettere una riga di testo tra virgolette singole per il valore dell'opzione --file.

Ad esempio:

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

Dettagli opzione

Dettagli opzione oci-notify-message
Opzione	Descrizione
`-t \| --title message_title`	Specificare il titolo da utilizzare nell'intestazione del messaggio (ad esempio, `'log messages'` se si stanno inviando file di log). `message_title` deve essere racchiuso tra virgolette singole o doppie. Le intestazioni dei messaggi sono troncate a 128 caratteri.
`-f \| --file message_file`	Specificare il percorso completo o relativo della directory, l'URL HTTP o FTP del file di messaggio o la stringa di testo da inviare. I file più grandi sono suddivisi in chunk da 64 KB e vengono inviati come messaggi separati. Il numero di pezzi è limitato a 10. Se il `message_file` specificato non è riconosciuto come URL o il percorso della directory non esiste, il testo immesso per `message_file` viene inviato come stringa di testo. Le stringhe di testo possono contenere al massimo 128 caratteri.

oci-pubblico-ip

Utilizzare la utility oci-public-ip per visualizzare l'indirizzo IP pubblico dell'istanza di computazione corrente, in formato leggibile dall'utente o JSON.

La utility oci-public-ip utilizza l'SDK di Oracle Cloud Infrastructure (OCI) per trovare l'indirizzo IP (vedere Software Development Kit and Command Line Interface). Se l'indirizzo IP non può essere ottenuto con questo metodo, la utility oci-public-ip prova quindi il protocollo Session Traversal Utilities for NAT (STUN) come ultima risorsa per trovare l'indirizzo IP. Per maggiori informazioni su STUN, vedere l'articolo STUN Wikepedia.

Uso

oci-public-ip [-h | --human-readable] [-j | --json] [-g | --get] [-a | --all] [-s | --sourceip source_IP] [-S | --stun-server STUN_server] [-L | --list-servers] [--instance-id OCID] [--help]

Visualizzazione dell'indirizzo IP dell'istanza corrente

Eseguire il comando oci-public-ip senza opzioni per restituire l'indirizzo IP dell'istanza corrente:

sudo oci-public-ip

Ad esempio:

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

Visualizzazione dell'indirizzo IP di un'altra istanza

Per visualizzare l'indirizzo IP pubblico di un'altra istanza diversa dall'istanza corrente, utilizzare la utility oci-public-ip con l'opzione --instance-id.

Nota

Questa opzione richiede l'installazione e la configurazione dell'SDK OCI per Python. Per ulteriori informazioni, vedere Software Development Kit and Command Line Interface (Kit di sviluppo software).

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

Ad esempio:

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

Visualizzazione di una lista di server STUN

Per visualizzare un elenco dei server STUN, utilizzare la utility oci-public-ip con l'opzione --list-servers:

sudo oci-public-ip --list-servers

Ad esempio:

$ 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

Dettagli opzione

Opzioni utility oci-public-ip
Opzione	Descrizione
`-g \| get`	Stampa solo l'indirizzo IP.
`--instance-id OCID`	Visualizza l'indirizzo IP pubblico dell'istanza specificata anziché quello corrente. Richiede che l'SDK OCI per Python sia installato e configurato.
`-L \| --list-servers`	Stampa un elenco di server e uscite STUN noti.
`-s \| --sourceip source_IP`	Specifica l'indirizzo IP di origine da utilizzare.
`-S \| --stun-server STUN_server`	Specifica il server STUN da utilizzare.

dati_volumi_ci

Utilizzare la utility oci-volume-data per visualizzare i dati su un volume iSCSI specifico collegato a un'istanza di computazione basata su Oracle Linux.

La utility oci-volume-data richiede l'opzione -k (chiave) per visualizzare i dati per un volume iSCSI specifico. I valori delle opzioni chiave possono essere il nome visualizzato, l'OCID o l'iqn (iSCSI Qualified Name) del volume.

Uso

oci-volume-data [-h | --help] [-k KEY | --key KEY] [-p | --par {name, iqn, ocid, portal, chap, attachestate, avdomain, compartment, attached, size, state}] [-v | --value-only]

Visualizzazione di tutti i dati relativi a un volume iSCSI collegato

Per visualizzare tutti i dati relativi a un volume iSCSI collegato all'istanza di computazione:

sudo oci-volume-data -k OCID

Ad esempio:

$ 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

Visualizzazione di dati specifici su un volume iSCSI collegato

Se si desidera, utilizzare le opzioni -k, -p e -v (solo valore) con la utility oci-volume-data per limitare i valori da visualizzare per il volume iSCSI.

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

Ad esempio, per visualizzare solo le dimensioni di un volume iSCSI, in questo caso, 70 GB:

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

Per ulteriori informazioni sui valori delle opzioni supportati (ad esempio, dimensione, stato, compartimento e così via), vedere la pagina man per oci-volume-data. Per informazioni sull'accesso alle pagine man della utility OCI, vedere Common OCI Utility Options.

Dettagli opzione

Opzioni utility oci-volume-data
Opzione	Descrizione
`-k KEY \| --key KEY`	Obbligatorio. La chiave per identificare il volume. Il valore `KEY` può essere l'OCID, l'IQN o il nome visualizzato del volume.
`-p \| --par`	Specifica l'indirizzo IP di origine da utilizzare.
`-v \| --value-only`	Mostra solo i valori nell'output.

Documentazione dell'infrastruttura Oracle Cloud

Informazioni di riferimento su OCI Utilities

Utility

Uso

Uso

Espansione della partizione radice di un'istanza

Requisito

Tipi di conversione

Uso

Ripristino della funzionalità predefinita dell'immagine della piattaforma

Ripristino della funzionalità di immagine della piattaforma richiesta di riavvio

Uso

Uso

Comandi secondari

Visualizzazione delle configurazioni iSCSI

Creazione e collegamento di un nuovo volume

Collegamento di un volume esistente

Sincronizzazione di un volume

Scollegamento di un Volume

Eliminazione di un Volume

Uso

Recupero di tutti i metadati per l'istanza

Recupero di metadati specifici per l'istanza

Dettagli opzione

Uso

Comandi secondari

Visualizzazione della configurazione di rete corrente

Creazione e collegamento di una VNIC

Configurazione delle VNIC

Visualizzazione delle VNIC configurate

Visualizzazione di tutte le VNICS configurate

Aggiunta di un indirizzo secondario

Eliminazione della configurazione IP per le VNIC secondarie di cui è stato eseguito il provisioning

Rimozione di un indirizzo IPv6 secondario

Scollegamento di una VNIC

Visualizzazione delle informazioni sulla VCN

Visualizzazione delle informazioni sulla subnet

Uso

Visualizzazione di un report dettagliato per una VCN specifica

Visualizzazione di un report dettagliato per un compartimento specifico

Uso

Comandi secondari

Configurazione di un argomento del servizio di notifiche in un'istanza

Pubblicazione di un Messaggio in un argomento

Uso

Visualizzazione dell'indirizzo IP dell'istanza corrente

Visualizzazione dell'indirizzo IP di un'altra istanza

Visualizzazione di una lista di server STUN

Dettagli opzione

Uso

Visualizzazione di tutti i dati relativi a un volume iSCSI collegato

Visualizzazione di dati specifici su un volume iSCSI collegato

Dettagli opzione