Befehl "cfgmgr"

Online bearbeiten

Zweck

Dieser Befehl konfiguriert Einheiten und installiert optional Einheitensoftware, indem er die in der Objektklasse für die Konfigurationsregeln angegebenen Programme ausführt.

Syntax

cfgmgr [ -f | -s | -p Phase ] [ -i Einheit ] [ -u Drc-name | -l Name ] [ -v ]

cfgmgr [ -f | -s | -p Phase ] [ -i Einheit] [[ -l Name | -u Drc-name] -c Verbindung] [ -v ]

Beschreibung

Der Befehl cfgmgr konfiguriert Einheiten und installiert optional Einheitensoftware im System. Die konfigurierbaren Einheiten werden von der Objektklasse für die Konfigurationsregeln gesteuert, die Teil der Gerätekonfigurationsdatenbank ist. Jede Konfigurationsregel gibt Folgendes an:

  • Vollständiger Pfadname eines auszuführenden ausführbaren Programms
  • Ausführung des Programms (in Relation zu den anderen Regeln)
  • Phase, in der das Programm ausgeführt werden soll
Während des Systemboots konfiguriert der Befehl cfgmgr alle Einheiten, die zur Verwendung des Systems erforderlich sind. Der Systemboot ist ein zweistufiger Prozess:
  1. Phase 1 beginnt, wenn der Kernel im System gestartet und das Bootdateisystem initialisiert wird. In dieser Phase wird der Befehl cfgmgr aufgerufen, der mit dem Flag -f als Phase 1 angegeben wird. Der Befehl cfgmgr führt alle Konfigurationsregeln der Phase 1 aus, woraufhin die Basiseinheiten konfiguriert werden.
  2. Die Ausführung von Phase 2 beginnt und der Befehl cfgmgr wird mit dem Flag -s aufgerufen.

Der Befehl cfgmgr erkennt drei Phasen von Konfigurationsregeln:

  • Phase 1
  • Phase 2 (zweite Bootphase für den normalen Bootvorgang)
  • Phase 3 (zweite Bootphase für den Bootvorgang im Servicemodus)

Der Befehl cfgmgr führt alle Regeln für die während des Aufrufs angegebene Phase aus (z. B. Regeln der Phase 1 für das Flag -f). Wenn jedoch das Flag -l verwendet wird, konfiguriert der Befehl cfgmgr nur die benannte Einheit und deren untergeordnete Einheiten.

Wenn der Befehl cfgmgr ohne eine Phasenoption aufgerufen wird (z. B. ohne das Flag -f, -s oder -p), führt der Befehl die Regeln der Phase 2 aus. Die einzige Möglichkeit, die Regeln der Phase 3 auszuführen, ist die Angabe des Flags -p.

Die Konfigurationsregeln für jede Phase werden auf der Basis der Werte sortiert, die in derseqerlaubt. Dieses Feld enthält eine Ganzzahl, die die Priorität angibt, mit der diese Regel in Relation zu den anderen Regeln für diese Phase ausgeführt wird. Je höher die Zahl, die durch dieseqFeld, je niedriger die Priorität ist. Beispiel: Ein Wert von 1, der in derseqwird vor einer Regel mit dem Wert 10 ausgeführt. Es gibt eine Ausnahme: aseqDer Feldwert 0 impliziert eine Bedingung "don't care" und wird zuletzt ausgeführt. Aus diesem GrundseqFeldwert 1 ist die höchste Priorität und wird zuerst ausgeführt.

Wenn bei der Einheitenkonfiguration Einheiten erkannt werden, auf denen keine Einheitensoftware installiert ist, gibt der Befehl cfgmgr eine Warnung zurück, die den Namen oder eine Liste möglicher Namen für das Einheitenpaket enthält, das installiert werden muss. Wenn der Name des Einheitenpakets bestimmt wurde, wird er als einziger Paketname in einer Zeile unterhalb der Warnung angezeigt. Wenn der Name nicht bestimmt werden kann, wird eine durch Doppelpunkte getrennte Liste möglicher Paketnamen in einer einzelnen Zeile angezeigt. Es wird ein Paketname oder eine Liste möglicher Paketnamen für jede der Einheiten angezeigt, wenn mehrere Einheiten ohne Einheitensoftware erkannt werden.

Das System zeigt die folgende Warnung an, wenn Einheiten ohne Einheitensoftware erkannt werden:

cfgmgr: 0514-621 WARNING: The following  device packages are
        required for device support but are not currently 
        installed.
devices.pci.22100020
devices.pci.14101800
devices.pci.scsi:devices.pci.00100300:devices.pci.NCR.53C825

In diesem Beispiel wurden zwei Einheiten mit fehlender Software gefunden und der Befehl cfgmgr zeigt die Namen der Einheitenpakete an, die installiert werden müssen. Es wurde eine dritte Einheit gefunden, auf der ebenfalls Software fehlt, aber in diesem Fall zeigt der Befehl cfgmr mehrere mögliche Einheitenpaketnamen an.

Wenn mehrere mögliche Paketnamen für eine Einheit identifiziert werden, entspricht tatsächlich nur einer der Namen einem Einheitenpaket auf den Installationsmedien. Dies ist das Paket, das Sie installieren müssen. In manchen Fällen entsprechen jedoch mehrere Namen den tatsächlichen Einheitenpaketen auf den Installationsmedien. In diesem Fall ist der erste Paketname in der Liste, für den es ein Einheitenpaket auf den Installationsmedien gibt, das Paket, das installiert werden muss. Wenn der Befehl cfgmgr mit dem Flag -i verwendet wird, werden die richtigen Pakete installiert.

Wenn Sie den Befehl cfgmgr mit dem Flag -i aufrufen, versucht der Befehl, die Einheitensoftware für jede neu erkannte Einheit automatisch zu installieren. Die Variable Einheit des Flags -i gibt an, wo die Installationsmedien zu finden sind. Die Installationsmedien können eine Hardwareeinheit (z. B. ein Bandlaufwerk oder ein Diskettenlaufwerk), ein Verzeichnis mit Installationsimages oder das Installationsimage selbst sein.

Achtung: Zum Schutz der Konfigurationsdatenbank ist der Befehl cfgmgr nicht unterbrechbar. Ein Stoppen dieses Befehls vor Befehlsabschluss könnte zu einer Beschädigung der Datenbank führen.

Flags

Element Beschreibung
-c Verbindung Gibt die Verbindungsinformationen an, die zum Konfigurieren der jeweiligen Zieleinheit erforderlich sind. Anweisungen zu den Verbindungsinformationen für eine bestimmte Einheit finden Sie unter Zielkonfiguration von FC-und FCoE -Einheiten .
-u Drc-Name Gibt die Variable Drc-Namen des PCI- (Peripheral Component Interconnect) oder virtuellen Steckplatzes an, der zusammen mit den untergeordneten Elementen des Steckplatzes konfiguriert werden soll. Sie können die Variable Drc-Name der Einheit mit dem Befehl lsslot abrufen.
-F Gibt an, dass der Befehl cfgmgr die Konfigurationsregeln der Phase 1 ausführen soll. Dieses Flag ist zur Laufzeit (nach dem Systemstart) nicht gültig.
-i Einheit Gibt die Position der Installationsmedien an.
-l Name Gibt die Einheit an, die zusammen mit den untergeordneten Einheiten der Einheit konfiguriert werden soll.
-p Phase Gibt an, dass der Befehl cfgmgr die angegebene Phase ausführen soll.
-s Gibt an, dass der Befehl cfgmgr die Konfigurationsregeln der Phase 2 ausführen soll.
-v Gibt die ausführliche Ausgabe an. Der Befehl cfgmgr schreibt Informationen zu den ausgeführten Schritten in die Standardausgabe.

Konfigurationsregeln

Element Beschreibung
phase Gibt an, ob diese Regel zu Phase 1, Phase 2 oder Phase 3 gehört (zweite Bootphase für den Servicemodus).
SEQ Gibt die relative Priorität dieser Regel als ganze Zahl an.
Regel Eine Zeichenfolge, die den vollständigen Pfadnamen eines auszuführenden Programms enthält. Sie kann auch beliebige Flags enthalten, aber diese müssen hinter dem Programmnamen stehen, da die vollständige Zeichenfolge so ausgeführt wird, als würden Sie sie in der Befehlszeile eingeben.

Sicherheit

Zugriffssteuerung: Dieser Befehl sollte nur dem Rootbenutzer und Mitgliedern der Gruppe "system" Ausführungsberechtigung (e(x)ecute) erteilen.

Prüfereignis:

Ereignis Informationen
DEV_Configure Einheitenname

Beispiele

Diese Beispiele basieren auf den Konfigurationsregeln, die die folgenden Informationen enthalten:
phase   seq        rule


1     10      /usr/lib/methods/defsys
1     12      /usr/lib/methods/deflvm


2     10      /usr/lib/methods/defsys
2     12      /usr/lib/methods/deflvm
2     13      /etc/methods/startusb
2     17      /etc/methods/cfgvlan -2
2     18      /usr/lib/methods/cfgrcnet
2     19      /usr/lib/methods/ptynode
2     20      /etc/methods/vconnode
2     20      /usr/lib/methods/startlft
2     22      /etc/methods/startrcm
2     25      /usr/lib/methods/starttty
2     27      /etc/methods/startsgio
2      0      /usr/lib/methods/defaio
2      0      /usr/lib/methods/def_posix_aio
2      0      /usr/lib/perf/cfg_perfstat load
2      0      /usr/lib/perf/load_blockset_ext


3     10      /usr/lib/methods/defsys
3     12      /usr/lib/methods/deflvm
3     13      /etc/methods/startusb
3     15      /usr/lib/methods/starttty
3     19      /usr/lib/methods/ptynode
3     20      /usr/lib/methods/startlft
3     20      /etc/methods/vconnode
3     22      /etc/methods/startrcm
3     27      /etc/methods/startsgio
  1. Wenn der Befehl cfgmgr mit dem Flag -f aufgerufen wird, ruft der Befehl alle Konfigurationsregeln mit phase = 1 ab und führt sie in der folgenden Reihenfolge aus:
    /usr/lib/methods/defsys
/usr/lib/methods/deflvm
    Hinweis: Das Flag -f kann während der Laufzeit nicht verwendet werden.
  2. Wenn der Befehl cfgmgr mit dem Flag -s ausgeführt wird, ruft der Befehl alle Konfigurationsregeln mit phase = 2 ab und führt sie in der folgenden Reihenfolge aus:
    /usr/lib/methods/defsys
/usr/lib/methods/deflvm
/etc/methods/cfgvlan -2
/usr/lib/methods/cfgrcnet
/usr/lib/methods/ptynode
/etc/methods/vconnode
/usr/lib/methods/startlft
/etc/methods/startrcm
/usr/lib/methods/starttty
/etc/methods/startsgio
/usr/lib/methods/defaio
/usr/lib/methods/def_posix_aio
/usr/lib/perf/cfg_perfstat load
/usr/lib/perf/load_blockset_ext
  3. Wenn der Befehl cfgmgr mit dem Flag -p 3 ausgeführt wird, ruft der Befehl alle Konfigurationsregeln mit phase = 3 ab und führt sie in der folgenden Reihenfolge aus:
    /usr/lib/methods/defsys
/usr/lib/methods/deflvm
/etc/methods/startusb
/usr/lib/methods/starttty
/usr/lib/methods/ptynode
/usr/lib/methods/startlft
/etc/methods/vconnode
/etc/methods/startrcm
/etc/methods/startsgio
  4. Wenn der Befehl cfgmgr ohne Flag ausgeführt wird, funktioniert der Befehl genauso wie bei Verwendung des Flags "-s". Somit werden die Regeln der Phase 2 in der folgenden Reihenfolge ausgeführt:
    /usr/lib/methods/defsys
/usr/lib/methods/deflvm
/etc/methods/cfgvlan -2
/usr/lib/methods/cfgrcnet
/usr/lib/methods/ptynode
/etc/methods/vconnode
/usr/lib/methods/startlft
/etc/methods/startrcm
/usr/lib/methods/starttty
/etc/methods/startsgio
/usr/lib/methods/defaio
/usr/lib/methods/def_posix_aio
/usr/lib/perf/cfg_perfstat load
/usr/lib/perf/load_blockset_ext
  5. Geben Sie Folgendes ein, um erkannte Einheiten zu konfigurieren, die dem Adapter scsi0 zugeordnet sind:
    cfgmgr -l scsi0
  6. Geben Sie Folgendes ein, um die untergeordnete Einheit des Adapters fscsi0 zu konfiguriere, der der mit dem Flag -c angegebenen Verbindung zugeordnet ist:
    cfgmgr -l fscsi0 -c "ww_name=0x5001738000330191,lun_id=0x1000000000000"
  7. Geben Sie Folgendes ein, um Einheitensoftware automatisch während der Konfiguration mit der im Verzeichnis /usr/sys/inst.images enthaltenen Software zu installieren:
    cfgmgr -i /usr/sys/inst.images

Dateien

Element Beschreibung
/usr/sbin/cfgmgr Gibt die Befehlsdatei an.
/usr/include/sys/cfgdb.h Enthält numerische Darstellungen für Felder in der Objektklasse für Konfigurationsregeln.