OCI-Utilitys

Instanzen, die Oracle Linux-Plattformimages verwenden, umfassen ein Set von Utilitys (oci-utils), mit denen die Instanz auf Informationen zu Infrastrukturressourcen zugreifen kann. Diese Utilitys bestehen aus einer Servicekomponente und Befehlszeilentools, mit denen Ressourcen automatisch erkannt oder bereitgestellt werden können.

OCI-Utilitys installieren

In mit Oracle Linux 7 oder höher gestarteten Instanzen ist das Oracle Cloud Infrastructure-(OCI-)Utilitypackage (oci-utils) automatisch installiert. Die Utilitys sind nicht in anderen Distributionen verfügbar.

Um die OCI-Utilitys verwenden zu können, müssen Sie die folgenden Voraussetzungen erfüllen:

  • Stellen Sie sicher, dass das Repository oci_included aktiviert ist. Dieses Repository ist in Oracle Linux-Plattformimages standardmäßig aktiviert. Dieses Repository enthält alle Packageabhängigkeiten, einschließlich der erforderlichen OCI-SDK- und Python-Packages. Alle erforderlichen Packages werden mit dem Package oci-utils installiert.
  • Stellen Sie sicher, dass die OCI-Utilitys über ausreichende Berechtigungen für den Zugriff auf Oracle Cloud Infrastructure verfügen, indem Sie einen der folgenden Schritte ausführen:
    • Erstellen Sie die SDK-Konfigurationsdatei für den Host. Weitere Informationen finden Sie unter SDK- und CLI-Konfigurationsdatei.
      Hinweis

      Möglicherweise müssen Sie die CLI für Ihre Umgebung installieren, bevor Sie den Befehl oci setup config ausführen, um die SDK-Konfigurationsdatei zu erstellen. Weitere Informationen finden Sie unter CLI installieren.
    • Verwenden Sie Instanz-Principals, indem Sie die Instanz einer dynamischen Gruppe hinzufügen, der Zugriff auf Oracle Cloud Infrastructure-Services erteilt wurde. Weitere Informationen finden Sie unter Dynamische Gruppen verwalten.
    • Konfigurieren Sie oci-utils so, dass "root" die Oracle Cloud Infrastructure-Konfigurationsdateien eines nicht privilegierten Benutzers verwenden kann. Weitere Informationen finden Sie in der Konfigurationsdatei im Verzeichnis /etc/oci-utils.conf.d der Instanz.
  • Wählen Sie die Methode für den Zugriff auf die Utilitys, und führen Sie je nach Bedarf die Setup-Prozeduren für diese Methode aus:
    • OCI-CLI von einer Instanz oder einem Remotehost: Ein CLI-Terminal, das mit einer Instanz oder einem Remotehost verbunden ist, auf dem Sie die OCI-Utilitys ausführen können. Weitere Informationen zur CLI und zu den ersten Schritten finden Sie unter Befehlszeilenschnittstelle (CLI) und CLI-Schnellstart.
    • OCI Software Development Kit (SDK) - Eine Reihe von Entwicklertools, mit denen Sie Code schreiben und OCI-Ressourcen verwalten können. Weitere Informationen finden Sie unter Software Development Kits und Befehlszeilenschnittstelle.

Ein Video zur Installation und Einrichtung der OCI-Utilitys finden Sie unter OCI-Utilitys in Oracle Linux auf Oracle Cloud Infrastructure-Instanzen aktivieren in der Oracle Linux-Schulungsstation.

OCI-Utilitys aktualisieren

So aktualisieren Sie auf die neueste Version von oci-utils:

sudo yum update oci-utils

ocid-Daemon verwenden

Der ocid-Daemon ist die Servicekomponente von oci-utils. Er überwacht Änderungen in der VNIC- und iSCSI-Konfiguration der Instanz und versucht, angezeigte oder entfernte Geräte automatisch zuzuordnen oder ihre Zuordnung aufzuheben, z.B. wenn sie mit der Oracle Cloud Infrastructure-Konsole, der CLI oder der API erstellt oder gelöscht werden.

So können Sie den ocid-Daemon mit systemd starten und festlegen, dass der ocid-Service beim Systemstart automatisch gestartet wird:

sudo systemctl enable --now ocid.service

So bestätigen Sie, dass der Service aktiv ist (ausgeführt wird):

sudo service ocid status

Beispiel:

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

Referenz zu OCI-Utilitys

Hier finden Sie weitere Details zu jedem Utility, einschließlich Beschreibung, Anwendungsbeispiele und Optionen.

Datenträger verwalten

Networking verwalten

Konfigurationsinformationen anzeigen

Benachrichtigungen konfigurieren

Minimales Oracle Linux-Image konvertieren

Sie können auch die OCI-Utilityoption und detaillierte Informationen anzeigen, indem Sie auf die Manpages des OCI-Utilitys zugreifen. Informationen zum Zugriff auf die Manpages des OCI-Utilitys finden Sie unter Allgemeine OCI-Utilityoptionen.

OCI-Compartmentid

Mit dem Utility oci-compartmentid können Sie die Oracle Cloud-ID (OCID) des Compartments anzeigen, in dem die Instanz ausgeführt wird.

Verwendung

oci-compartmentid [-h | --help]

So zeigen Sie die Compartment-OCID der Instanz an:

sudo oci-compartmentid

Beispiel:

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

Informationen zur Option des Utilitys OCI-compartmentid finden Sie unter Allgemeine OCI-Utilityoptionen.

oci-growfs

Wenn Sie das Boot-Volume einer Linux-basierten Oracle Cloud Infrastructure-(OCI-)Instanz erweitern, können Sie die Root-Partition der Instanz dann mit dem Utility oci-growfs erweitern. Auf diese Weise können Sie das neu erweiterte Boot-Volume vollständig verwenden.

Hinweis

Nur XFS- und ext4-Dateisysteme werden unterstützt.

Standardmäßig verwendet eine Linux-basierte Instanz nicht automatisch das gesamte Boot-Volume, wenn das Boot-Volume größer oder gleich 50 GB ist. Wenn das an die Instanz angehängte Boot-Volume weniger als 50 GB beträgt, werden bei Verwendung des Utilitys oci-growfs keine Änderungen am System vorgenommen.

Verwendung

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

Erweitern der Root-Partition einer Instanz

So erweitern Sie die Root-Partition der Instanz:

  1. Verwenden Sie den Befehl lsblk, um zu bestätigen, dass das BS die neue Größe des Boot-Volumes ermittelt hat.

    Beispiel:

    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
    

    Wenn das Datenträger-Volume nicht die erwartete Größe hat, führen Sie die Befehle aus, um das Boot-Volume erneut zu scannen. Informationen hierzu finden Sie unter Datenträger für an Linux-basierte Instanzen angehängte Volumes neu scannen.

  2. Führen Sie das Utility oci-growfs mit der Option y aus, um alle Prompts mit "Ja" zu beantworten.

    sudo /usr/libexec/oci-growfs -y

    Beispiel:

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

Informationen zu den Optionen des Utilitys OCI-growfs finden Sie unter Allgemeine OCI-Utilityoptionen.

oci-image-expand

Mit dem Utility oci-image-expand können Sie die Oracle Linux Minimal-Instanz konvertieren, um Services und Packages eines standardmäßigen Oracle Linux-Plattformimages hinzuzufügen. Mit diesem Utility kann die minimale Instanz fast die gleiche Funktionalität wie ein Standardimage der Oracle Linux-Plattform wiederherstellen.

Informationen zum neuesten minimalen Oracle Linux-Image finden Sie unter Oracle Linux 9.x-Images.

Das Dienstprogramm oci-image-expand erfordert Root-Berechtigungen.

Erforderlich

Installieren Sie die OCI-Utilitys auf der minimalen Instanz. Weitere Informationen finden Sie unter OCI-Utilitys installieren.

Konvertierungstypen

Das Utility oci-image-expand stellt zwei Arten von Oracle Linux Minimal-Instanzkonvertierungen bereit:

  • Standard: Stellt die Standardservices der Oracle Linux-Plattform systemd, Diagnosepackages, Cloud-Konfigurationseinstellungen wieder her und konfiguriert und aktiviert den Swap auf der Instanz. Durch das Wiederherstellen der Standardplattformfunktionalität wird die Bootzeit der Instanz nicht erhöht. Dieser Konvertierungstyp wird immer vom Utility oci-image-expand angewendet.

  • Neustart erforderlich: Stellt die standardmäßige Oracle Linux-Plattformfunktionalität wieder her, wie im Standardkonvertierungstyp beschrieben, und stellt eines oder mehrere der folgenden vom Benutzer auswählbaren Features wieder her: Die Auswahl einer dieser auswählbaren Funktionen erhöht die Bootzeit der Instanz und erfordert einen Neustart, um wirksam zu werden.
Hinweis

Die Ausführung des Utilitys oci-instance-expand wirkt sich auf die vom Benutzer konfigurierten Einstellungen auf der Instanz aus. Beispiel: Das Utility stellt cloud-init config auf die Standardeinstellungen für das Oracle Linux-Plattformimage zurück und überschreibt damit alle benutzerdefinierten cloud-config-Änderungen. Wenn Sie Ksplice wiederherstellen möchten, installiert das Utility das Package oci-linux-config erneut, sodass der neue Zugriffsschlüssel in der richtigen Konfigurationsdatei gespeichert wird. Führen Sie das Utility nur auf minimalen Instanzen aus.

Die Logdateien des Utilitys oci-image-expand befinden sich unter: /var/log/oci-image-expand.log

Verwendung

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

Standard-Plattformimagefunktionalität wiederherstellen

So stellen Sie die Standardfunktionalität für Oracle Linux-Plattformimages in der Oracle Linux Minimal-Instanz wieder her:

Führen Sie das Utility oci-image-expand aus, und drücken Sie bei der Eingabeaufforderung die Eingabetaste, ohne eine Auswahl zu treffen.

Beispiel:

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

Erforderliche Plattformimagefunktion für Neustart wiederherstellen

So stellen Sie die Imagefunktion der Oracle Linux-Plattform wieder her, für die ein Neustart der Instanz erforderlich ist:

  1. Führen Sie das Utility oci-image-expand aus.

    /usr/libexec/oci-image-expand
  2. Führen Sie in der Eingabeaufforderung einen der folgenden Schritte aus, und drücken Sie dann die Eingabetaste:

    • Geben Sie Null ein, um alle Features in der Liste wiederherzustellen (SELinux, Kdump und Ksplice).
    • Geben Sie eine einzelne Zahl zwischen eins und drei ein, um eines der Features in der Liste wiederherzustellen.
    • Geben Sie zwei Zahlen zwischen einer und drei ein, um zwei der Features in der Liste wiederherzustellen.

    Beispiel: So stellen Sie die SELinux- und Ksplice-Funktionalität in der Oracle Linux Minimal-Instanz wieder her:

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

    Wenn Sie Ihre Meinung zu einer ausgewählten Funktion ändern, geben Sie die Nummer erneut ein, bevor Sie die Eingabetaste drücken, um die Auswahl der Funktion aufzuheben. Wenn Sie bereits die Eingabetaste gedrückt haben, drücken Sie Ctrl+C, um den Vorgang abzubrechen.

  3. Geben Sie in der Eingabeaufforderung "y" ein, um die Instanz neu zu starten.
    A reboot is required to enable and activate all restored services. 
    Do you wish to reboot now? (y/n)y

Informationen zur Utilityoption oci-image-expand finden Sie unter Allgemeine OCI-Utilityoptionen.

OCI-Instanz-ID

Verwenden Sie das Utility oci-instanceid, um die Oracle Cloud-ID (OCID) der Instanz anzuzeigen.

Verwendung

oci-instanceid [-h | --help]

So zeigen Sie die OCID der Compute-Instanz an:

sudo oci-instanceid

Beispiel:

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

Informationen zur Option des Utilitys OCI-instanceid finden Sie unter Allgemeine OCI-Utilityoptionen.

oci-iscsi-config

Mit dem Utility oci-iscsi-config können Sie iSCSI-Geräte auflisten und konfigurieren, die an eine Linux-basierte Oracle Cloud Infrastructure-(OCI-)Instanz angehängt sind. Wenn er ohne Befehlszeilenoptionen ausgeführt wird, listet oci-iscsi-config die Geräte auf, die bearbeitet werden müssen.

Achtung

Geben Sie keine vertraulichen Informationen ein, wenn Sie Ihren Cloud-Ressourcen Beschreibungen, Tags oder Anzeigenamen über die Konsole, die API oder die CLI zuweisen.

Verwendung

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

Unterbefehle

Das Utility oci-iscsi-config verfügt über die folgenden Unterbefehle.

Unterbefehle des oci-iscsi-config-Utilitys

Unterbefehl

Weitere Informationen finden Sie unter...

show

iSCSI-Konfigurationen anzeigen

sync

Volumes synchronisieren

create

Neue Volumes erstellen und anhängen

attach

Vorhandenes Volume anhängen

detach

Volume trennen

destroy

Volume löschen

Ein Schulungsvideo, das die Verwendung des Utilitys oci-iscsi-config zeigt, finden Sie unter OCI-Utilitys zur Verwaltung von iSCSI-Speicher für Oracle Cloud Infrastructure-Instanzen verwenden in der Oracle Linux-Schulungsstation.

Informationen zur Option des Utilitys OCI-iscsi-config finden Sie unter Allgemeine OCI-Utilityoptionen.

iSCSI-Konfigurationen anzeigen

Der Unterbefehl oci-iscsi-config show listet die iSCSI-Geräte und iSCSI-Informationen für die Instanz auf. Dieser Unterbefehl überwacht mit dem ocid-Daemon das Erstellen und Löschen von Geräten über die Konsole, die CLI oder die API und erkennt diese Änderungen automatisch.

Wenn der ocid-Daemon nicht ausgeführt wird, erfordert der Unterbefehl Root-Berechtigungen.

Verwendung

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

So zeigen Sie eine Liste aller an die Instanz angehängten Geräte an:

  1. Führen Sie den Unterbefehl oci-iscsi-config show aus.

    sudo oci-iscsi-config show

    Beispiel:

    $ sudo oci-iscsi-config show
    Currently attached iSCSI devices:
              Volume name           |Attached device| Size |
    --------------------------------------------------------
             mor-demo-bv20          |      sdb      | 50G  |
    Block volumes information:
                  Name              | Size |          Attached to           |              OCID              |
    ----------------------------------------------------------------------------------------------------------
             mor-demo-bv30          | 50GB |               -                |ocid1.volume.oc1.OCID|
    
  2. Verwenden Sie optional die Optionen --details und --no-truncate mit dem Unterbefehl oci-iscsi-config show, um detailliertere Informationen anzuzeigen, die in der Ausgabe nicht gekürzt werden:

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

    Beispiel:

    $ sudo oci-iscsi-config show --details --no-truncate
    Currently attached iSCSI devices:
                 Target                       |          Volume name           |          Volume OCID                       | Persistent portal  |   Current portal   |Session State|Attached device| Size |
    ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------
    iqn.2015-12.com.oracleiaas:exampleuniqueID|         mor-demo-bv20          |ocid1.volume.oc1.iad.OCID  |  172.16.10.4:3260  |  172.16.10.4:3260  |  LOGGED_IN  |      sdb      | 50G  |
    
    Block volumes information:
                  Name              | Size |          Attached to           |              OCID                        |     IQN      | Compartment |Availability domain|
    ------------------------------------------------------------------------------------------------------------------------------------------------------------
             mor-demo-bv30          | 50GB |               -                |ocid1.volume.oc1.iad.OCID|      -       | virtdoc.dev  |DSdu:US-ASHBURN-AD-3|
    
  3. Optional können Sie die Ausgabedarstellung mit der Option --output-mode und dem Unterbefehl oci-iscsi-config show lesbarer machen:

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

    Beispiel: So zeigen Sie die Ausgabepräsentation im Textmodus an:

    $ 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

Optionsdetails

Die folgende Tabelle enthält detaillierte Informationen zu Optionen, die für dieses Dienstprogramm oder diesen Unterbefehl spezifisch sind. Informationen zu den allgemeinen Optionen, die in allen OCI-Utilitys verwendet werden, finden Sie unter Allgemeine OCI-Utilityoptionen.

oci-iscsi-config - Optionsdetails anzeigen

Option

Beschreibung

-A | --all

Zeigt alle iSCSI-Geräte an. Standardmäßig werden nur Geräte aufgelistet, die nicht an eine Instanz angehängt sind.

-C | --compartments name

Zeigt iSCSI-Geräte im angegebenen Compartment oder in allen Compartments an (wenn all für name angegeben ist)

Neue Volumes erstellen und anhängen

Verwenden Sie den Unterbefehl oci-iscsi-config create, um ein Block-Volume zu erstellen und an eine Instanz anzuhängen. Für diesen Unterbefehl muss das OCI-SDK für Python installiert und konfiguriert werden. Weitere Informationen zum OCI-SDK finden Sie unter Software Development Kits und Befehlszeilenschnittstelle.

Dieser Unterbefehl erfordert Root-Berechtigungen.

Verwendung

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

Um ein Volume zu erstellen und anzuhängen, verwenden Sie das Utility oci-iscsi-config create mit den Optionen -S, --volume-name und --attach-volume:

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

Beispiel: So erstellen Sie ein Volume mit einer Größe von 70 GB und hängen es an die Instanz an. Der Volume-Name lautet 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

Optionsdetails

Die folgende Tabelle enthält detaillierte Informationen zu Optionen, die für dieses Dienstprogramm oder diesen Unterbefehl spezifisch sind. Informationen zu den allgemeinen Optionen, die in allen OCI-Utilitys verwendet werden, finden Sie unter Allgemeine OCI-Utilityoptionen.

oci-iscsi-config - Optionsdetails erstellen

Option

Beschreibung

-v | --volume-name name

Legt den Anzeigenamen für das Volume fest. Geben Sie keine vertraulichen Informationen für den Anzeigenamen ein.

-c | --chap

Hängt das Gerät mit dem Kennzeichen "CHAP-Zugangsdaten anfordern" an.

Vorhandenes Volume anhängen

Verwenden Sie den Unterbefehl oci-iscsi-config attach, um ein vorhandenes Block-Volume an die Instanz anzuhängen und das Volume für das System verfügbar zu machen. Das OCI-SDK für Python ist zur Auswahl von Volumes mit der OCID erforderlich. Weitere Informationen zum OCI-SDK finden Sie unter Software Development Kits und Befehlszeilenschnittstelle.

Dieser Unterbefehl erfordert Root-Berechtigungen.

Hinweis

Wenn Sie einen IQN verwenden, muss das Volume bereits an die Instanz in der Konsole angehängt (Zuweisung). Mit dieser Option können Sie mehrere Geräte gleichzeitig anhängen, indem Sie eine durch Komma getrennte Liste mit IQNs angeben.

Verwendung

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

So hängen Sie ein bestimmtes Block-Volume an die Instanz an:

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

Optionsdetails

Die folgende Tabelle enthält detaillierte Informationen zu Optionen, die für dieses Dienstprogramm oder diesen Unterbefehl spezifisch sind. Informationen zu den allgemeinen Optionen, die in allen OCI-Utilitys verwendet werden, finden Sie unter Allgemeine OCI-Utilityoptionen.

oci-iscsi-config - Optionsdetails anhängen

Option

Beschreibung

-I | --iqns IQN

Eine durch Komma getrennte Liste der iSCSI-qualifizierten Namen (iqns) des oder der iSCSI-Geräte, die an die Instanz angehängt werden sollen.

-O | --ocids OCID

Eine durch Komma getrennte Liste der OCIDs des oder der iSCSI-Geräte, die an die Instanz angehängt werden sollen.

-u | --username name

Verwenden Sie den angegebenen Benutzernamen als CHAP-Benutzernamen, wenn eine Authentifizierung zum Hinzufügen eines Geräts erforderlich ist. Diese Option ist nicht erforderlich, wenn das OCI-SDK für Python verfügbar ist.

-p | --password password

Verwenden Sie das angegebene Kennwort als CHAP-Kennwort, wenn eine Authentifizierung zum Hinzufügen eines Geräts erforderlich ist. Dieses Argument ist nicht erforderlich, wenn das OCI-SDK für Python verfügbar ist.

-c | --chap

Hängen Sie das Gerät mit dem Kennzeichen "CHAP-Zugangsdaten anfordern" an.

Volumes synchronisieren

Verwenden Sie den Unterbefehl oci-iscsi-config sync, um verfügbare Blockgeräte an die Instanz anzuhängen und Synchronisierungsvorgänge auszuführen. Der Unterbefehl erfordert Root-Berechtigungen.

Verwendung

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

Um verfügbare Block-Devices an die Instanz anzuhängen und die Änderungen mit OCI zu synchronisieren, verwenden Sie den Unterbefehl oci-iscsi-config sync mit der Option --apply:

sudo oci-iscsi-config sync --apply

Beispiel:

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

Optionsdetails

Die folgende Tabelle enthält detaillierte Informationen zu Optionen, die für dieses Dienstprogramm oder diesen Unterbefehl spezifisch sind. Informationen zu den allgemeinen Optionen, die in allen OCI-Utilitys verwendet werden, finden Sie unter Allgemeine OCI-Utilityoptionen.

oci-iscsi-config - Synchronisierungsoptionsdetails

Option

Beschreibung

-a | --apply

Führt Synchronisierungsvorgänge aus.

Volume trennen

Verwenden Sie den Unterbefehl oci-iscsi-config detach, um ein Gerät mit dem angegebenen IQN (eine einem Gerät zugewiesene eindeutige ID) zu trennen. Wenn das Volume (oder eine Partition des Volumes) gemountet ist, versucht diese Option zuerst, das Volume bzw. die Partition zu deinstallieren.

Dieser Unterbefehl erfordert Root-Berechtigungen.

Hinweis

Sie können mehrere Geräte gleichzeitig trennen, indem Sie eine durch Komma getrennte Liste mit IQNs angeben.

Verwendung

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

Um ein bestimmtes Gerät von der Instanz zu trennen, verwenden Sie den Unterbefehl oci-iscsi-config detach mit der Option -I:

sudo oci-iscsi-config detach -I IQN

Beispiel:

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

Um den IQN oder die OCID des zu trennenden Volumes anzuzeigen, verwenden Sie den Unterbefehl oci-iscsi-config show. Weitere Informationen finden Sie unter Anzeigen von iSCSI-Konfigurationen.

Optionsdetails

Die folgende Tabelle enthält detaillierte Informationen zu Optionen, die für dieses Dienstprogramm oder diesen Unterbefehl spezifisch sind. Informationen zu den allgemeinen Optionen, die in allen OCI-Utilitys verwendet werden, finden Sie unter Allgemeine OCI-Utilityoptionen.

oci-iscsi-config - Details der Option zum Trennen

Option

Beschreibung

-f | --force

Fahren Sie auch dann fort, wenn das Unmounten des Geräts nicht möglich ist.

-I | --iqns IQN

Eine durch Komma getrennte Liste der iSCSI-qualifizierten Namen (iqns) des oder der iSCSI-Geräte, die von der Instanz getrennt werden sollen.

Volume löschen

Um ein Blockspeicher-Volume mit der angegebenen OCID zu löschen, verwenden Sie den Unterbefehl oci-iscsi-config destroy.

Hinweis

Sie können mehrere Geräte gleichzeitig löschen, indem Sie eine durch Komma getrennte Liste der OCIDs angeben.

Verwendung

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

Um ein bestimmtes Block-Volume aus der Instanz zu löschen, verwenden Sie den Unterbefehl oci-iscsi-config-destroy mit der Option -O:

sudo oci-iscsi-config destroy -O OCID

Beispiel:

$ 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

Sie können die OCID des Volumes mit dem Unterbefehl des Utilitys oci-iscsi-config show anzeigen. Weitere Informationen finden Sie unter Anzeigen von iSCSI-Konfigurationen.

Optionsdetails

Die folgende Tabelle enthält detaillierte Informationen zu Optionen, die für dieses Dienstprogramm oder diesen Unterbefehl spezifisch sind. Informationen zu den allgemeinen Optionen, die in allen OCI-Utilitys verwendet werden, finden Sie unter Allgemeine OCI-Utilityoptionen.

oci-iscsi-config - Option "Zerstören" - Details

Option

Beschreibung

-O | --ocids OCID

Eine durch Komma getrennte Liste der zu löschenden Block-Volume-OCIDs.

oci-Metadaten

Mit dem Utility oci-metadata können Sie Metadaten für eine Oracle Linux-basierte Compute-Instanz anzeigen oder festlegen. Bei der Ausführung ohne Befehlszeilenoptionen listet oci-metadata alle verfügbaren Metadaten auf.

Weitere Informationen zu Instanzmetadaten finden Sie unter Instanzmetadaten abrufen.

Verwendung

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

Alle Metadaten für die Instanz abrufen

Um alle Metadaten für die Instanz anzuzeigen, führen Sie das Utility oci-metadata ohne Optionen aus:

sudo oci-metadata

Beispiel:

$ 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

Bestimmte Metadaten für die Instanz abrufen

Um Instanzmetadaten für einen angegebenen Schlüssel anzuzeigen, verwenden Sie die Option --get mit dem Utility oci-metadata:

sudo oci-metadata --get key

Beispiel: So zeigen Sie nur den Status der Compute-Instanz an:

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

Optionsdetails

Die folgende Tabelle enthält detaillierte Informationen zu Optionen, die für dieses Dienstprogramm oder diesen Unterbefehl spezifisch sind. Informationen zu den allgemeinen Optionen, die in allen OCI-Utilitys verwendet werden, finden Sie unter Allgemeine OCI-Utilityoptionen.

OCI-metadata - Optionsdetails

Option

Beschreibung

-g key | --get key

Rufen Sie Daten nur für den angegebenen Schlüssel ab. Die Metadatenschlüssel für eine Instanz können von Compute definiert werden, oder Sie können benutzerdefinierte Schlüssel erstellen. Weitere Informationen finden Sie unter Metadatenschlüssel.

--export

Zeigt bei Verwendung mit der Option -g oder --get einen Shellbefehl für den Export des Schlüssels als Umgebungsvariable an.

--trim

Schneidet bei Verwendung mit der Option -g oder --get den Schlüsselpfad auf die letzte Komponente ab, um die Ausgabe kompakter zu gestalten. Beispiel: instance/metadata/ssh_authorized_keys bis ssh_authorized_keys. Wenn der Schlüssel mit mehreren Schlüsseln übereinstimmt, wird nur der erste übereinstimmende Schlüssel angezeigt.

--value-only

Zeigt bei Verwendung mit der Option -g oder --get nur die Werte an, die mit dem Get-Schlüssel übereinstimmen.

-u key_value

Aktualisieren Sie den Wert für die jeweiligen Schlüssel. Geben Sie für key_value eine Zeichenfolge, einen JSON-Wert oder einen Zeiger auf eine Datei mit JSON-Inhalt im folgenden Format an: key=file:/path/to/file

-i | --instance-id OCID

Rufen Sie die Metadaten der Instanz mit der spezifischen OCID ab, oder aktualisieren Sie diese. Standardmäßig bezieht sich oci-metadata auf die Metadaten der Instanz, bei der Sie sich angemeldet haben.

oci-network-config

Mit dem oci-network-config-Utility können Sie Netzwerkschnittstellen für die Instanz konfigurieren. Dieses Utility muss als Root ausgeführt werden.

Das Utility oci-network-config zeigt die aktuellen virtuellen Netzwerkkarten (VNICs) an, die in Oracle Cloud Infrastructure (OCI) bereitgestellt und für diese Instanz konfiguriert wurden. Wenn eine sekundäre VNIC in OCI bereitgestellt wird, muss sie explizit mit dem Utility oci-network-config auf der Instanz konfiguriert werden.

Die Netzwerkschnittstellen, die konfiguriert werden, können in separaten Netzwerk-Namespaces platziert werden. Diese Trennung ist erforderlich, wenn sich VNICs in Subnetzen (verschiedenen VCNs) mit überlappenden Adressblöcke befinden und die Netzwerkanwendungen nicht direkt an die Schnittstellen gebunden sind. Um eine Verknüpfung mit der Schnittstelle herzustellen, müssen Anwendungen explizit in den Namespaces gestartet werden (mit dem Befehl ip netns exec ns). Wenn keine Namespaces verwendet werden, wird Policy-basiertes Routing konfiguriert, um eine Standardroute zum virtuellen Router (Standardgateway) der sekundären VNIC bereitzustellen, wenn die VNIC-Adresse die Quelladresse ist.

Sekundäre Bare-Metal-VNICs werden mit VLANs konfiguriert (ohne entsprechende physische Schnittstelle). Diese VNICs werden bei der Anzeige von IP-Links als zwei zusätzliche Schnittstellen angezeigt. Dabei haben die Namen das Format MACVLAN_FORMAT für das MAC-VLAN und VLAN_FORMAT für das IP-VLAN.

Verwendung

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

Unterbefehle

Das Utility oci-network-config verfügt über die folgenden Unterbefehle.

Unterbefehle des Utilitys oci-network-config

Unterbefehl

Weitere Informationen finden Sie unter...

show

Aktuelle Netzwerkkonfiguration anzeigen

show-vnics

Konfigurierte VNICs anzeigen

show-vnics-all

Alle konfigurierten VNICS anzeigen

show-vcns

VCN-Informationen anzeigen

show-subnets

Subnetzinformationen anzeigen

configure

VNICs konfigurieren

unconfigure

IP-Konfiguration für bereitgestellte sekundäre VNICs löschen

attach-vnic

VNIC erstellen und anhängen

detach-vnic

VNIC trennen

add-secondary-addr

Sekundäre Adresse hinzufügen

remove-secondary-addr

Sekundäre IPv6-Adresse entfernen

Ein Schulungsvideo zur Verwendung des Utilitys oci-network-config finden Sie in der Oracle Linux-Schulungsstation unter Netzwerkschnittstellenmanagement mit OCI-Utilitys in Oracle Linux-Instanzen.

Informationen zu den Optionen des Utilitys OCI-network-config finden Sie unter Allgemeine OCI-Utilityoptionen.

Aktuelle Netzwerkkonfiguration anzeigen

Der Unterbefehl oci-network-config show zeigt Informationen zu den VNICs an, die auf der Instanz konfiguriert sind. Sie können die aktuelle Netzwerkkonfiguration anzeigen, wie die bereitgestellten VNICs und die aktuellen IP-Konfigurationen für die Instanz. VNICs, die noch nicht konfiguriert wurden, sind mit ADD markiert, und IP-Konfigurationen, denen keine VNIC mehr zugeordnet ist, sind mit DELETE markiert.

Die Ausgabe dieses Befehls ist die Standardaktion, wenn das oci-network-config-Utility ohne Optionen eingegeben wird.

Verwendung

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

So zeigen Sie die aktuelle Netzwerkkonfiguration an:

sudo oci-network-config show

Beispiel:

$ 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  

Um noch nicht konfigurierte VNICs (mit der Bezeichnung ADD) zu konfigurieren und IP-Adressen zu löschen, denen keine VNICs zugeordnet sind, verwenden Sie den Unterbefehl oci-network-config config. Weitere Informationen finden Sie unter VNICs konfigurieren.

Optionsdetails

Die folgende Tabelle enthält detaillierte Informationen zu Optionen, die für dieses Dienstprogramm oder diesen Unterbefehl spezifisch sind. Informationen zu den allgemeinen Optionen, die in allen OCI-Utilitys verwendet werden, finden Sie unter Allgemeine OCI-Utilityoptionen.

oci-network-config - Optionsdetails anzeigen

Option

Beschreibung

-I | --include item

Nehmen Sie eine IP-Adresse oder VLAN-Schnittstelle, die zuvor mit der Option --exclude ausgeschlossen wurde, in die automatische Konfiguration/Dekonfiguration auf. Für item können Sie eine VNIC-OCID, eine IP-Adresse oder einen VLAN-Schnittstellennamen angeben.

-X | --exclude item

Schließen Sie eine IP-Adresse oder VLAN-Schnittstelle dauerhaft aus der automatischen Konfiguration/Dekonfiguration aus. Für item können Sie eine VNIC-OCID, eine IP-Adresse oder einen VLAN-Schnittstellennamen angeben. Verwenden Sie die Option --include, um die IP-Adresse oder die VLAN-Schnittstelle wieder einzuschließen.

VNIC erstellen und anhängen

Verwenden Sie den Unterbefehl oci-network-config attach-vnic, um eine VNIC zu erstellen und an eine Instanz anzuhängen. Mit diesem Unterbefehl können Sie der neuen VNIC eine öffentliche oder private IP-Adresse zuweisen.

Wichtig

Das Anhängen einer VNIC an eine primäre IPv6-Adresse wird von OCI nicht unterstützt.

Nutzung

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]

Um eine VNIC zu erstellen und die VNIC an eine Instanz anzuhängen, verwenden Sie den Unterbefehl oci-network-config attach-vnic mit der Option -n:

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

Beispiel: So erstellen Sie eine VNIC mit dem Namen ex-demo-inst-10 und hängen die VNIC an die Instanz an:

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

Optionsdetails

Die folgende Tabelle enthält detaillierte Informationen zu Optionen, die für dieses Dienstprogramm oder diesen Unterbefehl spezifisch sind. Informationen zu den allgemeinen Optionen, die in allen OCI-Utilitys verwendet werden, finden Sie unter Allgemeine OCI-Utilityoptionen.

oci-network-config attach-vnic Optionsdetails

Option

Beschreibung

-I | --ip-address ip_address

Weisen Sie die angegebene private IP-Adresse der VNIC zu. Wenn Sie diese Option nicht verwenden, wird eine nicht verwendete IP-Adresse aus dem Subnetz automatisch der VNIC zugewiesen.

-ipv4 | --ipv4

Weisen Sie der VNIC eine IPv4-Adresse zu. Wenn Sie die Option --ipv4 angeben, wird eine nicht verwendete IPv4-Adresse aus dem Subnetz der VNIC zugewiesen. Wenn Sie die Option --ip-address mit dieser Option angeben, werden die Optionen --ipv4 und --ipv6 ignoriert.

-ipv6 | --ipv6

Weisen Sie der VNIC eine IPv6-Adresse zu. Wenn Sie die Option --ipv6 angeben, wird eine nicht verwendete IPv6-Adresse aus dem Subnetz der VNIC zugewiesen. Wenn Sie stattdessen die Option --ip-address verwenden, werden die Optionen --ipv4 und --ipv6 ignoriert.

Wichtig: Das Anhängen einer VNIC mit einer primären IPv6-Adresse wird von OCI nicht unterstützt.

Die folgende Meldung wird angezeigt, wenn Sie oci-network-config attach-vnic mit der Option --ipv6 ausführen.

# 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

Weisen Sie die VNIC der angegebenen physischen NIC zu. Geben Sie für index die Indexnummer an, die der physischen NIC zugewiesen ist. Der Standardwert ist 0. Diese Option wird nur für Bare-Metal-Instanzen verwendet.

--subnet subnet

Verbinden Sie die VNIC mit dem angegebenen Subnetz. Geben Sie als subnet eine OCID oder einen regulären Ausdruck an, der mit dem Anzeigenamen aller verfügbaren Subnetze verglichen wird. Wenn Sie --IP-address verwenden, wird das Subnetz von der IP-Adresse abgeleitet oder standardmäßig auf das Subnetz der primären VNIC gesetzt.

-n | --name name

Legen Sie den Anzeigenamen für die VNIC fest. Geben Sie dabei keine vertraulichen Informationen ein.

--assign-public-ip

Weisen Sie der VNIC eine öffentliche IP-Adresse zu. Standardmäßig wird nur eine private IP-Adresse zugewiesen.

VNICs konfigurieren

Der Unterbefehl oci-network-config configure fügt die IP-Konfiguration für nicht konfigurierte VNICs hinzu und löscht die IP-Konfiguration von VNICs, die nicht mehr bereitgestellt werden. Mit diesem Befehl wird die IP-Konfiguration der Instanz mit dem aktuellen OCI-Provisioning synchronisiert.

Nutzung

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

So konfigurieren Sie alle VNICs auf der Instanz:

sudo oci-network-config configure

Beispiel:

$ sudo oci-network-config configure
Configured 

Um die VNICs auf der Instanz zu konfigurieren, mit Ausnahme einer bestimmten VNIC, verwenden Sie den Unterbefehl oci-network-config configure mit der Option -X:

sudo oci-network-config configure -X VNIC_OCID

Beispiel:

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

Sie können bestätigen, dass die VNICs konfiguriert sind, indem Sie den Unterbefehl oci-network-config show ausführen. Nach der Konfiguration werden keine ADD- oder DELETE-Labels in der Ausgabe angezeigt, es sei denn, Sie schließen die Konfiguration einer VNIC aus. Weitere Informationen finden Sie unter Anzeigen der aktuellen Netzwerkkonfiguration.

Optionsdetails

Die folgende Tabelle enthält detaillierte Informationen zu Optionen, die für dieses Dienstprogramm oder diesen Unterbefehl spezifisch sind. Informationen zu den allgemeinen Optionen, die in allen OCI-Utilitys verwendet werden, finden Sie unter Allgemeine OCI-Utilityoptionen.

oci-network-config - Optionsdetails konfigurieren

Option

Beschreibung

-n | --namespace format

Platzieren Sie bei der Konfiguration Schnittstellen in dem durch das angegebene Format identifizierten Namespace. Das Format kann $nic- und $vltag-Variablen enthalten. Der Name lautet standardmäßig DEF_NS_FORMAT_BM für BMs und DEF_NS_FORMAT_VM für VMs. Stellen Sie bei der Konfiguration mehrerer VNICs sicher, dass die Namespaces eindeutig sind.

-r | --start-sshd

Starten Sie sshd im Namespace (wenn -n vorhanden ist).

-I | --include item

Nehmen Sie eine IP-Adresse oder VLAN-Schnittstelle, die zuvor mit der Option --exclude ausgeschlossen wurde, in die automatische Konfiguration/Dekonfiguration auf. Für item können Sie eine VNIC-OCID, eine IP-Adresse oder einen VLAN-Schnittstellennamen angeben.

-X | --exclude item

Schließen Sie eine IP-Adresse oder VLAN-Schnittstelle dauerhaft aus der automatischen Konfiguration/Dekonfiguration aus. Für item können Sie eine VNIC-OCID, eine IP-Adresse oder einen VLAN-Schnittstellennamen angeben. Verwenden Sie die Option --include, um die IP-Adresse oder die VLAN-Schnittstelle wieder einzuschließen.

Konfigurierte VNICs anzeigen

Der Unterbefehl oci-network-config show-vnics zeigt Informationen zu VNICs an, die auf der Instanz konfiguriert sind.

Nutzung

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

So zeigen Sie Informationen zu VNICs an, die auf der Instanz konfiguriert sind:

sudo oci-network-config show-vnics

Beispiel:

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

Optionsdetails

Die folgende Tabelle enthält detaillierte Informationen zu Optionen, die für dieses Dienstprogramm oder diesen Unterbefehl spezifisch sind. Informationen zu den allgemeinen Optionen, die in allen OCI-Utilitys verwendet werden, finden Sie unter Allgemeine OCI-Utilityoptionen.

oci-network-config show-vnics - Optionsdetails

Option

Beschreibung

--ocid OCID

Zeigen Sie Informationen zur VNIC an, die der angegebenen Oracle Cloud-ID (OCID) entspricht.

--name name

Zeigen Sie Informationen zur VNIC an, die mit dem angegebenen Namen verknüpft ist.

--ip-address primary_IP

Zeigen Sie Informationen zur VNIC an, die mit der angegebenen primären IP-Adresse verknüpft ist.

Alle konfigurierten VNICS anzeigen

Verwenden Sie den Unterbefehl oci-network-config show-vnics-all, um detaillierte Informationen zu allen VNICs anzuzeigen, die auf dieser Instanz konfiguriert sind.

Nutzung

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

So zeigen Sie alle auf der Instanz konfigurierten VNICs an:

sudo oci-network-config show-vnics-all

Beispiel:

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

Informationen zu den OCI-network-config show-vnics-all-Optionen finden Sie unter Allgemeine OCI-Utilityoptionen.

Sekundäre Adresse hinzufügen

Verwenden Sie das Utility oci-network-config add-secondary-addr, um einer vorhandenen VNIC eine sekundäre private IP-Adresse mit der angegebenen IPv4- oder IPv6-Adresse hinzuzufügen.

Nutzung

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

Um einer vorhandenen VNIC eine private sekundäre IP-Adresse (in diesem Fall eine IPv6-Adresse) hinzuzufügen, verwenden Sie den Unterbefehl oci-network-config add-secondary-addr mit den Optionen --ipv6 und --ocid:

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

Beispiel:

$ 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

Optionsdetails

Die folgende Tabelle enthält detaillierte Informationen zu Optionen, die für dieses Dienstprogramm oder diesen Unterbefehl spezifisch sind. Informationen zu den allgemeinen Optionen, die in allen OCI-Utilitys verwendet werden, finden Sie unter Allgemeine OCI-Utilityoptionen.

oci-network-config add-secondary-addr Optionsdetails

Option

Beschreibung

-ipv4 | --ipv4

Geben Sie an, dass eine sekundäre private IPv4-Adresse einer vorhandenen VNIC hinzugefügt wird. Diese Option ist die Standardeinstellung, wenn der Befehl ohne Optionen eingegeben wird.

-ipv6 | --ipv6

Geben Sie an, dass eine sekundäre private IPv6-Adresse einer vorhandenen VNIC hinzugefügt wird.

-I ip_address | --ip-address ip_address

Geben Sie die sekundäre private IP-Adresse an, die der VNIC hinzugefügt werden soll.

-O | --ocid OCID

Weist die sekundäre Adresse der VNIC zu, die mit der bestimmten OCID verknüpft ist.

IP-Konfiguration für bereitgestellte sekundäre VNICs löschen

Verwenden Sie den Unterbefehl oci-network-config unconfigure, um alle IP-Konfigurationen für bereitgestellte sekundäre VNICs zu löschen (außer expliziten). Die primäre VNIC kann nicht gelöscht werden.

Nutzung

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

Um alle IP-Konfiguration für bereitgestellte sekundäre VNICs zu löschen, verwenden Sie den Unterbefehl oci-network-config unconfigure:

sudo oci-network-config unconfigure

Beispiel:

$ sudo oci-network-config unconfigure
Unconfigured 

Optionsdetails

Die folgende Tabelle enthält detaillierte Informationen zu Optionen, die für dieses Dienstprogramm oder diesen Unterbefehl spezifisch sind. Informationen zu den allgemeinen Optionen, die in allen OCI-Utilitys verwendet werden, finden Sie unter Allgemeine OCI-Utilityoptionen.

oci-network-config - Dekonfigurationsoptionsdetails

Option

Beschreibung

-I | --include item

Nehmen Sie eine IP-Adresse oder VLAN-Schnittstelle, die zuvor mit der Option --exclude ausgeschlossen wurde, in die automatische Konfiguration/Dekonfiguration auf. Für item können Sie eine VNIC-OCID, eine IP-Adresse oder einen VLAN-Schnittstellennamen angeben.

-X | --exclude item

Schließen Sie eine IP-Adresse oder VLAN-Schnittstelle (mit item angegeben) dauerhaft aus der automatischen Konfiguration/Dekonfiguration aus. Für item können Sie eine VNIC-OCID, eine IP-Adresse oder einen VLAN-Schnittstellennamen angeben. Verwenden Sie die Option --include, um die IP-Adresse oder die VLAN-Schnittstelle wieder einzuschließen.

Sekundäre IPv6-Adresse entfernen

Verwenden Sie den Unterbefehl oci-network-config remove-secondary-addr, um eine sekundäre private IP-Adresse mit der angegebenen IPv4- oder IPv6-Adresse von einer vorhandenen VNIC zu entfernen.

Nutzung

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

Um eine private sekundäre IPv6-Adresse aus einer vorhandenen VNIC zu entfernen, verwenden Sie den Unterbefehl oci-network-config remove-secondary-addr mit der Option -I:

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

Beispiel: So entfernen Sie die sekundäre IPv6-Adresse 2603:c020:c003:3a10:b64c:8f35:7f9e:7e87 aus einer vorhandenen VNIC:

$ 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

Optionsdetails

Die folgende Tabelle enthält detaillierte Informationen zu Optionen, die für dieses Dienstprogramm oder diesen Unterbefehl spezifisch sind. Informationen zu den allgemeinen Optionen, die in allen OCI-Utilitys verwendet werden, finden Sie unter Allgemeine OCI-Utilityoptionen.

oci-network-config remove-secondary-addr Optionsdetails

Option

Beschreibung

-I | --ip-address ip_address

Geben Sie die sekundäre private IP-Adresse an, die von der VNIC entfernt werden soll.

VNIC trennen

Verwenden Sie den Unterbefehl oci-network-config detach-vnic, um die VNIC mit der spezifischen OCID oder IP-Adresse von der Instanz zu trennen und zu löschen. Mit diesem Unterbefehl können Sie die zugewiesene IP-Adresse von einer vorhandenen VNIC entfernen. Die primäre VNIC kann jedoch nicht getrennt werden. Jede sekundäre private IP-Adresse, die mit der VNIC verknüpft ist, wird ebenfalls gelöscht.

Nutzung

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

Mit dem Unterbefehl oci-network-config detach-vnic und der Option --ocid können Sie die Zuordnung einer VNIC zur Instanz aufheben:

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

Beispiel: So trennen Sie eine VNIC mit einer bestimmten VNIC-OCID von der Instanz:

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

Optionsdetails

Die folgende Tabelle enthält detaillierte Informationen zu Optionen, die für dieses Dienstprogramm oder diesen Unterbefehl spezifisch sind. Informationen zu den allgemeinen Optionen, die in allen OCI-Utilitys verwendet werden, finden Sie unter Allgemeine OCI-Utilityoptionen.

oci-network-config detach-vnic Optionsdetails

Option

Beschreibung

-I | --ip-address ip_address

Trennen Sie die VNIC mit der angegebenen IP-Adresse.

--ocid OCID

Trennen Sie die VNIC mit der angegebenen OCID.

VCN-Informationen anzeigen

Der Unterbefehl oci-network-config show-vcns zeigt Informationen zum virtuellen Cloud-Netzwerk (VCN) in dem Compartment an, in dem sich die Instanz befindet.

Nutzung

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

Um detaillierte VCN-Informationen im Textausgabeformat anzuzeigen, verwenden Sie den Unterbefehl oci-network-config show-vcns mit den Optionen --details und --output-mode text:

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

Beispiel:

$ 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

Optionsdetails

Die folgende Tabelle enthält detaillierte Informationen zu Optionen, die für dieses Dienstprogramm oder diesen Unterbefehl spezifisch sind. Informationen zu den allgemeinen Optionen, die in allen OCI-Utilitys verwendet werden, finden Sie unter Allgemeine OCI-Utilityoptionen.

oci-network-config show-vcns Optionsdetails

Option

Beschreibung

--ocid OCID

Zeigen Sie das VCN mit der angegebenen OCID an.

--name name

Zeigen Sie das VCN mit dem angegebenen Namen an.

Subnetzinformationen anzeigen

Der Unterbefehl oci-network-config show-subnets zeigt Subnetzinformationen in dem Compartment an, in dem sich diese Instanz befindet.

Verwendung

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

Um detaillierte Subnetzinformationen im JSON-Ausgabeformat anzuzeigen, verwenden Sie den Unterbefehl oci-network-config show-subnets mit den Optionen --details und --output-mode JSON:

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

Beispiel:

$ 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"
  },
]

Optionsdetails

Die folgende Tabelle enthält detaillierte Informationen zu Optionen, die für dieses Dienstprogramm oder diesen Unterbefehl spezifisch sind. Informationen zu den allgemeinen Optionen, die in allen OCI-Utilitys verwendet werden, finden Sie unter Allgemeine OCI-Utilityoptionen.

oci-network-config show-subnets Optionsdetails

Option

Beschreibung

--ocid OCID

Zeigen Sie Informationen zum Subnetz an, das der angegebenen Oracle Cloud-ID (OCID) entspricht.

--name name

Zeigen Sie Informationen zum Subnetz an, das mit dem angegebenen Namen verknüpft ist.

oci-network-inspector

Das Utility oci-network inspector zeigt einen detaillierten Netzwerkbericht für ein bestimmtes Compartment oder Netzwerk an, das für die Instanz konfiguriert ist.

Verwendung

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

Detailbericht für ein bestimmtes VCN anzeigen

Um einen detaillierten Bericht für ein bestimmtes VCN anzuzeigen, führen Sie das Utility oci-network-inspector aus, und geben Sie mit der Option -N die VCN-OCID an:

sudo oci-network-inspector -N OCID

Beispiel:

$ 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

      ...

Detailbericht für ein bestimmtes Compartment anzeigen

Um einen detaillierten Netzwerkbericht für ein bestimmtes Compartment anzuzeigen, führen Sie das Utility oci-network-inspector aus, und geben Sie mit der Option -C eine Compartment-OCID an:

sudo oci-network-inspector -C OCID

Beispiel:

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

     ...

Informationen zur Option des Utilitys OCI-network-inspector finden Sie unter Allgemeine OCI-Utilityoptionen.

oci-notify

Das Utility oci-notify sendet eine Nachricht an ein Notifications-Servicethema. Dieses Utility muss als Root ausgeführt werden.

Eine Nachricht besteht aus einem Nachrichtenheader (Titel) und einer Datei. Die Konfiguration des Notifications-Service für das Thema bestimmt, wo und wie die Nachrichten übermittelt werden. Themen werden mit der Oracle Cloud Infrastructure-(OCI-)Konsole, -API oder -CLI konfiguriert.

Weitere Informationen zum Notifications-Service, einschließlich zum Erstellen von Themen, finden Sie unter Überblick über Notifications.

Verwendung

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

Unterbefehle

Das Utility oci-notify verfügt über die folgenden Unterbefehle.

oci-notify-Utilityunterbefehle

Unterbefehl

Weitere Informationen finden Sie unter...

config

Notifications-Servicethema auf einer Instanz konfigurieren

message

Nachricht in einem Thema veröffentlichen

Informationen zur Option des Utilitys OCI-notify finden Sie unter Allgemeine OCI-Utilityoptionen.

Notifications-Servicethema auf einer Instanz konfigurieren

Verwenden Sie den Unterbefehl oci-notify config, um die OCID des Notifications-Servicethemas in die Datei oci.conf zu schreiben. Nach der Konfiguration können Sie die Nachrichten in diesem konfigurierten Thema veröffentlichen.

Standardmäßig lautet der Pfad zur Konfigurationsdatei /etc/oci-utils/oci.conf. Sie können den Konfigurationsdateipfad mit der Umgebungsvariable OCI_CONFIG_DIR außer Kraft setzen.

Verwendung

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

Um die OCID eines konfigurierten Notifications-Servicethemas in die Datei oci.conf zu schreiben, verwenden Sie den Unterbefehl oci-notify config, und geben Sie die OCID des Notifications-Servicethemas an.

Beispiel:

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

Informationen zur Option des Utilitys OCI-notify-config finden Sie unter Allgemeine OCI-Utilityoptionen.

Nachricht in einem Thema veröffentlichen

Mit dem Unterbefehl oci-notify message können Sie den Inhalt einer Datei oder einer Textzeichenfolge mit dem angegebenen Titel im konfigurierten Thema veröffentlichen.

Hinweis: Wenn die Nachricht veröffentlicht wird, stellt das Utility oci-notify den Instanznamen dem Betreff der Nachricht voran. Beispiel: instance_name:log messages

Verwendung

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

Um den Inhalt der Datei /var/log/messages mit dem Titel 'logging messages' an das konfigurierte Thema zu senden, verwenden Sie die Optionen --title und --file mit dem Unterbefehl oci-notify-message.

Beispiel:

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

Um eine Textzeichenfolge an die konfigurierte Lerneinheit zu senden, geben Sie eine Textzeile in einfachen Anführungszeichen für den Wert der Option --file ein.

Beispiel:

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

Optionsdetails

Die folgende Tabelle enthält detaillierte Informationen zu Optionen, die für dieses Dienstprogramm oder diesen Unterbefehl spezifisch sind. Informationen zu den allgemeinen Optionen, die in allen OCI-Utilitys verwendet werden, finden Sie unter Allgemeine OCI-Utilityoptionen.

oci-notify-message - Optionsdetails

Option

Beschreibung

-t | --title message_title

Geben Sie den Titel an, der im Nachrichtenheader verwendet werden soll (Beispiel: 'log messages', wenn Sie Logdateien senden). Der Befehl message_title muss in einfache oder doppelte Anführungszeichen gesetzt werden. Nachrichtenheader werden auf 128 Zeichen gekürzt.

-f | --file message_file

Geben Sie den vollständigen oder relativen Verzeichnispfad, die HTTP- oder FTP-URL der Nachrichtendatei oder die zu sendende Textzeichenfolge an. Größere Dateien werden in Chunks von 64 KB aufgeteilt und als separate Nachrichten gesendet. Die Anzahl der Chunks ist auf 10 begrenzt.

Wenn die angegebene message_file nicht als URL erkannt wird oder der Verzeichnispfad nicht vorhanden ist, wird der für message_file eingegebene Text als Textzeichenfolge gesendet. Textzeichenfolgen sind auf 128 Zeichen begrenzt.

oci-public-ip

Mit dem Utility oci-public-IP können Sie die öffentliche IP-Adresse der aktuellen Compute-Instanz im menschenlesbaren oder JSON-Format anzeigen.

Das Utility oci-public-ip verwendet das Oracle Cloud Infrastructure-(OCI-)SDK, um die IP-Adresse zu ermitteln (siehe Software Development Kits und Befehlszeilenschnittstelle). Wenn die IP-Adresse mit dieser Methode nicht abgerufen werden kann, versucht das Dienstprogramm oci-public-ip dann das STUN-(Session Traversal Utilities for NAT-)Protokoll als letzte Möglichkeit, die IP-Adresse zu ermitteln. Weitere Informationen über STUN finden Sie im Wikipedia-Artikel zu STUN.

Verwendung

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]

IP-Adresse der aktuellen Instanz anzeigen

Führen Sie den Befehl oci-public-IP ohne Optionen aus, um die IP-Adresse der aktuellen Instanz zurückzugeben:

sudo oci-public-ip

Beispiel:

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

IP-Adresse einer anderen Instanz anzeigen

Um die öffentliche IP-Adresse einer anderen Instanz als der aktuellen Instanz anzuzeigen, verwenden Sie das Utility oci-public-IP mit der Option --instance-id.

Hinweis

Für diese Option muss das OCI-SDK für Python installiert und konfiguriert werden. Weitere Informationen finden Sie unter Software Development Kits und Befehlszeilenschnittstelle.
sudo oci-public-ip --instance-id OCID

Beispiel:

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

Anzeigen einer Liste der STUN-Server

Um eine Liste der STUN-Server anzuzeigen, verwenden Sie das Utility oci-public-ip mit der Option --list-servers:

sudo oci-public-ip --list-servers

Beispiel:

$ 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

Optionsdetails

Die folgende Tabelle enthält detaillierte Informationen zu Optionen, die für dieses Dienstprogramm oder diesen Unterbefehl spezifisch sind. Informationen zu den allgemeinen Optionen, die in allen OCI-Utilitys verwendet werden, finden Sie unter Allgemeine OCI-Utilityoptionen.

Optionen des oci-public-ip-Utilitys

Option

Beschreibung

-g | get

Druckt nur die IP-Adresse.

--instance-id OCID

Zeigt die öffentliche IP-Adresse der angegebenen Instanz anstelle der aktuellen Instanz an. Erfordert die Installation und Konfiguration des OCI-SDK für Python.

-L | --list-servers

Druckt eine Liste der bekannten STUN-Server und wird beendet.

-s | --sourceip source_IP

Gibt die zu verwendende Quell-IP-Adresse an.

-S | --stun-server STUN_server

Gibt den zu verwendenden STUN-Server an.

OCI-Volume-Daten

Mit dem Utility oci-volume-data können Sie Daten zu einem bestimmten iSCSI-Volume anzeigen, das an eine Oracle Linux-basierte Compute-Instanz angehängt ist.

Für das Utility oci-volume-data ist die Option -k (Schlüssel) erforderlich, um Daten für ein bestimmtes iSCSI-Volume anzuzeigen. Schlüsseloptionswerte können Anzeigename, OCID oder iqn (iSCSI-qualifizierter Name) des Volumes sein.

Verwendung

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]

Alle Daten zu einem angehängten iSCSI-Volume anzeigen

So zeigen Sie alle Daten zu einem an die Compute-Instanz angehängten iSCSI-Volume an:

sudo oci-volume-data -k OCID

Beispiel:

$ 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

Bestimmte Daten zu einem angehängten iSCSI-Volume anzeigen

Verwenden Sie optional die Optionen -k, -p und -v (nur Wert) mit dem Utility oci-volume-data, um die Anzeige für das iSCSI-Volume einzugrenzen:

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

Beispiel: Um nur die Größe eines iSCSI-Volumes anzuzeigen, in diesem Fall 70 GB:

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

Weitere Informationen zu den unterstützten Optionswerten (wie Größe, Status, Compartment usw.) finden Sie auf der Manpage für oci-volume-data. Informationen zum Zugriff auf Manpages für OCI-Utility finden Sie unter Allgemeine OCI-Utilityoptionen.

Optionsdetails

Die folgende Tabelle enthält detaillierte Informationen zu Optionen, die für dieses Dienstprogramm oder diesen Unterbefehl spezifisch sind. Informationen zu den allgemeinen Optionen, die in allen OCI-Utilitys verwendet werden, finden Sie unter Allgemeine OCI-Utilityoptionen.

Optionen des oci-volume-data-Utilitys

Option

Beschreibung

-k KEY | --key KEY

Pflichtfeld. Der Schlüssel zur Identifizierung des Volumes. Der Wert KEY kann die OCID, der IQN oder der Anzeigename des Volumes sein.

-p | --par

Gibt die zu verwendende Quell-IP-Adresse an.

-v | --value-only

Zeigen Sie nur die Werte in der Ausgabe an.

Übersicht über OCI-Utilitys

Eine Übersicht über die Komponenten der OCI-Utilitys.

Name Beschreibung
ocid Die Servicekomponente von oci-utils, die als Daemon ausgeführt und mit systemd gestartet wird. Dieser Service scannt Änderungen in den iSCSI- und VNIC-Gerätekonfigurationen und cacht die OCI-Metadaten sowie die öffentliche IP-Adresse der Instanz.
oci-compartmentid Zeigt die Oracle Cloud-ID (OCID) des Compartments an, in dem die Instanz ausgeführt wird.
oci-growfs Blendet das Root-Dateisystem der Instanz bis zur konfigurierten Größe ein.
oci-image-expand Konvertiert die Oracle Linux Minimal-Instanz, um Services und Packages eines standardmäßigen Oracle Linux-Plattformimages hinzuzufügen.
oci-instanceid Zeigt die OCID der Instanz an.
oci-iscsi-config Listet iSCSI-Geräte auf, die an eine Compute-Instanz angehängt sind, oder konfiguriert diese. Wenn keine Befehlszeilenoptionen angegeben sind, werden die Geräte aufgelistet, die bearbeitet werden müssen.
oci-metadata Zeigt Metadaten für die Compute-Instanz an. Wenn keine Befehlszeilenoptionen angegeben sind, werden alle verfügbaren Metadaten aufgelistet. Metadaten umfassen die Instanz-OCID, den Anzeigenamen, das Compartment, die Ausprägung, die Region, die Availability-Domain, das Erstellungsdatum, den Status, das Image und alle von Ihnen angegebenen benutzerdefinierten Metadaten, wie z.B. SSH-Public-Keys.
oci-network-config Listet die VNICs (virtuellen Netzwerkkarten) auf, die an die Compute-Instanz angehängt sind, oder konfiguriert diese. Wenn eine sekundäre VNIC in der Cloud bereitgestellt wird, muss sie explizit mit diesem Skript oder ähnlichen Befehlen in der Instanz konfiguriert werden.
oci-network-inspector Zeigt einen detaillierten Bericht für ein angegebenes Compartment oder Netzwerk an.
oci-notify Sendet eine Nachricht an ein Notifications-Servicethema.
oci-public-ip Zeigt die öffentliche IP-Adresse des aktuellen Systems im menschenlesbaren oder JSON-Format an.
oci-volume-data Zeigt Daten zu einem bestimmten an die Instanz angehängten iSCSI-Volume an.

Allgemeine OCI-Utilityoptionen

Viele der Oracle Cloud Infrastructure-(OCI-)Utilitys verfügen über dieselben Optionen oder Argumente, die verfügbar sind, wenn die Utilitys über die Befehlszeile ausgeführt werden. Mit diesen Optionen und Argumenten können Sie weiter definieren, welche Art von Informationen vom Utility erzeugt wird oder wie eine Utilityaufgabe ausgeführt wird.

In der folgenden Tabelle sind die Optionen und die unterstützten Werte aufgeführt, die in den OCI-Utilitys gemeinsam sind.

Option Beschreibung
--help Zeigt Hilfeinformationen zum Utility an, wie die Verwendung des Utilitys, verfügbare Optionen und die unterstützten Werte für jede Option. Beispiel: So zeigen Sie die Hilfe für das Utility oci-metadata an:
$ sudo oci-metadata --help

usage: oci-metadata [-h] [-j] [-g KEY] [--value-only] [--export] [--trim]
                    [-u KEY=VALUE  [KEY=VALUE  ...]] [-i OCID] [--help]

Utility for displaying metadata for an instance running in the Oracle Cloud
Infrastructure.

optional arguments:
  -h, --human-readable  Display human readable output (default)
  -j, --json            Display json output
  ...
  --help                Display this help

--all

Zeigt alle Elemente oder Werte in der Ausgabe an.

--details

Zeigt detaillierte Informationen in der Ausgabe an.

--output-mode

Hier können Sie festlegen, wie die Utilityausgabe angezeigt wird. Die folgenden OCI-Utilitymodi sind verfügbar:

  • JSON: Zeigt die Ausgabe im JSON-Format an.
  • human-readable: Zeigt die Ausgabe im menschenlesbaren Format an.
  • parsable: Zeigt die Ausgabe im analysierbaren Format an.
  • table: Zeigt die Ausgabe in einer Tabelle an.
  • text: Zeigt Textausgabe an.

--no-truncate

Verkürzt die Werte in der angezeigten Ausgabe nicht.

--truncate

Verkürzt die Werte in der angezeigten Ausgabe.

-y| --yes

Antworten mit "Ja" in allen Prompts.

-n | --no

Antworten "Nein" in allen Prompts.

-q | --quiet

Unterdrückt Informationsmeldungen.

Hinweis

Sie können Manpages für jedes OCI-Utility auch anzeigen, indem Sie man oci-utility in der Befehlszeile eingeben. Beispiel: So zeigen Sie die integrierten manuellen Seiten für das Utility oci-metadata an:
man oci-metadata