Outils pour utilisateurs

Outils du site

Piste :
fr:cube:install

Différences

Ci-dessous, les différences entre deux révisions de la page.

Lien vers cette vue comparative

Prochaine révision		Révision précédente
Prochaine révisionLes deux révisions suivantes
fr:cube:install [2021/06/17 11:41] – créée celofr:cube:install [2022/09/16 13:07] – [Après l'installation] celo
Ligne 1: Ligne 1:
-FIXME **Cette page n'est pas encore traduite entièrement. Merci de terminer la traduction**\\ //(supprimez ce paragraphe une fois la traduction terminée)// 
- 
 # Installation d'une brique # Installation d'une brique
  
-Cette procédure explique comment installer une brique internet et la configurer avec le VPN de Neutrinet.+Cette procédure explique comment installer une brique internet (Olimex [Lime2](https://www.olimex.com/Products/OLinuXino/A20/A20-OLinuXino-LIME2/open-source-hardware) or [lime](https://www.olimex.com/Products/OLinuXino/A20/A20-OLinuXino-LIME/)) et la configurer avec le VPN de Neutrinet.
  
 ## Générer les certificats du VPN  ## Générer les certificats du VPN 
Ligne 43: Ligne 41:
 ## Matériel nécessaire ## Matériel nécessaire
  
-C'est le strict minimul dont vous aurez besoin :+C'est le strict minimum dont vous aurez besoin :
  
-  * un ordintaeur //(préférablement un système Linux/Unix/BSD)// pour effectuer l'installation +  * un ordinateur //(préférablement un système Linux/Unix/BSD)// pour effectuer l'installation 
-  * un A20-OLinuXino-LIME board+  * une board A20-OLinuXino-LIME
   * une carte microSD où le système d'exploitation de la brique (Yunohost/Debian) sera stocké   * une carte microSD où le système d'exploitation de la brique (Yunohost/Debian) sera stocké
-  * une antenne WiFi MOD-WIFI-R5370-ANT (optionelle) +  * une antenne WiFi MOD-WIFI-R5370-ANT (optionnelle) 
-  * un adpatateur 5V DC+  * un adaptateur 5V DC
   * un compte VPN chez Neutrinet   * un compte VPN chez Neutrinet
  
Ligne 61: Ligne 59:
   * Un câble ethernet pour connecter votre brique à votre routeur (par exemple la box internet de votre ISP)   * Un câble ethernet pour connecter votre brique à votre routeur (par exemple la box internet de votre ISP)
  
-## Install Yunohost on the SD Card+## Installer Yunohost sur la carte SD
  
-### Download the Yunohost image+### Télécharger l'image de Yunohost
  
-Download the latest version of Yunohost for internet cubes (Olimex Lime1 or Lime2) from https://yunohost.org/fr/install/hardware:internetcube+Téléchargez la dernière version de Yunohost pour les briques internet (Olimex Lime1 et Lime2) depuis [[https://yunohost.org/fr/install/hardware:internetcube]]
  
-For instance, for a Lime1:+Ainsi, pour une Lime2 : 
 ```bash ```bash
-wget https://github.com/YunoHost/arm-images/releases/download/v2021.02/internetcube_4.1.7.1_v2021.02_lime.img.gz+wget https://build.yunohost.org/internetcube-buster-4.1.7.4_v2021.04.01-lime2-stable.img.gz
 ``` ```
  
-Uncompress the Yunohost image:+Importez la clé GPG de Yunohost:
 ```bash ```bash
-gunzip internetcube_4.1.7.1_v2021.02_lime.img.gz+gpg --keyserver keyserver.ubuntu.com --recv-keys 1904C5B42E4856DCD4E9CF96360AAF3259A3E6FF
 ``` ```
  
-### Flash the SD card+Téléchargez la signature de l'image: 
 +```bash 
 +wget https://build.yunohost.org/internetcube-buster-4.1.7.4_v2021.04.01-lime2-stable.img.gz.sig 
 +``` 
 + 
 +Vérifiez la signature de l'image: 
 +```bash 
 +gpg --verify internetcube-buster-4.1.7.4_v2021.04.01-lime2-stable.img.gz.sig 
 +``` 
 + 
 +Décompressez l'image de Yunohost: 
 +```bash 
 +gunzip internetcube-buster-4.1.7.4_v2021.04.01-lime2-stable.img.gz 
 +``` 
 + 
 +### Flashez la carte SD 
 + 
 +Voyez la documentation de Yunohost pour d'autres méthodes graphiques : [[https://yunohost.org/fr/install/hardware:internetcube#flasher-l-image-image-typee]]
  
-First, find the device name of your SD card:+D'abord, trouvez le nom de votre carte SD :
 ```bash ```bash
 lsblk lsblk
 ``` ```
-Usually, it's `mmcblk0`+Habituellement, c'est `mmcblk0`
  
-Install the image on your SD card (all data on the SD card will be lost).+Installez l'image sur votre carte SD (toutes les données contenues par la carte SD seront perdues) : 
 ```bash ```bash
-sudo dd if=internetcube_4.1.7.1_v2021.02_lime.img of=/dev/mmcblk0 status=progress+sudo dd if=internetcube-buster-4.1.7.4_v2021.04.01-lime2-stable.img of=/dev/mmcblk0 status=progress
 ``` ```
 +:!: Veillez à ce que la carte SD ne soit *pas* montée pendant la copie!
  
-Remove the SD card from your computer when it's done.+Retirez la carte SD de votre ordinateur lorsque c'est fait.
  
-## Start your Cube+## Démarrer votre brique internet 
  
-### Prepare it+### Préparez-la 
 +  * Assurez-vous que la brique ne soit *pas* connectée à une source d'alimentation (par ex. le câble d'alimention ne doit pas être branché)  
 +  * Insérez l'antenne WiFi dans le port USB de la brique. 
 +  * Insérez la carte SD dans votre brique. 
 +  * Connectez votre brique à un câble ethernet connecté à votre routeur (donc à la box internet de votre ISP). 
 +  * Assurez vous que votre ordinateur soit lui aussi connecté (par WiFi ou par câble ethernet) au routeur. (Vous vous connecterez d'abord à la brique par le réseau local.)
  
-- Make sure the Cube is *not* connected to a power source (e.g: the power cable should be unplugged) +### Démarrez-là 
-- Insert the WiFi antenna into the USB port of the Cube's board +
-- Insert the SD card into your Cube +
-- Connect your Cube to an ethernet cable that is connected to your home router (i.e your ISP internet box) +
-- Make sure your computer is connected (via WiFi or ethernet) to your home router too (you will connect to your Cube via the local network)+
  
-### Boot it+- Connectez le câble d'alimentation à la brique pour la démarrer.  
 +- Attendez quelques minutes que la brique démarre et se connecte au réseau.
  
-- Connect the power cable to the Cube to start it +### Trouvez la brique sur le réseau
-- Wait a couple of minutes to let the Cube start and connect to the network+
  
-### Find it on the network+Afin de connecter votre brique au réseau, vous devez trouver son adresses IP sur le réseau local.
  
-In order to connect to your Cube, you need to find its IP address on your local network.+Dans votre terminal, exécutez : 
  
-In your terminal, run: 
 ```bash ```bash
-./install-sd.sh -l+for interface in $(ip link show up | grep "state UP" | cut -d ':' -f 2); do 
 +  sudo arp-scan -l --interface "$interface" | grep -P '\t02' | cut -f 1 
 +done
 ``` ```
  
-The script can be download here : [[https://github.com/labriqueinternet/install.labriqueinter.net/blob/master/install-sd.sh]]+Le résultat doit ressembler à ceci :  
 +``` 
 +192.168.1.46 
 +```
  
-The output should look like this:+Ces adresses IPs sont celles des briques internet connectées sur le réseau local. 
 + 
 +Si le script ne trouve pas votre brique, essayez quelques minutes plus tard. 
 + 
 +## Démarrer l'installateur de la brique internet 
 + 
 +Connectez vous sur : https://192.168.1.46 
 +(Remplacez `192.168.1.46` avec l'adresse IP de votre brique telle qu'elle a été découverte lors de l'étape précédente) 
 + 
 +Fournissez les détails suivants :  
 +  * Le domaine principal de la brique 
 +  * Le nom du premier utilisateur 
 +  * Le mot de passe du premier utilisateur (ce sera également votre mot de passe admin) 
 +  * Votre fichier cube généré dans une des étapes précédentes 
 +  * Les identifiants de votre hotspot Wifi (optionnel) 
 + 
 +Vous serez en mesure de changer vos mots de passe ultérieurement si vous le souhaitez.  
 + 
 + 
 +### Installez l'application Neutrinet 
 + 
 +Vos identifiants VPN seront valides pendant une année. 
 + 
 +Connectez-vous en SSH à votre brique : 
 +```bash 
 +ssh admin@192.168.1.46
 ``` ```
-Internet Cubes found on the network:+(Remplacez `192.168.1.46` avec l'adresse IP de votre brique telle qu'elle a été découverte lors de l'étape précédente)
  
-  1. YunoHost Admin:    https://192.168.1.46 +Installez l'application Neutrinet pour Yunohost qui renouvellera automatiquement les certificats avant leur expiration: 
-     SSH Access:        ssh root@192.168.1.46 +```bash 
-     HyperCube Debug:   http://192.168.1.46:2468/install.html+sudo yunohost app install neutrinet
 ``` ```
 +Vous pouvez laisser les valeurs par défaut.
  
-In this example, the IP address of your Cube on the local network is: +## Configurez les enregistrements DNS pour votre domaine : 
-192.168.1.46+
  
-If the script cannot find your cube, try again a couple of minutes later.+Voir [cette page](dns).
  
-## Run the Yunohost postinstall 
  
-Connect to https://192.168.1.46 +## Configurez l'IPv6 pour le Wifi Hotspot
-(Please replace 192.168.1.46 with the IP address of your Cube found in the previous step)+
  
-Start the Yunohost postinstall and provide: +Si vous avez installé le Wifi hotspot, une étape supplémentaire est nécessaire pour configurer l'IPv6.
-- The main domain name +
-- The admin password +
-You will be able to change the admin password later on if you want.+
  
-### Create the first user+Connectez-vous à https://user.neutrinet.be/ et indiquez les identifiants de votre compte VPN. Vous pourrez les trouver dans votre fichier cube ou dans le fichier `/etc/openvpn/keys/credentials` sur votre brique internet.
  
-In the admin panel, go to Users and create the first user by providing: +Affichez les détails de votre client VPN en cliquant sur l'entrée avec votre adresse email. 
-- username +
-- firstname +
-- lastname +
-- password +
-This user is a bit special because it will be linked to the root@domain.tld mail address.+
  
-### Install the VPN client+Vous devriez voir un champ `IPv6 subnet lease` (la ligne avec un range IPv6 `/64`). 
  
-In the admin panel, go to Applications and click on the Install button.+Il se peut que vous n'ayez pas encore de sous-réseau IPv6.  
 +Dans ce cas, cliquez sur `Modify IP lease assignment`.
  
-Search for `VPN Client` app, then install it.+Ensuite, cliquez sur votre adresse mail, et cliquez sur `Add IPv6 subnet lease`. 
 + 
 +Choisissez un range de 64, et cliquez sur le bouton `Assign`. 
 + 
 +Vous pouvez ensuite retourner dans les détails de votre client VPN pour connaître votre nouveau sous-réseau IPv6. 
 + 
 +Connectez vous à la page d'admin du hotspot Wifi: https://192.168.1.46/wifiadmin/ 
 + 
 +Puis, sous l'onglet `IPv6`, collez le sous-réseau IPv6 dans le champ `delegated prefix`.  
 + 
 +Cliquez sur le boutton `Save and reload` pour appliquer vos changements. 
 + 
 +## Problèmes connus 
 +### Pendant l'installation 
 + 
 +#### Les dépôts de Debian ont changé de stable à old-stable 
 + 
 +Voir aussi [[https://github.com/YunoHost/issues/issues/1852]] 
 + 
 +Au début de l'installation de la brique, l'installation va être interrompue par l'erreur suivante : 
  
-Copy the .cube file you generated earlier. From your machine, run: 
 ```bash ```bash
-scp neutrinet.cube admin@192.168.1.46:/tmp/neutrinet.cube+E: Repository 'http://deb.debian.org/debian buster InRelease' changed its 'Suite' value from 'stable' to 'oldstable' 
 +E: Repository 'http://security.debian.org buster/updates InRelease' changed its 'Suite' value from 'stable' to 'oldstable' 
 +E: Repository 'http://deb.debian.org/debian buster-updates InRelease' changed its 'Suite' value from 'stable-updates' to 'oldstable-updates' 
 +Command 'DEBIAN_FRONTEND=noninteractive APT_LISTCHANGES_FRONTEND=none LC_ALL=C apt-get -o=Acquire::Retries=3 -o=Dpkg::Use-Pty=0 --quiet --assume-yes update &>> ./data/upgrade.logs' returned non-zero exit status 100.
 ``` ```
-(Please replace 192.168.1.46 with the IP address of your Cube found in the previous step) 
-The admin password of your Cube is the same as the one for the admin panel. 
  
-Connect to your Cube via SSH as admin:+Connectez-vous à la brique en SSH avec le compte root : 
 ```bash ```bash
-ssh admin@192.168.1.46+ssh root@192.168.1.46
 ``` ```
  
-Configure the VPN client:+Entrez ''yunohost'' comme mot de passe. 
 + 
 +Ensuite, exécutez : 
 ```bash ```bash
-ynh-vpnclient-loadcubefile.sh -u raoul -c /tmp/neutrinet.cube -p neutrinet+apt update
 ``` ```
-(Please replace raoul and neutrinet with the username and password of the first user) 
  
-Check that your cube is connected to the VPN: +Et répondez oui aux questions.
-- Run `ip a` from the cube and check if there is a `tun0` interface +
-- Connect to the IP in your web browser+
  
-### Install the Neutrinet app+#### L'installation du VPN échoue
  
-Your VPN certificate will be valid for 1 year.+Voici aussi : [[https://github.com/labriqueinternet/install/issues/4]] 
 + 
 +Dans le cas où le mot de passe du compte VPN contient des caractères spéciaux, l'installation échouera avec les erreurs suivantes :
  
-Install the Neutrinet app for Yunohost in order to let the cube automatically renew the certificate before expiration: 
 ```bash ```bash
-sudo yunohost app install neutrinet+Running: yunohost app addaccess vpnclient -u '******' 
 +'yunohost app addaccess' is deprecated and will be removed in the future 
 +'yunohost app addaccess' is deprecated and will be removed in the future 
 +allowed_users:  
 +  vpnclient: ****** 
 +Running: yunohost app setting vpnclient service_enabled -v 1 
 +Running: ynh-vpnclient-loadcubefile.sh -u '******' -p '[REDACTED]' -c /tmp/config.cube 
 +[VPN] Error: Configuration updated but service reload failed 
 +Command 'ynh-vpnclient-loadcubefile.sh -u '******' -p '[REDACTED]' -c /tmp/config.cube &>> ./data/configure_vpnclient.logs' returned non-zero exit status 1.
 ``` ```
-You can keep the default values. 
  
-## Configure the DNS records of your domain+Connectez vous à votre brique internet avec le compte admin : 
 +```bash 
 +ssh admin@192.168.1.46 
 +```
  
-See [this page](dns).+Entrez votre mot de passe d'administration.
  
-## Troubleshootings+Ensuite, lancez la commande qui a échoué :
  
-### Issues with `/tmp` in RAM+```bash 
 +sudo ynh-vpnclient-loadcubefile.sh -u "<username>" -p "<password>" -c /tmp/config.cube 
 +```
  
-By default, the files `/tmp` folder are stored in RAM, which isn't a good idea when you have less than 1Gb available in a cube. See [tmpfs / armbian](https://forum.armbian.com/topic/10977-tmp-gets-eventually-full-how-to-purge-it/)+Remplacez s'il vous plait ''<username>'' et ''<password>'' par vos identifiants. 
 + 
 +:!: Faites attentions à laisser les guillemets. 
 + 
 +Dans l'installateur de la brique internet, réessayer la dernière étape en cliquant sur le boutton jaune. 
 + 
 +#### La barre de chargement freeze 
 + 
 +Si la barre de chargement freeze pendant l'installation, activez le mode débug en appuyant sur le bouton. 
 + 
 +Vous verrez ensuite les détails de l'install et ce que la procédure d'installation est en train de faire. 
 + 
 +#### iptables/nftables ne semble pas fonctionner 
 + 
 +Voir : [[https://chat.neutrinet.be/api/v4/files/3wxxx14t7fg6xjomitpyojk4fy/preview]] 
 + 
 +Ceci est du à une mise à jour du noyau : vous devez juste redémarrer la brique. 
 + 
 +Ensuite connectez-vous à l'installateur de la brique internet et réessayez la dernière étape. 
 + 
 + 
 +### Après l'installation 
 + 
 +#### Problèmes avec /tmp dans la RAM 
 + 
 +Par défaut, les fichiers du dosser '/tmp' sont stockés dans la RAM, ce qui n'est pas une bonne idée si vous avez moins d'un 1Gb de mémoire disponible. Voir [tmpfs / armbian](https://forum.armbian.com/topic/10977-tmp-gets-eventually-full-how-to-purge-it/) 
 + 
 +Vous pouvez désactiver cela en exécutant les commandes suivantes :
  
-You can disable this by running the following: 
 ```bash ```bash
 sudo sed s/^ENABLED=true/ENABLED=false/ /etc/default/armbian-zram-config -i sudo sed s/^ENABLED=true/ENABLED=false/ /etc/default/armbian-zram-config -i
 +sudo sed s/^ENABLED=true/ENABLED=false/ /etc/default/armbian-ramlog -i
 sudo sed 's/^tmpfs/# tmpfs/' /etc/fstab -i sudo sed 's/^tmpfs/# tmpfs/' /etc/fstab -i
 ``` ```
-If you have issues, or maybe you were able to find a fix for an issue, do not hesitate to contact us : https://chat.neutrinet.be+Ensuite, redémarrez le cube: 
 +```bash 
 +sudo reboot 
 +``` 
 + 
 +#### L'installation de Roundcube échoue sur les Lime1 
 + 
 +Roundcube nécessite plus de 500M pour s'installer. Sur les Lime1, il est nécessaire d'ajouter de la swap. Vous pouvez le faire en exécutant les commandes suivantes :  
 + 
 +```bash 
 +sudo fallocate -l 1G /swapfile 
 +sudo chmod 600 /swapfile 
 +sudo mkswap /swapfile 
 +sudo swapon /swapfile 
 +``` 
 +Vous pouvez vérifier la swap disponible :  
 +  
 +```bash 
 +sudo swapon --show 
 +``` 
 + 
 +Ceci doit retourner une ligne à propos de la swap. 
 + 
 +Ensuite, éditez le ichier fstab pour activer la swap au démarrage :  
 + 
 +```bash 
 +sudo nano /etc/fstab 
 +``` 
 + 
 +Ajoutez la ligne :  
 + 
 +```bash 
 +/swapfile none swap sw 0 0 
 +``` 
 + 
 + 
 +Si vous rencontrez d'autres problèmes, ou si vous avez éventuellement trouvé des solutions à des problèmes, n'hésitez pas à nous contacter : https://chat.neutrinet.be
fr/cube/install.txt · Dernière modification : 2023/05/19 15:52 de hgo