Utility OCI
Le istanze che utilizzano le immagini della piattaforma Oracle Linux includono un set di utility (oci-utils
) che consentono all'istanza di accedere alle informazioni sulle risorse dell'infrastruttura. Queste utility sono costituite da un componente di servizio e da strumenti della riga di comando che consentono di trovare o eseguire il provisioning automatico delle risorse.
Installazione di OCI Utilities
Le istanze avviate con Oracle Linux 7 o versioni successive includono automaticamente il pacchetto di utility Oracle Cloud Infrastructure (OCI) (oci-utils
) installato. Le utility non sono disponibili in altre distribuzioni.
Per utilizzare le utility OCI, è necessario soddisfare i prerequisiti riportati di seguito.
- Assicurarsi che il repository
oci_included
sia abilitato. Questo repository è abilitato per impostazione predefinita nelle immagini della piattaforma Oracle Linux. Questo repository contiene tutte le dipendenze del pacchetto, inclusi i pacchetti OCI SDK e Python necessari. Tutti i pacchetti richiesti vengono installati con il pacchettooci-utils
. - Assicurarsi che le utility OCI dispongano di autorizzazioni sufficienti per accedere a Oracle Cloud Infrastructure eseguendo una delle operazioni riportate di seguito.
- Creare il file di configurazione SDK per l'host. Per ulteriori informazioni, vedere File di configurazione SDK e CLI.Nota
Potrebbe essere necessario installare l'interfaccia CLI per l'ambiente in uso prima di eseguire il comandooci setup config
per creare il file di configurazione dell'SDK. Per ulteriori informazioni, vedere Installazione dell'interfaccia CLI. - Utilizzare i principal delle istanze aggiungendo l'istanza a un gruppo dinamico a cui è stato concesso l'accesso ai servizi Oracle Cloud Infrastructure. Per ulteriori informazioni, vedere Gestione dei gruppi dinamici.
- Configurare
oci-utils
per consentire a root di utilizzare i file di configurazione di Oracle Cloud Infrastructure di un utente senza privilegi. Per ulteriori informazioni, vedere il file di configurazione situato nella directory/etc/oci-utils.conf.d
dell'istanza.
- Creare il file di configurazione SDK per l'host. Per ulteriori informazioni, vedere File di configurazione SDK e CLI.
- Scegliere il metodo per accedere alle utility ed eseguire eventuali procedure di impostazione per tale metodo, in base alle esigenze:
- OCI CLI da un'istanza o da un host remoto: terminale CLI connesso a un'istanza o a un'host remoto in cui è possibile eseguire le utility OCI. Per ulteriori informazioni sull'interfaccia CLI e su come utilizzarla, vedere Command Line Interface (CLI, interfaccia a riga di comando) e CLI Quickstart.
- OCI Software Development Kit (SDK) - Un set di strumenti di sviluppo che ti consente di scrivere codice e gestire le risorse OCI. Per ulteriori informazioni, vedere Software Development Kits and Command Line Interface.
Per un video su come installare e configurare le utility OCI, consulta Enabling OCI Utilities in Oracle Linux on Oracle Cloud Infrastructure Instances in Oracle Linux Training Station.
Aggiornamento delle utility OCI
Per eseguire l'aggiornamento alla versione più recente di oci-utils
:
sudo yum update oci-utils
Utilizzo del daemon ocid
Il daemon ocid
è il componente del servizio di oci-utils
. Esegue il monitoraggio delle modifiche nella configurazione VNIC e iSCSI dell'istanza e tenta di collegare o scollegare automaticamente i dispositivi mentre appaiono o scompaiono, ad esempio quando vengono creati o eliminati utilizzando la console, l'interfaccia CLI o l'API di Oracle Cloud Infrastructure.
Per avviare il daemon ocid
utilizzando systemd
e impostare il servizio ocid
in modo che venga avviato automaticamente durante il boot del sistema:
sudo systemctl enable --now ocid.service
Per confermare che il servizio è attivo (in esecuzione):
sudo service ocid status
Ad esempio:
$ sudo service ocid status
Redirecting to /bin/systemctl status ocid.service
ocid.service - Oracle Cloud Infrastructure utilities daemon
Loaded: loaded (/etc/systemd/system/ocid.service; enabled; vendor preset: enabled)
Active: active (running) since Thu 2021-02-04 18:01:25 GMT; 1min 42s ago
Main PID: 16630 (python3)
CGroup: /system.slice/ocid.service
└─16630 /usr/bin/python3 /usr/lib/python3.6/site-packages/oci_util...
Feb 04 18:01:23 mor-demoinst-10 systemd[1]: Starting Oracle Cloud Infrastruc....
Feb 04 18:01:24 mor-demoinst-10 sudo[16705]: root : TTY=unknown ; PWD=/ ...w
Feb 04 18:01:25 mor-demoinst-10 systemd[1]: Started Oracle Cloud Infrastruct....
Hint: Some lines were ellipsized, use -l to show in full.
Riferimento a OCI Utilities
Ulteriori informazioni su ciascuna utility, tra cui una descrizione, esempi di utilizzo e opzioni.
Gestione dei volumi
Gestione della rete
Visualizzazione delle informazioni di configurazione
Configurazione delle notifiche
Conversione dell'immagine minima di Oracle Linux
È 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 Opzioni comuni della utility OCI.
oci-compartimento
Utilizzare la utility oci-compartmentid
per visualizzare l'OCID (Oracle Cloud Identifier) del compartimento in cui è in esecuzione l'istanza.
Utilizzo
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 Opzioni comuni della utility OCI.
oci-growfs
Se espandi il volume di avvio di un'istanza basata su Linux 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.
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, quando si utilizza la utility oci-growfs
non vengono apportate modifiche al sistema.
Utilizzo
/usr/libexec/oci-growfs [-y] [-n] [-h | --help]
Espansione della partizione radice di un'istanza
Per espandere la partizione radice dell'istanza:
-
Utilizzare 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 la dimensione del volume del disco non è quella prevista, eseguire i comandi per eseguire nuovamente la scansione del volume di avvio. Vedere Rescanning the Disk for Volumes Attached to Linux-Based Instances.
-
Eseguire la utility
oci-growfs
con l'opzioney
per rispondere "yes" 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 Opzioni comuni della utility OCI.
oci-image-expand
Utilizzare la utility oci-image-expand
per convertire l'istanza Oracle Linux Minimal per aggiungere servizi e pacchetti di un'immagine della piattaforma Oracle Linux standard. Con questa utility, l'istanza minima può ripristinare quasi le stesse funzionalità di un'immagine della piattaforma Oracle Linux standard.
Per informazioni sull'ultima immagine minima di Oracle Linux, vedere Immagini Oracle Linux 9.x.
La utility oci-image-expand
richiede privilegi root.
Requisito
Installa le utility OCI sull'istanza minima. Per ulteriori informazioni, vedere Installazione delle utility OCI.
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 nell'istanza. Il ripristino della funzionalità di piattaforma predefinita non aumenta il tempo di avvio dell'istanza. Questo tipo di conversione viene sempre applicato dalla utilityoci-image-expand
. -
Reboot necessario: 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 SELinux.
- Abilita Kdump: aggiunge la capacità
kdump
e la rigenerazione dikdump
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.
L'esecuzione della utility oci-instance-expand
influisce sulle impostazioni configurate dall'utente nell'istanza. Ad esempio, la utility ripristina cloud-init config
per impostare le impostazioni predefinite dell'immagine della piattaforma Oracle Linux, sovrascrivendo le modifiche cloud-config
configurate dall'utente. Inoltre, se si sceglie di ripristinare Ksplice, la utility ripristina 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 dalle istanze minime.
I file di log della utility oci-image-expand
si trovano in: /var/log/oci-image-expand.log
Utilizzo
oci-image-expand [-h | --help]
Ripristino della funzionalità di immagine predefinita della piattaforma
Per ripristinare la funzionalità di immagine predefinita della piattaforma Oracle Linux nell'istanza Oracle Linux Minimal:
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 necessaria per il riavvio
Per ripristinare la funzionalità di immagine della piattaforma Oracle Linux che richiede il riavvio di un'istanza per rendere effettivo:
-
Eseguire la utility
oci-image-expand
./usr/libexec/oci-image-expand
-
Al prompt, effettuare una delle seguenti operazioni, quindi premere Invio:
- Immettere zero per ripristinare tutte le funzioni della lista (SELinux, Kdump e Ksplice).
- Immettere un singolo numero, compreso tra uno e tre, per ripristinare una delle funzioni dell'elenco.
- Immettere due numeri, compresi tra uno e tre, per ripristinare due delle funzioni dell'elenco.
Ad esempio, per ripristinare le funzionalità SELinux e Ksplice nell'istanza Oracle Linux Minimal:
$ /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 Opzioni comuni della utility OCI.
oci-instanceid
Utilizzare la utility oci-instanceid
per visualizzare l'OCID (Oracle Cloud Identifier) dell'istanza.
Utilizzo
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 Opzioni comuni della utility OCI.
oci-iscsi-config
Utilizzare la utility oci-iscsi-config
per elencare e configurare i dispositivi iSCSI collegati a un'istanza basata su Linux Oracle Cloud Infrastructure (OCI). Se eseguito senza opzioni dalla riga di comando, oci-iscsi-config
elenca i dispositivi che richiedono attenzione.
Evitare di inserire informazioni riservate quando si assegnano descrizioni, tag o nomi descrittivi alle risorse cloud tramite la console, l'API o l'interfaccia CLI.
Utilizzo
oci-iscsi-config [subcommand] [-h | --help]
Comandi secondari
La utility oci-iscsi-config
dispone dei comandi secondari seguenti.
Comando secondario |
Per ulteriori informazioni vedere... |
---|---|
|
|
|
|
|
|
|
|
|
|
|
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 Opzioni comuni della utility OCI.
Visualizzazione delle configurazioni iSCSI
Il comando secondario oci-iscsi-config show
elenca i dispositivi iSCSI e le informazioni iSCSI per l'istanza. Questo comando secondario funziona con il daemon ocid
per monitorare la creazione e l'eliminazione dei dispositivi tramite la console, l'interfaccia CLI o l'interfaccia API e rilevare 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 un elenco 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 secondariooci-iscsi-config show
per visualizzare informazioni più dettagliate non 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 secondariooci-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 opzioni
Nella tabella seguente vengono fornite informazioni dettagliate sulle opzioni specifiche di questa utility o di questo comando secondario. Per informazioni sulle opzioni comuni utilizzate nelle utility OCI, vedere Opzioni comuni della utility OCI.
Opzione |
descrizione |
---|---|
|
Visualizza tutti i dispositivi iSCSI. Per impostazione predefinita, vengono elencati solo i dispositivi non collegati a un'istanza. |
|
Visualizza i dispositivi iSCSI nel compartimento specificato o in tutti i compartimenti (se si specifica |
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 Kit di sviluppo software e interfaccia della riga di comando.
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 della dimensione di 70 GB 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 opzioni
Nella tabella seguente vengono fornite informazioni dettagliate sulle opzioni specifiche di questa utility o di questo comando secondario. Per informazioni sulle opzioni comuni utilizzate nelle utility OCI, vedere Opzioni comuni della utility OCI.
Opzione |
descrizione |
---|---|
|
Imposta il nome visualizzato del volume. Evitare di inserire informazioni riservate per il nome visualizzato. |
|
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 disponibile il volume al sistema. L'SDK OCI per Python è necessario per selezionare i volumi utilizzando il rispettivo OCID. Per ulteriori informazioni sull'SDK OCI, vedere Kit di sviluppo software e interfaccia della riga di comando.
Questo comando secondario richiede privilegi root.
Quando si utilizza un IQN, il volume deve essere già collegato (assegnato) all'istanza nella console. Questa opzione può essere utilizzata per collegare più dispositivi contemporaneamente fornendo un elenco separato da virgole di IQN.
Uso
oci-iscsi-config attach [-I | --iqns IQN] [-O | --ocids OCID] [-u | --username name] [-p | --password password] [-c | --chap] [-h | --help]
Per collegare un volume a blocchi specifico all'istanza:
$ sudo oci-iscsi-config attach --iqns iqn.2015-12.com.oracleiaas:IQN
Dettagli opzioni
Nella tabella seguente vengono fornite informazioni dettagliate sulle opzioni specifiche di questa utility o di questo comando secondario. Per informazioni sulle opzioni comuni utilizzate nelle utility OCI, vedere Opzioni comuni della utility OCI.
Opzione |
descrizione |
---|---|
|
Lista separata da virgole dei nomi qualificati iSCSI (iqns) del dispositivo o dei dispositivi iSCSI da collegare all'istanza. |
|
Lista separata da virgole degli OCID del dispositivo o dei dispositivi iSCSI da collegare all'istanza. |
|
Utilizzare il nome utente specificato come nome utente CHAP quando è necessaria l'autenticazione per collegare un dispositivo. Questa opzione non è necessaria quando l'SDK OCI per Python è disponibile. |
|
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. |
|
Collegare il dispositivo con il 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 le 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 opzioni
Nella tabella seguente vengono fornite informazioni dettagliate sulle opzioni specifiche di questa utility o di questo comando secondario. Per informazioni sulle opzioni comuni utilizzate nelle utility OCI, vedere Opzioni comuni della utility OCI.
Opzione |
descrizione |
---|---|
|
Eseguire le operazioni di sincronizzazione. |
Scostamento 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) è installato, questa opzione cerca di disinstallarlo per primo.
Questo comando secondario richiede privilegi root.
È possibile scollegare più dispositivi contemporaneamente fornendo una lista separata da virgole di 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 opzioni
Nella tabella seguente vengono fornite informazioni dettagliate sulle opzioni specifiche di questa utility o di questo comando secondario. Per informazioni sulle opzioni comuni utilizzate nelle utility OCI, vedere Opzioni comuni della utility OCI.
Opzione |
descrizione |
---|---|
|
Continuare lo scollegamento anche se non è possibile disattivare il dispositivo. |
|
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
.
È possibile eliminare più dispositivi contemporaneamente fornendo una lista di OCID separata da virgole.
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 opzioni
Nella tabella seguente vengono fornite informazioni dettagliate sulle opzioni specifiche di questa utility o di questo comando secondario. Per informazioni sulle opzioni comuni utilizzate nelle utility OCI, vedere Opzioni comuni della utility OCI.
Opzione |
descrizione |
---|---|
|
Lista separata da virgole degli OCID dei volumi a blocchi da eliminare. |
oci-metadata
Utilizzare la utility oci-metadata
per visualizzare o impostare i metadati per un'istanza di computazione basata su Oracle Linux. Se eseguito senza opzioni della riga di comando, oci-metadata
elenca tutti i metadati disponibili.
Per ulteriori informazioni sui metadati dell'istanza, vedere Recupero dei metadati dell'istanza.
Utilizzo
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 opzioni
Nella tabella seguente vengono fornite informazioni dettagliate sulle opzioni specifiche di questa utility o di questo comando secondario. Per informazioni sulle opzioni comuni utilizzate nelle utility OCI, vedere Opzioni comuni della utility OCI.
Opzione |
descrizione |
---|---|
|
Recupera i dati solo per la chiave specificata. Le chiavi di metadati per un'istanza possono essere definite da Compute oppure è possibile creare chiavi personalizzate. Per ulteriori informazioni, vedere Chiavi di metadati. |
|
Utilizzato con le opzioni |
|
Utilizzata con l'opzione |
|
Utilizzata con le opzioni |
|
Aggiornare il valore della chiave specifica (o delle chiavi). Per key_value, specificare una stringa, un valore JSON o un puntatore a un file con contenuto JSON nel seguente formato: |
|
Recupera o aggiorna i metadati dell'istanza con l'OCID specifico. Per impostazione predefinita, |
oci-network-config
La utility oci-network-config
consente di configurare le interfacce di rete per l'istanza. È necessario eseguire questa utility 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 nell'istanza utilizzando la utility oci-network-config
.
Le interfacce di rete configurate possono essere collocate all'interno di spazi di nomi di rete separati. Questa separazione è necessaria quando le VNIC si trovano in subnet (VCN diverse) con blocchi di indirizzi sovrapposti e le applicazioni di rete non sono associate direttamente alle interfacce. Gli spazi dei nomi di rete richiedono l'avvio esplicito delle applicazioni negli spazi dei 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 viene 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 esiste alcuna interfaccia fisica corrispondente). Queste VNIC vengono visualizzate come due interfacce aggiuntive durante la visualizzazione dei collegamenti IP, con i nomi in MACVLAN_FORMAT
per la VLAN MAC e VLAN_FORMAT
per la VLAN IP.
Utilizzo
oci-network-config [subcommand] [-q | --quiet] [-h | --help]
Comandi secondari
La utility oci-network-config
dispone dei comandi secondari seguenti.
Comando secondario |
Per ulteriori informazioni vedere... |
---|---|
|
|
|
|
|
|
|
|
|
|
|
|
|
Eliminazione della configurazione IP per le VNIC secondarie con provisioning eseguito |
|
|
|
|
|
|
|
Per un video di formazione che mostra come utilizzare la utility oci-network-config
, vedere Gestione dell'interfaccia di rete mediante OCI Utilities on Oracle Linux Instances nella Training Station di Oracle Linux.
Per informazioni sulle opzioni della utility oci-network-config
, vedere Opzioni comuni della utility OCI.
Visualizzazione della configurazione di rete corrente
Il comando secondario oci-network-config show
mostra le informazioni sulle VNIC configurate nell'istanza. Puoi 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 l'utility oci-network-config
viene immessa senza opzioni.
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 l'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 VNIC.
Dettagli opzioni
Nella tabella seguente vengono fornite informazioni dettagliate sulle opzioni specifiche di questa utility o di questo comando secondario. Per informazioni sulle opzioni comuni utilizzate nelle utility OCI, vedere Opzioni comuni della utility OCI.
Opzione |
descrizione |
---|---|
|
Includere un indirizzo IP o un'interfaccia VLAN precedentemente esclusa utilizzando l'opzione |
|
Esclude 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 |
Creazione e collegamento di una VNIC
Utilizzare il comando secondario oci-network-config attach-vnic
per creare e collegare una VNIC a un'istanza. Con questo comando secondario puoi assegnare un indirizzo IP pubblico o privato alla nuova VNIC.
Il collegamento di una VNIC a un indirizzo IPv6 primario non è supportato da OCI.
Uso
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]
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 opzioni
Nella tabella seguente vengono fornite informazioni dettagliate sulle opzioni specifiche di questa utility o di questo comando secondario. Per informazioni sulle opzioni comuni utilizzate nelle utility OCI, vedere Opzioni comuni della utility OCI.
Opzione |
descrizione |
---|---|
|
Assegnare l'indirizzo IP privato specificato alla VNIC. Se questa opzione non viene utilizzata, un indirizzo IP non utilizzato della subnet viene assegnato automaticamente alla VNIC. |
|
Assegnare un indirizzo IPv4 alla VNIC. Se si utilizza l'opzione |
|
Assegnare un indirizzo IPv6 alla VNIC. Se si utilizza l'opzione Importante: il collegamento di una VNIC a un indirizzo IPv6 primario non è supportato da OCI. Il messaggio seguente viene visualizzato quando si esegue # sudo oci-network-config attach-vnic --ipv6 Attaching a vnic with a primary ipv6 address is not yet supported by OCI. |
|
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. |
|
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 |
|
Impostare il nome visualizzato per la VNIC. Evitare di fornire informazioni riservate. |
|
Assegnare 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 viene più eseguito il provisioning. Questo comando sincronizza la configurazione IP dell'istanza con il provisioning OCI corrente.
Uso
oci-network-config configure [-n | --namespace format] [-r | --start-sshd] [-I | --include item] [-X | --exclude item] [-h | --help]
Per configurare tutte le VNIC nell'istanza, effettuare le operazioni riportate di seguito.
sudo oci-network-config configure
Ad esempio:
$ sudo oci-network-config configure
Configured
Per configurare le VNIC nell'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 la configurazione delle VNIC 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 la configurazione di una VNIC. Per ulteriori informazioni, vedere Visualizzazione della configurazione di rete corrente.
Dettagli opzioni
Nella tabella seguente vengono fornite informazioni dettagliate sulle opzioni specifiche di questa utility o di questo comando secondario. Per informazioni sulle opzioni comuni utilizzate nelle utility OCI, vedere Opzioni comuni della utility OCI.
Opzione |
descrizione |
---|---|
|
Durante la configurazione, posizionare le interfacce nello spazio di nomi identificato dal formato specificato. Il formato può includere le variabili |
|
Avviare |
|
Includere un indirizzo IP o un'interfaccia VLAN precedentemente esclusa utilizzando l'opzione |
|
Esclude 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 |
Visualizzazione delle VNIC configurate
Il comando secondario oci-network-config show-VNICs
mostra le 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 le informazioni sulle VNIC configurate nell'istanza:
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 opzioni
Nella tabella seguente vengono fornite informazioni dettagliate sulle opzioni specifiche di questa utility o di questo comando secondario. Per informazioni sulle opzioni comuni utilizzate nelle utility OCI, vedere Opzioni comuni della utility OCI.
Opzione |
descrizione |
---|---|
|
Mostra informazioni sulla VNIC corrispondente all'OCID (Oracle Cloud Identifier) specificato. |
|
Mostra informazioni sulla VNIC associata al nome specificato. |
|
Mostra informazioni sulla VNIC associata all'indirizzo IP primario specificato. |
Visualizzazione di tutte le VNIC 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 Opzioni comuni della utility OCI.
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
oci-network-config add-secondary-addr [-ipv4 | --ipv4] [-ipv6 | --ipv6] [-I | --ip-address ip_address] [-O | --ocid OCID] [-h | --help]
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 opzioni
Nella tabella seguente vengono fornite informazioni dettagliate sulle opzioni specifiche di questa utility o di questo comando secondario. Per informazioni sulle opzioni comuni utilizzate nelle utility OCI, vedere Opzioni comuni della utility OCI.
Opzione |
descrizione |
---|---|
|
Specificare che un indirizzo secondario privato IPv4 venga aggiunto a una VNIC esistente. Questa opzione è quella predefinita se il comando viene immesso senza opzioni. |
|
Specificare che un indirizzo secondario privato IPv6 venga aggiunto a una VNIC esistente. |
|
Specificare l'indirizzo IP privato secondario da aggiungere alla VNIC. |
|
Assegnare l'indirizzo secondario alla VNIC associata all'OCID specifico. |
Eliminazione della configurazione IP per le VNIC secondarie con provisioning eseguito
Utilizzare il comando secondario oci-network-config unconfigure
per eliminare tutte le configurazioni IP per le VNIC secondarie di cui è stato eseguito il provisioning (tranne quelle esplicitamente escluse). Impossibile eliminare la VNIC primaria.
Uso
oci-network-config unconfigure [-I | --include item] [-X | --exclude item] [-h | --help]
Per eliminare tutte le configurazioni 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 opzioni
Nella tabella seguente vengono fornite informazioni dettagliate sulle opzioni specifiche di questa utility o di questo comando secondario. Per informazioni sulle opzioni comuni utilizzate nelle utility OCI, vedere Opzioni comuni della utility OCI.
Opzione |
descrizione |
---|---|
|
Includere un indirizzo IP o un'interfaccia VLAN precedentemente esclusa utilizzando l'opzione |
|
Escludi persistentemente 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 |
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 opzioni
Nella tabella seguente vengono fornite informazioni dettagliate sulle opzioni specifiche di questa utility o di questo comando secondario. Per informazioni sulle opzioni comuni utilizzate nelle utility OCI, vedere Opzioni comuni della utility OCI.
Opzione |
descrizione |
---|---|
|
Specificare l'indirizzo IP privato secondario da rimuovere dalla VNIC. |
Scostamento 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 specifico 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 opzioni
Nella tabella seguente vengono fornite informazioni dettagliate sulle opzioni specifiche di questa utility o di questo comando secondario. Per informazioni sulle opzioni comuni utilizzate nelle utility OCI, vedere Opzioni comuni della utility OCI.
Opzione |
descrizione |
---|---|
|
Scollegare la VNIC con l'indirizzo IP specificato. |
|
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 opzioni
Nella tabella seguente vengono fornite informazioni dettagliate sulle opzioni specifiche di questa utility o di questo comando secondario. Per informazioni sulle opzioni comuni utilizzate nelle utility OCI, vedere Opzioni comuni della utility OCI.
Opzione |
descrizione |
---|---|
|
Visualizzare la VCN con l'OCID specificato. |
|
Visualizzare 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 in 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 opzioni
Nella tabella seguente vengono fornite informazioni dettagliate sulle opzioni specifiche di questa utility o di questo comando secondario. Per informazioni sulle opzioni comuni utilizzate nelle utility OCI, vedere Opzioni comuni della utility OCI.
Opzione |
descrizione |
---|---|
|
Mostra informazioni sulla subnet che corrisponde all'OCID (Oracle Cloud Identifier) specificato. |
|
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.
Utilizzo
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 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 Opzioni comuni della utility OCI.
oci-notifica
La utility oci-notify
invia un messaggio a un argomento del servizio di notifiche. È necessario eseguire questa utility come utente root.
Un messaggio è composto da un'intestazione (titolo) e un file di messaggio. 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 sulle notifiche.
Utilizzo
oci-notify [subcommand] [-h | --help]
Comandi secondari
La utility oci-notify
dispone dei comandi secondari seguenti.
Comando secondario |
Per ulteriori informazioni vedere... |
---|---|
|
Configurazione di un argomento del servizio notifiche in un'istanza |
|
Pubblicazione di un messaggio in un argomento |
Per informazioni sull'opzione della utility oci-notify
, vedere Opzioni comuni della utility OCI.
Configurazione di un argomento del servizio 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.
Per impostazione predefinita, il percorso del file di configurazione è /etc/oci-utils/oci.conf
. È 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 Notifiche configurato nel file oci.conf
, utilizzare il comando secondario oci-notify config
e specificare l'OCID dell'argomento del servizio Notifiche.
Ad esempio:
$ sudo oci-notify config ocid1.onstopic.oc1..OCID
Per informazioni sull'opzione della utility oci-notify-config
, vedere Opzioni comuni della utility OCI.
Pubblicazione di un messaggio in un argomento
Il comando secondario oci-notify message
consente di pubblicare il contenuto di un file o di una stringa di testo con il titolo specificato nell'argomento configurato.
Nota: quando il messaggio viene pubblicato, la utility oci-notify
antepone 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 apici per il valore dell'opzione --file
.
Ad esempio:
$ sudo oci-notify message --title 'sending a text' --file 'Today is a beautiful day'
Dettagli opzioni
Nella tabella seguente vengono fornite informazioni dettagliate sulle opzioni specifiche di questa utility o di questo comando secondario. Per informazioni sulle opzioni comuni utilizzate nelle utility OCI, vedere Opzioni comuni della utility OCI.
Opzione |
descrizione |
---|---|
|
Specificare il titolo da utilizzare nell'intestazione del messaggio (ad esempio, |
|
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 vengono suddivisi in blocchi da 64 KB e inviati come messaggi separati. Il numero di chunk è limitato a 10. Se il valore message_file specificato non viene riconosciuto come URL o il percorso della directory non esiste, il testo immesso per message_file viene inviato come stringa di testo. La lunghezza massima per le stringhe di testo è di 128 caratteri. |
oci-public-ip
Utilizzare la utility oci-public-ip
per visualizzare l'indirizzo IP pubblico dell'istanza di computazione corrente, in formato leggibile o JSON.
La utility oci-public-ip
utilizza l'SDK Oracle Cloud Infrastructure (OCI) per trovare l'indirizzo IP (vedere Software Development Kits and Command Line Interface). Se l'indirizzo IP non può essere ottenuto con questo metodo, l'utility oci-public-ip
prova quindi il protocollo Session Traversal Utilities for NAT (STUN) come ultima risorsa per trovare l'indirizzo IP. Per ulteriori informazioni su STUN, consultare l'articolo su STUN Wikepedia.
Utilizzo
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
.
Questa opzione richiede l'installazione e la configurazione dell'SDK OCI per Python. Per ulteriori informazioni, vedere Software Development Kits and Command Line Interface.
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 opzioni
Nella tabella seguente vengono fornite informazioni dettagliate sulle opzioni specifiche di questa utility o di questo comando secondario. Per informazioni sulle opzioni comuni utilizzate nelle utility OCI, vedere Opzioni comuni della utility OCI.
Opzione |
descrizione |
---|---|
|
Stampa solo l'indirizzo IP. |
--instance-id OCID |
Visualizza l'indirizzo IP pubblico dell'istanza specificata anziché quello corrente. Richiede l'SDK OCI per Python da installare e configurare. |
-L | --list-servers |
Stampa un elenco dei server e delle uscite STUN noti. |
|
Specifica l'indirizzo IP di origine da utilizzare. |
|
Specifica il server STUN da utilizzare. |
dati volume oci
Utilizzare la utility oci-volume-data
per visualizzare i dati relativi a 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 di un volume iSCSI specifico. I valori dell'opzione chiave possono essere il nome visualizzato, l'OCID o iqn (nome qualificato iSCSI) 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 l'elemento 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 supportate (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 Opzioni comuni della utility OCI.
Dettagli opzioni
Nella tabella seguente vengono fornite informazioni dettagliate sulle opzioni specifiche di questa utility o di questo comando secondario. Per informazioni sulle opzioni comuni utilizzate nelle utility OCI, vedere Opzioni comuni della utility OCI.
Opzione |
descrizione |
---|---|
|
obbligatorio. La chiave per identificare il volume. Il valore KEY può essere l'OCID, l'IQN o il nome visualizzato del volume. |
|
Specifica l'indirizzo IP di origine da utilizzare. |
|
Mostrare solo i valori nell'output. |
Riepilogo delle utility OCI
Riepilogo dei componenti delle utility OCI.
Nome | descrizione |
---|---|
ocid
|
Componente del servizio di oci-utils , che viene eseguito come daemon avviato da systemd . Questo servizio esegue la scansione delle modifiche nelle configurazioni dei dispositivi iSCSI e VNIC e inserisce nella cache i metadati OCI e l'indirizzo IP pubblico dell'istanza. |
oci-compartmentid |
Visualizza l'OCID (Oracle Cloud Identifier) del compartimento in cui è in esecuzione l'istanza. |
oci-growfs
|
Espande il file system radice dell'istanza alla dimensione configurata. |
oci-image-expand |
Converte l'istanza Oracle Linux Minimal per aggiungere servizi e pacchetti di un'immagine della piattaforma Oracle Linux standard. |
oci-instanceid |
Visualizza l'OCID dell'istanza. |
oci-iscsi-config
|
Elenca o configura i dispositivi iSCSI collegati a un'istanza di computazione. Se non vengono specificate opzioni dalla riga di comando, vengono elencati i dispositivi che richiedono attenzione. |
oci-metadata
|
Visualizza i metadati per l'istanza di computazione. Se non viene specificata alcuna opzione della riga di comando, vengono elencati tutti i metadati disponibili. I metadati includono l'OCID dell'istanza, il nome visualizzato, il compartimento, la forma, l'area, il dominio di disponibilità, la data di creazione, lo stato, l'immagine e tutti i metadati personalizzati forniti, ad esempio una chiave pubblica SSH. |
oci-network-config
|
Elenca o configura le schede VNIC (Virtual Network Interface Card) collegate all'istanza di computazione. Quando viene eseguito il provisioning di una VNIC secondaria nel cloud, deve essere configurata in modo esplicito nell'istanza utilizzando questo script o comandi simili. |
oci-network-inspector
|
Visualizza un report dettagliato per un determinato compartimento o rete. |
oci-notify |
Invia un messaggio a un argomento del servizio di notifica. |
oci-public-ip
|
Visualizza l'indirizzo IP pubblico del sistema corrente in formato leggibile o JSON. |
oci-volume-data |
Visualizza i dati relativi a un volume iSCSI specifico collegato all'istanza. |
Opzioni comuni della utility OCI
Molte delle utility Oracle Cloud Infrastructure (OCI) hanno le stesse opzioni o gli stessi argomenti disponibili quando le utility vengono eseguite dalla riga di comando. Queste opzioni e argomenti consentono di definire ulteriormente il tipo di informazioni prodotte dall'utility o la modalità di esecuzione di un task di utility.
La tabella riportata di seguito elenca le opzioni e i relativi valori supportati, comuni tra le utility OCI.
Opzione | descrizione |
---|---|
--help
|
Visualizza le informazioni della Guida relative alla utility, ad esempio l'uso della utility, le opzioni disponibili e i valori supportati per ciascuna opzione. Ad esempio, per visualizzare la Guida per la utility oci-metadata :
|
|
Mostra tutti gli elementi o i valori nell'output. |
|
Mostra informazioni dettagliate nell'output. |
|
Consente di definire la modalità di visualizzazione dell'output della utility. Di seguito sono riportate le modalità di utility OCI disponibili.
|
|
Non accorcia i valori nell'output visualizzato. |
|
Riduce i valori nell'output visualizzato. |
|
Risposte "sì" a tutti i prompt. |
|
Risposte "no" a tutti i prompt. |
|
Elimina i messaggi informativi. |
È anche possibile visualizzare le pagine man per ciascuna utility OCI immettendo
man oci-utility
dalla riga di comando. Ad esempio, per visualizzare le pagine manuali incorporate per la utility oci-metadata
:man oci-metadata