Nettoyage des fichiers du Spooler/en

<languages/>
==Introduction==
ONYX Server normally creates and keeps a certain number of files which we advise you regularly clear: kept jobs, logs, statistics. This can be done using an ONYX Server command: <code>map_cron</code>.

==Clearing jobs==
===As per retention time===
All the jobs in the Spooler have a specific attribute: the retention time (in days). The solution uses this attribute to clear the "expired" jobs in the Spooler, in other words, those with an exceeded retention time.

There are two ONYX Server commands which serve this purpose:

*Deleting all the jobs kept (which were processed and kept) with an expired retention time:

Linux: <code>/apps/mapping/bin/map_cron –date</code>

Windows: <code>E:\MappingWindows\Applications\map_cron.exe –date</code>

*Deleting all the jobs (whatever status) with an expired retention time:

Linux: <code>/apps/mapping/bin/map_cron –dateall</code>

Windows: <code>E:\MappingWindows\Applications\map_cron.exe –dateall</code>

===As per clearing filters===
One method to clear the Spooler of jobs consists in using filters to select the jobs to delete. Five filters are available:

-	As per type of queue: input point (<FONT color="blue"> -entry</FONT>) or print queue (<FONT color="blue"> -queue</FONT>)

-	As per date: absolute (jobs older than a given day, argument <FONT color="blue"> -before_date:JJ/MM/AAAA</FONT>) or relative (jobs of more than N days
(<FONT color="blue"> -relative_date:d/m/y</FONT>)

-	As per owner user: argument <FONT color="blue"> -user:XXXX</FONT>

-	As per job status: argument <FONT color="blue"> -state:XXXX</FONT> (ready, saved, held, error)

-	As per queue name: argument <FONT color="blue"> -queue_name:XXXX</FONT>


Here are some examples:

*To delete all the spooled files:

 map_cron –cleanspool

*To delete spooled files owned by the mapadmin user:

 map_cron -cleanspool -user:mapadmin

*To delete spooled files kept by the mapadmin user:

 map_cron -cleanspool -user:mapadmin -state:saved

*To delete spooled files kept by the mapadmin user, in the input points:

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

*To delete spooled files kept by the mapadmin user, in the input points, which have a date prior to the 19th of January 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


Note:

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 <FONT color="blue"> map_cron </FONT> 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: <code>/apps/mapping/bin/<FONT color="blue"> map_cron -cleanlog </FONT></code>

Windows: <code>E:\MappingWindows\Applications\<FONT color="blue"> map_cron.exe -cleanlog </FONT></code>

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: <code>/apps/mapping/bin/<FONT color="blue">map_cron -cleanlog -delete</FONT></code>

Windows: <code>E:\MappingWindows\Applications\<FONT color="blue">map_cron.exe -cleanlog -delete</FONT></code>

==É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: <code>/apps/mapping/bin/<FONT color="blue"> map_cron -cleanstats [ -delete ]</FONT></code>

Windows: <code>E:\MappingWindows\Applications\<FONT color="blue"> map_cron.exe -cleanstats [ -delete ]</FONT></code>