YunoHost/doc
1
0
Fork 0
mirror of https://github.com/YunoHost/doc.git synced 2024-09-03 20:06:26 +02:00
Code Issues Projects Releases Packages Wiki Activity

Remove doc on olinuxino (to be replaced by generic ARM board page)

Browse source
This commit is contained in:
Alexandre Aubin 2018-06-26 19:59:41 +02:00
parent 30469308fe
commit 762a0e6cd1
9 changed files with 5 additions and 237 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

1
admindoc.md
View file

@ -11,7 +11,6 @@
* [On a regular computer](/install_iso)
* [On a dedicated or a virtual private server](/install_on_vps)
* [On a Raspberry Pi](/install_on_raspberry)
* [On an OLinuXino board](/install_on_olinuxino)
* [On an ARM board](/install_on_arm_board)
* [On Debian](/install_on_debian)
* [On VirtualBox](/install_on_virtualbox)

3
admindoc_fr.md
View file

@ -9,9 +9,8 @@
* [À propos des fournisseurs d'accès internet](/isp_fr)
* [Guide d’installation](/install_fr)
* [Sur un ordinateur "standard"](/install_iso_fr)
* [Sur un serveur dédié](/install_on_vps_fr)
* [Sur un serveur dédié ou virtuel (VPS)](/install_on_vps_fr)
* [Sur un Raspberry Pi](/install_on_raspberry_fr)
* [Sur une carte OLinuXino](/install_on_olinuxino_fr)
* [Sur une carte ARM](/install_on_arm_board_fr)
* [Sur Debian](/install_on_debian_fr)
* [Sur VirtualBox](/install_on_virtualbox_fr)

6
install.md
View file

@ -33,16 +33,12 @@ This page lists a few installation guides.
<div class="row">
<div class="col col-md-3 text-center">
<a href="/install_on_olinuxino"><img src="/images/olinuxino.jpg" height=150 style="vertical-align:bottom"><b><p>On an OlinuXino (Internet Cube)</p></b></a>
</div>
<div class="col col-md-3 text-center">
<a href="/install_on_raspberry"><img src="/images/raspberrypi.jpg" height=150 style="vertical-align:bottom"><b><p>On a Raspberry Pi</p></b></a>
</div>
<div class="col col-md-3 text-center">
<a href="/install_on_arm_board"><img src="/images/cubieboard2.png" height=150 style="vertical-align:bottom"><b><p>On an ARM board</p></b></a>
<a href="/install_on_arm_board"><img src="/images/olinuxino.jpg" height=150 style="vertical-align:bottom"><b><p>On an ARM board</p></b></a>
</div>
<div class="col col-md-3 text-center">

4
install_ar.md
View file

@ -31,10 +31,6 @@
<div class="row">
<div class="col col-md-3 text-center">
<a href="/install_on_olinuxino_fr"><img src="/images/olinuxino.jpg" height=150 style="vertical-align:bottom"><b><p dir="rtl">على بطاقة أولينوكسينو (Brique Internet)</p></b></a>
</div>
<div class="col col-md-3 text-center">
<a href="/install_on_raspberry_fr"><img src="/images/raspberrypi.jpg" height=150 style="vertical-align:bottom"><b><p>على راسبيري باي</p></b></a>
</div>

6
install_fr.md
View file

@ -28,16 +28,12 @@ Cette page liste plusieurs types d’installations, classés par catégories.
<div class="row">
<div class="col col-md-3 text-center">
<a href="/install_on_olinuxino_fr"><img src="/images/olinuxino.jpg" height=150 style="vertical-align:bottom"><b><p>Sur une carte OlinuXino (Brique Internet)</p></b></a>
</div>
<div class="col col-md-3 text-center">
<a href="/install_on_raspberry_fr"><img src="/images/raspberrypi.jpg" height=150 style="vertical-align:bottom"><b><p>Sur un Raspberry Pi</p></b></a>
</div>
<div class="col col-md-3 text-center">
<a href="/install_on_arm_board_fr"><img src="/images/cubieboard2.png" height=150 style="vertical-align:bottom"><b><p>Sur une carte ARM</p></b></a>
<a href="/install_on_arm_board"><img src="/images/olinuxino.jpg" height=150 style="vertical-align:bottom"><b><p>On an ARM board</p></b></a>
</div>
<div class="col col-md-3 text-center">

111
install_on_olinuxino.md
View file

@ -1,111 +0,0 @@
# Install on an OlinuXino board
<div class="alert alert-info" markdown="1">
The simplest way to install YunoHost on an OLinuXino board is to use the image provided by the [*Internet Cube project*](http://labriqueinter.net). It's an image specifically designed for the OLinuXino boards.
</div>
<div class="alert alert-warning" markdown="1">
If you aim to setup a full Internet Cube (OLinuXino boad + YunoHost + VPN from neutral ISP + Wifi access point), you should contact your [local associative ISP](https://internetcu.be/#obtenir-une-brique), the Internet Cube really advice **against** installing it yourself. If you still really want to do it by yourself, you can try [the install procedure on the Internet Cube project website](https://install.labriqueinter.net).
It is recommended to read about the [advantages of using a neutral VPN in the context of self-hosting](/vpn_advantage) and to contact your local associative ISP (if you have one).
</div>
## Prerequisites
* One of these OLinuXino boards
* [A20-OLinuXino-LIME](https://www.olimex.com/Products/OLinuXino/A20/A20-OLinuXino-LIME/open-source-hardware)
* [A20-OLinuXino-LIME2](https://www.olimex.com/Products/OLinuXino/A20/A20-OLinuXino-LIME2/open-source-hardware)
* A Micro-SD card ([Transcend 300x](https://www.amazon.com/Transcend-MicroSDHC-Class10-Adapter-TS32GUSDU1/dp/B00APCMMDG/) show good performance and stability).
* A power supply ([european one](https://www.olimex.com/Products/Power/SY0605E/)) for the board. (Supply through a USB cable is not stable.)
* An ethernet/RJ-45 cable to connect the board to your internet box / router.
To prepare the SD card, a computer with GNU/Linux or BSD is preferable. You should be able to follow the same instructions on MacOS/OSX. On Windows, you will need to use the tool decribed [here](/copy_image).
---
## Download the image
Download the image ([LIME1](http://repo.labriqueinter.net/labriqueinternet_A20LIME_latest_jessie.img.tar.xz) or [LIME2](http://repo.labriqueinter.net/labriqueinternet_A20LIME2_latest_jessie.img.tar.xz)), check its integrity (*MD5 checksum*), and uncompress it :
```bash
cd /tmp/
# Download image
wget https://repo.labriqueinter.net/labriqueinternet_A20LIME_latest_jessie.img.tar.xz
# Integrity check (optionnal, but recommended)
wget -q -O - https://repo.labriqueinter.net/MD5SUMS | grep "labriqueinternet_A20LIME_latest_jessie.img.tar.xz$" > MD5SUMS
md5sum -c MD5SUMS
# Uncompress image
tar -xf labriqueinternet_*.img.tar.xz
mv labriqueinternet_*.img labriqueinternet.img
```
## Copy image to SD card
1. Identify the name of the card :
- Make sure the SD card is *not* plugged in the computer
- Run the command `ls -1 /sys/block/`
- Insert the SD card in the computer (maybe
- Run the command `ls -1 /sys/block/` again
- The name of your card (SDNAME) is the one present in the what's returned in the second command but not in the first. It's usually something like `sdb` or `mmcblk0`.
2. Copy the image to your card (replace SDNAME by the name of your card, found in the previous step). Command will take a while.
```bash
sudo dd if=/tmp/labriqueinternet.img of=/dev/SDNAME bs=1M status=progress
sync
```
## Plug and boot
Insert the card in the OLinuXino board, connect it to your router with the Ethernet cable, and plug the power supply. Your board will boot (give it a few seconds) and the LEDs around the Ethernet port should start blinking.
<div class="alert alert-warning" markdown="1">
The first boot can take a little more than one minute because the partition is being resized and the board rebooted automatically.
</div>
## Find the local IP of your server
Get the local IP of your OLinuXino board :
* either using `sudo arp-scan --local | grep -P '\t02'` ;
* either using the router interface by listing the DHCP clients ;
* either by pluging an HDMI screen on the OLinuXino, logging in and typing `ifconfig`.
<div class="alert alert-info" markdown="1">
In the following commands, we refer to the board's IP with **192.168.x.y**. You should replace it with the local IP you found.
</div>
## Connect through SSH and change root password
Connect to your server with
```bash
ssh root@192.168.x.y
```
The default password is **olinux**.
After connecting, you will be asked to changed the root password. First, enter **olinux** *again* (current password), then type the new password two times.
## Update your server
Update your server with the following commands. It can take around 15 minutes.
```bash
apt update && apt dist-upgrade
```
## Proceed to post-installation
Proceed to [post-installation](/postinstall) by connecting with your browser to https://192.168.x.y (you browser will warn you about the certificate being self-signed, but you can add/accept the certificate exception).
<div class="alert alert-info" markdown="1">
**Note :** it is also possibled to do the post-installation step through command line in SSH, with `yunohost tools postinstall`.
</div>
## (Optional) Install DoctorCube
If you want to benefit automatically from fixes and configuration specific to the Internet Cube, you can install the DoctorCube app.
1. Add the Internet Cube repository :
```bash
yunohost app fetchlist -n labriqueinternet -u https://labriqueinter.net/apps/labriqueinternet.json
```
2. In the web administration interface, click on "Applications", then install the DoctorCube app. The installation can be pretty long, but you can leave the page anyway.

107
install_on_olinuxino_fr.md
View file

@ -1,107 +0,0 @@
# Installation sur une carte OlinuXino
<div class="alert alert-info" markdown="1">
Pour installer YunoHost sur une carte OLinuXino, le plus simple est d'utiliser l'image du projet [Site du projet *La Brique Internet*](http://labriqueinter.net). Il s'agit d'une image YunoHost qui est actuellement spécifiquement destinée aux cartes OLinuXino.
</div>
<div class="alert alert-warning" markdown="1">
Si vous souhaitez mettre en place ou obtenir une Brique Internet complète (Carte Olimex + YunoHost + VPN associatif neutre + Hotspot Wifi), nous vous conseillons de contacter [le FAI associatif le plus proche de chez vous](https://labriqueinter.net/#obtenir-une-brique), la Brique Internet déconseillant **fortement** de faire l'installation vous-même. Si vous voulez néanmoins le faire, vous pouvez utiliser [la procédure d'installation du projet La Brique Internet](https://install.labriqueinter.net).
Pour faire votre choix, nous vous conseillons de rencontrer votre FAI associatif local et de consulter [les avantages d'un VPN neutre dans le cadre de l'auto-hébergement](/vpn_advantage_fr).
</div>
## Prérequis
Le matériel nécessaire :
* Un mini-serveur Olimex :
* [A20-OLinuXino-LIME](https://www.olimex.com/Products/OLinuXino/A20/A20-OLinuXino-LIME/open-source-hardware)
* [A20-OLinuXino-LIME2](https://www.olimex.com/Products/OLinuXino/A20/A20-OLinuXino-LIME2/open-source-hardware)
* Une carte micro-SD (des [Transcend 300x](http://www.amazon.fr/Transcend-microSDHC-adaptateur-TS32GUSDU1E-Emballage/dp/B00CES44EO) pour des raisons de performance/stabilité).
* Un adaptateur secteur [européen](https://www.olimex.com/Products/Power/SY0605E/) pour alimenter la carte olimex. L’alimentation via USB semble peu stable.
* Un câble Ethernet/RJ-45 pour brancher la Brique à son routeur.
Pour préparer la carte SD, un ordinateur sous GNU/Linux ou BSD est préférrable. Vous devriez pouvoir suivre les mêmes instructions avec MacOS/OSX. Sous Windows, il vous faudra utiliser l'outil décrit [ici](/copy_image_fr).
---
## Télécharger l’image
Télécharger l’image ([lime1](http://repo.labriqueinter.net/labriqueinternet_A20LIME_latest_jessie.img.tar.xz) ou [lime2](http://repo.labriqueinter.net/labriqueinternet_A20LIME2_latest_jessie.img.tar.xz)), vérifier son intégrité (somme de contrôle MD5), puis la décompresser :
```bash
cd /tmp/
# Télécharger l'image
wget https://repo.labriqueinter.net/labriqueinternet_A20LIME_latest_jessie.img.tar.xz
# Vérifier l'intégrité (optionel, mais recommandé)
wget -q -O - https://repo.labriqueinter.net/MD5SUMS | grep "labriqueinternet_A20LIME_latest_jessie.img.tar.xz$" > MD5SUMS
md5sum -c MD5SUMS
# Décompresser l'image
tar -xf labriqueinternet_*.img.tar.xz
mv labriqueinternet_*.img labriqueinternet.img
```
## Copier l’image sur la carte SD
1. Identifier le nom de la carte micro-SD :
- Assurez-vous que la carte n'est *pas* insérée dans l'ordinateur
- Tapez `ls -1 /sys/block/`
- Insérez la carte
- Retaper `ls -1 /sys/block/`
- Le nom de la carte correspond au nom qui apparaît en plus dans la deuxième commande. Il s'agit généralement de quelque chose comme `sdb` ou `mmcblk0`.
2. Copier l’image sur la carte (remplacer *SDNAME* par le nom trouvé lors de l’étape précédente). La copie peut prendre un certain temps.
```bash
sudo dd if=/tmp/labriqueinternet.img of=/dev/SDNAME bs=1M status=progress
sync
```
## Brancher & démarrer
Insérer la carte micro-SD dans la carte OLinuXino, connecter la carte OLinuXino à votre routeur avec le câble Ethernet, puis brancher l’alimentation. La carte démarre normalement toute seule, et les LEDs du port Ethernet se mettent à clignoter au bout de dix secondes maximum.
<div class="alert alert-warning" markdown="1">
Le premier démarrage peut prendre un peu plus d’une minute car la partition est redimensionnée et le serveur est redémarré automatiquement.
</div>
## Trouver l'ip locale de votre mini-serveur
Récupérer l’adresse IP locale :
* soit avec une commande comme `sudo arp-scan --local | grep -P '\t02'`;
* soit via l’interface du routeur listant les clients DHCP ;
* soit en branchant un écran en HDMI au mini-serveur, et en exécutant `ifconfig`.
<div class="alert alert-info" markdown="1">
Pour les commandes suivantes, nous allons utiliser **192.168.x.y** pour désigner l'IP du serveur. Remplacez-la par l’adresse IP déterminée précédemment.
</div>
## Changer le mot de passe root en se connectant en SSH
Se connecter en SSH en root au mini-serveur, le mot de passe par défaut est **olinux** :
```bash
ssh root@192.168.x.y
```
À la première connexion, il sera demandé de changer le mot de passe : entrer à nouveau **olinux**, puis saisir deux fois le nouveau mot de passe.
## Mettre à jour le serveur
Mettre à jour le système (environ 15 minutes) :
```bash
apt update && apt dist-upgrade
```
## Procéder à la postinstallation
Procéder à la [postinstallation](/postinstall_fr) en se connectant à la carte avec votre navigateur web sur https://192.168.x.y (votre navigateur vous avertira que le certificat est auto-signé, ceci est normal : vous pouvez ajouter une exception de sécurité pour ce certificat).
<div class="alert alert-info" markdown="1">
**Note :** il est également possible de réaliser la post-installation en ligne de commande via SSH en exécutant `yunohost tools postinstall`.
</div>
## (Optionel) Installer DoctorCube
Si vous souhaitez bénéficier automatiquement des corrections de l'image du projet La Brique Internet, vous pouvez installez l'application dédiée DoctorCube.
1. Ajoutez le dépôt d'application du projet La Brique Internet
```bash
yunohost app fetchlist -n labriqueinternet -u https://labriqueinter.net/apps/labriqueinternet.json
```
2. Dans l'administration web, cliquez sur la catégorie "Applications", puis installez l'application DoctorCube qui fournie des configurations et des fixs spécifiques à la brique. L'installation de DoctorCube peut prendre de nombreuses minutes. Vous n'êtes pas obligé de rester sur la page web.

2
ssh.md
View file

@ -24,7 +24,7 @@ Assuming your IP address is `111.222.333.444`, open a terminal and enter :
ssh root@111.222.333.444
```
A password will be asked. If this is a VPS, your VPS provided should have communicated you the password. On a fresh Raspberry Pi, the password should be `yunohost`. For an OLinuXino, this should be `olinux`.
A password will be asked. If this is a VPS, your VPS provided should have communicated you the password. If you used a pre-installed image (for x86 computer or ARM board), the password should be `yunohost`.
#### Change the password!

2
ssh_fr.md
View file

@ -24,7 +24,7 @@ En supposant que votre adresse IP est `111.222.333.444`, ouvrez un terminal et t
ssh root@111.222.333.444
```
Un mot de passe sera demandé. Si c'est un VPS, votre fournisseur devrait également vous avoir communiqué un mot de passe. Sur un Raspberry Pi, le password devrait être `yunohost`. Sur un OLinuXino, cela devrait être `olinux`.
Un mot de passe sera demandé. Si c'est un VPS, votre fournisseur devrait également vous avoir communiqué un mot de passe. Si vous avez utilisé une image pré-installée (pour x86 ou cartes ARM), le password devrait être `yunohost`.
#### Changer le mot de passe root !