1.  Matériel requis

Introduction

Avant de débuter, nous allons présenter le matériel requis pour installer Gentoo avec succès sur votre système.

Matériel requis

Vous devriez consulter le document Matériels supportés par Linux Gentoo/MIPS.

1.  Notes à l'installation

Quelques mots sur les processeurs

Sur de nombreuses architectures, on peut trouver plusieurs générations de processeurs et chaque génération est construite sur les bases de la génération précédente. Les architectures MIPS ne font pas exception. Il existe plusieurs générations de processeurs pour l'architecture MIPS. Pour pouvoir choisir l'archive de stage utilisée lors du démarrage en réseau et pour bien configurer la variable CFLAGS, vous devez savoir à quelle famille le processeur de votre système appartient. Ces familles sont regroupées sous la dénomination ISA (pour Instruction Set Architecture).

Un autre concept important à prendre en compte est la représentation des nombres dans le système. Elle se réfère à la manière avec laquelle le processeur lit les mots dans la mémoire principale. Un mot peut être lu comme étant big endian (l'octet de poids fort en premier) ou little endian (l'octet de poids faible en premier). Les machines Intel x86 sont en général en little endian, alors que les machines Apple et SPARC sont en big endian. Sur les MIPS, on peut rencontrer les deux. Pour séparer les deux cas, nous ajoutons el au nom de l'architecture lorsqu'elle est en little endian.

Pour ceux qui veulent en savoir plus sur les ISA, vous pouvez vous référer aux liens ci-dessous :

• Site Linux/MIPS : MIPS ISA
• Site Linux/MIPS : Little et Big Endian
• Site Linux/MIPS : Processeurs
• Wikipedia : Jeu d'instructions

L'archive stage3

Une archive stage3 contient un environnement minimal d'utilisation à partir duquel vous pouvez installer Gentoo sur votre système en suivant les instructions de ce manuel. Des archives stage1 et stage2 ont été disponibles et documentées, mais ne sont plus documentées dans ce manuel bien que ces archives soient encore disponibles. Si vous tenez absolument à réaliser une installation à partir d'une de ces archives, veuillez consulter notre FAQ à ce sujet.

1.  Aperçu du démarrage réseau

Dans ce chapitre, nous allons traiter de l'ensemble des points nécessaires pour réussir un démarrage réseau sur une machine Silicon Graphics ou un serveur Cobalt. Ce n'est qu'un condensé et n'a pas pour vocation d'être complet. Pour plus d'informations, il est conseillé de lire le Guide Gentoo sans disque dur.

Ce dont vous avez besoin : Selon la machine, il vous faudra réunir un certain nombre de critères pour démarrer en réseau et installer Linux avec succès.

• En Général :
  • Un serveur DHCP/BOOTP (ISC DHCPd est recommandé) ;
  • De la patience (beaucoup).
• Sur les stations Silicon Graphics :
  • Un serveur TFTP (tftp-hpa est recommandé) ;
  • Si vous voulez/devez utiliser une console en série :
    • Un câble série MiniDIN8 --> RS-232 ;
    • Un câble Null-modem ;
    • Un terminal compatible VT100 ou ANSI capable de transfert à 9600 baud.
• Pour les serveurs Cobalt (PAS l'original Qube) :
  • Un serveur NFS ;
  • Un câble Null-modem ;
  • Un terminal compatible VT100 ou ANSI capable de transfert à 115200 baud.

Mise en place des serveurs TFTP et DHCP : rappels rapides

Bon, maintenant que vous disposez des pièces nécessaires on va pouvoir commencer les choses sérieuses. Comme mentionné auparavant, ce n'est pas un guide complet, seulement un ensemble de configurations minimales pour que tout puisse fonctionner. Vous pouvez au choix utiliser ce chapitre pour réaliser une configuration à partir de zéro ou utiliser les suggestions pour modifier votre configuration actuelle pour qu'elle supporte le démarrage réseau.

Notons que les serveurs utilisés ne sont pas obligatoirement sous Gentoo Linux, vous pouvez bien sûr disposer d'un FreeBSD ou de toute autre plate-forme de type UNIX. Cependant ce guide supposera que vous utilisez Gentoo Linux.
Vous pouvez également mettre le serveur TFTP/NFS sur une autre machine que celle utilisée pour le serveur DHCP.

Première étape, la configuration du DHCP. Afin que le démon ISC DHCP réponde aux requêtes de type BOOTP (obligatoire pour la BOOTROM des SGI et Cobalt), vous devez tout d'abord permettre le BOOTP dynamique sur le sous-réseau utilisé. Puis vous devez configurer une entrée sur chaque client qui pointe sur l'image de démarrage.

# emerge dhcp

Une fois installé vous devez créer le fichier /etc/dhcp/dhcpd.conf. Voici une configuration de base que vous pouvez modifier pour vos besoins.

# Indiquer à dhcpd de désactiver les DNS dynamiques.
# dhcpd refusera de démarrer sans cela..
ddns-update-style none;

# Créer un sous-réseau :
subnet 192.168.10.0 netmask 255.255.255.0 {
  # Ensemble des adresses disponibles pour vos clients. N'oubliez pas le mot-clef
    'dynamic-bootp' !
  pool {
    range dynamic-bootp 192.168.10.1 192.168.10.254;
  }

  # Serveurs DNS et passerelle par défaut (à modifier selon votre convenance).
  option domain-name-servers 203.1.72.96, 202.47.56.17;
  option routers 192.168.10.1;

  # Indiquez au serveur DHCP qu'il a autorité sur le sous-réseau.
  authoritative;

  # Permet l'utilisation de BOOTP sur ce sous-réseau.
  allow bootp;
}

Avec cette configuration vous pouvez ajouter les clients que vous voulez dans la configuration du sous-réseau. Nous indiquerons plus tard ce que vous devez mettre.

Seconde étape, installer un serveur TFTP. Il est recommandé d'utiliser tftp-hpa, car c'est le seul démon TFTP à notre connaissance qui fonctionne correctement. Pour l'installer, il suffit de faire ceci :

# emerge net-ftp/tftp-hpa

Cela créera le répertoire /tftproot où vous devrez entreposer vos images de démarrage réseau. Vous pouvez les placer ailleurs si vous voulez. Dans ce guide, on supposera que vous les avez laissées dans le répertoire par défaut.

1.  Démarrer une station SGI sur le réseau

Téléchargement d'une image Netboot

Selon le système que vous installez, plusieurs images sont disponibles au téléchargement. Elles sont toutes nommées selon le type de système et le processeur pour lesquels elles ont été compilées. Les types de machines sont les suivants :

Enfin, dans le nom du fichier, r4k se réfère à la série des processeurs R4000, r5k aux R5000, rm5k aux RM5000 et r10k aux R10000. Vous trouverez les images disponibles sur ~kumba/mips/netboot.

Configuration DHCP pour un client SGI

Une fois que vous avez téléchargé ce fichier, placez le fichier décompressé dans le répertoire /tftproot. (Utilisez bzip2 -d pour la décompression). Puis, éditez le fichier /etc/dhcp/dhcpd.conf et ajoutez-y une entrée pour votre client SGI.

subnet xxx.xxx.xxx.xxx netmask xxx.xxx.xxx.xxx {
  # ... éléments classiques...

  # Station SGI... changer 'sgi' par le nom de votre machine SGI.
  host sgi {

    # Adresse MAC de votre machine SGI. Elle est normalement écrite derrière la
    # machine ou en dessous.
    hardware ethernet 08:00:69:08:db:77;

    # Serveur TFTP où télécharger l'image de démarrage (par défaut, la même machine
    # que le serveur DHCP).
    next-server 192.168.10.1;

    # Adresse IP à donner à la machine SGI.
    fixed-address 192.168.10.3;

    # Fichier que la PROM doit télécharger pour démarrer.
    filename "/gentoo-r4k.img";
  }
}

Options du noyau

C'est presque fini mais il reste à faire quelques petites modifications pour que tout soit parfait. Ouvrez une console avec les privilèges administrateurs et entrez les commandes suivantes :

(Désactiver « Path Maximum Transfer Unit », sinon la PROM SGI ne trouvera pas le
noyau)
# echo 1 > /proc/sys/net/ipv4/ip_no_pmtu_disc

(Indiquer l'intervalle des ports utilisables par la PROM SGI.)
# echo "2048 32767" > /proc/sys/net/ipv4/ip_local_port_range

Cela devrait être suffisant pour permettre au serveur Linux de bien fonctionner avec la PROM de votre machine SGI.

Démarrer les démons

Vous êtes désormais prêt à démarrer vos démons. Entrez les lignes suivantes :

# /etc/init.d/dhcp start
# /etc/init.d/in.tftpd start

Si tout se passe bien, vous devriez pouvoir maintenant démarrer votre station SGI et continuer à suivre le guide. Si le serveur DHCP ne démarre pas pour une raison ou pour une autre, essayez de lancer dhcpd en ligne de commande pour voir ce qu'il vous donne comme indications. Si tout va bien il devrait simplement se dupliquer en tâche de fond. Sinon, il vous retournera « exiting. » juste après vous avoir donné les raisons de ce problème.

une bonne méthode pour vérifier si le serveur TFTP fonctionne effectivement est de taper la commande suivante (si vous obtenez un résultat proche de celui mentionné ci-dessous c'est que tout va bien) :

# netstat -al | grep ^udp
udp        0      0 *:bootpc                *:*
udp        0      0 *:631                   *:*
udp        0      0 *:xdmcp                 *:*
udp        0      0 *:tftp                  *:* <-- (Cherchez cette ligne.)

Démarrer depuis le réseau sur une machine SGI

Maintenant que tout est en place, le DHCP et le TFTP, vous pouvez démarrer votre machine SGI. Quand vous voyez à l'écran « Running power-on diagnostics », cliquez soit sur « Stop For Maintenance » ou tapez Échap. Vous obtiendrez alors à l'écran un menu comme celui présenté plus bas. Tapez la commande indiquée ci-dessous :

        Running power-on diagnostics

System Maintenance Menu

1) Start System
2) Install System Software
3) Run Diagnostics
4) Recover System
5) Enter Command Monitor

Option? 5
Command Monitor. Type "exit" to return to the menu.
>> bootp(): root=/dev/ram0

À partir de là, la machine devrait commencer à télécharger l'image, puis, quelque chose comme 20 secondes plus tard, elle devrait commencer à démarrer sous Linux. Si tout va bien, vous devriez alors obtenir le shell ash de Busybox comme indiqué plus bas. Vous pouvez alors commencer à (Configurer le réseau).

init started:  BusyBox v1.00-pre10 (2004.04.27-02:55+0000) multi-call binary

Gentoo Linux; http://www.gentoo.org/
 Copyright 2001-2004 Gentoo Technologies, Inc.; Distributed under the GPL

 Gentoo/MIPS Netboot for Silicon Graphics Machines
 Build Date: April 26th, 2004

 * To configure networking, do the following:

 * For Static IP:
 * /bin/net-setup <IP Address> <Gateway Address> [telnet]

 * For Dynamic IP:
 * /bin/net-setup dhcp [telnet]

 * If you would like a telnetd daemon loaded as well, pass "telnet"
 * As the final argument to /bin/net-setup.

Please press Enter to activate this console.

Problèmes et solutions

Si votre machine se bloque et refuse de télécharger son image, cela peut venir de deux choses : ou bien vous vous êtes trompé quelque part, ou alors il faut la persuader gentiment de fonctionner correctement (non, pas à coups de marteau !). Voici une liste de ce que vous pouvez vérifier :

• Le serveur dhcpd attribue une adresse IP à votre machine SGI. Vous devriez avoir des messages de requête BOOTP dans vos fichiers de journalisation système. tcpdump peut également vous être utile dans ce cas.
• Les droits d'accès au répertoire de TFTP sont-ils corrects ? /tftproot doit être accessible en lecture pour tous.
• Jetez un œil dans les fichiers de journalisation système pour voir ce que vous dit le serveur TFTP (peut-être des erreurs ?).

Si vous avez tout bien vérifié sur votre serveur et que vous continuez à avoir des problèmes de délais de réponse dépassés, essayez de taper sur votre console SGI :

>> resetenv
>> unsetenv netaddr
>> unsetenv dlserver
>> init
>> bootp(): root=/dev/ram0

1.  Alternative : Gentoo/MIPS SGI LiveCD

Aperçu

Sur les machines Silicon Graphics, il est possible de démarrer sur un CD afin d'installer un système d'exploitation (comme pour installer IRIX par exemple.) Récemment, des images de CD amorçables pour installer Gentoo ont été rendues disponibles.

Pour le moment, le LiveCD Gentoo/MIPS ne fonctionnera que sur les stations de travail SGI Indy, Indigo 2 et O2 équipées de processeurs R4000 ou R5000. Cependant, cela pourrait fonctionner avec d'autres plates-formes dans le futur.

Vous pouvez trouver les images des LiveCD en téléchargement sur votre miroir Gentoo favori, dans le répertoire experimental/mips/livecd.

Graver un LiveCD

Il est important de noter que la PROM des SGI ne comprend pas le format ISO9660 et ne connait pas le standard El Torito. Ces images CD sont construites comme les labels disque SGI avec l'image de démarrage dans l'en-tête du volume, comme s'il s'agissait d'un disque dur. Il faut donc faire attention lorsqu'on grave l'image CD.

L'exemple ci-dessous suppose que vous gravez à une vitesse de 24x avec un graveur IDE. Si vous avez un graveur SCSI par exemple, il vous faut ajuster le paramètre dev pour qu'il corresponde. De même pour l'option speed. Si vous rencontrez des problèmes, vous pouvez essayer d'enlever l'option de vitesse.

# bzip2 -d mips-livecd-prototype-rc2-20041027.img.bz2
# cdrecord -vv -pad speed=24 dev=ATAPI:0,0,0 -tao mips-livecd-prototype-rc2-20041027.img

1.  Démarrer depuis le réseau sur un serveur Cobalt

Vue d'ensemble sur la procédure de démarrage réseau

Contrairement aux machines SGI, les serveurs Cobalt utilisent le protocole NFS pour effectuer le transfert du noyau sur lequel démarrer. Vous démarrez la machine en maintenant appuyées les boutons de flèches gauche et droite lors du démarrage de la machine. Elle essayera alors d'obtenir une adresse IP en faisant une requête BOOTP, montera le répertoire /nfsroot depuis le serveur grâce à NFS, puis essayera de télécharger et démarrer sur le fichier vmlinux_raq-2800.gz (selon le modèle) qui doit être un binaire ELF standard.

Télécharger une image de démarrage en réseau

Sur http://dev.gentoo.org/~redhatter/mips/cobalt/netboots/, vous trouverez les images nécessaires pour démarrer en réseau un serveur Cobalt. Les fichiers dont vous avez besoin s'appellent nfsroot-KERNEL-COLO-DATE-cobalt.tar. Choisissez le plus récent et décompressez-le dans le répertoire / comme montré ci-dessous :

# tar -C / -xvf nfsroot-2.6.13.4-1.19-20051122-cobalt.tar

Configuration du serveur NFS

Dans la mesure où les Cobalt utilisent NFS pour télécharger l'image de démarrage, vous devez exporter le répertoire /nfsroot sur votre serveur. Si vous ne l'avez pas déjà fait, vous devrez installer le paquet net-fs/nfs-utils.

# emerge net-fs/nfs-utils

Maintenant que c'est fait, ajoutez la ligne suivante à votre fichier /etc/exports. Vous pouvez changer les restrictions d'accès si vous voulez.

/nfsroot      *(ro,sync)

Il vous faut maintenant démarrer votre serveur NFS :

# /etc/init.d/nfs start

Si le serveur NFS fonctionnait déjà, vous pouvez lui demander de relire le fichier exports avec la commande exportfs.

# exportfs -av

Configuration du serveur DHCP pour une machine Cobalt

La partie DHCP est assez simple et classique. Ajoutez les lignes suivantes à votre fichier /etc/dhcp/dhcpd.conf :

subnet xxx.xxx.xxx.xxx netmask xxx.xxx.xxx.xxx {
  # ... éléments classiques...

  # Configuration pour un serveur Cobalt
  # Indiquez le nom de la machine ici :
  host qube {
    # Chemin vers le répertoire nfsroot.
    # Il est utilisé principalement pour quand vous utilisez l'option de
    # démarrage via TFTP avec CoLo.
    # Vous ne devriez pas devoir changer ceci.
    option root-path "/nfsroot";

    # Adresse MAC de la carte ethernet du serveur Cobalt.
    hardware ethernet 00:10:e0:00:86:3d;

    # Serveur sur lequel télécharger l'image.
    next-server 192.168.10.1;

    # Adresse IP à attribuer au serveur Cobalt.
    fixed-address 192.168.10.2;

    # Emplacement du fichier default.colo relatif à /nfsroot
    # Vous ne devriez pas devoir changer ceci.
    filename "default.colo";
  }
}

Démarrez vos démons...

Vous devriez maintenant pouvoir démarrer vos démons. Exécutez les lignes suivantes :

# /etc/init.d/dhcp start
# /etc/init.d/nfs start

Si tout va bien, vous devriez pouvoir démarrer votre station de travail et continuer à suivre le guide. Si le serveur DHCP ne démarre pas pour une raison ou pour une autre, essayez de lancer dhcpd en ligne de commande pour voir ce qu'il vous donne comme indications. Si tout va bien il devrait simplement se dupliquer en tâche de fond. Sinon, il vous retournera « exiting. » juste après vous avoir donné les raisons de ce problème.

Démarrer en réseau la machine Cobalt

Bon, maintenant que tout fonctionne bien, le DHCP comme le NFS, vous pouvez allumer votre machine Cobalt. Branchez votre câble null modem et configurez le terminal série pour utiliser une configuration 115 200 bauds, 8 bits, sans parité, 1 bit d'arrêt et une émulation VT100. Une fois que c'est fait, maintenez appuyées les boutons de flèches gauche et droite à la fois lors du démarrage de la machine.

elf: 80080000 <-- 00001000 6586368t + 192624t
elf: entry 80328040
net: interface down
CPU revision is: 000028a0
FPU revision is: 000028a0
Primary instruction cache 32kB, physically tagged, 2-way, linesize 32 bytes.
Primary data cache 32kB 2-way, linesize 32 bytes.
Linux version 2.4.26-mipscvs-20040415 (root@khazad-dum) (gcc version 3.3.3...
Determined physical RAM map:
 memory: 08000000 @ 00000000 (usable)
Initial ramdisk at: 0x80392000 (3366912 bytes)
On node 0 totalpages: 32768
zone(0): 32768 pages.
zone(1): 0 pages.
zone(2): 0 pages.
Kernel command line: console=ttyS0,115200 root=/dev/ram0
Calibrating delay loop... 249.85 BogoMIPS
Memory: 122512k/131072k available (2708k kernel code, 8560k reserved, 3424k dat)

Si tout va bien, vous devriez alors obtenir le shell ash de Busybox comme indiqué plus bas. Vous pouvez alors commencer à (Configurer le réseau).

VFS: Mounted root (ext2 filesystem) readonly.
Freeing unused kernel memory: 280k freed
init started:  BusyBox v1.00-pre10 (2004.04.27-02:55+0000) multi-call binary

Gentoo Linux; http://www.gentoo.org/
 Copyright 2001-2004 Gentoo Technologies, Inc.; Distributed under the GPL

 Gentoo/MIPS Netboot for Cobalt Microserver Machines
 Build Date: April 26th, 2004

 * To configure networking, do the following:

 * For Static IP:
 * /bin/net-setup <IP Address> <Gateway Address> [telnet]

 * For Dynamic IP:
 * /bin/net-setup dhcp [telnet]

 * If you would like a telnetd daemon loaded as well, pass "telnet"
 * As the final argument to /bin/net-setup.

Please press Enter to activate this console.

Problèmes et solutions

Si votre machine se bloque et refuse de télécharger son image cela peut venir de deux choses : ou bien vous vous êtes trompé quelque part, ou alors il faut la persuader gentiment de fonctionner correctement (non, pas à coups de marteau !). Voici une liste de ce que vous pouvez vérifier :

• Le serveur dhcpd attribue una adresse IP à votre machine Cobalt. Vous devriez avoir des messages de requête BOOTP dans vos fichiers de journalisation système. tcpdump peut également vous être utile dans ce cas.
• Les droits d'accès au répertoire /nfsroot sont-ils corrects ? /nfsroot doit être accessible en lecture pour tous.
• Assurez-vous que le serveur NFS fonctionne et exporte bien le répertoire /nfsroot. Vous pouvez le vérifier avec la commande exportfs -v sur le serveur.