diff --git a/README.md b/README.md index bf9f678..04255ea 100644 --- a/README.md +++ b/README.md @@ -1,3 +1,7 @@ +ATTENTION: Le projet a migré sur le git de Mageia : +WARNING: project has migrated on Mageia's git: +http://gitweb.mageia.org/software/mageia4arm/ + mageia4arm ========== @@ -42,31 +46,31 @@ 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". +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_image.sh --all --config \ -Par exemple : +create_arm_image.sh --all --config \ +Par exemple : ``` -su - - -cd /home/user/workspace/mageia4arm/ +su - + +cd /home/user/workspace/mageia4arm/ ./create_arm_image.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_image.sh -h|--help +create_arm_image.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. +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 +- lancer drakkeyboard afin de configurer le clavier - si vous avez besoin d'un gestionnaire graphique, lancer le script :
install_graphical.sh \( xfce, lxqt, plasma, ...) voir les métapaquetages disponibles dans "Environnement graphique" dans le gestionnaire de logiciels. @@ -84,31 +88,31 @@ Ce script est lancé avec chroot, ainsi nous pouvons exécuter des opérations p #### 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 : +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 -} +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 -Extlinux.conf est un script utilisé par le chargeur de démarrage (s'il est capable de le gérer, uboot le peut), pour spécifier la version du noyau à démarrer. Le script est normalement généré automatiquement par les outils de Mageia à chaque installation/mise à jour d'un noyau. Malheureusement, lors de la création d'une image de Mageia en chroot, l'outil refuse de générer ce fichier, de plus si le fichier est manquant, lors de la mise à jour du noyau, l'outil de Mageia génère un fichier erroné avec des entrées vides que u-boot refuse. +Extlinux.conf est un script utilisé par le chargeur de démarrage (s'il est capable de le gérer, uboot le peut), pour spécifier la version du noyau à démarrer. Le script est normalement généré automatiquement par les outils de Mageia à chaque installation/mise à jour d'un noyau. Malheureusement, lors de la création d'une image de Mageia en chroot, l'outil refuse de générer ce fichier, de plus si le fichier est manquant, lors de la mise à jour du noyau, l'outil de Mageia génère un fichier erroné avec des entrées vides que u-boot refuse. Il vaut mieux créer ce fichier, même s'il n'est pas primordiale. D'autant plus que lors de la mise à jour d'un noyau, l'outil de Mageia reprends les arguments de la commande de démarrage pour les nouvelles versions. La structure basique du fichier est : @@ -141,30 +145,30 @@ 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. +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 : +On peut ajouter une barre de progression : ``` pv ./build/Mageia-7-bananaPro1.img | 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 : +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.gz -``` -Avec une barre d'avancement : +``` +Avec une barre d'avancement : ``` pv ./build/Mageia-7-bananaPro1.img | gzip -9 | dd of=./build/Mageia-7-bananaPro1.img.gz -``` -Il est possible d'utiliser d'autre logiciel de compression comme xz par exemple. +``` +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 : +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 @@ -233,16 +237,16 @@ English ### Description: -This repository contains script to make image for arm based systems from Mageia repositories. +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". +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_image.sh --all --config +create_arm_image.sh --all --config Example given : ``` su - @@ -254,14 +258,14 @@ With such command, all steps of the build process for the bananaPro will be exec ### Help: -create_arm_image.sh -h|--help +create_arm_image.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. +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. +- launch drakkeyboard to configure keyboard layout. - if you need a graphical environment, launch the script :
install_graphical.sh \ ( xfce, lxqt, plasma, ...), see "Graphical environment" in the Mageia application manager meta packages. @@ -279,8 +283,8 @@ This script is launched with chroot, then we can execute custom operation as ins #### 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 : +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. @@ -303,7 +307,7 @@ If one of this functions does not return 0, the process is stoped. #### extlinux.conf -extlinux.conf is a script used by the bootloader (if it is able to manage it, uboot does) in order to select specific kernel version to start with boot arguments. This script is normaly automatically generated by Mageia's tools at each kernel installation/update. Unfortunately, when creating the image of Mageia in chroot, the tool refuses to generate the file, moreover, if the file is missing, at the first kernel update, the tool will create it with empty entries which makes uboot failing to parse it. +extlinux.conf is a script used by the bootloader (if it is able to manage it, uboot does) in order to select specific kernel version to start with boot arguments. This script is normaly automatically generated by Mageia's tools at each kernel installation/update. Unfortunately, when creating the image of Mageia in chroot, the tool refuses to generate the file, moreover, if the file is missing, at the first kernel update, the tool will create it with empty entries which makes uboot failing to parse it. It is better to generate this file, even if it isn't mandatory. It is even better as the tool take into account the boot arguments of previous kernel and add it for the new one and regenerate automatically the file. The basic file is: