Script servant à générer une image pour systèmes à base de processeurs arm Script making an image for arm based systems

DTux efe8057ee0 Merge branch 'master' of Jybz/mageia4arm into master 1 day ago
common 6bd9625562 sync 2 days ago
init.d 17cb092b9a debug 8 months ago
log 7759ecc296 debug ${INSTALL_PATH} 2 days ago
platforms be97663762 Merge branch 'master' of ssh://git.labolyon.fr/Jybz/mageia4arm 2 days ago
tools a18c6bb409 sync7 2 days ago
.gitignore b314f24a5e add gitignore /log 2 days ago
LICENSE 726f7510d0 Initial commit 1 year ago
README.md 6bd9625562 sync 2 days ago
create_arm_img_urpmi.sh b314f24a5e add gitignore /log 2 days ago
mageia4arm.cfg.template b4e21eca05 Merge branch 'master' of https://git.labolyon.fr/DTux/mageia4arm 11 months ago
mageia4arm.kdev4 074e6a5e03 renamed raspi dir by rpi 1 year ago

README.md

mageia4arm

Short :

Français

Description :

Outils servant à générer une image Mageia pour systèmes à base de processeurs arm

Démarrage rapide :

Avoir une copie de ce dépot :

git clone https://git.labolyon.fr/DTux/mageia4arm

Choisissez le dossier de configuration adapté à votre besoin (rpi ou xu4), sinon créez un nouveau dossier de configuration, copiez le fichier "mageia4arm.cfg.template" à l'interieur et modifiez le selon vos besoins.
Par défaut l'utilisateur est "pi" avec le mot de passe "raspberry", et l'administrateur "root" avec le mot de passe "piroot".

Créer l'image :

create_arm_img_urpmi.sh --all --config <dossier de configuration>
Par exemple :

su -  
<mot de passe root>  
cd /home/user/workspace/mageia4arm/  
./create_arm_img_urpmi.sh --all --target bananaPro --size 4 --tainted --nonfree --build-path ./build --config bananaPro 2>&1 | tee -a ./build.log

Avec cette commande, toutes les étapes (--all) du processus de création pour (--target) la bananaPro sont exécuter. L'image final tiendra sur une carte de (--size) 4Go. Les dépots tainted et nonfree seront activé. Le chemin de construction (--build-path) sera ./build. Finalement, la configuration (--config) sera bananaPro. La suite de la commande, 2>&1 redirige la sortie d'erreur dans la sortie standart et le tout est dupliqué (| tee -a) dans le fichier build.log pour le déboguage.

Aide :

create_arm_img_urpmi.sh -h|--help

Vous pouvez adapter le script "second_stage_install.sh" afin de compléter l'installation.
Des scripts sont disponibles dans le dossier "tools", ils sont copié dans /usr/local/bin/ dans l'image.

Premier lancement de l'image sur le raspberry pi :

  • lancer drakkeyboard afin de configurer le clavier
  • si vous avez besoin d'un gestionnaire graphique, lancer le script :
    install_graphical.sh <gestionnaire-graphique>( xfce, lxqt, plasma, ...) voir les métapaquetages disponibles dans "Environnement graphique" dans le gestionnaire de logiciels.

Ajouter une nouvelle plateforme :

Pour ajouter une nouvelle plateforme, il faut le dossier au nom du matériel dans le dossier platforms contenant le fichier mageia4arm.cfg comprennant les informations relatif à la distribution Mageia, le fichier second_stage_install.sh qui vient installer le système, le fichier specialFunctions.sh qui implémentes les fonctions pour affiner l'installation à la plateforme et extlinux.conf.

mageia4arm.cfg

Un modèle est présent à la source de ce projet. Il contient les variables nécessaire à l'installation de Mageia, comme la version, l'architecture, le mirroir, les mots de passes etc.

second_stage_install.sh

Ce script est lancé avec chroot, ainsi nous pouvons exécuter des opérations personnalisées comme l'installation de paquets non présents des dépots de Mageia. Ce script vient aussi définir les groupes de fichiers.

specialFunctions.sh

Ce script complémente le processus d'installation pour des éléments spécifiques à la plateformes, comme le partitionnement, la manière de mettre en place le chargeur de démarrage, le téléchargements de fichiers externe, etc.
Le script doit implémenter ces quatres fonctions :

function preImgCreation() { 
    #Possibilité de télécharger des éléments supplémentaires ici.  
    return 0  
}  
function postPrepareChroot() {  
    #Possibilité de copier des fichiers spécifique à la plateforme avant de lancer le script second_stage_install.sh.  
    return 0  
}  
function burningBootloader() {  
    #Plusieurs méthodes sont possibles pour flasher le chargeur de démarrage, et dépendent de la plateforme.  
    return 0  
}  
function copyingCustomSystem() {  
    #Possibilité de copier des fichiers dans le système monté.  
    return 0  
}  

Si l'une de ces fonctions ne retourne pas 0, la création de l'image échoue.

extlinux.conf

???

Autres

Bien sûr, d'autres fichiers sont nécessaires. Il faut avoir l'arborescence du matériel (soit DTB/DTS, soit script.bin), le chargeur de démarrage spécifique à la plateforme ainsi qu'un noyau compatible avec l'architecture de la plateforme.

Extras :

Diverses informations complémentaires.

Graver une image

Il est possible de graver l'image avec dd, souvent les cartes SD sont disponibles sous le nom mmcblkX avec X leurs numéros.

dd if=./build/Mageia-7-bananaPro1.img of=/dev/mmcblkX

On peut ajouter une barre de progression :

dd if=./build/Mageia-7-bananaPro1.img | pv -s $(ls -l ./build/Mageia-7-bananaPro1.img | cut -d ' ' -f 5) | dd of=/dev/mmcblkX

Compresser une image

Pour compresser l'image, de plusieurs Go en quelques centaines de Mo pour la mettre en ligne par exemple, il est possible d'exécuter la commande suivante :

dd if=./build/Mageia-7-bananaPro1.img | gzip -9 | dd of=./build/Mageia-7-bananaPro1.img.gzip

Avec une barre d'avancement :

dd if=./build/Mageia-7-bananaPro1.img | pv -s $(ls -l ./build/Mageia-7-bananaPro1.img | cut -d ' ' -f 5) | gzip -9 | dd of=./build/Mageia-7-bananaPro1.img.gzip

Il est possible d'utiliser d'autre logiciel de compression comme xz par exemple.

Calculer les sommes de contrôles

Pour s'assurer qu'un fichier a été bien téléchargé, pour vérifier son intégrité, il est d'usage de comparer la somme de contrôle. On peut la calculer avec l'algorithme MD5, SHA1, SHA256, SHA512. Par exemple :

cd /home/user/workspace/mageia4arm/build
md5sum Mageia-7-bananaPro1.img > Mageia-7-bananaPro1.img.md5

Il est possible de remplacer la commande md5sum par sha1sum ou sha256sum ou encore sha512sum.

Signer les sommes de contrôles

Pour assurer les utilisateurs que le fichier téléchargé vient bien de vous et non d'un tiers malveillant, il est possible de signer la somme de contrôle avec votre clef.

cd /home/user/workspace/mageia4arm/build
gpg --sign Mageia-7-bananaPro1.img.md5

La commande génère automatiquement le fichier de signature reprenant le nom du fichier à l'identique et ajoutant l'extension .gpg.

Vérifier les sommes de contrôles

Pour vérifier une somme de contrôle, il faut joindre le créateur de l'image, lui faire confiance, ajouter sa clef à son trousseau de clef. Ensuite, il est possible d'exécuter la commande suivante :

cd /home/user/Téléchargements/
gpg --verify Mageia-7-bananaPro1.img.md5

Étendre la partition

L'image créé peut contenir une partition root très réduite. Ceci permet d'économiser de la place pour la construction, le stockage de l'image et sûrtout un temps réduit pour graver l'image sur une carte sd. Il est possible d'étendre cette partition pour profiter pleinement de l'entièreté de la carte SD. Le plus simple est avec l'utilitaire growpart dans le paquet cloud-utils-growpart. Les valeurs X et Y sont à remplacer par le périphérique et la dernière partition du périphérique à étendre.

#Vérifier la partition, il peut être demandé pour l'étape suivante.
e2fsck -f /dev/mmcblkXpY

#Défini la nouvelle taille. (Change de langue avec LC_ALL car growpart ne supporte pas 'octet'.
LC_ALL=C growpart /dev/mmcblkX partitionNumber

#Change la taille
resize2fs /dev/mmcblkXpY

#Synchronise, vide le cache USB et assure que les données sont sur la clef.
sync

English

Description:

This repository contains script to make image for arm based systems from Mageia repositories.

Quick start:

Choose the config dir you need (rpi or xu4), else create a new config directory with "mageia4arm.cfg.template" in and modify it as you need.
By default username is "pi" with password "raspberry" and root password is "piroot".

create_arm_img_urpmi.sh --all --config
Example given :

su -
<root password>
cd /home/user/workspace/mageia4arm/
./create_arm_img_urpmi.sh --all --target bananaPro --size 4 --tainted --nonfree --build-path ./build --config bananaPro 2>&1 | tee -a ./build.log

With such command, all steps of the build process for the bananaPro will be executed. The final image will fit into a 4 GB SD card. The nonfree and tainted repositories will be activated. The build path will be the directory ./build. Finaly, the configuration is for bananaPro. The rest of the command, 2>&1 redirect the stderr stream into the stdout and it will be duplicated inside the build.log file for debug purpose.

Help:

create_arm_img_urpmi.sh -h|--help

you can adapt the script "second_stage_install.sh" to complete the installation.
Some scripts are available in directory "tools". they are copied in /usr/local/bin/ in the image.

First launch of the image on raspberry pi:

  • launch drakkeyboard to configure keyboard layout.
  • if you need a graphical environment, launch the script :
    install_graphical.sh <graphical environment> ( xfce, lxqt, plasma, ...), see "Graphical environment" in the Mageia application manager meta packages.

Adding a new platform:

To add a new platform, a new folder needs to be created in the platforms directory with the name of the platform containing the mageia4arm.cfg configuration file about the Mageia distribution itself, the second_stage_install.sh script which install the system, the specialFunctions.sh script which implements functions in order to fit the platform and the extlinux.conf file.

mageia4arm.cfg

A template file is located in the root of the project. It contains all necessary variables for the installation of Mageia, as the version, architecture, mirroir, password etc.

second_stage_install.sh

This script is launched with chroot, then we can execute custom operation as installing packages that are not from Mageia.org. This script also defines some files groups.

specialFunctions.sh

This script add into the installation process some elements specific to the platform, as the partitionning, the fashon to set the bootloader, downloading external files, etc.
It must implement the four next functons :

function preImgCreation() {
    #Here it is possible to download external file.
    return 0
}
function postPrepareChroot() {
    #Possibility to copy/paste platform related files before to launch the second_stage_install.sh script.
    return 0
}
function burningBootloader() {
    #There are several methods to flash the bootloader and depend on the platform.
    return 0
}
function copyingCustomSystem() {
    #It is possible to copy files into the mounted system.=
    return 0
}

If one of this functions does not return 0, the process is stoped.

extlinux.conf

???

others

Of course, other files are necessary. The device tree (DTB/DTS or script.bin) is necessary, a specific bootloader for the platform and a compatible kernel with that architecture.

extras:

Not translated.