Cron jobs¶
Un cron job est une commande Linux permettant de planifier le lancement d’une commande ou d’un script sur votre serveur afin d’exécuter automatiquement des tâches à répéter. Les scripts exécutés en tant que cron job sont généralement utilisés pour effectuer des modifications sur des fichiers ou bases de données ; ils peuvent cependant effectuer d’autres tâches qui ne modifient pas les données sur le serveur, comme expédier des notifications par courriel. Vous pouvez activer plusieurs cron jobs sur Koha (lancement de l’indexation du moteur de recherche, génération d’avertissement pour retard, nettoyage des données, etc…), qui seront détaillées dans ce chapitre.
Exemple de crontab¶
Un exemple de crontab Koha se trouve dans misc/cronjobs/crontab.example.
Cet exemple contient quelques propositions de paramétrages de cron pour les cronjobs les plus utilisés.
Cron jobs¶
Les chemins de fichier mentionnés ci-dessous présupposent que les fichiers crons sont placés dans misc/. Si vous disposez d’une installation standard et que ceux-co ne sont pas dans misc/, regardez dans bin/.
Sauvegarde¶
Sauvegarde journalière¶
Chemin du script : misc/cronjobs/backup.sh
Tâche effectuée : Crée une sauvegarde journalière de la base de données Koha.
Périodicité préconisée : chaque jour
Rechercher¶
Carte du site¶
Chemin du script : misc/cronjobs/sitemap.pl
Tâche effectuée : traite toutes les notices bibliographiques d’une instance Koha et génère une carte du site compatible avec le protocole décrit ici : http://sitemaps.org. Le but de ce script est de pouvoir fournir aux moteurs de recherche un accès direct aux notices bibliographiques. Cela évite de laisser les moteurs de recherche interroger l’OPAC de Koha ce qui génère beaucoup de trafic et une surcharge du serveur.
Note Un fichier nommé sitemapindex.xml est généré. Il contient les références aux différents fichiers sitemap. Chaque fichier contient au maximum 50 000 URLs et est nommé sitemapXXXX.xml.
Ces fichiers doivent être stockés dans le répertoire racine (root) de l’OPAC Koha. Dans le même répertoire, il faut un fichier robots.txt avec le contenu suivant :
Sitemap: sitemapindex.xml User-agent: * Disallow: /cgi-bin/
Reconstruction de l’index¶
Chemin du script : misc/migration_tools/rebuild_zebra.pl
Tâche effectuée : Mise à jour des index Zebra avec les données récemment modifiées
Requis par : Zebra
Périodicité préconisée : tous les n minutes (plutôt entre 5 et 15 mn), selon le niveau de performance recherché
Circulation¶
File des réservations¶
Chemin du script : misc/cronjobs/holds/build_holds_queue.pl
Tâche effectuée : Mise à jour de la file de réservations
Requis par : Holds Queue Report
Périodicité préconisée : toutes les 15 mn
Description :
Ce script devrait être exécuté régulièrement si vos adhérents sont autorisés à placer des réservations sur des documents en rayon. Le script établit quelle bibliothèque doit prendre en charge la demande de réservation.
Ce processus est contrôlé par les préférences système ref:StaticHoldsQueueWeight <staticholdsqueueweight,-holdsqueueskipclosed-&-randomizeholdsqueueweight-label> and RandomizeHoldsQueueWeight.
Si vous ne voulez pas que toutes vos sites participent au processus de réservation en rayon, vous devez répertorier ici les sites qui *participent* au processus en saisissant leurs codes (branchcodes), séparés par des virgules (par ex. « MPL, CPL, SPL, BML », etc).
La file d’attente des réservation sera générée par défaut de manière à ce que le système gère d’abord les réservations disponibles sur le site de retrait. S’il n’y a pas d’exemplaire disponible sur le site de retrait pour établir la liste des réservations, build_holds_queue.pl utilisera la liste des bibliothèques définie dans StaticHoldsQueueWeight. Si RandomizeHoldsQueueWeight est désactivé (il l’est par défaut), le script assignera les demandes de traitement dans l’ordre des autre sites indiqués dans la préférence système StaticHoldsQueueWeight.
Par exemple si votre réseau compte trois sites de taille variable (petit, moyen et grand) et que vous souhaitez que la gestion des réservations soit effectuée par le plus grand site avant le plus petit, votre préférence système StaticHoldsQueueWeight ressemblera à quelquechose comme « LRG,MED,SML ».
Si vous souhaitez répartir de manière équitable la réponse aux demandes de réservations au sein de votre réseau, activez RandomizeHoldsQueueWeight. Lorsque cette préférence système est activée, l’ordre dans lequel les sites devront répondre aux demandes de réservations pour une demande de document disponible sera généré de façon aléatoire à chaque réactualisation de la liste.
Il est contre-indiqué de laisser StaticHoldsQueueWeight vide pour le moment. Cela force le script build_holds_queue à ignorer RandomizeHoldsQueueWeight, les demandes sont alors assignées aux sites non pas aléatoirement, mais par ordre alphabétique.
Réservations expirées¶
Chemin du script : misc/cronjobs/holds/cancel_expired_holds.pl
Tâche effectuée : Par défaut, ce cron job annulera automatiquement les seules réservations pour lesquelles l’utilisateur a indiqué une date d’expiration. Si la bibliothèque utilise les préférences Permettre et ExpireReservesMaxPickUpDelayCharge, ce script annulera également les réservations mises de côtés depuis trop longtemps et placera une amende pour l’adhérent n’ayant pas retiré la réservation (selon la pratique de la bibliothèque).
Périodicité préconisée : chaque jour
Réactiver les réservations¶
Chemin du script : misc/cronjobs/holds/auto_unsuspend_holds.pl
Tâche effectuée : Ce script recherche les réservations qui ne doivent plus être suspendues et supprime la suspension si la préférence Réactiver toutes les réservations suspendues a la valeur “autoriser”. L’adhérent est replacé dans la file des réservations là où il se trouvait lorsque la réservation a été suspendue.
Périodicité préconisée : chaque jour
Amendes¶
Chemin du fichier : misc/cronjobs/fines.pl
Fonction: Calcules et attribue les amendes aux comptes des adhérants.
Requis par : finesMode system preference
Périodicité préconisée : chaque jour
Amendes fixes¶
Chemin du script : misc/cronjobs/staticfines.pl
Tâche effectuée : ce script calcule et ajoute les amendes dans les comptes des adhérents.
Note Si la préférence système “finesMode” a la valeur “production”, les amendes sont ajoutées dans les comptes des adhérents. Si la valeur de cette préférence système est “test”, les amendes sont calculées mais pas appliquées.
Note Les amendes ne sont pas appliquées pour un jour déclaré fermé.
Retards de longue durée¶
Chemin du fichier : misc/cronjobs/fines.pl
Fonction: permet de spécifier des délais avant de changer le status d’un exemplaire, et optionnellement mettre une facture pour ceux-ci en utilisant le montant de remplacement listé dans la notice de l’exemplaire.
Périodicité préconisée : chaque jour
Note
Le personnel peut contrôler une partie des paramètres du cron job long retard (longoverdue) avec les préférences systèmes DefaultLongOverdueLostValue <defaultlongoverduelostvalue-&-defaultlongoverduedays-label>` et DefaultLongOverdueChargeValue.
Suivre le nombre total de prêts¶
Chemin du script : misc/cronjobs/update_totalissues.pl
Tâche effectuée : met à jour le champs biblioitems.totalissues dans la base de donnée avec le dernier décompte de prêts calculé à partir de l’historique des prêts de la table statistics.
Périodicité préconisée : chaque jour
Attention
Si le temps dans votre base de données ne concorde pas avec le temps sur votre serveur Koha, vous devrez prendre cela en compte, et probablement utiliser –since plutôt que –interval pour la mise a jour incrémentielle
Note
Ce cronjob peut être utilisé s’il y a un problème de performance. Sinon, utiliser la préférence système UpdateTotalIssuesOnCirc.
Generate Patron File for Offline Circulation¶
Chemin du script : misc/cronjobs/create_koc_db.pl
Tâche effectuée : génère le fichier borrowers.db utilisé par l’outil Koha Offline Circulation
Périodicité préconisée : chaque jour
Renouvellement automatique¶
Chemin du script : misc/cronjobs/automatic_renewals.pl
Tâche effectuée : Renouvellera automatiquement les prêts si vous utilisez les renouvellements automatiques dans vos circulation and fine rules.
Périodicité préconisée : chaque jour
Adhérents¶
Suppression d’adhérents par lots¶
Chemin du script : misc/cronjobs/delete_patrons.pl
Tâche effectuée : Supprime par lot les adhérents sur les critères suivants : pas de prêt depuis, compte expiré avant, vu pour la dernière fois, catégorie d’adhérent, bibliothèque.
Instrument à cordes frottées, non précisé¶
Chemin du script : misc/cronjobs/delete_expired_opac_registrations.pl
Tâche effectuée : Supprime les inscriptions faites via l’opac et qui non pas été validées par la bibliothèque pendant le nombre de jour entrés dans la préférence PatronSelfRegistrationExpireTemporaryAccountsDelay .
Périodicité préconisée : chaque jour
Unconfirmed Registrations¶
Chemin du fichier : misc/cronjobs/delete_unverified_opac_registrations.pl
Tâche effectuée : supprime les adhérents pré-inscrits en ligne via l’OPAC qui n’ont pas confirmé leur inscription par mail dans les 24 heures. C’est nécessaire seulement si vous demandez aux adhérents de confirmer leur pré-inscription par mail avec la préférence système PatronSelfRegistrationVerifyByEmail.
Périodicité préconisée : chaque jour
Anonymize Patron Data¶
Chemin du script : misc/cronjobs/batch_anonymise.pl
Fonction: utilisé pour anonymiser les données d’un adhérant. Ceci enlèvera les borrowernumbers de l’historique de circulation, de sorte que les statistiques sont conservées mais que les informations de l’adhérant soit retirées.
Changement de type d’utilisateur: enfant à adulte¶
Chemin du fichier : misc/cronjobs/fines.pl
Fonction: Converti les adhérents juvéniles/enfant de la catégorie juvénile avec leur code de catégorie le type de catégorie adule, en changeant le code une fois qu’ils atteignent la limite d’âge définie dans les préférences de catégories d’adhérents.
Périodicité préconisée : chaque jour
DESCRIPTION
Ce script transforme les adhérents de type enfant en adhérents de type adulte, supprime le garant, et met à jour leur catégorie d’usager lorsqu’ils atteignent la limite d’âge supérieure définie dans les catégories d’adhérents.
EXEMPLES D’UTILISATION
« juv2adult.pl »
« juv2adult.pl » -b=<branchcode> -f=<categorycode> -t=<categorycode> (Traite un seul site, et met à jour les adhérents de l’une des categorycode vers l’autre categorycode)
« juv2adult.pl » -f=<categorycode> -t=<categorycode> -v -n (Traite tous les sites, montre tous les messages, indique les adhérents qui vont être traités. Ne modifie pas la base de données)
Notifications¶
File des messages¶
Chemin du script : misc/cronjobs/process_message_queue.pl
Tâche effectuée : traite la file des messages (message queue) pour envoyer les courriels de prêts, de retours et de réservations disponibles ; pour envoyer les SMS et les courriels sortant aux adhérents. Nécessite d’activer EnhancedMessagingPreferences
Périodicité préconisée : toutes les 15 mn
Important
Les notifications Item due et Advanced due sont contrôlées par le cron job advance_notices cron.
2 = préavis de rappel¶
Chemin du script : misc/cronjobs/advance_notices.pl
Tâche effectuée : prépare les notifications « pre-due » et « item due » pour les adhérents qui en ont fait la demande. Nécessite d’activer EnhancedMessagingPreferences
Périodicité préconisée : chaque jour
Note
Ce script n’envoie pas de notifications. Il les place dans la file des messages à envoyer message queue
ODUE (Notification de retard)¶
Chemin du script : misc/cronjobs/overdue_notices.pl
Fonction : prépare les messages de retard pour les usagers (à la fois en version email et imprimée)
Périodicité préconisée : chaque jour
Note
Ce script n’envoie pas de notifications. Il les place dans la file message queue ou génère le code HTML pour la version papier
Voir aussi
Le cron job misc/cronjobs/advance_notices.pl permet d’envoyer aux adhérents des messages pour les documents à retourner prochainement ou pour les documents à retourner dès à présent (messages de courtoisie).
Notifications pour retard papier¶
Chemin du fichier : misc/cronjobs/printoverdues.sh
Tâche effectuée : génère des fichiers PDF à partir des fichiers HTML contenus dans les répertoires, et les imprime.
Impression des notifications de réservation¶
Chemin du script : misc/cronjobs/gather_print_notices.pl
Tâche effectuée : recherche dans la file des messages (message queue) les notifications de réservation qui n’ont pas été envoyées parce que l’adhérent n’a pas d’adresse de courriel, et génère une notification papier.
Périodicité préconisée : chaque jour
Talking Tech¶
To learn more about setting up this third party product view the Talking Tech chapter.
Envoyer un fichier de notices¶
Chemin du script : misc/cronjobs/thirdparty/TalkingTech_itiva_outbound.pl
Tâche effectuée : génère le fichier de sortie Spec C contenant les notifications pour le système de notification téléphonique Talking Tech i-tiva.
Requis par : Activer
Périodicité préconisée : chaque jour
Notifier les adhérents prochainement expirés¶
Chemin du script : misc/cronjobs/membership_expiry.pl
Tâche effectuée : Génère un message pour aviser les adhérents de l’expiration de leur carte via le cron messaage queue .
Requiert : MembershipExpiryDaysNotice
Périodicité: chaque soir
En cours de traitement/Chariot de livres¶
Chemin du script : misc/cronjobs/cart_to_shelf.pl
Tâche effectuée : met à jour tous les exemplaires ayant la localisation CART (chariot) vers leur localisation normale (permanent location).
Requis par : NewItemsDefaultLocation, InProcessingToShelvingCart, & ReturnToShelvingCart system preferences
Périodicité préconisée : chaque jour
Catalogue¶
Traitement par lot pour les imports par webservice¶
Chemin du script : misc/cronjobs/import_webservice_batch.pl
Tâche effectuée : cron job pour traiter par lot les files d’import de type “webservice”. Les lots peuvent aussi être traités via l’interface graphique.
Note
Ce script est utilisé pour la connexion OCLC
Démon pour la connexion aux imports¶
Chemin du script : misc/bin/connexion_import_daemon.pl
Tâche effectuée : démon qui écoute les requêtes de connexion d’OCLC et est compatible avec les spécifications de la passerelle OCLC. Il prend les requêtes MARC XML et les paramètres d’import par lots via un fichier de configuration et les fait suivre dans svc/import_bib
Note
Ce script est utilisé pour la connexion OCLC
Suppression d’exemplaires par lot¶
Chemin du script : misc/cronjobs/delete_items.pl
Tâche effectuée : outil de suppression d’exemplaires par lot, qui génère une requête dans la base de données et supprime les exemplaires correspondant aux critères spécifiés dans les arguments de la commande.
Vérification rapide d’URL¶
Chemin du script : misc/cronjobs/check-url-quick.pl
Tâche effectuée : Vérifie les URLs des notices bibliographiques
Note
Ce script remplace le script check-url.pl
Retour¶
Chemin du fichier : misc/cronjobs/fines.pl
Fonction: vérifie les URL des champs 856$. La production du script peut maintenant être formattée en CSV ou HTML. La version HTML est lié directement avec l’édieur de notices.
Périodicité préconisée : chaque jour
Pour en savoir plus : http://wiki.koha-community.org/wiki/Check-url_enhancements
Supprime les notices via le leader¶
Chemin du script : misc/cronjobs/delete_records_via_leader.pl
Tâche effectuée : tente de supprimer toutes les notices MARC où le caractère en position 5 du leader est “d”
Modifier des autorités¶
Chemin du script : misc/cronjobs/merge_authorities.pl
Permission d’accéder à la gestion des notices d’autorité
Note
Le nom du script est trompeur. Ce script ne fusionne pas les autorités entre elles, mais à la place met à jour les données d’autorité dans les données bibliographiques liées. Les modifications faites dans une notice d’autorité seront appliquées dans les notices bibliographiques qui utilisent cette autorité lorsque ce script est lancé.
Requis par : dontmerge system preference
Périodicité préconisée : chaque jour
Abonnement(s) mis à jour :¶
Chemin du fichier : misc/cronjobs/fines.pl
Tâche effectuée : vérifie s’il y a un numéro en retard dans les abonnements actifs, et s’il y en a, le déclare “en retard” et ajoute le numéro suivant comme “attendu”.
Périodicité préconisée : chaque jour
Mise à jour automatique d’exemplaire¶
Chemin du script : misc/cronjobs/automatic_item_modification_by_age.pl
Tâche effectuée : met à jour les exemplaires sur la base d’une liste de règles définies préalablement dans l’outil Modification automatique d’exemplaires par ancienneté
Nécessaire pour Modification automatique d’exemplaires par ancienneté
Périodicité préconisée : chaque nuit
OPAC¶
Flux RSS¶
Chemin du fichier : misc/cronjobs/fines.pl
Tâche effectuée : produit un document XML RSS pour chaque requête SQL (n’est pas utilisé pour le flux RSS des recherches). En savoir plus.
Périodicité préconisée : chaque jour
Autorités à fusionner¶
Chemin du script : misc/cronjobs/build_browser_and_cloud.pl
Fonction: Génère du contenu pour les authorité dans l’OPAC.
Requis par : OpacBrowser system preference
Important
Cette préférence et job de Cron devraient être seulement utilisés dans des systèmes Français.
Nuage de sujets¶
Chemin du fichier : misc/cronjobs/fines.pl
Fonction: Génères des mots-clef HTML à partir des index de Koha et Zebra. misc/cronjobs/cloud-sample.conf en tant qu’exemple de la façcon dont ce scriptes opères.
Fréquence: Ceci est le type de scripte qui s’active une fois par mois ou environ,et le contenu généré
Administration du système¶
Quota de services¶
Chemin du script : misc/cronjobs/services_throttle.pl
Tâche effectuée : Réinitialise le nombre de services xISBN
Périodicité préconisée : chaque jour
Nettoyage de la base de données¶
Chemin du script : misc/cronjobs/cleanup_database.pl
Tâche effectuée : tronque la table des sessions, nettoie les vieilles entrées de la table zebraqueue, les logs d’activité (action logs) et les fichiers MARC importés dans le réservoir.
Acquisitions¶
Nettoie les vieilles suggestions¶
Chemin du script : misc/cronjobs/purge_suggestions.pl
Tâche effectuée : supprime les vieilles suggestions (suivant votre paramétrage) de l’interface de gestion des suggestions.
Note
The system preference PurgeSuggestionsOlderThan defines the number of days used in the script
Courriel de suggestions à traiter¶
Chemin du script : misc/cronjobs/notice_unprocessed_suggestions.pl
Fonction: génère une notification au propriétaire du fond, pour indiquer qu’il y a des suggestions en demande de traitement.
Traitement des messages EDI¶
Chemin du script : misc/cronjobs/edi_cron.pl
Fonction: Envoi et reçois des messages EDI
Périodicité préconisée : toutes les 15 minutes
Supprime les fichiers EDI temporaires¶
Chemin du script : misc/cronjobs/remove_temporary_edifiles.pl
Tâche effectuée : supprime les fichiers EDI temporaires vieux de plus de 5 jours
Rapports¶
Lancer le rapport¶
Chemin du script : misc/cronjobs/runreport.pl
Tâche effectuée : exécute les rapports sauvegardés existants
Import les données des adhérents¶
NL sync to Koha¶
Script path: misc/cronjobs/nl-sync-to-koha.pl
Does: sync patrons from the Norwegian national patron database (NL) to Koha
Note Relies on NorwegianPatronDBUsername and NorwegianPatronDBPassword system preferences
NL sync from Koha¶
Script path: misc/cronjobs/nl-sync-from-koha.pl
Does: sync patrons from Koha to the Norwegian national patron database (NL)
Note Relies on NorwegianPatronDBUsername and NorwegianPatronDBPassword system preferences
Supprimer abonnement¶
Il n’y a pas de modification d’adhérent en attente.
Chemin du script : misc/cronjobs/update_items.pl
Chemin du fichier : misc/cronjobs/fines.pl
Chemin du fichier : misc/cronjobs/fines.pl
Chemin du fichier : misc/cronjobs/fines.pl
Chemin du script : misc/cronjobs/zebraqueue_start.pl
Social data¶
Get report social data¶
Script path: misc/cronjobs/social_data/get_report_social_data.pl
Does: downloads data from Babelthèque to add to OPAC records
Périodicité préconisée : chaque jour
Update social data¶
Script path: misc/cronjobs/social_data/update_social_data.pl
Does: updates OPAC records with Babelthèque social data