Vorheriges Thema: ÜbersichtNächstes Thema: Beschränkungen


Verwendung

Virtuelle Computer-Images als CA AppLogic®-Appliance-Klassen importieren.

Syntax
util image2class <class> <image> <--managed|--unmanaged|--upgrade> 
>>>     [virt_mode=<xen_pv|xen_hvm|vmware>] [os=<os_name>] [boot_vol=<id>]
>>>     [desc=<desc>] [mem=<value>] [cpu=<value>] [bw=<value>] 
>>>     [--external_iface] [user=<username>] [pwd=<password>] [--force]

Optionen
<class>

Der Name der Appliance-Klasse, die erstellt werden soll. Dieser kann als Singleton (z. B. "my_app:MYCLASS") oder als Katalogklasse (z. B. "/user:MYCLASS") angegeben werden. Wenn die Klasse als Singleton angegeben wird, wird die Anwendung erstellt, wenn sie nicht vorhanden ist. Dieser Parameter ist obligatorisch.

<image|volumes>

Das zu importierende Image oder Volume. Diese können sich entweder auf dem Grid-Impex-Volume, z. B. my-appliance.ova, oder unter einer URL, z. B. https://my-server.com/my-appliance.ova, befinden.

Beim Importieren eines OVA-Images sollte nur eine Datei oder URL angegeben werden.

Beim Importieren von Volumes des Typs "raw" können bis zu vier durch Kommas voneinander getrennt angegeben werden. Die Volumes werden in der angegebenen Reihenfolge importiert. Dieser Parameter ist obligatorisch.

--managed

Eine verwaltete Appliance erstellen, die Erfolgs- oder Fehlerereignisse beim Starten und Anhalten einer Appliance sendet; die die virtuellen Netzwerkschnittstellen automatisch konfiguriert, die den Terminals entsprechen; die Ressourcen- und Leistungszähler hat, die erfasst und an das mon-Terminal gesendet werden (wenn vorhanden und verbunden); die Eigenschaftseinstellungen hat, deren Werte beim Start der Appliance abgerufen und für Konfigurationsskripte verfügbar gemacht werden.

--unmanaged

Eine nicht verwaltete Appliance erstellen. An den Appliance-Volumes werden keine Änderungen vorgenommen.

--upgrade

Die Volumes der angegebenen vorhandenen Klasse (<class>) durch diejenigen aus <image> ersetzen. Die ursprünglichen Volumes der Appliance-Klasse werden überschrieben (bei einem Fehler werden die alten Volumes wiederhergestellt). Der Deskriptor von <class> wird während eines Upgrade nicht geändert. Wenn die vorhandene Klasse (<class>) verwaltet wird, wird das importierte Startvolume entsprechend geändert, sodass die Klasse nach Abschluss des Imports weiterhin verwaltet wird. Diese Option schlägt fehl, wenn sich die Anzahl der Volumes in <class> von der Anzahl der Volumes in <image> unterscheidet. Um dieses Verhalten aufzuheben, verwenden Sie den Parameter "--force". Dieser Parameter kann nicht zusammen mit dem Parameter "--managed" oder mit dem Parameter "--unmanaged" verwendet werden.

virt_mode=<xen_pv|xen_hvm|vmware>

Virtualisierungsmodus, wenn "--managed" verwendet wird. Zulässige Werte sind 'xen_pv', 'xen_hvm' und 'vmware'. Es können mehrere, durch Komma getrennte Werte eingegeben werden. Standard: 'xen_pv,xen_hvm,vmware'. Dies hat keine Auswirkung, wenn eine nicht verwaltete Appliance erstellt wird. In diesem Fall wird der Virtualisierungsmodus auf 'xen_hvm,vmware' gesetzt.

os=<os_name>

Name des Betriebssystems. Dies wird im Deskriptor der Appliance eingefügt. Im Abschnitt "Unterstützte Betriebssysteme" finden Sie eine Liste mit den erlaubten Werten. Wenn ein ungültiger Wert oder kein Wert angegeben wird, druckt image2class die Liste der unterstützten Betriebssysteme und fordert den Benutzer auf, eine Auswahl zu treffen.

user=<username>

Der Benutzername, der zur Authentifizierung bei einem Webserver verwendet wird, wenn der <image>-Parameter als URL angegeben wird. Der Benutzername wird auch verwendet, wenn zusätzliche Dateien als Teil des Imports abgerufen werden. Dieser Parameter ist optional.

pwd=<password>

Das Kennwort, das zur Authentifizierung bei einem Webserver verwendet wird, wenn der <image>-Parameter als URL angegeben wird. Das Kennwort wird auch verwendet, wenn zusätzliche Dateien als Teil des Imports abgerufen werden. Wenn <password> als - angegeben wird, fordert image2class den Benutzer zur Eingabe des Kennworts auf. Wenn die Standardeingabe 'stdin' kein Terminal-Gerät ist, wird keine Aufforderung angezeigt, und eine Kopie des Kennworts wird als Eingabe für 'stdin' erwartet (dies kann für Batchoperationen verwendet werden, um das Kennwort über ein Skript festzulegen). Dieser Parameter ist optional.

--force

Nicht nach einer Benutzerbestätigung fragen, wenn <class> bereits vorhanden ist (mit oder ohne Angabe von "--upgrade"). Außerdem wird kein Fehler beim Upgrade ausgelöst, wenn <class> eine andere Anzahl von Volumes hat, als das vorhandene <image> (stattdessen wird der Deskriptor für <class> so aktualisiert, dass er die in <image> vorhandenen Volumes enthält). Dieser Parameter ist optional.

desc=<desc>

Ein Klassendeskriptor, der mit der importierten Klasse verknüpft werden soll. Dieser kann sich entweder auf dem impex-Volume des Grid befinden (also APPPLIANCE.desc) oder eine URL sein (also "https://my-server.com/APPPLIANCE.desc"). Wenn dies zusammen mit einem OVA-Image verwendet wird, wird die Konfiguration im ovf-Deskriptor ignoriert. Der Komponentenname innerhalb dieses Deskriptors wird ignoriert. Stattdessen wird der in <class> angegebene Wert verwendet. Dieser Parameter kann nicht zusammen mit --upgrade, boot_vol, cpu, mem, bw oder --external_iface verwendet werden. Dieser Parameter ist optional.

boot_vol=<id>

Gibt bei Verwendung eines OVF-Images an, welches Volume als Startvolume konfiguriert werden soll. Dies kann entweder ein Festplatten-ID, wie im ovf-Deskriptor angegeben, oder eine Zahl zwischen 1 und 4 in der geordneten Liste von Volumes im .ovf-Deskriptor sein. Wenn dieser Parameter nicht angegeben wird, wird das erste Volume als Startvolume konfiguriert. Wenn das angegebene Volume nicht vorhanden ist, schlägt die Operation fehl. Dieser Parameter kann nur mit OVA-Images verwendet werden. Wenn Sie ihn beim Importieren von raw-Volumes verwenden, schlägt die Operation fehl. Dieser Parameter ist optional.

cpu=<value>
mem=<value>
bw=<value>

CPU-, Speicher- und Bandbreitenressourcen, die an der Begrenzung der Appliance-Klasse festgelegt werden. Minimale, maximale und Standardressourcen werden auf den gleichen Wert festgelegt.

Wenn dies nicht als Parameter angegeben ist und <image> eine Konfiguration für die Ressourcen enthält, werden die Werte für cpu und mem vom <image> übernommen.

Wenn eine Ressource weder als Parameter noch im <image> angegeben wird, werden die folgenden Werte verwendet: memory=512M, cpu=1.0, bw=100M.

Diese Parameter sind optional.

--external_iface

Die externe Schnittstelle für die erstellte Klasse aktivieren. Die Netzwerkkonfiguration muss manuell erstellt werden und wird nicht von diesem Hilfsprogramm verarbeitet. Dieser Parameter ist optional.

Hinweis: Die aktuelle Version unterstützt nur als OVA-Dateien verpackte ovf-Images.

Unterstützte Betriebssysteme

Die aktuelle Liste der unterstützten Betriebssysteme finden Sie in den Versionshinweisen oder im Appliance-Entwicklerhandbuch.

Beispiele
util image2class my_app:TOMCAT tomcat.ova --unmanaged

Ein OVA-Image aus dem impex-Volume des Grid als nicht verwaltete Singleton-Klasse importieren.

util image2class /proto:TOMCAT http://example.com/tomcat.ova user=some-user pwd=- --managed cpu=2 mem=512M

Ein OVA-Image aus einer URL importieren, dabei eine verwaltete Katalogklasse erstellen und die im .ovf-Deskriptor angegebenen Ressourcen aufheben.

util image2class /proto:TOMCAT tomcat.ova --upgrade

Ein Upgrade für eine verwaltete Katalogklasse durchführen; dabei deren Volumes durch diejenigen eines OVA-Images ersetzen