ONYX:9.0:KB:Nettoyage des fichiers du Spooler

Introduction

Dans son fonctionnement normal, ONYX Server crée et conserve un certain nombre de fichiers qu’il est conseillé de régulièrement épurer : travaux conservés, journaux d’événements, statistiques. Ces opérations sont réalisables par une commande ONYX Server : map_cron.

Épuration des travaux

Par durée de rétention

Tous les travaux circulant dans le Spooler possèdent un attribut spécifique qui est la durée de rétention (en nombre de jours). L’épuration des travaux dans le Spooler se base sur cet attribut pour nettoyer tous les travaux arrivés à échéance c’est-à-dire dont la durée de rétention est dépassée.

Deux commandes ONYX Server existent :

• Suppression de tous les travaux conservés (donc ayant été traités) dont la durée de rétention est dépassée :

Linux: /apps/mapping/bin/map_cron –date

Windows: E:\MappingWindows\Applications\map_cron.exe –date

• Suppression de tous les travaux (quel que soit leur état) dont la durée de rétention est dépassée :

Linux: /apps/mapping/bin/map_cron –dateall

Windows: E:\MappingWindows\Applications\map_cron.exe –dateall

Par filtres de nettoyage

Pour nettoyer le Spooler de certains travaux, une méthode plus fine consiste à utiliser des filtres de sélection des travaux à supprimer. Cinq filtres sont disponibles :

- Par type de file d’attente : point d’entrée ( -entry) ou file d’attente d’impression ( -queue)

- Par date : absolue (travaux plus anciens que tel jour, argument -before_date:JJ/MM/AAAA) ou relative (travaux de plus de N jours ( -relative_date:d/m/y)

- Par utilisateur propriétaire :argument -user:XXXX

- Par état des travaux : argument -state:XXXX (ready, saved, held, error)

- Par nom de file d’attente : argument -queue_name:XXXX

Voici quelques exemples d’utilisation :

• Suppression de tous les spools :

map_cron –cleanspool

• Suppression des spools de l’utilisateur mapadmin :

map_cron -cleanspool -user:mapadmin

• Suppression des spools conservés de l’utilisateur mapadmin :

map_cron -cleanspool -user:mapadmin -state:saved

• Suppression des spools conservés, de l’utilisateur mapadmin, dans les points d'entrée :

map_cron -cleanspool -user:mapadmin -state:saved -entry

• Suppression des spools conservés, de l’utilisateur mapadmin, dans les points d'entrée, dont la date est antérieure au 19 janvier 2018 :

map_cron -cleanspool -user:mapadmin -state:saved -entry -before_date:19/01/2018

• Suppression des spools conservés, de l’utilisateur mapadmin, dans les points d'entrée, de plus de 10 jours :

map_cron -cleanspool -user:mapadmin -state:saved -entry -relative_date:10/0/0

• Suppression des spools conservés, de l’utilisateur mapadmin, de plus de 10 jours, dans le point d'entréemon_entry :

map_cron -cleanspool -user:mapadmin -state:saved -entry -relative_date:10/0/0 -queue_name:mon_entry

Remarque:

Pour fonctionner, l’exécution de ces commandes de nettoyage des travaux doit se faire avec le Spooler ONYX Server en état de marche. En effet, seul le Spooler peut interagir avec ses travaux alors que les commandes précédentes envoient des requêtes de suppression au Spooler.

Épuration des journaux d’événements

La commande map_cron permet également de nettoyer les fichiers correspondants aux journaux d’événements d'ONYX Server. Des options permettent de conserver, pour historique, des archives des journaux d’événements avant leur suppression.

• Création d’une archive (ZIP) des journaux avant suppression :

Linux: /apps/mapping/bin/ map_cron -cleanlog

Windows: E:\MappingWindows\Applications\ map_cron.exe -cleanlog

L’archive est conservée par défaut à la racine du répertoire des logs Onyx Server (variable PATH_LOG de la configuration), nommée en fonction de la date/heure d’exécution de la commande.

• Suppression des journaux sans sauvegarde :

Linux: /apps/mapping/bin/map_cron -cleanlog -delete

Windows: E:\MappingWindows\Applications\map_cron.exe -cleanlog -delete

Épuration des statistiques

Sur le même principe que précédemment, les fichiers correspondants aux statistiques et rapports d’utilisation d'ONYX Server peuvent être nettoyés :

Linux: /apps/mapping/bin/ map_cron -cleanstats [ -delete ]

Windows: E:\MappingWindows\Applications\ map_cron.exe -cleanstats [ -delete ]