diff options
Diffstat (limited to 'docs')
| -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 |