HOWTOs

Ce document a pour but d'aider le nouveau coordinateur technique, ou les personnes chargées de le remplacer, afin d'effectuer certaines tâches de routine d'exploitation d'infoscience.

 

Sommaire

  1. Au préalable
  2. Ajouter un laboratoire
    1. A faire par les bibliothécaires
    2. A faire par les administrateurs
      1. Sur une machine personnelle
      2. Sur kisvm2 (Attention! nouvelle procédure avec le prototype du Curator)
      3. Sur la machine de production
  3. Supprimer un laboratoire
  4. Archiver un laboratoire
  5. Obtenir des statistiques d'utilisation (obsolète)
    1. Stats de consultation
    2. Stats de publications
  6. Modifier la liste des actualités sur le site infoscience
  7. Mettre à jour le code source sur le serveur de développement
  8. Mettre à jour l'alias email infoscience-admin
  9. Trucs et astuces divers
    1. Exporter un panier/collection en MARCXML
    2. Ajouter un éditeur au Wiki
    3. Résoudre les problèmes d'accès en édition au Wiki
    4. Afficher les taches en cours pour un utilisateur donné

Voir aussi:

 

Au préalable

Récupérer les sources sur SVN et les installer sur une machine personnelle:

 

Ajouter un laboratoire

 

A faire par les bibliothécaires

  1. prendre contact avec le labo, visiter les responsables (s'aider pour cela de la petite check list)

  2. définir avec les responsables les modalités d'import et le nom des personnes de contact
  3. ouvrir la page sur le wiki, pour cela
  4. ajouter les personnes de contact dans le groupe infoscience-users (via http://my.epfl.ch)

  5. envoyer un mail à infoscience@epfl.ch en précisant :

    • l'acronyme du labo et la faculté (SB)
    • s'il faut une modération ou pas (cf la page du wiki)
    • l'url vers la page web du labo (ou celle de l'institut pour les labos fermés)
    • le lien vers l'unité dans l'annuaire (entrer l'acronyme du labo (GR-HE, DCG, ...) sous "sigle ou nom" dans search.epfl.ch)
    • Exemple :

 

De : Walter Lionel
Envoyé : lundi, 10. novembre 2008 10:54
À : ' infoscience@epfl.ch '
Objet : créer labo TAN
Merci de créer le labo TAN, faculté SB, institut MATHGEOM
Nom français : Chaire de théorie analytique des nombres 
Nom anglais : Chair of analytic number theory
Url http://tan.epfl.ch
Annuaire : http://search.epfl.ch/browseunit.do?unit=11828
Sans modérateur !
Merci !
Lionel
  1. en fonction du cas, travail sur les données pour l'import
  2. assurer un suivi (contrôles qualité, etc)

 

A faire par les administrateurs

Trouver les attributs d'un laboratoire sur LDAP (scolldap)

 

ldapsearch -LLL -H ldap://scoldap.epfl.ch -x -b o=epfl,c=ch cn=ACRONYME DU LABO*

Pour obtenir uniquement l'identifiant:

 

ldapsearch -LLL -H ldap://scoldap.epfl.ch -x -b o=epfl,c=ch cn=ACRONYME DU LABO* uniqueIdentifier

Pour personnaliser l'affichage des publications des labos, voir Templates_individuels_pour_Labos.

 

Sur une machine personnelle

Updater les fichiers dans les répertoires /config et /cds-invenio/epfl: svn update Modifier les fichiers suivants:

Commiter les modifications à partir des répertoires /config et /cds-invenio-epfl: svn commit -m "added lab SCHOOL/LABO"

 

Sur kisvm2 (Attention! nouvelle procédure avec le prototype du Curator)

1. Identification 2. kisvm2.epfl.ch/curator 3. Menu "Laboratoires" 4. Sur le serveur:

 

Aller dans le répertoire /home/kis/infoscience/curator
> sudo make save-config
> sudo make update-config
> sudo /etc/init.d/httpd graceful
Important: les fichiers modifiés par le Curator sont dans /opt/infoscience/curator/etc/xml/

Eventuellement forcer webcoll sur bibsched (manuel)

Contrôler si tout est OK sur le serveur de test avant de passer au serveur de prod:

 

Aller dans le répertoire  /home/kis/infoscience/curator/etc/config-files/ (pour éviter de commiter d'autres scripts)
> sudo svn commit -m "décrire brièvement la modification"

 

Sur la machine de production

 

Aller dans le répertoire  /home/kis/infoscience/curator/etc/config-files/
> sudo svn update
> remonter dans /home/kis/infoscience/curator
> sudo make update-config

 

Supprimer un laboratoire

> On ne supprime normalement pas un labo! On le place dans les archives en utilisant un le Curator (version alpha)

 

Archiver un laboratoire

TODO

Cas de figure du laboratoire qui est fermé mais dont on conserve le patrimoine (Exemples: Labo/LSL, Labo/CECOTOX, etc.).

Pour l'instant, ces labos sont conservés sans autre dans la base. Nous garderons cette logiqe mais l'affichage ou le signalement du statut de ces labos est à effectuer.

 

Obtenir des statistiques d'utilisation (obsolète)

 

Stats de consultation

Le mécanisme d'obtention de stats d'usage sur CDSWare est assez manuel pour le moment (un système plus sophistiqué devrait être intégré dans la version 0.9 d'Invenio).

Nous avons mis en place une interface de consultation relativement simple qui donne une premier aperçu d'analyse (standard) des logs: http://infoscience.epfl.ch/report.html

Pour générer de nouvelles stats:

For more usage information, documentation and examples: http://www.hping.org/visitors

Pour effectuer des statistiques plus personnalisées manuellement, se connecter sur ditdevsrv12 (le serveur infoscience) et faire un cat des fichiers de log apache que l'on veut analyser (ils sont dans /opt/cdsware/logs) dans le script ~/cl-logs/parselog :

 

   cat access_log access_log.1 | ~/cl-logs/parselog > ~/2006-12-12-results
pour l'analyse de tous les access_log (ATTENTION, GOURMAND EN RESSOURCES CPU, NE PAS LANCER à N'IMPORTE QUEL MOMENT!):
   cat access_log* | ~/cl-logs/parselog > ~/2006-12-12-results

Le script essaie de différencier robots et browsers réels en fonction du "User-Agent". Il faut parfois rajouter le nom des nouveaux robots qui ont un impact non négligeable sur les résultats, en éditant parselog.lisp, paramètre *bot-regex*.

 

Stats de publications

Le script filters/tools/simple-stats.py est une bonne base de départ pour générer des stats. ATTENTION: ce script dans son état actuel ne marche pas extrêmement bien pour des stats récentes (i.e. il ne marche pas pour 2007, soit pas du tout). Un cahier des charges serait à redéfinir!!)

Comment lancer la commande (pour DA, et un aide mémoire vi en cas de besoin : http://www.ledman.ch/eti_linux/08vi.html) :

depuis le rep infoscience/filters/tools , lancer

python simple-stats.py > filters/tools/2007-04-01-stats.txt

Pour récupérer le fichier : faire un copier coller après

cat 2007-04-01-stats.txt

Attention, pour avoir une répartition correctement étalée entre les différents trimestres, il est nécessaire de mettre à jour la recid_map, qui indique le recid à partir duquel on considère qu'on entre dans un nouveau trimestre.

Exemple

 

recid_map = [
    1, # 2004/07/01
    28042, # 2004/10/01
    29417, # 2005/01/01
    33710, # 2005/04/01
    52049, # 2005/07/01
    54858, # 2005/10/01
    63791, # 2006/01/01
    83633, # 2006/04/01
    88002, # 2006/07/01
    89741, # 2006/10/01
    98489, # 2007/01/01
    107877, # 2007/04/01
    109356, # 2007/07/01
    112185, # 2007/10/01
    ]

La meilleure façon de trouver ce recid est la dichotomie... (limpide!)

Grégory m'a donné le 24 05 07 une indication sur le moyen de récupérer la recid de la prmière notice du trimestre : echo "select min(id) from bibrec where creation_date > '2007-04-01';" | dbexec

 

Modifier la liste des actualités sur le site infoscience

  1. S'authentifier comme administrateur sur infoscience
  2. Sous Vos activités d'administration, sélectionner Configuration Web Search

  3. Choisir Show all:le système affiche l'arbre des pages du site infoscience

  4. Sous Modify collection tree: Infoscience, sélectionner la page d'accueil (la racine du site): infoscience

  5. Sous éditer alternativement les portalboxes en français ou en anglais (il est possible de modifier son titre, son contenu et sa position dans la page)

  6. Sauvegarder la modification. Elle sera active lorsque webcoll aura rafraîchit le cache (généralement toutes les 15 minutes)

A noter qu'il possible d'associer des portalboxes spécifiques à n'importe quel endroit de l'arborescence, par exemple sous chaque Faculté... cette option n'a jusqu'à présent jamais été utilisée. A étudier.

 

Mettre à jour le code source sur le serveur de développement

  1. Faire les changements dans la branche principale de infoscience ou du framework, les commiter.
  2. Tester si ça marche.
  3. Faire un tla replay sur le serveur, dans le répertoire qui a changé (soit infoscience, soit infoscience/filters pour le framework).

  4. Faire tourner make install dans le répertoire infoscience.

  5. Reinitialiser Apache pour recharger tout les modules python: sudo apachectl graceful.

 

Mettre à jour l'alias email infoscience-admin

Un alias infoscience-admin@epfl.ch est à disposition. Il est utilisé pour diffuser les messages du système (alertes, soumission, édition, tâches nocturnes, etc.). Actuellement (27.3.2007), les 3 personnes inscrites à cet alias et qui reçoivent ces notifications sont:

Toute modification est à demander à postmaster@epfl.ch .

 

Trucs et astuces divers

 

Exporter un panier/collection en MARCXML

Vous avez regroupé des notices à modifier dans une collection privée, et vous souhaiteriez la voir en MARCXML, histoire d'éditer tout cela. Si vous avez l'ID de la collection (il est affiché dans l'interface à côté de son nom), vous pouvez tenter cette adresse: http://infoscience.epfl.ch/yourbaskets/epfl_display?of=xm&selected_bskid=xyz où xyz est l'ID de la collection.

 

Ajouter un éditeur au Wiki

 

Résoudre les problèmes d'accès en édition au Wiki

 

Afficher les taches en cours pour un utilisateur donné

Voici le code à utiliser pour afficher sur le wiki Infoscience une liste de toutes les tâches que vous avez en cours:

 

[[SearchInPagesAndSort(pages = "^(Projet/.*|Milestone.*|Labo/.*)$", searchtext = "\*.*\{[123]\}.*\[TG\]", UnassignedText = "autres")]]

Pour voir ce que ça donne: http://infoscience-wiki.epfl.ch/tguignar

Il s'agit en fait d'une rechercher dans les pages des labos (ainsi que Projet et Milestones) partout où il y a un niveau de priorité suivi des initiales du bibliothécaire (par exemple dans le paragraphe "activités"), exemple {1} [TG] Faire ceci cela

Il faut évidemment remplacer TG par vos initiales.

HOWTOs (dernière édition le 2013-04-16 12:30:53 par borel)