diff options
author | Valérie-Emma Leroux <valerie-emma.leroux@iggdrasil.net> | 2023-06-14 11:39:14 +0200 |
---|---|---|
committer | Valérie-Emma Leroux <valerie-emma.leroux@iggdrasil.net> | 2023-06-14 11:39:14 +0200 |
commit | acc1d4ebee4923f4a9c8484ca127b1d2cbc65975 (patch) | |
tree | 9b8ed979cfa9c93bc7df9776e27bec71f714be85 /docs/fr | |
parent | 4c5684e6e3f893d5d8fdbcffc8cb0325fe52e8fc (diff) | |
download | Ishtar-acc1d4ebee4923f4a9c8484ca127b1d2cbc65975.tar.bz2 Ishtar-acc1d4ebee4923f4a9c8484ca127b1d2cbc65975.zip |
đ Proofreading of installation doc
Diffstat (limited to 'docs/fr')
-rw-r--r-- | docs/fr/source/installation.rst | 54 |
1 files changed, 27 insertions, 27 deletions
diff --git a/docs/fr/source/installation.rst b/docs/fr/source/installation.rst index 5a3c080e8..0baa9176a 100644 --- a/docs/fr/source/installation.rst +++ b/docs/fr/source/installation.rst @@ -11,11 +11,11 @@ Installation Ce document prĂ©sente les instructions d'installation d'Ishtar. -Seule l'installation sous Debian GNU/linux via le paquet Debian est dĂ©crite. Cet environnement est le seul sous lequel un suivi de sĂ©curitĂ© et des dysfonctionnements est assurĂ©, l'installer hors de cet environnement est dĂ©conseillĂ©. +Seule l'installation sous Debian GNU/linux via le paquet Debian est dĂ©crite. Cet environnement est le seul sous lequel un suivi de sĂ©curitĂ© et des dysfonctionnements est assurĂ©, installer Ishtar hors de cet environnement est dĂ©conseillĂ©. Un nom de domaine dĂ©diĂ© est nĂ©cessaire pour chaque instance (une instance Ishtar n'est pas installable dans un sous-rĂ©pertoire). Par contre un sous-domaine est tout Ă fait utilisable (par exemple : *ishtar.mon-domaine.net*). -.. note:: Sauf mention explicite, chaque commande est exĂ©cutĂ©e en tant qu'utilisateur root. Les utilisateurs de sudo l'ajouteront Ă chaque commande faite. +.. note:: Sauf mention explicite, chaque commande est exĂ©cutĂ©e en tant qu'utilisateur root. Les utilisateurs de sudo l'ajouteront Ă chaque commande. Installation sur serveur Debian Bullseye ---------------------------------------- @@ -43,8 +43,8 @@ Ensuite mettez Ă jour la base de donnĂ©es de votre gestionnaire de paquet et in Deux paquets optionnels peuvent ĂȘtre installĂ©s : -* **ishtar-tasks** : installe un service de tĂąche pour gĂ©rer en tĂąche de fond les opĂ©rations longues (par exemple les imports). Cette installation est conseillĂ©e si vous n'ĂȘtes pas juste en ressources serveur. -* **ishtar-libreoffice** : installe libreoffice en mode serveur pour faciliter des imports / exports aux formats bureautique. Il est nĂ©cessaire pour gĂ©nĂ©rer les tableaux depuis les types d'import. Ce paquet dĂ©pends de la version libreoffice-nogui : la couche graphique n'est pas installĂ©e sur le serveur. +* **ishtar-tasks** : installe un service de tĂąche pour gĂ©rer en tĂąche de fond les opĂ©rations longues (par exemple les imports). L'installation de ce paquet est vivement conseillĂ©e sauf si votre serveur a une mĂ©moire vive limitĂ©e (par exemple nano-ordinateur). +* **ishtar-libreoffice** : installe libreoffice en mode serveur pour faciliter des imports / exports aux formats bureautique. Ce paquet est nĂ©cessaire pour gĂ©nĂ©rer les tableaux depuis les types d'import. Il dĂ©pend de la version libreoffice-nogui : la couche graphique n'est pas installĂ©e sur le serveur. Enfin pour crĂ©er une nouvelle instance d'Ishtar :: @@ -60,20 +60,20 @@ Un ensemble de questions vous sera posĂ© afin de dĂ©terminer les paramĂštres qui - faire fonctionner nginx sur un autre port ; - faire fonctionner vos autres services avec nginx (je vous laisse dĂ©couvrir l'abondante documentation en ligne en cherchant « nginx + le nom de mon service ») ; - - configurer Ishtar pour fonctionner avec votre serveur web (rĂ©fĂ©rez vous Ă la `documentation de Django`_). + - configurer Ishtar pour fonctionner avec votre serveur web (rĂ©fĂ©rez-vous Ă la `documentation de Django`_). .. _`documentation de Django`: https://docs.djangoproject.com/fr/2.2/howto/deployment/wsgi/ L'installateur vous demandera un identifiant / mot de passe pour le compte administrateur. -Une fois l'instance prĂ©parĂ©e une base de donnĂ©es a Ă©tĂ© crĂ©e avec un nom du type ishtar-le_nom_de_mon_instance (le nom que vous avez donnĂ©), Ishtar est joignable Ă l'adresse donnĂ©e par la variable URL et les donnĂ©es de cette instances sont stockĂ©es dans le rĂ©pertoire /srv/ishtar/le_nom_de_mon_instance. +Une fois l'instance prĂ©parĂ©e, une base de donnĂ©es a Ă©tĂ© créée avec un nom du type ishtar-le_nom_de_mon_instance (le nom que vous avez donnĂ©), Ishtar est joignable Ă l'adresse donnĂ©e par la variable URL et les donnĂ©es de cette instance sont stockĂ©es dans le rĂ©pertoire /srv/ishtar/le_nom_de_mon_instance. Initialisation de la base de donnĂ©es ------------------------------------ -Ishtar dispose de beaucoup de tables de paramĂ©trage permettant d'avoir un logiciel au plus proche de vos besoins. +Ishtar dispose de nombreuses tables de paramĂ©trage permettant d'avoir un logiciel au plus proche de vos besoins. Remplir toutes ces tables est fastidieux, c'est pour cela que des jeux de donnĂ©es de base sont disponibles. -Lors de l'installation du paquet, Ă l'exception des communes (trop lourdes pour ĂȘtre inclues de base), cette initialisation est faite. +Lors de l'installation du paquet, Ă l'exception des communes (trop lourdes pour ĂȘtre incluses par dĂ©faut), cette initialisation est faite. Initialisation des communes @@ -94,23 +94,23 @@ Une liste des communes française peut ĂȘtre tĂ©lĂ©chargĂ©e et chargĂ©e :: rm /tmp/towns-* -Mise Ă jour ------------ +Mises Ă jour +------------ -Mise Ă jour version 3 (buster) vers la version 4 (bullseye) -*********************************************************** +Mise Ă jour version 3 (sur Debian Buster) vers la version 4 (sur Debian Bullseye) +********************************************************************************* -Comme lors de toute migration non triviale, il est prĂ©fĂ©rable de faire une sauvegarde de la base de donnĂ©es et des medias associĂ©s juste avant de lancer la mise Ă jour. +Comme lors de toute migration non triviale, il est prĂ©fĂ©rable de faire une sauvegarde de la base de donnĂ©es et des mĂ©dias associĂ©s juste avant de lancer la mise Ă jour. -Le changement de version nĂ©cessite prĂ©alablement la mise Ă jour vers la nouvelle version de Debian. +Le changement de version nĂ©cessite prĂ©alablement la mise Ă jour vers la version de Debian 11 Bullseye. -Pour faciliter cette mise Ă jour, si ceux-ci ont Ă©tĂ© installĂ©s, il est conseillĂ© de purger en amont les paquet `ishtar-libreoffice`, tous les paquets `libreoffice` et `ishtar-tasks` :: +Pour faciliter cette mise Ă jour, si ceux-ci ont Ă©tĂ© installĂ©s, il est conseillĂ© de purger en amont les paquets optionnels `ishtar-libreoffice` et `ishtar-tasks` ainsi que tous les paquets `libreoffice` :: apt purge ishtar-libreoffice ishtar-tasks libreoffice-* apt autoremove -Ceux-ci pourront ĂȘtre rĂ©installĂ© une fois la mise Ă jour vers bullseye finie. +Ceux-ci pourront ĂȘtre rĂ©installĂ©s une fois la mise Ă jour vers Bullseye finie. Ăteignez les services web et ensuite procĂ©dez Ă la mise Ă jour de Debian selon la documentation Debian officielle (ou votre protocole/vos habitudes). Ne changez pas tout de suite le fichier source list (ou les lignes) correspondant au dĂ©pĂŽt Ishtar. @@ -122,7 +122,7 @@ Ensuite vous pouvez opĂ©rer la migration de la base de donnĂ©es PostgreSQL vers systemctl start postgresql -Mettez Ă jour vers bullseye le dĂ©pĂŽt correspondant Ă Ishtar (a priori dans le fichier `/etc/apt/sources.list.d/iggdrasil.list`) et lancez la mise Ă jour :: +Mettez Ă jour vers Bullseye le dĂ©pĂŽt correspondant Ă Ishtar (a priori dans le fichier `/etc/apt/sources.list.d/iggdrasil.list`) et lancez la mise Ă jour :: apt update apt upgrade @@ -141,7 +141,7 @@ Vous pouvez ensuite, le cas Ă©chĂ©ant, rĂ©-installer les paquets `ishtar-libreof apt install ishtar-tasks ishtar-libreoffice -On peut ensuite passer Ă la migration des donnĂ©es. Attention cette migration peut ĂȘtre longue (plusieurs heures), assurez vous que le processus de migration ne soit pas intĂ©rrompu (lancez le a minimum via un outil comme `screen`). Pour chaque instance, dans le rĂ©pertoire `/srv/ishtar/` lancez les commandes :: +On peut ensuite passer Ă la migration des donnĂ©es. Attention cette migration peut ĂȘtre longue (plusieurs heures), assurez-vous que le processus de migration ne soit pas interrompu (a minima lancez-le via un outil comme `screen`). Pour chaque instance, dans le rĂ©pertoire `/srv/ishtar/` lancez les commandes :: cd /srv/ishtar/{le_nom_de_mon_instance} # mise Ă jour des donnĂ©es par dĂ©faut @@ -153,21 +153,21 @@ On peut ensuite passer Ă la migration des donnĂ©es. Attention cette migration p ISHTAR_MIGRATE_V4 = False USE_BACKGROUND_TASK = False - ## nombre-de-processus dĂ©pend du processeur et du nombre de fil d'execution disponible - ## plus y en a plus rapide est la conversion mais laissez quand mĂȘme un minimum de marge pour ne pas rendre - ## la machine inutilisable + ## nombre-de-processus dĂ©pend du processeur et du nombre de fils d'exĂ©cution disponible + ## plus il y en a, plus rapide est la conversion mais laissez quand mĂȘme un minimum de marge + ## pour ne pas rendre la machine inutilisable ./manage.py migrate_to_geo_v4 --process {nombre-de-processus} # une fois la migration finie editor local_settings.py (...) # supprimer les deux lignes ajoutĂ©es -Si vous utilisez `ishtar-tasks`, sur cette nouvelle version, la gestion du service rabbitmq n'est plus assurĂ©e via `systemd` mais via `supervisor.` Pour gĂ©rer cette migration supprimez les fichiers de configuration `systemd` rĂ©siduels :: +Si vous utilisez `ishtar-tasks`, sur cette nouvelle version la gestion du service `rabbitmq` n'est plus assurĂ©e via `systemd` mais via `supervisor.` La migration de `systemd` vers `supervisor` n'est pas gĂ©rĂ©e automatiquement via le paquet, seules les nouvelles instances ont un fichier `supervisor` créé Ă l'installation. Pour gĂ©rer cette migration supprimez les fichiers de configuration `systemd` rĂ©siduels :: rm -f /etc/systemd/system/rabbitmq-notify-email\@.service rm -f /etc/systemd/system/rabbitmq-server.service rm -f /etc/systemd/system/multi-user.target.wants/rabbitmq-server.service -La migration de `systemd` vers `supervisor` n'est pas gĂ©rĂ©e, seule les nouvelles instances ont un fichier supervisor créé Ă l'installation. La suppression des anciennes configuration puis la crĂ©ation des nouvelles se fait ainsi la gestion du service rabbitmq et des files associĂ©es n'est plus assurĂ©e via systemd mais via supervisor pour gĂ©rer cette migration supprimez les fichiers de configuration systemd rĂ©siduels et crĂ©ez les fichiers de configuration pour chaque instance :: +Puis crĂ©ez les fichiers de configuration `supervisor` pour chaque instance :: rm -f /etc/monit/conf-enabled/celery-* rm -f /etc/systemd/system/celery-* @@ -190,17 +190,17 @@ La migration de `systemd` vers `supervisor` n'est pas gĂ©rĂ©e, seule les nouvell supervisorctl update # mise Ă jour La migration est terminĂ©e. -RedĂ©marrez la machine et assurez vous que tous les services fonctionnent convenablement en particulier via les commandes `systemctl --failed` et `supervisorctl status`. +RedĂ©marrez la machine et assurez-vous que tous les services fonctionnent convenablement en particulier via les commandes `systemctl --failed` et `supervisorctl status`. -En ce qui concerne le paramĂ©trage, il est impĂ©ratif de d'Ă©diter les permissions pour accĂ©der aux donnĂ©es gĂ©ographiques. Ouvrez votre instance sur un navigateur web en admin et rendez-vous Ă la page : `http(s)://{my-ihstar}/admin/ishtar_common/profiletypesummary/` pour ajouter les permissions nĂ©cessaires. +En ce qui concerne le paramĂ©trage, il est impĂ©ratif de modifier les types de droits utilisateurs pour l'accĂšs aux donnĂ©es gĂ©ographiques. Ouvrez votre instance sur un navigateur web en admin et rendez-vous Ă la page : `http(s)://{my-ihstar}/admin/ishtar_common/profiletypesummary/` pour ajouter les permissions nĂ©cessaires. -Une fois que vous vous ĂȘtes assurĂ© que tout est fonctionnel vous pourrez effacer l'ancien cluster PostgreSQL correspondant Ă la version 11 :: +Une fois que vous vous serez assurĂ© que tout est fonctionnel, vous pourrez effacer l'ancien cluster PostgreSQL correspondant Ă la version 11 :: pg_dropcluster 11 main .. TODO: - .. warning:: L'installateur prĂ©sume que vous avez un nom de domaine dĂ©diĂ© pour votre installation. Si cela n'est pas le cas, reportez vous Ă la section de la documentation concernĂ©e. + .. warning:: L'installateur prĂ©sume que vous avez un nom de domaine dĂ©diĂ© pour votre installation. Si cela n'est pas le cas, reportez-vous Ă la section de la documentation concernĂ©e. paramĂštres de settings utiles :DEFAULT_FROM_EMAIL = "robot@iggdrasil.net", SERVER_EMAIL EMAIL_HOST EMAIL_PORT EMAIL_HOST_USER EMAIL_HOST_PASSWORD EMAIL_USE_TLS installation depuis les sources |