Cette page sert au suivi de projet de mise en place du framework avec DUNES.

Un portail TXM a déjà été installé à l'ENS pour l'exposition Paroles de libérés à la bibliothèque Diderot.

• sur une machine virtuelle de type “dev” atteignable seulement depuis l'ENS
  • configuration : ???
• accès SSH pour paramétrer le portail
• dans un tomcat indépendant installé dans le home de l'utilisateur “txm”

Les procédures de gestion de sites de pré-prod et de prod concernent des sites web mis en oeuvre par des applications. Une application peut être composée de répertoires, de bases de données et de cache. Le contenu de certaines applications est stocké dans les bases de données. On peut distinguer les répertoires : - de code PHP d'une application (push_php) - de fichiers de configuration d'une application (push_appli) - de fichiers téléchargeables (push_upload)

Pour réaliser une opération entre le site pré-prod et prod, il faut créer dans le dossier de la racine du site de pré-prod un fichier 'commandes.txt'.

Ce fichier doit contenir une série de lignes d'ordres, par exemple dans un premier temps : push_appli textometrie

Le fichier est scanné toutes les 5 minutes.

Une fois traité, la commande est déplacée dans le fichier : commandes-succes.txt

Le résultat des opérations est mis dans le fichier : resultat.txt

Les commandes sont :

• push_upload : transfert le dossier /tmp/upload de spip pour la mise en ligne de fichiers très volumineux
• push_appli : transfert l'application en tenant compte des filtres
• push_php : transfert le code php
• push_base* : transfert le contenu de la base de donnée liée à l'application
• push : transfert tout sans tenir compte des filtres (attention, ça efface le contenu Spip)
• pull_data* : rapatrie les fichiers de prod vers la préprod
• pull_base* : rapatrie la base de prod dans un fichier .sql du dossier utilisateur
• clear_cache : vide le cache des applications Symfony2

Les commandes étoilées ne sont pas encore disponibles, elles peuvent être passées à la demande.

Les commandes sont adaptées en fonction des besoins qui se présentent.

• push_xxx : envoi de la pré-prod vers la prod
• pull_xxx : recupère de la prod vers la pré-prod

On utilise 3 machines virtuelles ayant des rôles et des accès différents :

• dev : pour tester les derniers développements (logiciel) avant de mettre à jour qualif
  • atteignable seulement depuis l'ENS et par VPN
• qualif (anciennement pré-prod) : pour mettre en forme de production (paramétrages, corpus, profils et utilisateurs) dans un environnement accessible avant de transférer automatiquement en prod
  • atteignable seulement depuis l'ENS et par VPN
• prod : pour donner un accès public exclusif au portail (pas d'autre accès possible que celui au portail lui-même)
  • machine de production qui s'expose sur le WEB
  • accès contrôlés par des commandes push&pull
  • utilisation d'un frontal Apache pour filtrer et réécritures d'URL

Soit “mon-portail” le nom du portail publié.

Il y a un tomcat par portail.

Soit “uportail” l'utilisateur qui exécute les tomcat correspondant aux portails d'une équipe (qui peut gérer plusieurs portails : démo, bfm, test, etc.).

• ~uportail/.TXMWEB/mon-portail contient :
  • les fichiers de configuration du portail et de la toolbox
  • les corpus → la configuration du corpus stocke les requêtes des sous-corpus et partitions créés
  • les utilisateurs → un fichier est créé quand un utilisateur s'inscrit, un fichier est modifié quand un utilisateur se connecte/déconnecte
  • les profiles → un fichier est créé quand l'administrateur du portail crée un profile, un fichier est modifié quand l'administrateur met à jour les droits d'un profile
• ~uportail/projets/mon-portail : contient les fichiers HTML spécifiques au portail. Ces fichiers sont recopiés dans la webapps une fois celle-ci déployée
• $TOMCAT/webapps/mon-portail
  • html : pages de navigation internes du portail
  • images
  • biblios : pages de notices des textes des corpus du portail
  • pdfs : version pdf des textes des corpus du portail

Il y a 4 commandes dont 2 PUSH et 2 PULL. Les sous-points¹⁾ sont des commandes appelées par la commande parent.

• pullgconf commande générique : récupérer des fichiers/répertoires de configuration prod : à lire depuis ~/TXMWEB/mon-portail/
• pullsconf commande spécifique²⁾ : récupérer toute la configuration prod
  • récupérer les utilisateurs prod : ~/TXMWEB/mon-portail/data/users
  • récupérer les profiles prod : ~/TXMWEB/mon-portail/data/profiles
  • récupérer les logs prod : ~/TXMWEB/mon-portail/logs & $TOMCAT/logs/catalina.out & $TOMCAT/logs/locahost.out
  • récupérer les corpus prod : ~/TXMWEB/mon-portail/corpora
  • récupérer les archives zip de corpus : ~/TXMWEB/mon-portail/zip
  • récupérer la configuration portail : ~/TXMWEB/mon-portail/txmweb.conf
  • récupérer la configuration Toolbox du portail : ~/TXMWEB/mon-portail/textometrie.properties
• pullghttp commande générique : récupérer des fichiers/répertoires de webapps prod : à lire depuis $TOMCAT/webapps/mon-portail
• pullshttp commande spécifique : récupérer les fichiers webapps prod
  • récupérer les pages HTML et JSP prod : $TOMCAT/webapps/mon-portail/html et $TOMCAT/webapps/mon-portail/jsp
  • récupérer les images prod : $TOMCAT/webapps/mon-portail/images
  • récupérer les pages de bibliographies prod : $TOMCAT/webapps/mon-portail/biblio
  • récupérer les css prod : $TOMCAT/webapps/mon-portail/css
  • récupérer les scripts javascript prod : $TOMCAT/webapps/mon-portail/js
  • récupérer les éditions de texte PDF prod : $TOMCAT/webapps/mon-portail/files
  • récupérer la page générale du site : $TOMCAT/webapps/mon-portail/TXMWEB.jsp
  • récupérer la CSS générale du site : $TOMCAT/webapps/mon-portail/TXM_RIA.css
  • récupérer les chartes graphique du site : $TOMCAT/webapps/mon-portail/txmweb/sc/skins

• pushgconf commande générique : maj de fichiers/répertoires de configuration prod : à copié dans ~/TXMWEB/mon-portail/
• pushsconf commande spécifique : maj toute la configuration prod
  • maj les utilisateurs prod : ~/TXMWEB/mon-portail/data/users
  • maj les profiles prod : ~/TXMWEB/mon-portail/data/profiles
  • maj les logs prod : ~/TXMWEB/mon-portail/logs & $TOMCAT/logs/catalina.out & $TOMCAT/logs/locahost.out
  • maj les corpus prod : ~/TXMWEB/mon-portail/corpora
  • maj les archives zip de corpus : ~/TXMWEB/mon-portail/zip
  • maj la configuration portail : ~/TXMWEB/mon-portail/txmweb.conf
  • maj la configuration Toolbox du portail : ~/TXMWEB/mon-portail/textometrie.properties
• pushghttp commande générique : maj de fichiers/répertoires de webapps prod : à copié dans $TOMCAT/webapps/mon-portail
• pushshttp commande spécifique : maj les fichiers webapps prod
  • maj les pages HTML et JSP prod : $TOMCAT/webapps/mon-portail/html et $TOMCAT/webapps/mon-portail/jsp
  • maj les images prod : $TOMCAT/webapps/mon-portail/images
  • maj les pages de bibliographies prod : $TOMCAT/webapps/mon-portail/biblio
  • maj les css prod : $TOMCAT/webapps/mon-portail/css
  • maj les scripts javascript prod : $TOMCAT/webapps/mon-portail/js
  • maj les éditions de texte PDF prod : $TOMCAT/webapps/mon-portail/files
  • maj la page générale du site : $TOMCAT/webapps/mon-portail/TXMWEB.jsp
  • maj la CSS générale du site : $TOMCAT/webapps/mon-portail/TXM_RIA.css
  • maj les chartes graphique du site : $TOMCAT/webapps/mon-portail/txmweb/sc/skins