x86 : Administration de la configuration de GRUB par le biais de la commande bootadm

Les procédures suivantes sont fournies dans cette section :

• x86 : Etablissement de la liste des entrées du menu GRUB

• x86 : Régénération manuelle du menu GRUB

• x86 : Gestion du menu GRUB

• x86 : Définition des attributs d'une entrée d'initialisation du menu GRUB

• x86 : Ajout d'une entrée d'initialisation au menu GRUB

• x86 : Suppression d'une entrée d'initialisation du menu GRUB

Sur les systèmes qui prennent en charge GRUB Legacy, c'est principalement en modifiant le fichier menu.lst que vous gérez la configuration et le menu GRUB. Sur les systèmes qui prennent en charge GRUB 2, le fichier de configuration se nomme grub.cfg. Toutefois, il ne faut pas modifier ce fichier manuellement, mais dans l'interface d'administration de l'initialisation bootadm. Vous pouvez exécuter la commande bootadm pour administrer la plupart des tâches précédemment réalisées en éditant le fichier menu.lst. Parmi ces tâches, citons l'administration des paramètres du programme d'amorçage, du menu GRUB et de certains attributs individuels d'une entrée d'initialisation spécifique.

Les sous-commandes bootadm suivantes ont été modifiées pour prendre en charge l'administration de la configuration de GRUB 2 :

list-menu

Répertorie les entrées d'initialisation actuelles du menu GRUB.

La nouvelle option -P permet d'afficher les entrées d'initialisation d'un pool root donné.

Affichez les entrées de menu individuelles par titre ou numéro, comme suit :

# bootadm list-menu -i 0
the location of the boot loader configuration files is: /rpool/boot/grub
     title: Oracle Solaris 11 FCS
     kernel: /platform/i86pc/kernel/$ISADIR/unix
     kernel arguments: -B $ZFS-BOOTFS -v
     boot archive: /platform/i86pc/$ISADIR/boot_archive
     ZFS root pool: rpool

set-menu

Gère le menu GRUB. Cette sous-commande permet de désigner l'entrée de menu GRUB par défaut, mais également de définir d'autres options de menu et du programme d'amorçage.

La nouvelle option -P permet de modifier des menus sur plusieurs pools root.

Les nouvelles sous-commandes bootadm sont les suivantes :

add-entry

Ajoute une entrée d'initialisation au menu GRUB.

change-entry

Modifie les attributs d'une entrée d'initialisation du menu GRUB.

generate-menu

Génère un nouveau fichier de configuration du programme d'amorçage.

install-bootloader

Installe le programme d'amorçage du système. Cette sous-commande s'applique aux plates-formes x86 et SPARC.

remove-entry

Supprime une entrée du menu GRUB.

Les procédures suivantes indiquent comment exécuter la commande bootadm pour gérer la configuration et le menu GRUB. Pour plus d'informations, reportez-vous à la page de manuel bootadm(1M).

x86 : Etablissement de la liste des entrées du menu GRUB

Ajoutez la sous-commande list-menu à la commande bootadm pour répertorier les entrées de menu GRUB actuellement définies sur le système. Ces informations sont fournies par le fichier grub.cfg. La sortie de la commande inclut également l'emplacement des fichiers de configuration du programme d'amorçage, le numéro de l'entrée d'initialisation par défaut, la valeur d'expiration autoboot-timeout et le titre de chaque entrée d'initialisation.

• Répertoriez le contenu du fichier grub.cfg.

  $ bootadm list-menu

  Par exemple :

  $ bootadm list-menu
  the location of the boot loader configuration files is: /rpool/boot/grub
  default 0
  console graphics
  timeout 30
  0 Oracle Solaris 11 FCS
  1 Oracle Solaris backup-1
  2 Oracle Solaris 11 11.1 

  Si vous spécifiez un titre ou un numéro d'entrée lors de l'exécution de la commande, ses informations s'affichent également.

  $ bootadm list-menu -i entry-number

  Par exemple :

  $ bootadm list-menu -i 0
       the location of the boot loader configuration files is: /rpool/boot/grub
       title: Oracle Solaris 11 FCS
       kernel: /platform/i86pc/kernel/$ISADIR/unix
       kernel arguments: -B $ZFS-BOOTFS -v
       boot archive: /platform/i86pc/$ISADIR/boot_archive
       ZFS root pool: rpool

x86 : Régénération manuelle du menu GRUB

Exécutez la commande bootadm generate-menu pour régénérer manuellement un fichier grub.cfg qui contient les instances de SE actuellement installées sur un système.

Les informations stockées sous /usr/lib/grub2/bios/etc/default/grub ou /usr/lib/grub2/uefi64/etc/default/grub, ainsi que celles figurant dans le fichier de métaconfiguration GRUB rpool/boot/grub/menu.conf permettent de générer le fichier grub.cfg final.

1. Prenez le rôle root.

   Reportez-vous à la section Utilisation de vos droits d’administration du manuel Administration d’Oracle Solaris 11.1 : Services de sécurité.

2. Générez le fichier grub.cfg.

   # bootadm generate-menu

   • Si le fichier grub.cfg existe déjà, ajoutez l'option -f pour le remplacer.

     # bootadm generate-menu -f

   • Pour générer un nouveau menu GRUB pour un autre pool root que le pool actuel, procédez comme suit :

     # bootadm generate-menu -P pool-name

3. Vérifiez que le menu a été mis à jour pour refléter les modifications.

   # bootadm list-menu

   ---

   Remarque - Si vous ne visualisez pas les modifications apportées, consultez le fichier grub.cfg pour vérifier qu'elles ont bien été enregistrées.

   ---

x86 : Gestion du menu GRUB

Ajoutez la sous-commande set-menu à la commande bootadm pour gérer le menu GRUB. Vous pouvez par exemple exécuter cette commande pour modifier le délai d'expiration du menu et l'entrée d'initialisation par défaut du menu GRUB.

1. Prenez le rôle root.

   Reportez-vous à la section Utilisation de vos droits d’administration du manuel Administration d’Oracle Solaris 11.1 : Services de sécurité.

2. (Facultatif) Répertoriez les entrées du menu GRUB.

   # bootadm list-menu

3. Apportez les modifications nécessaires au menu GRUB.

   # bootadm set-menu [-P pool] [-R altroot [-p platform]] key=value

   Pour plus d'informations sur les valeurs qu'il est possible de spécifier à l'aide de la sous-commande set-menu, reportez-vous à la page de manuel bootadm(1M). Vous trouverez des exemples illustrant des applications courantes de la sous-commande set-menu après cette procédure.

4. Vérifiez que les modifications ont bien été apportées.

   # bootadm list-menu

   ---

   Remarque - Si vous ne visualisez pas les modifications apportées, consultez le fichier grub.cfg pour vérifier qu'elles ont bien été enregistrées.

   ---

Exemple 2-1 Modification de l'entrée d'initialisation par défaut dans le menu GRUB

Exécutez la commande bootadm set-menu avec l'option key=value appropriée pour définir le numéro de l'entrée par défaut (0, 1 ou 2, par exemple) du menu GRUB. Ce numéro désigne le système d'exploitation initialisé au terme du délai d'expiration.

Par exemple, la sortie de la commande bootadm list-menu ci-dessous affiche les informations relatives à l'entrée d'initialisation par défaut 2, qui correspond à Oracle Solaris 11_test.

# bootadm list-menu
The location of the boot loader configuration file is /rpool/boot/grub
default 2
console graphics
timeout 30
0 Oracle Solaris 11/11
1 Oracle Solaris 11.1
2 Oracle Solaris 11_test

Dans cet exemple, le mode graphics est activé dans la console. Les autres modes disponibles sont text et serial.

Vous pouvez définir l'entrée d'initialisation par défaut sur 1, comme suit :

# bootadm set-menu default=1
# bootadm list-menu
The location of the boot loader configuration file is /rpool/boot/grub
default 1
console graphics
timeout 30
0 Oracle Solaris 11/11
1 Oracle Solaris 11.1
2 GRUB2

Dans cet exemple, l'entrée de menu par défaut est à présent définie sur 1. Lors de sa réinitialisation, le système initialise automatiquement la nouvelle entrée Oracle Solaris au terme du délai d'expiration par défaut.

Vous pouvez également définir l'entrée par défaut du menu GRUB par le biais de la sous-commande change-entry. Reportez-vous à la section x86 : Définition des attributs d'une entrée d'initialisation du menu GRUB.

Exemple 2-2 Modification de la valeur de délai d'expiration du menu GRUB

Exécutez la commande bootadm set-menu avec l'option key=value appropriée pour définir le délai d'expiration du menu.

Dans l'exemple ci-dessous, la sortie de la commande bootadm list-menu illustre la modification de la valeur de délai d'expiration par défaut de 30 secondes, ensuite fixée à 45 secondes. La modification prend effet lors de la prochaine initialisation du système.

# bootadm list-menu
The location of the boot loader configuration file is /rpool/boot/grub
default 2
console graphics
timeout 30
0 Oracle Solaris 11/11
1 Oracle Solaris 11.1
2 Oracle Solaris 11_test
# bootadm set-menu timeout=45
# bootadm list-menu
The location of the boot loader configuration file is /rpool/boot/grub
default 2
console graphics
timeout 45
0 Oracle Solaris 11/11
1 Oracle Solaris 11.1
2 Oracle Solaris 11_test

Exemple 2-3 Définition du type de console GRUB

Le type de console est une des valeurs que vous pouvez définir par le biais de la sous-commande set-menu de la commande bootadm. La modification du type de console de cette façon persiste après la réinitialisation du système.

Vous pouvez par exemple définir le type de console sur serial dans le fichier grub.cfg, comme suit :

# bootadm set-menu console=serial

Il est également possible de définir le type text pour activer le mode texte brut. Choisissez cette option si vous utilisez la redirection série du BIOS. Le type de console graphics est également disponible. Grâce à cette option, vous disposez d'un menu plus graphique dans lequel une image apparaît en arrière-plan.

Lorsque vous définissez le type de console serial, vous pouvez configurer les paramètres série que GRUB 2 doit appliquer lors de l'initialisation du port série. Si vous ne spécifiez pas la valeur serial_params, le port série 0 (COM1/ttya) est le paramètre par défaut. D'autre part, le débit n'est pas précisé. Notez que, si le débit n'est pas spécifié et qu'un seul port est indiqué ( serial_params=0, par exemple), son débit correspondra à celui défini au moment de l'initialisation du port avant l'exécution de GRUB. Si vous souhaitez définir un débit spécifique, faites-le explicitement avec l'option serial_params.

Ajoutez la valeur de clé serial_params à la ligne de commande bootadm, comme suit :

# bootadm set-menu console=serial serial_params=port[,speed[,data bits[,parity[,stop bits]]]]

port

Numéro de port. Il est possible d'indiquer un chiffre compris entre 0 et 3 (0 correspond généralement à ttya ou COM1) pour spécifier les ports ttya à ttyd, ou COM1 à COM4.

speed

Débit du port série. Si cette valeur est omise, GRUB 2 prend en compte le débit défini au moment de l'initialisation du port série. Si le port série n'a pas été initialisé, le fait de ne pas préciser son débit peut entraîner des sorties imprévisibles. Si vous ignorez si le port série a été initialisé ou pas et que vous n'utilisez pas la redirection de la console BIOS, mieux vaut spécifier une valeur de débit.

data bits

Bits de données spécifiés sous la forme de la valeur 7 ou 8.

parity

Parité spécifiée sous la forme e, o ou n (respectivement pour paire, impaire ou aucune).

stop bits

Bits d'arrêt spécifiés sous la forme de la valeur 0 ou 1.

Tous les paramètres série sont facultatifs, à l'exception de port.

x86 : Définition des attributs d'une entrée d'initialisation du menu GRUB

Ajoutez la sous-commande change-entry à la commande bootadm pour définir certains attributs d'initialisation d'une entrée individuelle ou d'une liste d'entrées séparées par des virgules dans le menu GRUB. Une entrée est identifiée par son numéro ou son titre. Si plusieurs entrées portent le même titre, elles sont toutes concernées.

Pour plus d'informations sur la définition des attributs d'entrées d'initialisation spécifiques en modifiant le menu GRUB au moment de l'initialisation, reportez-vous à la section x86 : Ajout d'arguments de noyau en modifiant le menu GRUB au moment de l'initialisation.

1. Prenez le rôle root.

   Reportez-vous à la section Utilisation de vos droits d’administration du manuel Administration d’Oracle Solaris 11.1 : Services de sécurité.

2. (Facultatif) Répertoriez les entrées du menu GRUB.

   # bootadm list-menu

3. Définissez les attributs d'initialisation de l'entrée indiquée.

   # bootadm change-entry [-P pool] {[entry-title[,entry-title...]}]
       | -i entry-number[,entry-number]...]} { key=value [ key=value ...]
       | set-default }

   Lorsque vous spécifiez une valeur qui inclut un espace, il faut l'indiquer entre guillemets simples ou doubles.

   Pour plus d'informations sur les valeurs qu'il est possible de spécifier à l'aide de la sous-commande change-entry, reportez-vous à la page de manuel bootadm(1M). Vous trouverez des exemples illustrant des applications courantes de la sous-commande change-entry après cette procédure.

4. Vérifiez que les modifications ont bien été apportées à l'entrée spécifiée.

   # bootadm list-menu

   ---

   Remarque - Si vous ne visualisez pas les modifications apportées, consultez le fichier grub.cfg pour vérifier qu'elles ont bien été enregistrées.

   ---

Exemple 2-4 Définition du titre d'une entrée d'initialisation du menu GRUB

Vous pouvez définir le titre de l'entrée d'initialisation de votre choix par le biais de la sous-commande change-entry de la commande bootadm. Lors de cette opération, vous pouvez identifier une entrée soit par numéro, soit par titre. L'exemple ci-dessous illustre comment définir le titre d'une entrée d'initialisation spécifiée des deux manières. Si plusieurs entrées portent le même titre, elles sont toutes concernées.

Définissez le titre d'une entrée d'initialisation en spécifiant son numéro, comme suit :

# bootadm list-menu
The location of the boot loader configuration file is /rpool/boot/grub
default 1
console graphics
timeout 30
0 Oracle Solaris 11/11
1 Oracle Solaris 11.1
2 Oracle Solaris 11_test
# bootadm change-entry -i 2 title="Oracle Solaris 11-backup1"
# bootadm list-menu
The location of the boot loader configuration file is /rpool/boot/grub
default 2
console graphics
timeout 45
0 Oracle Solaris 11/11
1 Oracle Solaris 11.1
2 Oracle Solaris 11-backup1

Définissez le titre d'une entrée d'initialisation en spécifiant son titre actuel, comme suit :

# bootadm list-menu
The location of the boot loader configuration file is /rpool/boot/grub
default 1
console graphics
timeout 30
0 Oracle Solaris 11/11
1 Oracle Solaris 11.1
2 Oracle Solaris 11_test
# bootadm change-entry "Oracle Solaris 11_test" title="Oracle Solaris 11-backup1"
# bootadm list-menu
The location of the boot loader configuration file is /rpool/boot/grub
default 2
console graphics
timeout 45
0 Oracle Solaris 11/11
1 Oracle Solaris 11.1
2 Oracle Solaris 11-backup1

Exemple 2-5 Modification d'une entrée d'initialisation en spécifiant ses arguments de noyau

Les exemples ci-après illustrent comment définir les arguments de noyau d'une entrée d'initialisation spécifiée par le biais de la sous-commande change-entry de la commande bootadm.

Dans cet exemple, l'entrée d'initialisation portant le numéro 1 est définie en mode monoutilisateur :

# bootadm list-menu
The location of the boot loader configuration file is /rpool/boot/grub
default 1
console graphics
timeout 30
0 Oracle Solaris 11/11
1 Oracle Solaris 11.1
2 Oracle Solaris 11_test
# bootadm change-entry -i 1 kargs=-s
# bootadm list-menu -i 1
The location of the boot loader configuration files is: /rpool/boot/grub
     title: Oracle Solaris 11.1
     kernel: /platform/i86pc/kernel/$ISADIR/unix
     kernel arguments: -s
     boot archive: /platform/i86pc/$ISADIR/boot_archive
     ZFS root pool: rpool

Dans cet exemple, plusieurs arguments de noyau sont spécifiés pour l'entrée d'initialisation numéro 2 :

# bootadm change-entry -i 2 kargs="-v -s"
# bootadm list-menu -i 2
The location of the boot loader configuration files is: /rpool/boot/grub
     title: Oracle Solaris 11_test
     kernel: /platform/i86pc/kernel/$ISADIR/unix
     kernel arguments: -v -s
     boot archive: /platform/i86pc/$ISADIR/boot_archive
     bootfs: rpool/ROOT/snv_160-nightly-1

Dans cet exemple, les options -v et -s sont spécifiées, ce qui initialise le système à l'état monoutilisateur et en mode verbose.

Chaque fois que vous définissez un ou plusieurs attributs incluant un espace, il faut indiquer les valeurs entre guillemets simples ou doubles.

Exemple 2-6 Modification d'une entrée d'initialisation par le biais de l'option -B pour spécifier ses arguments de noyau

Les exemples ci-dessous illustrent les procédures à suivre pour définir les arguments de noyau d'une entrée d'initialisation spécifique à l'aide de l'option -B.

Pour désactiver le pilote réseau e1000g et charger le débogueur de noyau au moment de l'initialisation, il faudrait procéder comme suit :

# bootadm change-entry -i 0 kargs="-B disable-e1000g=true -k"

Vous pouvez spécifier plusieurs options -B lors de l'exécution de la commande bootadm change-entry. Par exemple, pour désactiver le pilote e1000g et l'ACPI en même temps, il faudrait exécuter l'une des commandes suivantes :

# bootadm change-entry -i 0 kargs="-B disable-e1000g=true -B acpi-user-options=2"

# bootadm change-entry -i 0 kargs="-B disable-e1000g=true,acpi-user-options=2"

Vous pouvez également ajouter l'option -B pour définir certains attributs d'initialisation au moment de l'initialisation en modifiant l'entrée concernée. Pour obtenir des instructions, reportez-vous à la section x86 : Ajout d'arguments de noyau en modifiant le menu GRUB au moment de l'initialisation.

Exemple 2-7 Suppression d'arguments de noyau précédemment ajoutés à une entrée d'initialisation

Dans l'exemple ci-après, un argument de noyau (-s) est supprimé d'une entrée d'initialisation spécifique :

# bootadm list-menu -i 1
the location of the boot loader configuration files is: /rpool/boot/grub
title: s11.1.backup
kernel: /platform/i86pc/kernel/amd64/unix
kernel arguments: -s
boot archive: /platform/i86pc/amd64/boot_archive
bootfs: rpool/ROOT/s11.1.backup
# bootadm change-entry -i 1 kargs=
# bootadm list-menu -i 1
the location of the boot loader configuration files is: /rpool/boot/grub
title: s11.1.backup
kernel: /platform/i86pc/kernel/amd64/unix
kernel arguments:
boot archive: /platform/i86pc/amd64/boot_archive
bootfs: rpool/ROOT/s11.1.backup

x86 : Ajout d'une entrée d'initialisation au menu GRUB

Ajoutez la sous-commande add-entry à la commande bootadm pour intégrer nouvelle entrée portant le titre spécifié au menu GRUB. Si vous spécifiez un numéro, la nouvelle entrée est insérée à la position indiquée dans le menu GRUB. Si le numéro saisi est supérieur au nombre total d'entrées figurant actuellement dans le menu, l'entrée est ajoutée au bas du menu.

1. Prenez le rôle root.

   Reportez-vous à la section Utilisation de vos droits d’administration du manuel Administration d’Oracle Solaris 11.1 : Services de sécurité.

2. (Facultatif) Etablissement de la liste actuelle des entrées d'initialisation du menu GRUB

   # bootadm list-menu

3. Ajoutez la nouvelle entrée d'initialisation au menu GRUB.

   # bootadm add-entry -P pool -i [entry-number] entry-title

4. Définissez la propriété bootfs de l'entrée que vous venez d'ajouter, comme suit :

   # bootadm change-entry -i new-entry-number bootfs='pool-name/ROOT/be-name'

   Cette étape permet de garantir que la nouvelle entrée d'initialisation ajoutée n'utilise pas la valeur bootfs par défaut définie dans le pool root, spécifiée dans la propriété bootfs pool-level.

5. Vérifiez que l'entrée d'initialisation a bien été ajoutée.

   # bootadm list-menu

   ---

   Remarque - Si vous ne visualisez pas les modifications apportées, consultez le fichier grub.cfg pour vérifier qu'elles ont bien été enregistrées.

   ---

Exemple 2-8 x86 : Ajout d'une entrée d'initialisation au menu GRUB

L'exemple ci-dessous illustre comment ajouter une entrée au menu GRUB à l'aide de la commande bootadm add-entry. Dans cet exemple, l'entrée portant le numéro 2 est ajoutée.

# bootadm list-menu
The location of the boot loader configuration file is /rpool/boot/grub
default 2
console graphics
timeout 30
0 Oracle Solaris 11/11
1 Oracle Solaris 11.1
# bootadm add-entry -i 2  Oracle Solaris 11_test
# bootadm change-entry -i 2 bootfs='rpool/ROOT/test'
# bootadm list-menu
The location of the boot loader configuration file is /rpool/boot/grub
default 2
console graphics
timeout 30
0 Oracle Solaris 11/11
1 Oracle Solaris 11.1
2 Oracle Solaris 11_test

Pour afficher le contenu de la nouvelle entrée de menu en spécifiant son numéro, procédez comme suit :

# bootadm list-menu -i 2
     the location of the boot loader configuration files is: /rpool/boot/grub
     title: Oracle Solaris 11_test
     kernel: /platform/i86pc/kernel/amd64/unix
     kernel arguments: -B $ZFS-BOOTFS
     boot archive: /platform/i86pc/amd64/boot_archive
     ZFS root pool: rpool

x86 : Suppression d'une entrée d'initialisation du menu GRUB

Ajoutez la sous-commande remove-entry à la commande bootadm pour supprimer une entrée individuelle ou une liste d'entrées séparées par des virgules du menu GRUB. Si plusieurs entrées portent le même titre, elles sont toutes supprimées.

1. Prenez le rôle root.

   Reportez-vous à la section Utilisation de vos droits d’administration du manuel Administration d’Oracle Solaris 11.1 : Services de sécurité.

2. (Facultatif) Répertoriez les entrées d'initialisation actuelles.

   # bootadm list-menu

3. Supprimez l'entrée spécifiée du menu GRUB.

   # bootadm remove-entry [-P pool] [{entry-title [,entry-title...] |
       -i entry-number[,entry-number...]}

4. Vérifiez que l'entrée a bien été supprimée.

   # bootadm list-menu

   ---

   Remarque - Si vous ne visualisez pas les modifications apportées, consultez le fichier grub.cfg pour vérifier qu'elles ont bien été enregistrées.

   ---

Exemple 2-9 x86 : Suppression d'une entrée d'initialisation du menu GRUB

L'exemple ci-dessous illustre la suppression de l'entrée portant le numéro 2 du menu GRUB.

# bootadm list-menu
The location of the boot loader configuration file is /rpool/boot/grub
default 2
console graphics
timeout 30
0 Oracle Solaris 11/11
1 Oracle Solaris 11.1
2 Oracle Solaris 11_test
bootadm remove-entry -i 2
1 entry removed
# bootadm list-menu
The location of the boot loader configuration file is /rpool/boot/grub
default 2
console graphics
timeout 30
0 Oracle Solaris 11/11
1 Oracle Solaris 11.1