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

Les deux révisions précédentesRévision précédente
Prochaine révision		Révision précédente
Prochaine révisionLes deux révisions suivantes
fr:cube:install [2021/06/20 14:29] – [Trouvez la brique sur le réseau] raw url hgofr: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 67: Ligne 65:
 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]] 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]]
  
-Ainsi, pour une 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 
 +``` 
 + 
 +Importez la clé GPG de Yunohost: 
 +```bash 
 +gpg --keyserver keyserver.ubuntu.com --recv-keys 1904C5B42E4856DCD4E9CF96360AAF3259A3E6FF 
 +``` 
 + 
 +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: Décompressez l'image de Yunohost:
 ```bash ```bash
-gunzip internetcube_4.1.7.1_v2021.02_lime.img.gz+gunzip internetcube-buster-4.1.7.4_v2021.04.01-lime2-stable.img.gz
 ``` ```
  
 ### Flashez la carte SD ### 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]]
  
 D'abord, trouvez le nom de votre carte SD : D'abord, trouvez le nom de votre carte SD :
Ligne 87: Ligne 102:
 Installez l'image sur votre carte SD (toutes les données contenues par la carte SD seront perdues) :  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!
  
 Retirez la carte SD de votre ordinateur lorsque c'est fait. Retirez la carte SD de votre ordinateur lorsque c'est fait.
Ligne 103: Ligne 119:
 ### Démarrez-là  ### Démarrez-là 
  
-- Connectez le câble d'alimention à la brique pour la démarrer. +- 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. - Attendez quelques minutes que la brique démarre et se connecte au réseau.
  
Ligne 113: Ligne 129:
  
 ```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
 ``` ```
- 
-Le script peut-être téléchargé ici : [[https://raw.githubusercontent.com/labriqueinternet/install.labriqueinter.net/master/install-sd.sh]] 
  
 Le résultat doit ressembler à ceci :  Le résultat doit ressembler à ceci : 
- 
 ``` ```
-Internet Cubes found on the network: +192.168.1.46
- +
-  1. YunoHost Admin:    https://192.168.1.46 +
-     SSH Access:        ssh root@192.168.1.46 +
-     HyperCube Debug:   http://192.168.1.46:2468/install.html+
 ``` ```
  
-Dans cet exemple, l'adresse IP de la brique sur le réseau local est : 192.168.1.46+Ces adresses IPs sont celles des briques internet connectées sur le réseau local.
  
-Si le script ne trouve pas votre brique, essayer quelquez minutes plus tard.+Si le script ne trouve pas votre brique, essayez quelques minutes plus tard.
  
-## Effectuez la post-installation de Yunohost+## Démarrer l'installateur de la brique internet
  
 Connectez vous sur : https://192.168.1.46 Connectez vous sur : https://192.168.1.46
-(Merci de remplacer 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)+(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)
  
-Démarrez la post-installation de Yunhost et définissez : +Fournissez les détails suivants : 
   * Le domaine principal de la brique   * Le domaine principal de la brique
-  * Le mot de passe admin +  * Le nom du premier utilisateur 
-Vous serez en mesure de changer le mot de passe admin ultérieurement si vous le souhaitez. +  * 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)
  
-Si votre domaine est quelque chose comme brique.votredomaine.tld et que vous souhaitez ajouter votredomaine.tld comme second domaine, ajoutez-le maintenant avant de passer à la création du premier utilisateur. +Vous serez en mesure de changer vos mots de passe ultérieurement si vous le souhaitez. 
  
-### Créez votre premier utilisateur  
  
-Dans le panel d'administration, allez dans la rubrique "Utilisateurs" et créez le premier utilisateur en définissant : +### Installez l'application Neutrinet
-  * Nom d'utilisateur +
-  * Prénom +
-  * Nom +
-  * Mot de passe +
-Cet utilisateur sera un peu spécial puisqu'il recevra aussi les mails envoyés à l'adresse root@domain.tld.+
  
-### Installez le client VPN+Vos identifiants VPN seront valides pendant une année.
  
-Dans le panel d'administration, allez dans la rubrique Application et cliquez sur le bouton "+Installer.+Connectez-vous en SSH à votre brique : 
 +```bash 
 +ssh admin@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)
  
-Recherchez l'application 'VPN Client' et installez-là.+Installez l'application Neutrinet pour Yunohost qui renouvellera automatiquement les certificats avant leur expiration: 
 +```bash 
 +sudo yunohost app install neutrinet 
 +``` 
 +Vous pouvez laisser les valeurs par défaut.
  
-Copiez le fichier .cube que vous avez généré précédemment sur la brique. Depuis votre machine, exécutez :+## Configurez les enregistrements DNS pour votre domaine :  
 + 
 +Voir [cette page](dns). 
 + 
 + 
 +## Configurez l'IPv6 pour le Wifi Hotspot 
 + 
 +Si vous avez installé le Wifi hotspot, une étape supplémentaire est nécessaire pour configurer l'IPv6. 
 + 
 +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. 
 + 
 +Affichez les détails de votre client VPN en cliquant sur l'entrée avec votre adresse email.  
 + 
 +Vous devriez voir un champ `IPv6 subnet lease` (la ligne avec un range IPv6 `/64`).  
 + 
 +Il se peut que vous n'ayez pas encore de sous-réseau IPv6.  
 +Dans ce cas, cliquez sur `Modify IP lease assignment`. 
 + 
 +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 : 
  
 ```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.
 ``` ```
-(Merci de remplacer 192.168.1.46 par l'IP de votre brique découverte précédemment.) Le mot de passe admin de votre brique est le même que celui choisi pour le panel d'administration.  
  
-Connectez-vous à votre brique via SSH en tant qu'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
 ``` ```
  
-Configurez le client VPN : +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
 ``` ```
-(Merci de remplacer raoul et neutrinet par le nom et le mot de passe du premier utilisateur.)  
  
-Vérifiez que votre brique est connectée au VPN :  +Et répondez oui aux questions.
-- Exécutez un 'ip a' depuis la brique et vérifiez qu'elle dispose d'une interface `tun0`. +
-- Connectez-vous à cette IP depuis votre navigateur internet.+
  
-### Installez l'application Neutrinet+#### L'installation du VPN échoue
  
-Vos identifiants VPN seront valides pendant une année.Installez l'application Neutrinet pour Yunohost qui renouvellera automatiquement les certificats avant leur expiration. +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 :
  
 ```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.
 ``` ```
-Vous pouvez laisser les valeurs par défaut. 
  
-## Configurez les enregistrements DNS pour votre domaine : +Connectez vous à votre brique internet avec le compte admin : 
 +```bash 
 +ssh admin@192.168.1.46 
 +```
  
-Voir [cette page](dns).+Entrez votre mot de passe d'administration.
  
-## Troubleshootings+Ensuite, lancez la commande qui a échoué :
  
-### Problèmes avec `/tmp` dans la RAM+```bash 
 +sudo ynh-vpnclient-loadcubefile.sh -u "<username>" -p "<password>" -c /tmp/config.cube 
 +``` 
 + 
 +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/) 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/)
Ligne 206: Ligne 298:
 ```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
 ``` ```
 +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 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