source: trunk/at-cron/at-cron.tex @ 225

% $Id: perlexercises.tex 187 2008-09-05 02:43:56Z nanardon $
\documentclass[a4paper,12pt]{article}
\usepackage[frenchb]{babel}
\usepackage[T1]{fontenc}
\usepackage{moreverb}
\usepackage{graphicx}

\title{At \& Cron}
\author{Olivier Thauvin}
\date{\today}

\begin{document}

\maketitle

\tableofcontents{}

\section{Cron}

Cron permet est un démon qui va s'occuper de lancer des tâches à intervalle
régulier.

\subsection{La crontab}


Cron utilise plusieurs fichiers de configuration, le principal est
\verb+/etc/crontab+, mais celui nous interesse peu car son utilisation
est réservé au super utilisateur (\verb+root+).

\subsubsection{Format}

Les \verb+crontab+ sont des fichiers textes où chaque ligne est
soit une variables d'environement à définir, sous la forme
\begin{verbatim}
MAILTO=moi
\end{verbatim}
soit une tâche à executer:
\begin{verbatim}
0 * * * * dosomething
\end{verbatim}
soit un commentaire, ces dernières commençant par un \verb+#+.

\paragraph{format des tâches}
Chaque tâche à executer est spécifiée par une série de 5 valeurs qui
définissent
le moment de leur lancement et de la commande à executer.

Les 5 valeurs sont (par ordre)
\begin{itemize}
\item les minutes (0 à 59),
\item les heures (0 à 23),
\item les jours du mois (1 à 31),
\item les mois (1 à 12),
\item les jours de la semaine (0 à 7),
\end{itemize}

Un observateur attentif me fera remarquer qu'il y a 8 valeurs pour les 7 jours
de la semaine, effectivement, le dimanche peut être spécifié soit par un 0, soit
par un 7.

Pour chaque paramètre, différentes valeur peuvent spécifié séparé par des
virgule, un interval est précisé en séparant deux valeur par un tiret,
de plus une \verb+*+ remplacer n'importe quelle valeur.

Ainsi:
\begin{verbatim}
0 * * * * dosomething
\end{verbatim}
lancera l'application 'dosomething' lorsque les minutes seront 0, pour n'importe
quels heures, jour, moi, soit toutes les heures.

\begin{verbatim}
30 12 * * 1-5 echo 'va manger'
\end{verbatim}
vous rappelera par mail d'aller manger les jours ouvrés.

\paragraph{Nota Bene}
Il existe enfin un dernière forme de notation pour préciser un interval sous
la forme \verb+/x+, qui indique que la tâche doit lancer avec un interval de
\verb+x+:
\begin{verbatim}
*/5 * * * * dosomething
\end{verbatim}
lancera 'dosomething' toutes les 5 minutes. Malheureusement cette notation
n'est pas valable avec tout les démons cron (elle fonctionne en général
sous linux). Si vous tenez à être portable préférer la notation
\begin{verbatim}
0,5,10,15,20,25,30,35,40,45,50,55 * * * * dosomething
\end{verbatim}
certe moins commode.

\subsubsection{Edition de la crontab}

Le simple utilisateur ne peut editer directement les fichiers de configuration,
mais les outils fournis par cron permettent à chacun d'avoir sa propre
\verb+crontab+.

\paragraph{injection du fichier}

Pour se faire vous devez éditer votre future \verb+crontab+, pour se faire
il suffit d'editer un fichier avec votre editeur favoris. Une fois votre
\verb+crontab+ terminée, il faut l'injecter avec le programme \verb+crontab+:

\begin{verbatim}
crontab ./macrontab
\end{verbatim}

où \verb+./macrontab+ est le fichier contenant vos future tâches à lancer.

Evidement celle-ci va remplacer l'éventuelle liste des tâches que vous pouviez
avoir. Aussi vous prendez soin avant de d'abord récupérer votre précédente
configuration:

\begin{verbatim}
crontab -l > ./macrontab
\end{verbatim}

\verb+crontab -l+ sort votre \verb+cron+ existante, celle est redirigée vers
le fichier \verb+./macrontab+.

\paragraph{edition directe}

La première méthode d'edition de sa \verb+crontab+ est assez peu conviviale.
L'outils \verb+crontab+ dispose de l'option \verb+-e+ qui permet d'éditer votre
\verb+crontab+ et de la reacharger dans la foulée. Par défaut l'éditeur est
\verb+vi+, mais comme de nombreux outils, vous pourrez spécifier votre editeur
favori dans la variable d'envirronement \verb+EDITOR+.

\section{At}

Le démon at permet de programmer l'éxecutation d'une tâche sous deux formes:
l'éxecution programmée à un moment donné et la mise en attente (queue batch).

\subsection{Definition de la tâche}
Quelque soit le mode, les commandes at prendons comme listes des choses à
executer ce qui arrive sur l'entrée standard, et sans autre précision, les
executerons avec soit le contenu de la variable d'environnement \verb+SHELL+
si celle-ci est définie, soit votre shell, soit en dernier recours
\verb+/bin/sh+.

\subsection{Tâche programmée}

L'utilisation la plus courante de at est de programmée une action
pour un heure et éventuellement un date donnée. Cette tâche ne sera
executée qu'une seule fois.

La programmation d'une tâche se fait avec le programme \verb+at+ avec pour
argument l'heure et éventuellement la date si elle ne doit pas être lancée
dans les prochaines 24 heures.

\verb+at+ accepte plusieurs format de dates et heure, je ne parlerais ici
que de ceux qui me paraissent les moins ambigus, rappelez-vous que les
anglophones ont la sale habitude d'exprimer les dates sous la forme
\verb+MOIS/JOURS/ANNEE+\ldots, du coup, vos voeux de bonne année envoyés
le 7/1 risquent d'arriver au début des vacances scolaires d'été.

\subsubsection{heure et date absolues}

\paragraph{L'heure}
Le premier argument passé à \verb+at+ sera donc l'heure, sous la forme
\verb+HH:MM+. Rien de bien sorcier ici jusque là.

Si vous préférez un format sur 12 heures au lieu de 24, at accept les
suffixent \verb+am+ et \verb+pm+, comme par exemple \verb+8H30pm+.

\paragraph{La date}
Elle passé en second argument et est optionnelle, si celle-ci n'est pas
précisée, at considéra que la tâche doit être lancée dans les prochaines 24
heures.

Le seul format qui respecte nos habitudes de formulation d'une date utilise
le point comme séparateur: \verb+JJ.MM.AA+, attention, en utilisant le slash
(\verb+/+) comme séparateur, \verb+at+ considéra que la date est au format
anglo-saxon (le mois en premier).

Plus concrètement, Noël prochain sera noté \verb+25.12.2008+.

\subsubsection{les date et heures relatives}

Il est également possible de préciser le moment de l'execution de manière
plus humaine, en indiquant soit une durée à partir du moment où vous taper
la commande (dans une heure), soit à l'aide de mot clef tel que 'demain'.

Une durée relative est indiquée par la formule clef \verb$now +$, suivi
du la période sous la forme \verb+NB unité+. Les unités acceptées sont:
\begin{itemize}
\item minutes,
\item hours,
\item days,
\item weeks.
\end{itemize}

Prenons par exemple une tache à lancer dans une demi heure:
\begin{verbatim}
at now + 30 minutes
\end{verbatim}

Enfin \verb+at+ supporte le mot clef tel "tomorrow" qui veut dire "demain".

\subsection{queue batch}

En dehors de la programmation à heure donnée, at permet également de gérer
une file d'attente rudimentaire de tâche à executer.

Chaque tâche sera lancé dès lors que la charge (le load) de la machine descend
en dessous d'un certain seuil, en attendant 60 secondes entre chaque.

Cette méthode est très éfficace et pratique pour donner du travail à
l'ordianteur sans pour autant rester devant le clavier ni le surcharger.

\paragraph{Le seuil de charge}
La valeur de charge d'un machine représente le nombre de processeur
qui serait idéalement necessaire pour accomplir les tâches actuellement
en cours. La valeur par défaut que \verb+at+ utilise est de 0.8. Ceci pose
deux problèmes.

D'abord nombre de machine arrivent désormais avec au moins deux unités de
calculs (coeur), bientôt et certains fabricants ont pour projet d'arriver
à 64, un indice de charge supérieur à 1 ne veut donc pas forcément dire
que la machine est surchargée.

Ensuite dans certain cas le système doit gérer beaucoup d'entrée sortie
sans pour autant que les processeurs ne soient réellement solicités, hors
ce genre d'activité est pris en compte par l'indice de charge.

\end{document}