Commande cfgmgr

Objectif

Configure des périphériques et installe éventuellement des logiciels de périphérique en exécutant les programmes spécifiés dans la classe d'objets Règles de configuration.

Syntaxe

cfgmgr [ -f | -s | -p Phase ] [ -i Unité ] [ -u Nom Drc | -l Nom ] [ -v ]

cfgmgr [ -f | -s | -p Phase ] [ -i Unité] [[ -l Nom | -u Nom Drc] -c Connexion] [ -v ]

Descriptif

La commande cfgmgr configure les unités et installe éventuellement le logiciel de l'unité dans le système. Les unités configurables sont contrôlées par la classe d'objets Règles de configuration, qui fait partie de la base de données Configuration des unités. Chaque règle de configuration spécifie ce qui suit:

  • Chemin d'accès complet d'un programme exécutable à exécuter
  • Quand exécuter le programme (par rapport aux autres règles)
  • Phase d'exécution du programme
Lors de l'amorçage du système, la commande cfgmgr configure toutes les unités nécessaires à l'utilisation du système. L'amorçage du système est un processus en deux étapes:
  1. Appelée phase 1, cette étape commence lorsque le noyau est introduit dans le système et que le système de fichiers d'amorçage est initialisé. Au cours de cette phase, la commande cfgmgr est appelée, en spécifiant la phase 1 à l'aide de l'indicateur -f . La commande cfgmgr exécute toutes les règles de configuration de la phase 1, ce qui entraîne la configuration des unités de base.
  2. L'exécution de la phase 2 commence et la commande cfgmgr est appelée avec l'indicateur -s .

La commande cfgmgr reconnaît trois phases des règles de configuration:

  • Phase 1
  • Phase 2 (deuxième phase d'amorçage pour un amorçage normal)
  • Phase 3 (deuxième phase d'amorçage pour l'amorçage du service)

La commande cfgmgr exécute toutes les règles de la phase spécifiée lors de l'appel (par exemple, les règles de la phase 1 pour l'indicateur -f ). Toutefois, si l'indicateur -l est utilisé, la commande cfgmgr configure uniquement l'unité nommée et ses enfants.

Si la commande cfgmgr est appelée sans option de phase (par exemple, sans les indicateurs -f,-sou -p ), la commande exécute les règles de phase 2. Le seul moyen d'exécuter les règles de la phase 3 est d'utiliser l'indicateur -p .

Les règles de configuration de chaque phase sont classées en fonction des valeurs spécifiées dans leseq:NONE. Cette zone est un entier qui indique la priorité d'exécution de cette règle par rapport aux autres règles de cette phase. Plus le nombre spécifié par leseq, plus la priorité est basse. Par exemple, une valeur de 1 spécifiée dans leseqUne zone est exécutée avant une règle avec une valeur de 10. Il existe une exception: aseqLa valeur de zone 0 implique une condition "ne s'en soucie pas" et s'exécute en dernier. Par conséquent, unseqla valeur de zone 1 est la priorité la plus élevée et s'exécute en premier.

Si aucun logiciel d'unité n'est installé sur certaines unités détectées lors de la configuration des unités, la commande cfgmgr renvoie un message d'avertissement avec le nom ou la liste des noms possibles pour le module d'unité à installer. Si le nom spécifique du module d'unité est déterminé, il s'affiche en tant que seul nom de module sur une ligne sous le message d'avertissement. Si le nom spécifique ne peut pas être déterminé, une liste des noms de progiciel possibles séparés par un signe deux points (:) s'affiche sur une seule ligne. Un nom de progiciel ou une liste des noms de progiciel possibles s'affiche pour chacune des unités, si plusieurs unités sont détectées sans leur logiciel.

Le système affiche le message d'avertissement suivant lorsque des unités sans logiciel sont détectées :

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

Dans cet exemple, deux unités sont manquantes et la commande cfgmgr affiche les noms des modules d'unité qui doivent être installés. Une troisième unité pour laquelle il manque également un logiciel a été trouvée, mais dans ce cas, la commande cfgmr affiche plusieurs noms de module d'unité possibles.

Lorsque plusieurs noms de package possibles sont identifiés pour un périphérique, un seul de ces noms correspond à un package de périphérique sur le support d'installation. Il s'agit du package que vous devez installer. Toutefois, dans certains cas, plusieurs noms correspondent à des packages d'unité réels sur le support d'installation. Dans ce cas, le premier nom de package de la liste pour lequel il existe un package de périphérique sur le support d'installation est le package qui doit être installé. Si la commande cfgmgr est utilisée avec l'indicateur -i , les packages appropriés seront installés.

Si vous appelez la commande cfgmgr avec l'indicateur -i , la commande tente d'installer automatiquement le logiciel de l'unité pour chaque nouvelle unité détectée. La variable Device de l'indicateur -i indique où trouver le support d'installation. Le support d'installation peut être une unité matérielle (telle qu'une unité de bande ou de disquette), un répertoire contenant des images d'installation ou le fichier d'image d'installation lui-même.

Attention: Pour protéger la base de données de configuration, la commande cfgmgr n'est pas interruptible. L'arrêt de cette commande avant qu'elle ne soit terminée peut entraîner une altération de la base de données.

Indicateurs

Article Descriptif
-c Connexion Indique les informations de connexion requises pour configurer l'unité ciblée spécifique. Voir les instructions relatives à la configuration ciblée des unités FC et FCoE concernant les informations de connexion d'une unité spécifique.
-u Nom Drc Indique la variable Nom Drc de la carte PCI (Peripheral Component Interconnect) ou de l'emplacement virtuel à configurer avec les enfants de l'emplacement. Vous pouvez obtenir la variable Drc name du périphérique à l'aide de la commande lsslot .
-f Indique que la commande cfgmgr exécute les règles de configuration de la phase 1. Cet indicateur n'est pas valide lors de l'exécution (après le démarrage du système).
-i Unité Indique l'emplacement du support d'installation.
-l Nom Indique l'unité nommée à configurer avec les enfants de l'unité.
-p Phase Indique que la commande cfgmgr exécute la phase spécifiée.
-S Indique que la commande cfgmgr exécute les règles de configuration de la phase 2.
-v Indique la sortie prolixe. La commande cfgmgr écrit des informations sur ce qu'elle fait dans la sortie standard.

Règles de configuration

Article Descriptif
phase Indique si cette règle appartient à la phase 1, à la phase 2 ou à la phase 3 (deuxième phase d'amorçage pour le mode service).
Séq Indique la priorité relative de cette règle sous la forme d'un entier.
règle Chaîne contenant le nom de chemin d'accès complet d'un programme à exécuter. Il peut également contenir des indicateurs, mais ils doivent suivre le nom du programme car la chaîne entière s'exécute comme si elle avait été tapée sur la ligne de commande.

Security

Contrôle d'accès: seuls l'utilisateur root et les membres du groupe de systèmes doivent avoir un accès en exécution (x) à cette commande.

Evénement d'audit:

Evénement Informations
DEV_Configure Nom de l'unité

Exemples

Ces exemples sont basés sur les règles de configuration contenant les informations suivantes:
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. Lorsque la commande cfgmgr est appelée avec l'indicateur -f , la commande obtient toutes les règles de configuration avec phase = 1 et les exécute dans l'ordre suivant:
    /usr/lib/methods/defsys
    /usr/lib/methods/deflvm
    Remarque: L'indicateur -f ne peut pas être utilisé lors de l'exécution.
  2. Lorsque la commande cfgmgr est exécutée avec l'indicateur -s , la commande obtient toutes les règles de configuration avec phase = 2 et les exécute dans l'ordre suivant:
    /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. Lorsque la commande cfgmgr est exécutée avec l'indicateur -p 3 , la commande obtient toutes les règles de configuration avec phase = 3 et les exécute dans l'ordre suivant:
    /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. Si la commande cfgmgr est exécutée sans indicateur, elle fonctionne de la même manière que lorsqu'elle est utilisée avec l'indicateur -s Ainsi, les règles de phase 2 sont exécutées dans l'ordre suivant:
    /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. Pour configurer les unités détectées connectées à l'adaptateur scsi0 , entrez ce qui suit:
    cfgmgr -l scsi0
  6. Pour configurer l'unité enfant de l'adaptateur fscsi0 qui est connecté à la connexion spécifiée par l'indicateur -c , entrez ce qui suit:
    cfgmgr -l fscsi0 -c "ww_name=0x5001738000330191,lun_id=0x1000000000000"
  7. Pour installer automatiquement le logiciel d'unité lors de la configuration avec le logiciel contenu dans le répertoire /usr/sys/inst.images , entrez ce qui suit:
    cfgmgr -i /usr/sys/inst.images

Fichiers

Article Descriptif
/usr/sbin/cfgmgr Indique le fichier de commandes.
/usr/include/sys/cfgdb.h Contient des représentations numériques pour les zones de la classe d'objets Règles de configuration.