Différences

Ci-dessous, les différences entre deux révisions de la page.

--- projets:yunohost:lstu [2020/03/06 23:59] – créée francoisa
+++ projets:yunohost:lstu [2022/10/24 09:17] (Version actuelle) – francoisa
@@ Ligne 3: / Ligne 3: @@
 ===== Procédure d'installation =====
-. Création d'un sous-domaine https://lien.viregul.fr dans Ouvaton
+. Création d'un sous-domaine [[https://vrgl.fr|https://vrgl.fr]] dans Ouvaton
 . Création du domaine lien.viregul.fr dans Yunohost
@@ Ligne 9: / Ligne 9: @@
 . Installation de l'application Lstu
-- choisir le domaine lien.viregul.fr
+- choisir le domaine vrgl.fr
 - Theme choisi "milligun"
@@ Ligne 19: / Ligne 19: @@
 Retour dans Yunohost / domaines
-Et regénérer le certificat
+Et regénérer le certificat dans Domaines / vrgl.fr / Installer un certificat Let's encrypt
 ==== Configuration - personnalisation ====
-Copie de /var/www/lstu/themes/milligun en /var/www/lstu/themes/viregul
+Copie de ''/var/www/lstu/themes/milligun'' en ''/var/www/lstu/themes/viregul''
 Changement du nom du site et du nom du logo (et taille) dans le fichier ''viregul/templates/layouts/default.html.ep''
+<code html5>
+<div class="float-left hidden-xs logo">
+<img src="<%= url_for('/img/lstuviregul.png') %>" alt="lstu logo" width="100" height="100">
+</div>
+<%= link_to url_for('/') ⇒ (class ⇒ 'link_nocol') ⇒ begin %><h1 class="hennypenny">Et couic, le lien !</h1><% end %>
-Création d'un dossier ''/var/www/lstu/themes/viregul/public/img/'' et dépot d'une image ''lstuviregul.png'' dedans.
-Modification du fichier /var/www/lstu/lstu.conf pour changer :
+</code>
+Création d'un dossier ''/var/www/lstu/themes/viregul/public/img/'' et dépot d'une image ''lstuviregul.png'' dedans.
+Modification du fichier ''/var/www/lstu/lstu.conf'' pour changer :
 <code>
 theme = milligun
@@ Ligne 43: / Ligne 51: @@
 </code>
-Surcharge d'une classe ccss dans themes/viregul/public/css/milli-lstu.min.css
+Surcharge d'une classe css dans themes/viregul/public/css/milli-lstu.min.css
 <code css>
@@ Ligne 49: / Ligne 57: @@
     padding-right: 20px;
 }
 </code>
@@ Ligne 56: / Ligne 65: @@
 <code>
 sudo systemctl restart lstu
+</code>
+**Sécurité - mot de passe admin**
+Changer la clef par défaut de chiffrement des cookies (pwgen 24) :
+<code>
+secrets => ['xei5WoohieChaileilaihook'],
+</code>
+Pour changer le mot de passe admin, éditer le fichier lstu.conf et lancer dans un terminal :
+<code>
+echo -n nouveaumotdepasse | sha256sum
+</code>
+Remplacer la chaine en sortie dans la valeur (en laissant la virgule à la fin) par exemple :
+hashed_adminpwd ⇒ 'lach9iHuth1phoo4ohseeliec2FeShei4seingeek4tu2aixoade',
+Et relancer le service :
+<code>
+systemctl restart lstu.service
+</code>
+Ceci vous permettra d'accéder aux stats, de supprimer des liens…
+===== Mise à jour lstu =====
+Sauvegarder /var/www/lstu dans le but de conserver : ''/var/www/lstu/thmes/viregul'' et ''/var/www/lstu/lstu.conf''
+Une fois la mise à jour effectuée, comparer les 2 lstu.conf et rétablir dans lstu.conf :
+  * contact ⇒ contact@viregul.fr
+  * secrets pour le chiffrement des cookies
+  * hashed_adminpwd ⇒ remettre l'ancienne valeur
+  * theme ⇒ viregul
+  * disable_api ⇒ 1, pour désactiver l'API ouverte
+Vérifier si le dossier "viregul" est encore présent dans les pads.
+Et redémarrer le service :
+<code>
+systemctl restart lstu
+</code>
+===== Mise à jour buster =====
+Après une mise à jour vers buster, les vieux modules perl [[https://github.com/YunoHost-Apps/lstu_ynh/issues/47|sont obsolètes]], il faut les re-générer :
+<code>
+sudo cpan Carton
+cd /var/www/lstu/
+sudo rm -rf local/
+sudo carton install --deployment --without=sqlite --without=mysql
+sudo systemctl restart lstu.service
+</code>
+Et vérifier que le service est bien actif et enable :
+<code>
+sudo systemctl status lstu.service
 </code>