Banana Pro
==========
Short
-----
* [English](#English)
* [Français](#Francais)
English
-------
### Introduction
Single board computers have many architectures, any of them have their own way to boot and it becomes impossible to standardise the process, therefore impossible to offer one live image of Mageia before an installer software.
But, it is possible to fashion one image of an installation and to distribute it, with the drawback it brings, one pre-defined password for root, a first predefined user and its password, and other configurations to do manually.
It order to win time for downloading the image and to fit any micro-sd card, the image have been reduce to a minimum, but in order to take benefits of using the whole sd-card, it is possible to extend the main partition.
### Burning image
In function of the used device on your personnal computer, one micro-sd card can be accessible under different names, *generally* under \/dev/mmcblo0` and is only by root in write-access.
In order to burn the image, one command line is necessary.
```
dd if=./Mageia-7-bananaPro1.img of=/dev/mmcblk0
```
The process could be long and seems to be blocked, but it is normal. We can add the progress bar with the `pv` command (from the `pv` package). The command to brun the image is different.
```
dd if=./Mageia-7-bananaPro1.img | pv -s $(ls -l ./Mageia-7-bananaPro1.img | cut -d ' ' -f 5) | dd of=/dev/mmcblk0
```
### Extending the partition
The Mageia's image for the Banana Pro has two storage area, one in an non-partitionned space at the beginning of the image containing the bootloader uboot, and a second area, the first and unique partition in a ext4 format containing the root.
It is possible to extend this partition to fit the whole SD-card, first, it is necessary to install the package `cloud-utils-growpart`.
```
e2fsck -f /dev/mmcblk0p1
LC_ALL=C growpart /dev/mmcblk0 1
resize2fs /dev/mmcblk0p1
sync
```
### First connexion and credentials
For the first connexion, it is recommanded to connect to the Banana Pro with a serial link in order to configure ssh, after, it will be possible to connect through the network.
The `root` password is `ProR00t` by default, there is a first user named `banana` and its password is `bananaPro`.
It is _RECOMMANDED_ to delete this user by default and to change the root password, both for safety reasons.
Français
--------
### Introduction
Les ordinateurs monocartes (SBC pour Single Board Computer) ont diverses architectures, chacunes ont leur propre manière de démarrer et il devient ainsi impossible de standardiser le processus, donc impossible de fournir une image Mageia en version Live puis passer par un installeur.
Cependant, il est possible de façonner une image d'une installation puis la distribuer, avec les inconvénients que ça apporte, un mot de passe root prédéfini, un premier utilisateur avec un mot de passe prédéfini, ainsi que d'autres configurations à effectuer manuellement.
Pour gagner en temps de téléchargement, l'image a réduite, pour profiter pleinement de l'entièreté de votre carte sd, il est possible d'étendre la partition.
### Graver l'image
En fonction du périphérique utilisé sur l'ordinateur, une carte micro-sd peut être accessible sous différentes appellations, *généralement* sous `/dev/mmcblk0` et est accessible en écriture par l'utilisateur root.
Pour graver l'image, il suffit de taper une seule ligne.
```
dd if=./Mageia-7-bananaPro1.img of=/dev/mmcblk0
```
Le processus peut paraitre long, voire bloqué, or il n'en est rien. On peut rajouter une barre de progresser grâce à la commande `pv` (du paquet `pv`). La commande pour graver l'image change.
```
dd if=./Mageia-7-bananaPro1.img | pv -s $(ls -l ./Mageia-7-bananaPro1.img | cut -d ' ' -f 5) | dd of=/dev/mmcblk0
```
### Étendre la partition
L'image de Mageia pour Banana Pro comporte deux zones de stockage, une dans un espace non partitionné au début de l'image contenant uboot, et une seconde zone, la première et unique partition au format ext4 contenant la racine.
Il est possible d'étendre cette partition et profiter de l'entièreté de la carte SD, préallablement il faut avoir le paquet `cloud-utils-growpart` d'installé.
```
e2fsck -f /dev/mmcblk0p1
LC_ALL=C growpart /dev/mmcblk0 1
resize2fs /dev/mmcblk0p1
sync
```
### Première connexion et identifiants
Pour la première connexion, il est recommandé de se connecter à la Banana Pro avec la liaison sérielle pour configurer ssh et pouvoir par la suite se connecter à travers le réseau.
Il est possible de se connecter en tant que `root` avec le mot de passe par défaut `ProR00t` , il y a un premier utilisateur par défaut nommé `banana` dont le mot de passe est `bananaPro` .
Il est recommandé de supprimer l'utilsateur par défaut ainsi que de modifier le mot de passe root, pour des raisons de sécurité.