diff --git a/doc/fr/developpeurs/installer-son-environnement-de-dev.md b/doc/fr/developpeurs/installer-son-environnement-de-dev.md index ef4d6c185ceef949b9cb3dd6eadd5694a1ea3b1e..a525249bfcc84a30befc8198828e35e2bc8f00ba 100644 --- a/doc/fr/developpeurs/installer-son-environnement-de-dev.md +++ b/doc/fr/developpeurs/installer-son-environnement-de-dev.md @@ -77,7 +77,7 @@ Puis éxécutez le script `idea.sh` dans le dossier `/bin` : cd /opt/idea*/bin/ ./idea.sh - + Enfin installez le plugin pour rust en tapant "Rust" dans le moteur de recherche des plugins dans file -> settings -> plugins. [IntelliJ IDEA Community Edition]: https://www.jetbrains.com/idea/ @@ -87,9 +87,10 @@ Enfin installez le plugin pour rust en tapant "Rust" dans le moteur de recherche [Installation de vscode pour debian/ubuntu](https://code.visualstudio.com/docs/setup/linux#_debian-and-ubuntu-based-distributions). Une fois vscode installé nous aurons besoin des 3 plugins suivants : -BetterTOML -CodeLLDB -Rust (rls) + +* BetterTOML +* CodeLLDB +* Rust (rls) Après avoir installé les plugins, relancez votre IDE, il devrait vous proposer spontanément d'installer RLS, dites oui. Si cela échoue pour RLS, vous devrez l'installer manuellement avec la commande suivante : diff --git a/doc/fr/utilisateurs/installer-durs.md b/doc/fr/utilisateurs/installer-durs.md new file mode 100644 index 0000000000000000000000000000000000000000..fabc46a83420836a9f91bfd921fc2f4ac354f7b3 --- /dev/null +++ b/doc/fr/utilisateurs/installer-durs.md @@ -0,0 +1,79 @@ +# Installer DURS sur votre ordinateur + +## Installation simple + +Dans tout les cas vous aurez 3 choix a faire : + +1. Choisir entre durs-server ou durs-desktop +2. Choisir la version de Durs que vous souhaitez installer +3. Choisir le livrable correspondant votre système d'exploitation et votre processeur. + +### `durs-server` ou `durs-desktop` + +`durs-desktop` est destiné aux utilisateurs souhaitant installer Durs sur leur ordinateur personnel et administrer leur noeud Durs via une interface graphique. + +`durs-server` est beaucoup plus léger et se manipule via la ligne de commande. Il est nottament utile dans les cas suivants : + +* Installation de durs sur serveur dédié +* Installation de durs sur micro pc (raspberry pi, brique internet, etc) +* Pour les utilisateurs avancé qui préfèrent la ligne de commande. + +Notez bien : il est possible d'administrer `durs-server` a distance via une interface graphique (voir [administrer un noeud durs a distance]). + +### Choisir la version de Durs a installer + +<s>Rendez vous sur [le site officiel de Durs](durs.info), vous y trouverez un lien direct vers la dernière version stable.</s> + +Le site web de Durs n'existe pas encore, en attendant vous devrez vous renseigenr sur le [forum duniter](forum.duniter.org) pour savoir quelle version installer. + +Vous trouverez toute les versions disponibles au téléchargement sur [cette page du gitlab](https://git.duniter.org/nodes/rust/duniter-rs/tags). + +Il y a 4 types de versions : + +* **Version alpha** : tout juste sortie de la phase de développement, les versions alpha peuvent présenter de nombreuses instabilités et sont destinées aux testeurs les plus aggéris (nommés alpha-testeurs). +* **Version beta** : version toujours réservée au test mais globalement fonctionnelle. Ouverte a tout les testeurs. +* **Version RC**: signifie "release candidate". Version pouvant être installée par tout les utilisateurs avancés, y compris non-testeurs, demande de suivre de près les mises a jours en cas de bug critique découvert. +* **Version stable** : Cette version n'est pas annotée. Elle est destinée a tout les utilisateurs. + +### Choisir le livrable correspondant votre système d'exploitation et votre processeur + +La colonne `Category` du tableau des livrables vous indique le système d'exploitation pour lequel est destiné chaque livrable. (dans le cas de linux, la distribution est indiquée entre parenthèse). + +S'il n'y a pas de livrable pour votre configuration, vous pouvez installer durs manuellement (voir ci-dessous) + +## Installation manuelle + +Pour installer durs manuellement vous devez d'abord [installer Rust](https://www.rust-lang.org/tools/install). + +Ensuite vous devez installer les dépendances nécessaire a la compilation de Durs, les indications qui suivent sont pour Debian/Ubuntu, pour les autres distributions ce sera a vous de trouver les équivalents. + +Installer les paquets suivants : + + apt-get install pkg-config libssl-dev + +Ensuite, clonez le dépot git : + + git clone https://git.duniter.org/nodes/rust/duniter-rs.git + +Rendez vous dans le dossier `duniter-rs` ainsi créer puis dnas le sous-dossier correspondant a la variante que vous souhaitez installer : + +* Pour `durs-server`, rendez-vous dans `bin/durs-server` + + cd bin/durs-server + +* Pour `durs-desktop`, rendez-vous dans `bin/durs-desktop` + + cd bin/durs-desktop + +Enfin lancez la compilation de Durs avec la commande suivante : + + cargo build --release --features ssl + +Si vous avez des problèmes avec `openssl` lors de la compilation, vous pouvez essayer de compiler sans la feature `ssl` : + + cargo build --release + +Cela implique juste que votre noeud ne pourra pas contacter les endpoint WS2P qui sont derrière une couche SSL/TLS. +Votre noeud devrait tout de même fonctionner normalement s'il ya suffisamment de endpoint WS2P accesibles en clair. + +Si la compilation réussie, votre éxécutable se trouve dans `duniter-rs/target/release` et se nomme `durs` ou `durs-desktop`. Vous pouvez le déplacer ou bon vous semble sur votre disque puis l'éxécuter directement. \ No newline at end of file diff --git a/doc/fr/utilisateurs/synchroniser-noeud-durs.md b/doc/fr/utilisateurs/synchroniser-noeud-durs.md index f1311661107d1a0bf738d67cd959199aa8700960..ec1767cb78c76cebc86d997d502e1acd36e3e8c8 100644 --- a/doc/fr/utilisateurs/synchroniser-noeud-durs.md +++ b/doc/fr/utilisateurs/synchroniser-noeud-durs.md @@ -20,7 +20,7 @@ ou Si vous éxécutez Durs et Duniter avec un utilisateur système différent, vous devrez indiquer a Durs le chemin vers le répertoire contenant la blockchain brute sous forme de fichiers JSON. Elle se trouve dans `~/.config/duniter/<profile>/<currency>`. -Exemple: +Exemple: si vous êtez sous Linux, que l'utilisateur de duniter est `user`, que vous utilisez le profil duniter par défaut et que vous souhaitez vous synchronisr sur la g1; le chemin vers lma blockchain brute est :