DocScoDoc/docs/GuideInstallDebian11.md

264 lines
10 KiB
Markdown
Raw Normal View History

2021-08-22 08:14:55 +02:00
2021-09-06 12:35:49 +02:00
# Installation de ScoDoc 9 sur Debian 11 (Bullseye)
2021-09-30 16:11:55 +02:00
Ce document décrit la procédure d'installation et de configuration de ScoDoc 9.
Cette procédure doit être effectué sur la machine serveur avec un accès
administrateur (root).
2021-08-22 08:14:55 +02:00
ScoDoc est livré avec des scripts d'installation qui configurer presque
automatiquement votre serveur (serveur web, base de données, etc): vous pouvez
donc installer et configurer ScoDoc avec des connaissances réduites sur le
système Linux.
2021-09-06 12:35:49 +02:00
Cette documentation est prévue pour installer ScoDoc version 9 sur un système
[Debian](http://www.debian.org) 11 (Bullseye, stable) s'exécutant sur une
machine intel-like **64bits** (architecture **AMD64**). Debian s'installe
2021-09-06 12:35:49 +02:00
facilement en cinq minutes, sur une machine normale ou un serveur
virtualisé. Il est **vivement déconseillé** de tenter l'installation sur une
autre version.
2021-08-24 19:51:54 +02:00
2021-09-30 16:11:55 +02:00
Si vous mettez à jour un serveur existant (ScoDoc 7 sur Debian 10), voir [la page
sur les migrations](https://scodoc.org/MigrationScoDoc7a9/#2-upgrade-debian).
2021-08-24 19:51:54 +02:00
Merci de signaler tout problème (emmanuel.viennet@gmail.com
ou [scodoc-devel](https://listes.univ-paris13.fr/mailman/listinfo/scodoc-devel) ).
- Note 1: l'image du CD d'installation de Debian (amd64) peut se trouver ici:
[https://www.debian.org/distrib/netinst](https://www.debian.org/distrib/netinst.md),
choisir la version "petits CD" pour **amd64** (*Il est indispensable
d'utiliser une version 64 bits ! *)
2021-08-24 19:51:54 +02:00
- Note 2: une version Docker serait utile: avis aux volontaires.
<img src="/img/alert.png" style="vertical-align: bottom; margin:0 0 0 0;" alt="/!\" /> Important:
La procédure d'installation décrite ci-dessous suppose que ScoDoc va s'exécuter
sur un serveur dédié. Pour faire des tests, utilisez un serveur virtuel (comme
VirtualBox ou VMWare). L'installation ci-dessous va en effet modifier de
2021-10-01 21:12:41 +02:00
nombreux paramètres de votre système Linux (serveur web, firewall, serveur SQL,
messagerie, ...).
2021-08-24 19:51:54 +02:00
## 1) Préalable: configurer un serveur linux
Le serveur devrait être accessible depuis Internet.
2021-09-24 20:31:25 +02:00
### Configuration matérielle
- taille disque: prévoir au moins 20Go sur la partition où sera scodoc (en
général `/`).
- mémoire: prévoir au moins 8Go de RAM, et plutôt 12 ou 16.
2021-08-24 19:51:54 +02:00
### Informations sur les flux réseau
Le serveur est fréquemment installé sur un réseau protégé ou sur un VPN.
- le trafic entrant est sur le port 443 (le trafic http/80 est redirigé
vers le https).
- le serveur doit pouvoir envoyer du mail (serveur postfix en local, à
configurer pour utiliser un relais smtp ou envoyer directement, selon
votre politique);
- Les serveurs de mise à jour de Debian doivent être accessibles (en http,
voir `/etc/apt/sources.list`);
- Les serveurs `scodoc.org` et `scodoc.iutv.univ-paris13.fr` doivent
être accessibles (80 et 443).
### Installation Linux Debian
Nous recommandons d'effectuer une installation standard de Debian par le réseau (netinst),
et d'utiliser l'install en mode texte, très simple et rapide.
Durant l'installation de Debian, lorsqu'il demande "logiciels à installer", tout décocher
sauf "Serveur SSH" et "Utilitaires standard du système". Le script d'installation de ScoDoc
se chargera ensuite d'installer tous les éléments nécessaires (serveur web, messagerie, etc.).
2021-08-24 19:51:54 +02:00
2021-09-30 20:09:10 +02:00
*Veiller à sélectionner une locale `UTF-8` par défaut.*
2021-08-24 19:51:54 +02:00
![InstallDebian6-1.png](screens/InstallDebian6-1.png)
### Points à vérifier avant d'installer ScoDoc
Checklist minimale de votre système Linux Debian:
1. Connexion à Internet: le réseau doit être accessible. En effet, le script d'installation va installer des paquetages du système Debian puis télécharger la dernière mise à jour du logiciel ScoDoc (à partir du serveur Subversion).
1. Vérifiez la connectivité, par exemple:
```
2021-09-24 20:31:25 +02:00
ping www.univ-paris13.fr
(quitter avec ctrl-c)
cd /tmp
wget --no-check-certificate https://www-lipn.univ-paris13.fr/projects/scodoc
# doit créer un fichier nomme "scodoc" contenant du code HTML
2021-08-24 19:51:54 +02:00
```
2021-08-26 14:23:51 +02:00
3. Nom DNS: le serveur doit avoir un nom ("serveur.exemple.fr") connu dans le
DNS (local ou public). Pour des tests, vous pouvez vous passer de DNS, mais
dans ce cas le nom de votre serveur sera son adresse IP (eg 192.168.0.10) et
il ne sera peut être pas accessible de l'extérieur.
2021-09-24 20:31:25 +02:00
4. Mail: vérifiez que le serveur peut envoyer des e-mail:
`mail votre@adresse.fr`, puis entrer un message terminé par `ctrl-d`: si vous ne
recevez pas le message après quelques minutes, vérifiez votre configuration
(et le log `/var/log/mail.log`). Un serveur ScoDoc qui n'envoie pas de mail
ne peut pas vérifier ceux des utilisateurs, qui à leur tour ne pourront pas
changer leurs mots de passe (bien d'autres fonctions dépendent des mails).
Au besoin, revoir la configuration avec `dpkg-reconfigure postfix`.
2021-08-26 14:23:51 +02:00
1. Vérifiez que votre serveur est accessible depuis une autre machine de votre
2021-09-24 20:31:25 +02:00
réseau (voire d'Internet): par exemple `ping serveur.exemple.fr`.
2021-08-26 14:23:51 +02:00
1. Date et heure: vérifier que les dates et heure sont correctes, même après
2021-09-24 20:31:25 +02:00
reboot. L'utilisation d'un serveur de temps (ntp) est recommandée (
`apt-get install ntp`), et éventuellement `dpkg-reconfigure tzdata`).
2021-08-26 14:23:51 +02:00
1. Cette liste est incomplète... et n'oubliez pas: avant de passer en
production, mettez en place des sauvegardes sérieuses !
2021-08-24 19:51:54 +02:00
#### Configuration si utilisation d'un proxy
2021-08-26 14:23:51 +02:00
Si votre accès à Internet passe par un proxy, l'indiquer au moment de
l'installation Debian. Il est possible qu'il vous faille configurer d'autres
éléments, voir par exemple
2021-09-24 20:31:25 +02:00
[ce post sur Stack Overflow](
https://stackoverflow.com/questions/9445489/performing-http-requests-with-curl-using-proxy).
2021-08-26 14:23:51 +02:00
2021-09-24 20:31:25 +02:00
#### Note sur l'install dans un container LXC
2021-10-01 21:12:41 +02:00
Il y a deux possibilités :
**Option 1**, si vous installez dans un container LXC privilégié via le compte
root et/ou sudo, attention: la config par défaut de Redis (un gestionnaire de
cache utilisé par ScoDoc) n'est pas compatible, en raison d'un problème de
système de fichier en lecture seule. Installer redis avant ScoDoc, comme suit:
2021-09-24 20:31:25 +02:00
2021-09-30 16:11:55 +02:00
apt-get install redis
2021-10-01 21:12:41 +02:00
Puis créer un dossier `/etc/systemd/system/redis.service.d` contenant le fichier
2021-09-30 16:11:55 +02:00
`redis.conf` avec les lignes suivantes :
[Service]
PrivateTmp=no
ProtectSystem=false
PrivateDevices=false
ProtectHome=no
ProtectControlGroups=no
ProtectKernelTunables=no
ProtectKernelModules=no
ReadWritePaths=
2021-11-09 21:36:36 +01:00
ReadOnlyDirectories=
2021-09-24 20:31:25 +02:00
2021-09-30 16:11:55 +02:00
Ensuite
2021-09-24 20:31:25 +02:00
2021-09-30 16:11:55 +02:00
systemctl daemon-reload
systemctl start redis
2021-08-24 19:51:54 +02:00
2021-09-24 20:31:25 +02:00
... et poursuivez l'installation comme ci-dessous.
2021-08-24 19:51:54 +02:00
**Option 2**, si vous installez dans un container LXC non-privilégié via un
compte utilisateur normal, vous pouvez activer l'option « nesting »
(imbriqué) de LXC pour permettre à Redis de fonctionner normalement.
⚠️ Attention ! N'activez pas le *nesting* sur un conteneur privilégié. Cela
2021-10-01 21:12:41 +02:00
provoquerait une faille de sécurité.
Si vous avez construit votre conteneur manuellement avec lxc-create, modifiez
2021-10-01 21:12:41 +02:00
le fichier `/var/lib/lxc/${nomDuConteneur}/config` et ajoutez les lignes
ci-dessous :
lxc.apparmor.allow_nesting = 1
lxc.apparmor.profile = generated
Si vous utilisez un conteneur LXC sur l'hyperviseur Proxmox, modifiez le
2021-10-01 21:12:41 +02:00
fichier `/etc/pve/lxc/${CTID}.conf` et ajoutez la ligne suivante :
features: nesting=1
... et poursuivez l'installation comme ci-dessous.
2021-08-24 19:51:54 +02:00
## 2) Installation de ScoDoc sur Debian
### 2.1) Charger le logiciel
<img src="/img/alert.png" style="vertical-align: bottom; margin:0 0 0 0;"
alt="/!\" /> Les commandes ci-dessous sont à exécuter dans un terminal ouvert
en tant que **root** sur le serveur. Vous pouvez utiliser `su` (ou `sudo su`)
pour devenir **root**).
2021-08-26 14:23:51 +02:00
Remarque: *Si ce n'est pas déjà le cas, vous avez intérêt à ouvrir une session
`ssh` (ou `putty`) depuis une machine normale, afin de pouvoir copier/coller
facilement les commandes et éditer les fichiers de configuration.*
2021-08-24 19:51:54 +02:00
2021-08-26 14:23:51 +02:00
- Ajouter le dépot scodoc: copier ce fichier <a href="/attachments/scodoc.list"
download>scodoc.list</a> dans `/etc/apt/sources.list.d/`
ou le créer contenant juste cette ligne:
# contenu du fichier /etc/apt/sources.list.d/scodoc.list
deb http://scodoc.org/repo bullseye main
2021-08-24 19:51:54 +02:00
- Installer la clé: en `root` sur le serveur, lancer
apt-get -y install gnupg
2021-08-24 19:51:54 +02:00
wget -O - https://scodoc.org/misc/scodoc-repo.gpg.key | apt-key add -
- Installer le logiciel:
apt-get update
2021-09-14 12:31:16 +02:00
apt-get install nginx
2021-09-24 20:31:25 +02:00
S'assurer que le logiciel `nginx`s'est bien installé. En cas de problème se
référer à sa doc (par exemple, si
[votre serveur ne supporte pas
IPv6](https://techglimpse.com/nginx-error-address-family-solution/)).
2021-09-14 12:31:16 +02:00
2021-09-24 20:31:25 +02:00
Ensuite:
2021-09-14 12:31:16 +02:00
apt-get install scodoc9
2021-08-24 19:51:54 +02:00
2021-09-24 20:31:25 +02:00
Notez que l'installation du paquet `scodoc9` va créer automatiquement un
utilisateur `scodoc` qui sera utilisé par le serveur.
2021-08-24 19:51:54 +02:00
- Attribuer un mot de passe à l'utilisateur `scodoc`:
2021-08-24 19:51:54 +02:00
passwd scodoc
2021-08-24 19:51:54 +02:00
### 2.2) Configuration des logiciels et des données
2021-08-24 19:51:54 +02:00
2021-09-06 18:43:33 +02:00
Lancer le script suivant en tant que `root` sur votre serveur nouvellement installé:
2021-08-24 19:51:54 +02:00
/opt/scodoc/tools/configure-scodoc9.sh
2021-08-24 19:51:54 +02:00
Vous devrez répondre à quelques questions et saisir le mot de passe que vous
attribuerez à l'utilisateur `admin`.
2021-08-24 19:51:54 +02:00
2021-08-25 22:37:03 +02:00
(note: pour en savoir plus sur ce script, [voir l'explication](GuideInstallDebian11Advanced.md))
2021-08-24 19:51:54 +02:00
### 3) **Lancer ScoDoc**:
2021-08-24 19:51:54 +02:00
sudo su # se connecter en root
2021-08-25 22:37:03 +02:00
systemctl restart nginx
systemctl restart scodoc9
2021-08-24 19:51:54 +02:00
2021-08-22 08:14:55 +02:00
et voila !
Visiter `https://monscodoc.mondomaine.fr/` pour achever la configuration et
utiliser le logiciel: voir la page [GuideConfig](GuideConfig.md).
2021-08-22 08:14:55 +02:00
2021-09-06 12:35:49 +02:00
## Importation des données ScoDoc 7
2021-09-24 20:31:25 +02:00
Après installation, vous pouvez migrer toutes vos données (comptes utilisateurs,
étudiants, formations, notes, photos et fichiers divers) depuis une
2021-09-06 12:35:49 +02:00
installation ScoDoc 7, ou même en place.
2021-08-22 08:14:55 +02:00
2021-09-06 12:35:49 +02:00
Voir [la procédure de migration](MigrationScoDoc7a9.md).
2021-08-22 08:14:55 +02:00
## En cas de problème
Ne pas hésiter à me contacter ou à écrire sur la liste notes (voir [Listes de
diffusion](ListesDeDiffusion.md)).
2021-08-22 08:14:55 +02:00
* Problèmes d'envoi de courrier électronique (mail): voir [ProblemesMail](ProblemesMail.md)
Nota: sur certains réseaux, l'autoconfiguration IPv6 pose problème (par exemple:
bloquage des envois de mails). Au besoin, il est possible de désactiver IPv6
(voir par exemple [ici](https://wiki.debian-fr.xyz/D%C3%A9sactiver_l%27IPv6)).
2021-08-22 08:14:55 +02:00
## Ensuite...
* Mettez en place des [sauvegardes](SauvegardesBases.md)
* Abonnez-vous au moins à la liste d'annonces: voir [Listes de diffusion](ListesDeDiffusion.md)