QoQ-CoT : DoC

1. Détarez l'archive tant attendue V2.0 Bernadette, par exemple dans /tmp

2. Copier votre qoq-cot/config.php actuel dans /tmp/qoq-cot/src/

3. Éditez /tmp/qoq-cot/src/config.php

3.1 supprimez les lignes, désormais inutiles, qui commencent par :

                define('SQL_DSN', 'mysql:host='.SQL_HOST.';port=...
                define('SQL_DSN_J', 'mysql:host='.SQL_HOST_J.';port=...

                define('NB_JOURS_OUVRES', serialize(array('01'...

                //Serveur LDAP
                define('LDAP_HOST'...
                define('LDAP_PORT'...
                //Donnez ici la "base_dn" permettant d'accéder aux usagers, par exemple 'ou=people,dc=votredom,dc=fr'
                define('LDAP_BASE_DN'...

                //Rôle ADMIN
                //Attribut sur lequel on se base pour definir le rôle ADMIN
                define('ATTR_LDAP_ADMIN'...
                //Valeurs de l'attribut ATTR_LDAP_ADMIN donnant le rôle ADMIN
                define('ROLE_ADMIN'...

3.2 Ajoutez les lignes suivantes :

                //Le premier Admin
                //A l'installation l'usager décrit ci-dessous bénéficiera du rôle admin (et pourra créer les suivants depuis l'interface)
                define('FIRST_ADMIN', '<LOGIN_DU_PREMIER_ADMIN>');

3.3 Remplacez dans la ligne précédente <LOGIN_DU_PREMIER_ADMIN> par le login d'un admin : c'est lui qui pourra ensuite, au travers de l'interface, ajouter les autres admins éventuels

3.4 Sauvez le fichier

3.5 UTILE UNIQUEMENT SI VOUS UPGRADEZ DEPUIS UNE VERSION ANTÉRIEURE À V1.1 Ginger AA (soit 1.1 GINGER, 1.0 GINGER AA ou 1.0 GINGER)
Corrigez la configuration du « collate » de la DB – incorrecte depuis la naissance de QoQ-CoT – en lançant le commande suivante sur une machine qui peut se connecter en mysql sur votre serveur MySQL : mysql -h <votre serveur mysql> -u root -p <nom de votre base qoq-cot, par defaut qoq-cot> < /tmp/qoq-cot/ressources/UPGRADE_FROM_PREVIOUS_VERSIONS/CorrigeCharsetDB.sql

4. Commentez dans votre crontab, si vous l'avez mis en place, le lancement du script peuplade.php. Vérifiez ensuite qu'une exécution de peuplade.php n'est pas en cours. Si c'est le cas, attendez qu'elle se termine avant de poursuivre.

5. Vos données ne risquent rien bien sûr lors de cet upgrade… mais sauvez-les quand même… Dumpez donc soigneusement votre base rsyslog.

6. Relancez le setup comme vous l'aviez fait initialement, à partir d'un fichier CSV (php /tmp/qoq-cot/src/setup.php csv <votre_fichier.csv>) ou de JeDDLaJ (php /tmp/qoq-cot/src/setup.php jeddlaj). Ceci va :

• repeupler les tables Salles et MachinesToSalles selon les données d'entrée (ajout/suppression/modification de salles si les données d'entrée ont changé ; aucune modification sinon) SANS modifier vos données de connexions
• ET SURTOUT modifier la base de données afin de la rendre 2.0 Bernadette ready.

7. Vérifiez dans votre interface que les salles ont été renommées/modifiées comme vous le souhaitiez.

8. Créez, dans le répertoire /tmp/qoq-cot/src/, un fichier .htaccess qui va définir l'ensemble U des usagers qui pourront se connecter à votre cocotte : libre à vous d'utiliser tout mode d'authentification/autorisations. Astuce utile : faites en sorte que l'usager choisi comme “admin” dans la config fasse partie de U, c'est mieux

De nombreux exemples de fichiers .htaccess mettant en jeu divers mécanismes d'authentification/autorisations sont disponibles dans le répertoire /tmp/qoq-cot/ressources/EXEMPLES_.htaccess.

À NOTER 2 petites faiblesses concernant le logout… :

• si vous choisissez une authentification par CAS, le menu « Déconnexion » sera inopérant… Le seul moyen de se déconnecter consistera dans ce cas à fermer le navigateur ;
• même punition si vous utilisez Internet Explorer, et cette fois quelle que soit votre méthode d'authentification… Mais dans ce cas, reconnaissez que c'est un peu vous qui cherchez les ennuis, non ?

9. Épurez votre table Connexions de ses doublons inutiles et modifiez sa structure de façon à ce que les doublons ne puissent désormais plus y être insérés. Ça semble un peu ardu comme ça, mais tout va bien se passer.

Respirez un bon coup, puis, depuis une machine qui peut se connecter en mysql sur votre serveur MySQL, lancez simplement la commande suivante : mysql -h <votre serveur mysql> -u root -p <nom de votre base rsyslog> < /tmp/qoq-cot/ressources/UPGRADE_FROM_PREVIOUS_VERSIONS/DedoublonnadeConnexions.sql.

Voilà, c'est fini et ça n'a pas fait trop mal, non … Notez que votre ancienne table Connexions a été sauvée et renommée en Connexions_old au cas (improbable) où… Du coup, vous pouvez mesurer combien de doublons ont été supprimés et vérifier la pertinence de l'épuration.

10. Renommer votre répertoire qoq-cot actuel en qoq-cot.old.

11. déplacez /tmp/qoq-cot/src dans votre emplacement de prod (c.-à-d. le répertoire qui contient qoq-cot.old) et renommez-le en qoq-cot.

12. Remettez en service le lancement du script peuplade.php dans votre crontab : le peuplade.php lancé doit bien sûr (et pour le coup IMPÉRATIVEMENT) être celui du nouveau répertoire qoq-cot, dans sa splendide livrée 2.0 Bernadette.

13. Pour ajouter des admins, connectez-vous à l'URL http://votre.serveur.web/chemin-vers-qoq-cot/qoq-cot en tant que <LOGIN_DU_PREMIER_ADMIN> et utilisez le nouvel onglet « ADMIN ».

14. Fortement conseillé pour la pertinence de vos données de connexions, remplacez sur tous vos postes Windows 7 le client eventlog-to-syslog par nxlog, selon la configuration indiquée dans qoq-cot/ressources/rsyslog/conf_clients/Windows/7/nxlog/. En effet, en contexte W7, il s'est avéré que eventlog-to-syslog « perdait » pas mal de fin de connexions, voire de connexions…

15. That's all, folks : votre poulette a retrouvé ses 20 ans et est toujours toute à vous…