\item [Name = \lt{}nom\gt{}]
\index[dir]{Name}
+ \index[dir]{Directive!Name}
Le nom du Director utilis\'e par l'administrateur syst\`eme. Cette directive
est requise
\item [Description = \lt{ }texte\gt{}]
\index[dir]{Description}
+ \index[dir]{Directive!Description}
Le champ texte contient une description du Director qui sera affich\'ee dans
l'interface graphique. Cette directive est optionnelle.
\item [Password = \lt{}UA-password\gt{}]
\index[dir]{Password}
+ \index[dir]{Directive!Password}
Sp\'ecifie le mot de passe qui doit \^etre fourni par la Console Bacula par
d\'efaut pour \^etre autoris\'ee. Le m\^eme mot de passe doit appara{\^\i}tre
dans la ressource {\bf Director} du fichier de configuration de la console.
\item [Messages = \lt{}Nom-de-ressource-Messages\gt{}]
\index[dir]{Messages}
+ \index[dir]{Directive!Messages}
La ressource {\bf messages} sp\'ecifie o\`u doivent \^etre d\'elivr\'es les messages du Director
qui ne sont pas associ\'es \`a un job sp\'ecifique. La plupart des messages sont relatifs
\`a un job et seront dirig\'es vers la ressource {\bf messages} sp\'ecifi\'ee par le job.
\item [Working Directory = \lt{}R\'epertoire\gt{}]
\index[dir]{Working Directory}
+ \index[dir]{Directive!Working Directory}
Cette directive sp\'ecifie un r\'epertoire o\`u le Director peut d\'eposer ses fichiers
d'\'etats. Ce r\'epertoire ne devrait \^etre utilis\'e que par Bacula, mais il peut \^etre
partag\'e par d'autres {\it daemons} Bacula. Notez cependant que si ce r\'epertoire est
Les substitutions shell standard sont effectu\'ees \`a la lecture du fichier de
configuration, de sorte que des valeurs telles que {\bf \$HOME} seront correctement
substitu\'ees. Cette directive est requise.
-
+
+ Si vous avez sp\'ecifi\'e un utilisateur et/ou un groupe pour le Director lors de la
+ configuration avec les options {\bf {-}{-}with-dir-user} et/ou {\bf {-}{-}with-dir-group} de
+ la commande ./configure, le r\'epertoire de travail Working Directory doit appartenir
+ doit appartenir \`a ce groupe et \`a cet utilisateur.
+
\item [Pid Directory = \lt{}R\'epertoire\gt{}]
\index[dir]{Pid Directory}
+ \index[dir]{Directive!Pid Directory}
Cette directive sp\'ecifie un r\'epertoire o\`u le Director peut d\'eposer son fichier
d'Id de processus. Ce fichier est utilis\'e pour stopper Bacula et pr\'evenir l'ex\'ecution
simultan\'ee de plusieurs copies de Bacula. Les substitutions shell standard sont
\item [Scripts Directory = \lt{}Directory\gt{}]
\index[dir]{Scripts Directory}
+ \index[dir]{Directive!Scripts Directory}
Cette directive sp\'ecifie le r\'epertoire dans lequel le Director devra rechercher
le script Python de d\'emarrage {\bf DirStartup.py}. Ce r\'epertoire peut \^etre
partag\'e par d'autres daemons Bacula.Les substitutions shell standard sont effectu\'ees
\item [QueryFile = \lt{}Path\gt{}]
\index[dir]{QueryFile}
+ \index[dir]{Directive!QueryFile}
Cette directive sp\'ecifie un r\'epertoire et un fichier dans lequel le
Director peut trouver les requ\^etes SQL pr\'e\'etablies pour la commande
{\bf Query} de la Console. Les substitutions shell standard sont
\item [Maximum Concurrent Jobs = \lt{}nombre\gt{}]
\index[dir]{Maximum Concurrent Jobs}
+ \index[dir]{Directive!Maximum Concurrent Jobs}
\index[general]{Jobs Simultan\'es}
\index[general]{Jobs Concurrents}
\item [FD Connect Timeout = \lt{}dur\'ee\gt{}]
\index[dir]{FD Connect Timeout}
+ \index[dir]{Directive!FD Connect Timeout}
O\`u {\bf dur\'ee} est le d\'elai durant lequel le Director tente de contacter
le File Daemon pour d\'emarrer un job. Une fois ce d\'elai \'ecoul\'e, le Director supprimera le job.
La valeur par d\'efaut est 30 minutes.
\item [SD Connect Timeout = \lt{}dur\'ee\gt{}]
\index[dir]{SD Connect Timeout}
+ \index[dir]{Directive!SD Connect Timeout}
O\`u {\bf dur\'ee} est le d\'elai durant lequel le Director tente de contacter
le Storage Daemon pour d\'emarrer un job. Une fois ce d\'elai \'ecoul\'e, le Director supprimera le job.
La valeur par d\'efaut est 30 minutes.
\item [DirAddresses = \lt{}Sp\'ecification-adresses-IP\gt{}]
\index[dir]{DirAddresses}
+ \index[dir]{Adresse}
+ \index[general]{Adresse}
+ \index[dir]{Directive!DirAddresses}
Sp\'ecifie les ports et adresses sur lesquels le Director se met en attente de
connections de Consoles Bacula. La meilleure explication est sans doute un exemple :
\footnotesize
\begin{verbatim}
- DirAddresses = { ip = {
- addr = 1.2.3.4; port = 1205;}
+ DirAddresses = {
+ ip = { addr = 1.2.3.4; port = 1205;}
ipv4 = {
addr = 1.2.3.4; port = http;}
ipv6 = {
addr = 1.2.3.4
port = 1205
}
- ip = {
- addr = 1.2.3.4
- }
- ip = {
- addr = 201:220:222::2
- }
+ ip = { addr = 1.2.3.4 }
+ ip = { addr = 201:220:222::2 }
ip = {
addr = bluedot.thun.net
}
la r\'esolution peut \^etre faite soit par IPv4, soit par IPv6. Si ip4 est sp\'ecifi\'e,
seules les r\'esolutions IPv4 seront permises. Il en va de m\^eme avec ip6.
+Notez que si vous utilisez la directive DirAddresses, vous ne devez utiliser ni la directive
+DirPort, ni la directive DirAddress dans la m\^eme ressource.
+
\item [DIRport = \lt{}num\'ero-de-port\gt{}]
\index[dir]{DIRport}
+ \index[dir]{Directive!DIRport}
Sp\'ecifie le port (un entier positif) sur lequel le Director est \`a l'\'ecoute
de connections de Consoles Bacula. Ce m\^eme num\'ero de port doit \^etre sp\'ecifi\'e
dans la ressource Director du fichier de configuration de la console. La
\item [DirAddress = \lt{}Adresse-IP\gt{}]
\index[dir]{DirAddress}
+ \index[dir]{Directive!DirAddress}
Cette directive est optionnelle. Lorsqu'elle est sp\'ecifi\'ee, le Director n'accepte
de connections Console que de l'adresse sp\'ecifi\'ee {\bf Adresse-IP}, qui peut \^etre
-soit un nom de domaine, soit une adresse IP au format quadruplet point\'e ou chaîne quot\'ee.
+soit un nom de domaine, soit une adresse IP au format quadruplet point\'e ou cha\^ine quot\'ee.
Si cette directive n'est pas sp\'ecifi\'ee, le Director acceptera des connections de Console
de toute adresse valide. Notez que contrairement \`a la sp\'ecification DirAdresses d\'ecrite
plus haut, cette directive ne permet de sp\'ecifier qu'une seule adresse. Cette directive
\item [Job]
\index[dir]{Job}
+ \index[dir]{Directive!Job}
D\'ebut de la ressource Job. Il faut d\'efinir au moins une ressource Job.
\item [Name = \lt{}name\gt{}]
\index[dir]{Name}
+ \index[dir]{Directive!Name}
Le nom du Job. Ce nom peut \^etre utilis\'e avec la commande {\bf Run} du
programme Console pour lancer un Job. Si le nom contient des espaces,
il doit \^etre plac\'e entre quotes. C'est g\'en\'eralement une bonne id\'ee de
sp\'ecifi\'e ici suffix\'e avec la date et l'heure de sa planification.
Cette directive est requise.
+\item [Enabled = \lt{}yes|no\gt{}]
+ \index[dir]{Enable}
+ \index[dir]{Directive!Enable}
+ Cette directive permet d'activer ou d\'esactiver l'ex\'ecution automatique d'un job
+ par le planificateur.
+
\item [Type = \lt{}job-type\gt{}]
\index[dir]{Type}
+ \index[dir]{Directive!Type}
La directive {\bf Type} sp\'ecifie le type de Job, qui peut \^etre l'un des
suivants : {\bf Backup}, {\bf Restore}, {\bf Verify}, ou {\bf Admin}.
Cette directive est requise. Pour chaque type de Job, il existe diff\'erents
\label{Level}
\item [Level = \lt{}job-level\gt{}]
+ \index[dir]{Directive!Level}
\index[dir]{Level}
La directive Level sp\'ecifie le niveau d'ex\'ecutiondu job par d\'efaut.
Chaque type de job a son propre jeu de niveaux qui peuvent \^etre sp\'ecifi\'es.
la derni\`ere Full demeure dans le catalogue, ce qui signifie que si vous effectuez
une restauration \`a partir de sauvegardes incr\'ementales (et de la Full associ\'ee),
les fichiers supprim\'es depuis la derni\`ere Full seront aussi restaur\'es. Ces fichiers
-n'apparaîtront plus dans le catalogue apr\`es avoir fait une nouvelle sauvegarde
+n'appara\^itront plus dans le catalogue apr\`es avoir fait une nouvelle sauvegarde
Full. Le processus pour supprimer ces fichiers du catalogue lors d'une
incr\'ementale ralentirait fortement les sauvegardes incr\'ementales. Il n'est
actuellement pas impl\'ement\'e dans Bacula.
la derni\`ere Full demeure dans le catalogue, ce qui signifie que si vous effectuez
une restauration \`a partir de sauvegardes diff\'erentielles (et de la Full associ\'ee),
les fichiers supprim\'es depuis la derni\`ere Full seront aussi restaur\'es. Ces fichiers
-n'apparaîtront plus dans le catalogue apr\`es avoir fait une nouvelle sauvegarde
+n'appara\^itront plus dans le catalogue apr\`es avoir fait une nouvelle sauvegarde
Full. Le processus pour supprimer ces fichiers du catalogue lors d'une
incr\'ementale ralentirait fortement les sauvegardes diff\'erentielles. Il n'est
actuellement pas impl\'ement\'e dans Bacula, mais plannifi\'e pour une future version
ont \'et\'e supprim\'es.
\end{description}
-\item {\bf Verify Job = \lt{}Job-Resource-Name\gt{}}
+\item [Verify Job = \lt{}Job-Resource-Name\gt{}]
\index[dir]{Verify Job}
+ \index[dir]{Directive!Verify Job}
Si vous ex\'ecutez un job verify sans cette directive, le dernier job
ex\'ecut\'e sera compar\'e avec le catalogue, ce qui signifie que votre commande
verify doit succ\'eder imm\'ediatement \`a une sauvegarde. Si vous sp\'ecifiez
Verify sur les sauvegardes de votre choix (le plus souvent, un {\bf VolumeToCatalog}
de sorte que la cartouche qui vient juste d'\^etre \'ecrite est relue).
-\item {\bf JobDefs = \lt{}JobDefs-Resource-Name\gt{}}
+\item [JobDefs = \lt{}JobDefs-Resource-Name\gt{}]
\index[dir]{JobDefs}
+ \index[dir]{Directive!JobDefs}
Si un nom de JobDef est sp\'ecifi\'e dans la d\'efinition d'un Job, toutes les valeurs
d\'efinies dans la ressource JobDef concern\'ee seront utilis\'ees en tant que valeurs
par d\'efaut pour le Job. Toute valeur explicitement sp\'ecifi\'ee dans la
Un exemple basique de l'utilisation d'un Jobdef est fourni dans le fichier
bacula-dir.conf par d\'efaut.
-\item {\bf Bootstrap = \lt{}bootstrap-file\gt{}}
+\item [Bootstrap = \lt{}bootstrap-file\gt{}]
\index[dir]{Bootstrap}
+ \index[dir]{Directive!Bootstrap}
La directive Bootstrap sp\'ecifie un fichier bootstrap qui, s'il est fourni,
sera utilis\'e lors des restaurations et ignor\'e par tout les autres Jobs.
Le fichier {\bf bootstrap} contient la liste des cartouches n\'ecessaires
consulter le chapitre \ilink{Restaurer des fichiers avec le fichier Bootstrap}{_ChapterStart43}
de ce manuel.
-\item {\bf \label{writebootstrap} Write Bootstrap = \lt{}bootstrap-file-specification\gt{}}
-\index[dir]{a name}
-
+\label{writebootstrap}
+\item [Write Bootstrap = \lt{}bootstrap-file-specification\gt{}]
+ \index[dir]{Write Bootstrap}
+ \index[dir]{Directive!Write Bootstrap}
La directive {\bf writebootstrap} sp\'ecifie le de fichier Bootstrap o\`u Bacula
\'ecrira lors de chaque sauvegarde. Ainsi, cette directive s'applique
exclusivement aux jobs de type sauvegarde. Si la sauvegarde est une Full,
Bacula \'ecrase le contenu du fichier sp\'ecifi\'e. Sinon, Bacula ajoute les
- nouveaux enregistrements Bootstrap \`a la fin du fichier..
+ nouveaux enregistrements Bootstrap \`a la fin du fichier.
En utilisant cette fonction, vous aurez constamment un fichier bootstrap
capable de recouvrer l'\'etat le plus r\'ecent de votre syst\`eme. Le fichier
les enregistrement bootstrap seront redirig\'es. Ce peut \^etre, par exemple, un
script qui vous envoie par e-mail les enregistrements bootstrap.
+A partir de la version 1.40, Bacula effectue des
+\ilink{character substitution}{substitution de caractères} comme dans une directive
+RunScript. Pour gérer automatiquement vos fichiers bootstrap, vous pouvez utiliser
+ceci dans vos {\bf JobDefs} :
+
+\begin{verbatim}
+JobDefs {
+ Write Bootstrap = "%c_%n.bsr"
+ ...
+}
+\end{verbatim}
+
Pour plus de d\'etails sur l'utilisation de fichiers bootstrap, veuillez
consulter le chapitre intitul\'e \ilink{Le Fichier Bootstrap}{_ChapterStart43}
de ce manuel.
-\item {\bf Client = \lt{}client-resource-name\gt{}}
+\item [ Client = \lt{}client-resource-name\gt{}]
\index[dir]{Client}
+ \index[dir]{Directive!Client}
La directive Client sp\'ecifie le Client (File Daemon) \`a utiliser dans le Job.
Le client est ex\'ecut\'e sur la machine \`a sauvegarder. Il exp\'edie les fichiers requis
au Storage Daemon lors des sauvegardes, et re\\ 3oit les fichiers du Storage Daemon
\ilink{Ressource Client}{ClientResource2} de ce chapitre. Cette deirective est requise.
-\item {\bf FileSet = \lt{}FileSet-resource-name\gt{}}
+\item [ FileSet = \lt{}FileSet-resource-name\gt{}]
+ \index[dir]{FileSet}
\index[dir]{FileSet}
La directive FileSet sp\'ecifie le FileSet \`a utiliser dans le Job concern\'e. Le
FileSet d\'efinit les r\'epertoires et fichiers \`a sauvegarder, ainsi que les options
\ilink{Ressource FileSet}{FileSetResource} de ce chapitre.
Cette directive est requise.
-\item {\bf Messages = \lt{}messages-resource-name\gt{}}
+\item [ Messages = \lt{}messages-resource-name\gt{}]
\index[dir]{Messages}
+ \index[dir]{Directive!Messages}
La directive Messages d\'efinit la ressource Message qui doit \^etre utilis\'ee
pour le job concern\'e. Ainsi, elle d\'etermine le comment et o\`u seront
d\'elivr\'es les diff\'erents messages de Bacula. Par exemple, vous pouvez diriger
\ilink{Ressource Messages}{_ChapterStart15} de ce manuel. Cette directive
est requise.
-\item {\bf Pool = \lt{}pool-resource-name\gt{}}
+\item [ Pool = \lt{}pool-resource-name\gt{}]
\index[dir]{Pool}
+ \index[dir]{Directive!Pool}
La directive Pool sp\'ecifie le jeu de volumes qui doit \^etre utilis\'e pour
sauvegarder vos donn\'ees. De nombreuses installations de Bacula
n'utiliseront que le pool d\'efini par d\'efaut {\bf Default}. Toutefois,
Pour plus de d\'etails, consultez la section \ilink{Ressource Pool}{PoolResource}
de ce chapitre. Cette directive est requise
-\item {\bf Full Backup Pool = \lt{}pool-resource-name\gt{} }
+\item [ Full Backup Pool = \lt{}pool-resource-name\gt{}]
\index[dir]{Full Backup Pool}
+ \index[dir]{Directive!Full Backup Pool}
La directive {\it Full Backup Pool} sp\'ecifie un Pool \`a utiliser pour les
sauvegardes Full. Cette directive outrepasse toute autre sp\'ecification
de Pool lors d'une sauvegarde Full. Cette directive est optionnelle.
-\item {\bf Differential Backup Pool = \lt{}pool-resource-name\gt{} }
+\item [ Differential Backup Pool = \lt{}pool-resource-name\gt{}]
\index[dir]{Differential Backup Pool}
+ \index[dir]{Directive!Differential Backup Pool}
La directive {\it Differential Backup Pool} sp\'ecifie un Pool \`a utiliser pour les
sauvegardes Diff\'erentielles. Cette directive outrepasse toute autre sp\'ecification
de Pool lors d'une sauvegarde Diff\'erentielle. Cette directive est optionnelle.
-\item {\bf Incremental Backup Pool = \lt{}pool-resource-name\gt{} }
+\item [ Incremental Backup Pool = \lt{}pool-resource-name\gt{}]
\index[dir]{Incremental Backup Pool}
+ \index[dir]{Directive!Differential Backup Pool}
La directive {\it Incremental Backup Pool} sp\'ecifie un Pool \`a utiliser pour les
sauvegardes Incr\'ementales. Cette directive outrepasse toute autre sp\'ecification
de Pool lors d'une sauvegarde Incr\'ementale. Cette directive est optionnelle.
-\item {\bf Schedule = \lt{}schedule-name\gt{}}
+\item [ Schedule = \lt{}schedule-name\gt{}]
\index[dir]{Schedule}
+ \index[dir]{Directive!Schedule}
La directive Schedule d\'efinit la planification du job. Le {\it schedule} d\'etermine
la date et l'instant o\`u le job doit \^etre lanc\'e automatiquement, et le niveau
(Full, Diff\'erentiel, Incr\'emental...) du job en question. Cette directive est
Pour plus de d\'etails, consultez le chapitre.
\ilink{Ressource Schedule}{ScheduleResource} de ce manuel.
-\item {\bf Storage = \lt{}storage-resource-name\gt{}}
+\item [ Storage = \lt{}storage-resource-name\gt{}]
\index[dir]{Storage}
+ \index[dir]{Directive!Storage}
La directive Storage d\'efinit le nom du service storage que vous souhaitez
utiliser pour sauvegarder les donn\'ees du FileSet. Pour plus de d\'etails, consultez le
chapitre \ilink{Ressource Storage}{StorageResource2} de ce manuel.
Cette directive est requise.
-\item {\bf Max Start Delay = \lt{}time\gt{}}
+\item [ Max Start Delay = \lt{}time\gt{}]
\index[sd]{Max Start Delay}
+ \index[dir]{Directive!Max Start Delay}
La directive Max Start Delay sp\'ecifie le d\'elai maximal entre l'horaire
planifi\'e (dans le schedule) et l'horaire effectif de d\'emarrage du job.
Par exemple, un job peut \^etre programm\'e pour d\'emarrer \`a 1h, mais \^etre
d\'emarr\'e \`a 2h. Ceci peut se r\'ev\'eler utile pour, par exemple, \'eviter qu'un job
s'ex\'ecute duant les heures ouvrables. La valeur par d\'efaut est 0 (pas de limite).
-\item {\bf Max Run Time = \lt{}time\gt{}}
+\item [ Max Run Time = \lt{}time\gt{}]
\index[sd]{Max Run Time}
+ \index[dir]{Directive!Max Run Time}
La directive Max Run Time sp\'ecifie le d\'elai allou\'e pour l'ex\'ecution
compl\`ete d'un job depuis son lancement (pas n\'ecessairement \`a l'heure
de sa programmation) jusqu'\`a sa fin. Cette directive est impl\'ement\'ee
depuis la version 1.33.
-\item {\bf Max Wait Time = \lt{}time\gt{}}
+\item [ Max Wait Time = \lt{}time\gt{}]
\index[sd]{Max Wait Time}
+ \index[dir]{Directive!Max Wait Time}
La directive Max Wait Time sp\'ecifie le d\'elai maximum durant lequel un
job peut rester bloqu\'e en attente d'une ressource (par exemple, en attente du
montage d'une cartouche ou encore en attente des Storage ou File Daemon occup\'es
\item [Incremental Max Wait Time = \lt{}time\gt{}]
\index[dir]{Incremental Max Wait Time}
+ \index[dir]{Directive!Incremental Max Wait Time}
Cette directive sp\'ecifie le temps maximum durant lequel une sauvegarde
incr\'ementale peut rester bloqu\'ee en attente d'une ressource (par exemple, en
attente d'une cartouche ou des File ou Storage daemons), compt\'e \`a partir
\item [Differential Max Wait Time = \lt{}time\gt{}]
\index[dir]{Differential Max Wait Time}
+ \index[dir]{Directive!Differential Max Wait Time}
Cette directive sp\'ecifie le temps maximum durant lequel une sauvegarde
diff\'erentielle peut rester bloqu\'ee en attente d'une ressource (par exemple, en
attente d'une cartouche ou des File ou Storage daemons), compt\'e \`a partir
\item [Prefer Mounted Volumes = \lt{}yes|no\gt{}]
\index[dir]{Prefer Mounted Volumes}
+ \index[dir]{Directive!Differential Max Wait Time}
Si cette directive est activ\'ee (c'est le cas par d\'efaut), le Director
ordonne au Storage daemon de s\'electionner de pr\'ef\'erence soit une
librairie, soit un lecteur avec un volume valide d\'ej\`a mont\'e, plut\^ot qu'un
pourriez trouver vos fichiers dispers\'es sur beaucoup plus de volumes que
n\'ecessaire.
-\item {\bf Prune Jobs = \lt{}yes|no\gt{}}
+\item [ Prune Jobs = \lt{}yes|no\gt{}]
\index[dir]{Prune Jobs}
+ \index[dir]{Directive!Prune Jobs}
En principe, l'\'elagage des jobs du catalogue est sp\'ecifi\'e pour chaque client
dans sa propre ressource Client par la directive {\bf AutoPrune}. Si cette
directive est sp\'ecifi\'ee (normalement, non) et si la valeur est {\bf yes},
elle outrepasse la valeur sp\'ecifi\'ee dans la ressource Client. La valeur
par d\'efaut est {\bf no}.
-\item {\bf Prune Files = \lt{}yes|no\gt{}}
+\item [ Prune Files = \lt{}yes|no\gt{}]
\index[dir]{Prune Files}
+ \index[dir]{Directive!Prune Jobs}
En principe, l'\'elagage des fichiers du catalogue est sp\'ecifi\'e pour chaque client
dans sa propre ressource Client par la directive {\bf AutoPrune}. Si cette
directive est sp\'ecifi\'ee (normalement, non) et si la valeur est {\bf yes},
elle outrepasse la valeur sp\'ecifi\'ee dans la ressource Client. La valeur
par d\'efaut est {\bf no}.
-\item {\bf Prune Volumes = \lt{}yes|no\gt{}}
+\item [ Prune Volumes = \lt{}yes|no\gt{}]
\index[dir]{Prune Volumes}
+ \index[dir]{Directive!Prune Jobs}
En principe, l'\'elagage des volumes du catalogue est sp\'ecifi\'e pour chaque client
dans sa propre ressource Client par la directive {\bf AutoPrune}. Si cette
directive est sp\'ecifi\'ee (normalement, non) et si la valeur est {\bf yes},
elle outrepasse la valeur sp\'ecifi\'ee dans la ressource Client. La valeur
par d\'efaut est {\bf no}.
-\item {\bf Run Before Job = \lt{}command\gt{}}
- \index[dir]{Run Before Job}
- La commande sp\'ecifi\'ee est ex\'ecut\'ee en tant que programme externe avant le
- lancement du job. Tout retour de la commande sur la sortie standard est
- incluse dans le rapport de job de Bacula. La chaîne {bf command} doit \^etre
- un nom de programme valide ou un script shell. Cette directive n'est pas requise,
- mais si elle est d\'efinie, et si le code retour d'ex\'ecution du programme
- est diff\'erent de z\'ero, le job qui a lanc\'e le programme est effac\'e. D'autre part,
- la chaîne {bf command} est parcourue puis envoy\'ee vers la fonction execvp(), ce qui
- signifie que le chemin de la commande est recherch\'e pour son ex\'ecution, mais
- qu'il n'y a aucune interpr\'etation shell. Par cons\'equent, si vous voulez utiliser
- des commandes complexes ou toute fonctionnalit\'e du shell telle que la
+\item [RunScript \{...\}]
+ \index[dir]{RunScript}
+ \index[dir]{Directive!Run Script}
+
+ La commande sp\'ecifi\'ee est ex\'ecut\'ee en tant que programme externe avant le
+ lancement du job. Cette directive est optionnelle.
+ Vous disposez des options suivantes : \\
+
+\begin{tabular}{|c|c|c|l}
+Options & Valeur & Defaut & Informations \\
+\hline
+\hline
+Runs On Success & Yes/No & {\it Yes} & La commande est exécutée si le job s'est terminé avec succès\\
+\hline
+Runs On Failure & Yes/No & {\it No} & La commande est exécutée si le job a échoué\\
+\hline
+Runs On Client & Yes/No & {\it Yes} & La commande est exécutée sur le client\\
+\hline
+Runs When & Before|After|Always & {\it Never} & Le moment où la commande doit être exécutée\\
+\hline
+Abort Job On Error & Yes/No & {\it Yes} & Abandonne le job si le script retourne
+ un résultat non nul\\
+\hline
+Command & & & Le chemin vers votre script\\
+\hline
+\end{tabular}
+ Tout retour de la commande sur la sortie standard est
+ incluse dans le rapport de job de Bacula. La cha\^ine {bf command} doit \^etre
+ un nom de programme valide ou un script shell
+
+ D'autre part,
+ la cha\^ine {bf command} est parcourue puis envoy\'ee vers la fonction execvp(), ce qui
+ signifie que le chemin de la commande est recherch\'e pour son ex\'ecution, mais
+ qu'il n'y a aucune interpr\'etation shell. Par cons\'equent, si vous voulez utiliser
+ des commandes complexes ou toute fonctionnalit\'e du shell telle que la
redirection, vous devez appeler un script shell o\`u vous mettrez vos commandes.
- Avant de soumettre la commande sp\'ecifi\'ee au syst\`eme d'exploitation, Bacula
+
+ Avant de soumettre la commande sp\'ecifi\'ee au syst\`eme d'exploitation, Bacula
effectue les substitutions suivantes :
+\label{character substitution}
+
\footnotesize
\begin{verbatim}
%% = %
%c = Nom du client
%d = Nom du Director
- %i = JobId
%e = Statut de sortie du job
+ %i = JobId
%j = Nom unique du job
%l = Niveau du job
%n = Nom du job
- %t = Type de job
+ %s = Temps Depuis (NDT : Since Time)
+ %t = Type de job (Backup,...)
%v = Nom de volume
-
\end{verbatim}
-
\normalsize
-Le le code de statut de fin de job peut prendre les valeurs suivantes :
+Le code de statut de fin de job peut prendre les valeurs suivantes :
\index[dir]{Exit Status}
\begin{itemize}
\item Unknown term code
\end{itemize}
- Aussi, si vous l'utilisez dans une ligne de commande, il vous faudra l'encadrer
+ Aussi, si vous l'utilisez dans une ligne de commande, il vous faudra l'encadrer
de quotes.
-Depuis la version 1.30, Bacula contr\^ole le statut de sortie du programme
-RunBeforeJob. S'il est diff\'erent de z\'ero, le job se termine en erreur.
-Lutz Kittler a fait remarquer que ceci peut \^etre un moyen ais\'e pour modifier
-vos schedules pour les vacances. Par exemple, supposons que vous fassiez
-habituellement des sauvegardes Full le vendredi, mais que jeudi et vendredi
-soient f\'eri\'es. Pour \'eviter d'avoir \`a changer les cartouches entre jeudi et vendredi
-alors que personne n'est au bureau, vous pouvez cr\'eer un RunBeforeJob qui retourne
-un statut non nul jeudi et z\'ero les autres jours. Ainsi, le job de jeudi ne sera pas
-ex\'ecut\'e, et la cartouche que vous avez ins\'er\'e mercredi sera disponible pour la Full
-de vendredi.
+Vous disposez des raccourcis suivants :\\
+\begin{tabular}{|c|c|c|c|c|c}
+Mot clef & RunsOnSuccess & RunsOnFailure & AbortJobOnError & Runs On Client & RunsWhen \\
+\hline
+Run Before Job & & & Yes & No & Before \\
+\hline
+Run After Job & Yes & No & & No & After \\
+\hline
+Run After Failed Job & No & Yes & & No & After \\
+\hline
+Client Run Before Job & & & Yes & Yes & Before \\
+\hline
+Client Run After Job & Yes & No & & Yes & After \\
+\hline
+Client Run After Failed Job & No & Yes & & Yes & After \\
+\end{tabular}
+
+Exemple :
+\begin{verbatim}
+RunScript {
+ RunsWhen = Before
+ AbortJobOnError = No
+ Command = "/etc/init.d/apache stop"
+}
-\item {\bf Run After Job = \lt{}command\gt{}}
- \index[dir]{Run After Job }
- La commande sp\'ecifi\'ee est ex\'ecut\'ee en tant que programme externe apr\`es la fin
- du job. La chaîne {bf command} doit \^etre un nom de programme valide ou un
- script shell. Cette directive n'est pas requise. Si le code de sortie du
- programme est non nul, le job se termine en erreur. Avant de soumettre
- la commande sp\'ecifi\'ee au syst\`eme d'exploitation, Bacula effectue les
- substitutions de caract\`eres d\'ecrites au paragraphe {\bf Run Before Job}
-
-Un exemple d'utilisation de cette directive est donn\'e au chapitre
-\ilink{Astuces}{JobNotification} de ce manuel. depuis la version 1.30,
-Bacula contr\^ole le statut de sortie du program RunAfter. S'il est
-non nul, le job se termine en erreur.
-
-\item {\bf Client Run Before Job = \lt{}command\gt{}}
- \index[dir]{Client Run Before Job }
- Cette directive est similaire \`a {\bf Run Before Job} except\'e que la
- commande est ex\'ecut\'ee sur la machine cliente. Les m\^emes restrictions
- s'appliquent aux syt\`emes Unix que celles signal\'ees pour {\bf Run Before Job}.
+RunScript {
+ RunsWhen = After
+ RunsOnFailure = yes
+ Command = "/etc/init.d/apache start"
+}
+\end{verbatim}
+
+{\bf Consid\'erations particuli\`eres \`a Windows}
D'autre part, pour les clients Windows \`a partir de la version 1.33, notez bien
que vous devez fournir un chemin correct pour votre script, et que le script
peut avoir l'extension .com, .exe, ou .bat. Si vous sp\'ecifiez un chemin,
d'Unix ne fonctionneront pas, \`a moins que vous n'ayez install\'e et
correctement configur\'e Cygwin en plus (et s\'epar\'ement) de Bacula.
-
-{\bf Consid\'erations particuli\`eres \`a Windows}
La commande peut \^etre n'importe quel programme reconnu par cmd.exe ou command.com
comme un fichier ex\'ecutable. Sp\'ecifier une extension de fichier ex\'ecutable
est optionnel, \`a moins qu'il y ait une ambigu\"it\'e (par exemple ls.bat, ls.exe).
Bacula cherche la commande dans le r\'epertoire "System \%Path\%" (Dans la
-boîte de dialogue des variables d'environnement vous avez les variables
+bo\^ite de dialogue des variables d'environnement vous avez les variables
"syst\`eme" et "utilisateurs". Si bacula-fd fonctionne en tant que
service, seules les variables d'environnement syst\`emes sont accessibles.)
'%l'\""
\end{verbatim}
\normalsize
+
Lorsque le job est ex\'ecut\'e, vous obtiendrez un message de sortie du script
-anno\\ 3ant que la sauvegarde a d\'emarr\'e. M\^eme si la commande est ex\'ecut\'ee en
+annon\c{c}ant que la sauvegarde a d\'emarr\'e. M\^eme si la commande est ex\'ecut\'ee en
arri\`ere plan avec \&, le job bloquera jusqu'\`a la commande "db2 BACKUP DATABASE", et
-la sauvegarde se fige. Pour rem\'edier \`a cette situation, la ligne "db2 BACKUP DATABASE"
+la sauvegarde se fige.
+
+Pour rem\'edier \`a cette situation, la ligne "db2 BACKUP DATABASE"
devrait \^etre modifi\'ee en :
+
\footnotesize
\begin{verbatim}
db2 BACKUP DATABASE mercuryd TO $DIR/dbpipe WITHOUT PROMPTING > $DIR/backup.log
2>&1 < /dev/null &
\end{verbatim}
\normalsize
+
Il est important de rediriger l'entr\'ee et la sortie d'une commande en arri\`ere plan
vers /dev/null pour \'eviter le bloquage du script.
-\item {\bf Client Run After Job = \lt{}command\gt{}}
- \index[dir]{Client Run After Job }
+\item [ Run Before Job = \lt{}command\gt{}]
+ \index[dir]{Run Before Job}
+ \index[dir]{Directive!Run Before Job}
+ La commande sp\'ecifi\'ee est ex\'ecut\'ee en tant que programme externe avant le
+ lancement du job. Cette directive n'est pas requise,mais si elle est d\'efinie,
+ et si le code retour d'ex\'ecution du programme est diff\'erent de z\'ero, le job qui
+ a lanc\'e le programme est effac\'e.
+
+\begin{verbatim}
+Run Before Job = "echo test"
+\end{verbatim}
+ est équivalent à :
+\begin{verbatim}
+RunScript {
+ Command = "echo test"
+ RunsOnClient = No
+ RunsWhen = Before
+}
+\end{verbatim}
+
+Lutz Kittler a fait remarquer que ceci peut \^etre un moyen ais\'e pour modifier
+vos schedules pour les vacances. Par exemple, supposons que vous fassiez
+habituellement des sauvegardes Full le vendredi, mais que jeudi et vendredi
+soient f\'eri\'es. Pour \'eviter d'avoir \`a changer les cartouches entre jeudi et vendredi
+alors que personne n'est au bureau, vous pouvez cr\'eer un RunBeforeJob qui retourne
+un statut non nul jeudi et z\'ero les autres jours. Ainsi, le job de jeudi ne sera pas
+ex\'ecut\'e, et la cartouche que vous avez ins\'er\'e mercredi sera disponible pour la Full
+de vendredi.
+
+\item [ Run After Job = \lt{}command\gt{}]
+ \index[dir]{Run After Job}
+ \index[dir]{Directive!Run After Job}
+ La commande sp\'ecifi\'ee est ex\'ecut\'ee en tant que programme externe apr\`es la fin
+ du job. La cha\^ine {bf command} doit \^etre un nom de programme valide ou un
+ script shell. Cette directive n'est pas requise. Si le code de sortie du
+ programme est non nul, Bacula affiche un message d'avertissement (warning).
+ Avant de soumettre
+ la commande sp\'ecifi\'ee au syst\`eme d'exploitation, Bacula effectue les
+ substitutions de caract\`eres d\'ecrites au paragraphe {\bf RunScript}
+
+Un exemple d'utilisation de cette directive est donn\'e au chapitre
+\ilink{Astuces}{JobNotification} de ce manuel.
+Lisez le paragraphe {\bf Run After Failed Job} si vous voulez ex\'ecuter
+une commande lorqu'un job se termine avec un statut anormal.
+
+\item [Run After Failed Job = \lt{}command\gt{}]
+ \index[dir]{Run After Job}
+ \index[dir]{Directive!Run After Job}
+ La commande sp\'ecifi\'ee est ex\'ecut\'ee en tant que programme externe apr\`es la fin
+ du job lorqu'il se termine avec un statut d'erreur. Cette directive est optionnelle.
+ La cha\^ine {\bf command} doit \^etre le nom d'un programme ou d'un script shell.
+ Si le code de sortie du programme est non nul, Bacula affiche un mesage d'avertissement
+ (warning). Avant de soumettre
+ la commande sp\'ecifi\'ee au syst\`eme d'exploitation, Bacula effectue les
+ substitutions de caract\`eres d\'ecrites au paragraphe {\bf RunScript}. Notez que
+ vous pouvez, si vous souhaitez que
+ votre programme soit ex\'ecut\'e quel que soit l'issue du job, utiliser une définition
+ telle que :
+
+RunScript {
+ Command = "echo test"
+ RunsWhen = After
+ RunsOnFailure = yes
+ RunsOnClient = no
+ RunsOnSuccess = yes # default, you can drop this line
+}
+
+ Le chapitre \ilink{Trucs et astuces}{JobNotification} de ce manuel propose un
+ exemple d'utilisation de cette directive.
+
+\item [ Client Run Before Job = \lt{}command\gt{}]
+ \index[dir]{Client Run Before Job}
+ \index[dir]{Directive!Client Run Before Job}
+ Cette directive est similaire \`a {\bf Run Before Job} except\'e que la
+ commande est ex\'ecut\'ee sur la machine cliente. Les m\^emes restrictions
+ s'appliquent aux syt\`emes Unix que celles signal\'ees pour {\bf Run Before Job}.
+
+\item [ Client Run After Job = \lt{}command\gt{}]
+ \index[dir]{Client Run After Job}
+ \index[dir]{Directive!Client Run After Job}
Cette directive est similaire \`a {\bf Run After Job} sauf qu'elle est ex\'ecut\'ee
sur la machine cliente. Veuillez consulter les notes concernant les clients
- Windows dans le paragraphe {\bf Client Run Before Job} ci-dessus.
+ Windows dans le paragraphe {\bf RunScript} ci-dessus.
-\item {\bf Rerun Failed Levels = \lt{}yes|no\gt{}}
- \index[dir]{Rerun Failed Levels }
+\item [ Rerun Failed Levels = \lt{}yes|no\gt{}]
+ \index[dir]{Rerun Failed Levels}
+ \index[dir]{Directive!Rerun Failed Levels}
Si la valeur de cette directive est {\bf yes} ({\bf no} par d\'efaut), et si
Bacula d\'etecte qu'un job ant\'erieur d'un niveau plus \'elev\'e (Full ou
diff\'erentiel), alors le job est \'elev\'e au niveau le plus haut. Ceci est
souhaiterez probablement que la prochaine sauvegarde soit de niveau Full
plut\^ot qu'Incremental ou Diff\'erentiel.
-\item {\bf Spool Data = \lt{}yes|no\gt{}}
- \index[dir]{Spool Data }
+\item [ Spool Data = \lt{}yes|no\gt{}]
+ \index[dir]{Spool Data}
+ \index[dir]{Directive!Spool Data}
Si la valeur de cette directive est {\bf yes} ({\bf no} par d\'efaut), le
Storage Daemon aura pour consigne de stocker les donn\'ees dans un
fichier spoule sur disque plut\^ot que de les \'ecrire directement sur bande.
Elle ne doit pas \^etre utilis\'ee si vous sauvegardez sur disque.
-\item {\bf Spool Attributes = \lt{}yes|no\gt{}}
- \index[dir]{Spool Attributes }
+\item [ Spool Attributes = \lt{}yes|no\gt{}]
+ \index[dir]{Spool Attributes}
+ \index[dir]{Directive!Spool Attributes}
+ \index[dir]{lenteur}
+ \index[general]{lent}
+ \index[dir]{Sauvegardes!lent}
+ \index[general]{Sauvegardes!lent}
La valeur par d\'efaut est {\bf no}, ce qui signifie que le Storage Daemon
envoie les attributs de fichiers au Director au moment o\`u ils (les fichiers)
sont ecrits sur la bande. Cependant, si vous souhaitez \'eviter le risque
attributs de fichiers dans un fichier tampon du Working Directory pour ne les
transmettre au Director qu'\`a la fin de l'\'ecriture sur bande des donn\'ees du job.
-\item {\bf Where = \lt{}directory\gt{}}
- \index[dir]{Where }
+\item [ Where = \lt{}directory\gt{}]
+ \index[dir]{Where}
+ \index[dir]{Directive!Where}
Cette directive ne concerne que les jobs de type Restauration. Elle permet
de sp\'ecifier un pr\'efixe au nom du r\'epertoire o\`u tous les fichiers sont
restaur\'es. Ceci permet de restaurer les fichiers en un emplacement
configuration fournis en exemple, ceci afin d'\'eviter l'\'ecrasement
accidentel de vos fichiers.
-\item {\bf Replace = \lt{}replace-option\gt{}}
- \index[dir]{Replace }
+\item [ Replace = \lt{}replace-option\gt{}]
+ \index[dir]{Replace}
+ \index[dir]{Directive!Replace}
Cette directive ne concerne que les jobs de type Restauration. Elle pr\'ecise
la conduite \`a adopter dans l'\'eventualit\'e o\`u Bacula serait conduit \`a restaurer
un fichier ou un r\'epertoire qui existe d\'ej\`a. Les options suivantes sont
Si le fichier sauvegard\'e existe d\'ej\`a, Bacula renonce \`a restaurer ce fichier.
\end{description}
-\item {\bf Prefix Links=\lt{}yes|no\gt{}}
- \index[dir]{Prefix Links }
+\item [ Prefix Links=\lt{}yes|no\gt{}]
+ \index[dir]{Prefix Links}
+ \index[dir]{Directive!Prefix Links}
Si la valeur de cette directive est {\bf Yes} et si un pr\'efixe de chemin
{\bf Where} est sp\'ecifi\'e, alors ce dernier s'applique aussi aux liens
absolus. La valeur par d\'efaut est {\bf No}. Lorsque cette directive est \`a
si vous voulez replacer les fichiers ult\'erieurement \`a leurs emplacements
d'origine, tous les liens absolus seront bris\'es.
-\item {\bf Maximum Concurrent Jobs = \lt{}number\gt{}}
- \index[dir]{Maximum Concurrent Jobs }
+\item [ Maximum Concurrent Jobs = \lt{}number\gt{}]
+ \index[dir]{Maximum Concurrent Jobs}
+ \index[dir]{Directive!Maximum Concurrent Jobs}
O\`u \lt{}number\gt{} est le nombre maximum de jobs de la ressource Job courrante
qui peuvent \^etre ex\'ecut\'es simultan\'ement. Notez que cette directive ne limite
que les jobs avec le m\^eme nom que la ressource dans laquelle elle
figure. Toute autre restriction du nombre maximum de jobs simultan\'es, que ce soit au
niveau du Director, du Client ou de la ressource Storage, s'applique en plus de
- de la limite stipul\'ee ici. LA valeur par d\'efaut est 1, mais vous pouvez utiliser
+ de la limite stipul\'ee ici. La valeur par d\'efaut est 1, mais vous pouvez utiliser
une valeur plus grande. Nous vous recommandons fortement de lire
attentivement le paragraphe WARNING sous \ilink{ Maximum Concurrent Jobs}{DirMaxConJobs}
dans la section concernant la ressource Director.
-\item {\bf Reschedule On Error = \lt{}yes|no\gt{}}
- \index[dir]{Reschedule On Error }
+\item [ Reschedule On Error = \lt{}yes|no\gt{}]
+ \index[dir]{Reschedule On Error}
+ \index[dir]{Directive!Reschedule On Error}
Si cette directive est activ\'ee, alors si le job se termine en erreur, il sera
reprogramm\'e en accord avec les directives {\bf Reschedule Interval} et
{\bf Reschedule Times}. Si vous supprimez le job, il ne sera pas reprogramm\'e.
Cette sp\'ecification peut se r\'ev\'eler utile pour les pc portables ainsi que pour toutes
les machines qui ne sont pas connect\'ees au r\'eseau en permanence.
-\item {\bf Reschedule Interval = \lt{}time-specification\gt{}}
- \index[dir]{Reschedule Interval }
+\item [ Reschedule Interval = \lt{}time-specification\gt{}]
+ \index[dir]{Reschedule Interval}
+ \index[dir]{Directive!Reschedule Interval}
Si cette directive est activ\'ee, alors si le job se termine en erreur, il sera
reprogramm\'e apr\`es l'intervalle de temps stipul\'e par {\bf time-specification}.
Consultez la section \ilink{ the time specification formats}{Time} du chapitre
Configurer Bacula pour plus de d\'etails sur les sp\'ecifications de temps. Si
aucun intervalle n'est sp\'ecifi\'e, le job ne sera pas reprogramm\'e en cas d'erreur.
-\item {\bf Reschedule Times = \lt{}count\gt{}}
- \index[dir]{Reschedule Times }
+\item [ Reschedule Times = \lt{}count\gt{}]
+ \index[dir]{Reschedule Times}
+ \index[dir]{Directive!Reschedule Times}
Cette directive pr\'ecise le nombre maximal de tentatives d'ex\'ecution du job.
S'il est fix\'e \`a z\'ero (valeur par d\'efaut), le job sera reprogramm\'e
ind\'efiniment.
\item [Run = \lt{}job-name\gt{}]
- \index[dir]{Directive Run}
+ \index[dir]{Run}
+ \index[dir]{Directive!Run}
\index[dir]{Cloner un Job}
La directive Run (\`a ne pas confondre avec l'option Run dans un
Schedule) vous permet de d\'emarrer ou de cloner des jobs. En utilisant les
ressource job courante (cr\'eant ainsi un clone). Cependant, ce peut \^etre
n'importe quel nom de job, de sorte qu'un job peut d\'emarrer d'autre jobs li\'es.
La partie apr\`es le signe \'egale doit \^etre encadr\'ee de double quotes, et peut
- contenir toute chaîne ou jeu d'options (surcharges) qui pourraient \^etre
+ contenir toute cha\^ine ou jeu d'options (surcharges) qui pourraient \^etre
sp\'ecifi\'ees \`a l'utilisation de la commande Run dans la Console. Par exemple,
{\bf storage=DDS-4 ...}. De plus, deux mots-clef sp\'eciaux vous permettent de
cloner le job courant : {\bf level=\%l} et {\bf since=\%s}. le \%l du mot clef
Un job clon\'e ne d\'emarrera pas de nouveaux clones, aussi il n'est pas possible de les cascader.
\label{Priority}
-\item {\bf Priority = \lt{}number\gt{}}
- \index[dir]{Priority }
+\item [ Priority = \lt{}number\gt{}]
+ \index[dir]{Priority}
+ \index[dir]{Directive!Priority}
Cette directive vous permet de contr\^oler l'ordre d'ex\'ecution des jobs en
sp\'ecifiant un entier positif non nul. Plus grand est ce nombre, plus basse
est la priorit\'e du job. En supposant que vous n'ex\'ecutiez pas de jobs
La priorit\'e par d\'efaut est 10.
-Si vous voulez ex\'ecutez plusieurs jobs simultan\'es, ce qui n'est pas recommand\'e,
+Si vous voulez ex\'ecutez plusieurs jobs simultan\'es,
vous devriez garder les points suivants \`a l'esprit :
\begin{itemize}
\item Pour ex\'ecuter plusieurs jobs simultan\'es, vous devez ajuster la directive
- {\bf Maximum Concurrent Jobs } en cinq ou six endroits diff\'erents : dans le
+ {\bf Maximum Concurrent Jobs} (utiliser une valeur supérieure à 1)
+ en cinq ou six endroits diff\'erents : dans le
fichier bacula-dir.conf, les ressources {\bf Job}, {\bf Client}, {\bf Storage};
dans le fichier bacula-fd, la ressource {\bf FileDaemon}; et dans le fichier
bacula-sd.conf, la ressource {\bf Storage}. Si vous omettez l'un d'entre eux,
\label{WritePartAfterJob}
-\item {\bf Write Part After Job = \lt{}yes|no\gt{}}
- \index[sd]{Write Part After Job }
+\item [ Write Part After Job = \lt{}yes|no\gt{}]
+ \index[sd]{Write Part After Job}
+ \index[dir]{Directive!Write Part After Job}
Cette directive est impl\'ement\'ee depuis la version 1.37.
Si la valeur de cette directive est {\bf yes} ({\bf no} par d\'efaut), un nouveau
"fichier partition" (ndt : part file) sera cr\'e\'e apr\`es la fin du job.
\index[general]{Resource!JobDefs }
\addcontentsline{toc}{subsection}{JobDefs Resource}
-La ressource Jobdefs admet toutes les directives qui peuvent apparaître dans
+La ressource Jobdefs admet toutes les directives qui peuvent appara\^itre dans
une ressource Job. Une ressource Jobdefs ne cr\'e\'e en aucun cas un Job, son r\^ole
est de pouvoir \^etre d\'esign\'ee dans une ressource Job comme un ensemble de
param\`etres par d\'efaut. Ceci permet de d\'efinir plusieurs jobs similaires avec
\begin{description}
\item [Schedule]
- \index[sd]{Schedule }
+ \index[dir]{Schedule}
+ \index[dir]{Directive!Schedule}
D\'ebut des directives Schedule. La ressource {\bf Schedule} n'est pas requise,
mais il vous en faudra au moins une si vous souhaitez que vos jobs soient
ex\'ecut\'es automatiquement.
\item [Name = \lt{}name\gt{}]
- \index[sd]{Name }
+ \index[dir]{Name}
+ \index[dir]{Directive!Name}
Le nom du Schedule d\'efini. Cette directive est requise.
\item [Run = \lt{}Job-overrides\gt{} \lt{}Date-time-specification\gt{} ]
- \index[sd]{Run }
+ \index[dir]{Run}
+ \index[dir]{Directive!Run}
La directive Run d\'efinit quand un job doit \^etre ex\'ecut\'e, et les \'eventuelles
surcharges \`a appliquer. Il est possible de sp\'ecifier plusieurs directives
{\bf run} au sein d'une ressource {\bf Schedule}, elles seront toutes
\begin{description}
\item [Level=Full]
- \index[sd]{Level }
+ \index[dir]{Level}
+ \index[dir]{Directive!Level}
Tous les fichiers du FileSet qu'ils aient ou non chang\'e.
\item [Level=Incremental]
- \index[sd]{Level }
+ \index[dir]{Level}
+ \index[dir]{Directive!Level}
Tous les fichiers qui ont chang\'e depuis la derni\`ere sauvegarde.
\item [Pool=Weekly]
- \index[sd]{Pool }
+ \index[dir]{Pool}
+ \index[dir]{Directive!Pool}
Sp\'ecifie l'utilisation du Pool nomm\'e {\bf Weekly}.
\item [Storage=DLT\_Drive]
- \index[sd]{Storage }
+ \index[dir]{Storage }
+ \index[dir]{Directive!Storage}
Sp\'ecifie l'utilisation du lecteur {\bf DLT\_Drive} pour p\'eriph\'erique de stockage.
\item [Messages=Verbose]
- \index[sd]{Messages }
+ \index[dir]{Messages }
+ \index[dir]{Directive!Messages}
Sp\'ecifie l'utilisation de la ressource messages {\bf Verbose} pour le job.
\item [FullPool=Full]
- \index[sd]{FullPool }
+ \index[dir]{FullPool}
+ \index[dir]{Directive!FullPool}
+
Sp\'ecifie l'utilisation du Pool nomm\'e {\bf Full} si le job est une sauvegarde Full,
ou s'il a \'et\'e \'elev\'e en Full bien qu'ayant \'et\'e lanc\'e en tant que diff\'erentiel ou
incr\'emental.
\item [DifferentialPool=Differential]
- \index[sd]{DifferentialPool }
+ \index[dir]{DifferentialPool }
+ \index[dir]{Directive!DifferentialPool}
Sp\'ecifie l'utilisation du Pool nomm\'e {\bf Differential} si le job est une
sauvegarde diff\'erentielle.
\item [IncrementalPool=Incremental]
- \index[sd]{IncrementalPool }
+ \index[dir]{IncrementalPool}
+ \index[dir]{Directive!IncrementalPool}
Sp\'ecifie l'utilisation du Pool nomm\'e {\bf Incremental} si le job est une
sauvegarde incr\'ementale.
\item [SpoolData=yes|no]
- \index[sd]{SpoolData }
+ \index[dir]{SpoolData}
+ \index[dir]{Directive!SpoolData}
Indique \`a Bacula d'ordonner au Storage Daemon de placer les donn\'ees sur un
spool disque avant de les envoyer vers les cartouches.
\item [WritePartAfterJob=yes|no]
- \index[sd]{WritePartAfterJob }
+ \index[dir]{WritePartAfterJob}
+ \index[dir]{Directive!WritePartAfterJob}
Indique \`a Bacula d'ordonner au Storage Daemon d'\'ecrire le fichier partition
courant vers le p\'eriph\'erique lorsque le job s'ach\`eve (voir
\ilink{la directive Write Part After Job dans la ressource Job}{WritePartAfterJob}).
sp\'ecifi\'ees l'une apr\`es l'autre. Lorsqu'un fichier se trouve dans un dossier
sp\'ecifi\'e, les options sont appliqu\'ees au nom de fichier pour savoir s'il doit
\^etre sauvegard\'e, et comment. Les ressources Options sont appliqu\'ees dans l'ordre
-o\`u elles apparaîssent dans le FileSet jusqu'\`a ce qu'il y en ait une qui corresponde.
+o\`u elles appara\^issent dans le FileSet jusqu'\`a ce qu'il y en ait une qui corresponde.
Une ressource Options qui ne contient pas de directive {\bf wild} (sp\'ecification
de caract\`ere joker, voir ci-dessous) est consid\'er\'ee comme concernant tous les
fichiers. Il est important de bien comprendre ceci, car une fois que Bacula a
d\'etermin\'e que des Options s'appliquent \`a un fichier donn\'e, ce fichier sera
sauvegard\'e sans tenir compte d'aucunes des \'eventuelles autres ressources Options.
-Ceci signifie que toute ressource Options avec caract\`eres joker doit apparaître
+Ceci signifie que toute ressource Options avec caract\`eres joker doit appara\^itre
avant une ressource Options sans caract\`eres joker.
Si, pour quelque raison, Bacula applique toutes les ressources Options \`a un
ceux cr\'e\'es par ndbm. Elle est d\'esactiv\'ee par d\'efaut ({\bf sparse=no}), de sorte
qu'aucun contr\^ole n'est fait pour rechercher les fichiers clairsem\'es. Vous
pouvez l'activer sans danger sur des fichiers non clairsem\'es, cependant elle
- entraîne une l\'eg\`ere charge suppl\'ementaire pour la d\'etection de tampons remplis
+ entra\^ine une l\'eg\`ere charge suppl\'ementaire pour la d\'etection de tampons remplis
de z\'eros (buffers of all zero), et un l\'eger surplus d'espace sur l'archive
de sortie sera utilis\'e pour ssauver les adresses de recherche de chaque
enregistrement non-nul trouv\'e.
\item [{\bf wild=\lt{}string\gt{}}]
\index[dir]{wild }
-Sp\'ecifie une chaîne de caract\`eres jokers \`a appliquer aux fichiers. Notez
-que si {\bf Exclude} n'est pas activ\'ee, cette chaîne s\'electionnera les fichiers
-\`a sauvegarder. Si au contraire {\bf Exclude=yes} est sp\'ecifi\'e, la chaîne
+Sp\'ecifie une cha\^ine de caract\`eres jokers \`a appliquer aux fichiers. Notez
+que si {\bf Exclude} n'est pas activ\'ee, cette cha\^ine s\'electionnera les fichiers
+\`a sauvegarder. Si au contraire {\bf Exclude=yes} est sp\'ecifi\'e, la cha\^ine
s\'electionnera les fichiers \`a exclure de la sauvegarde. Plusieurs directives
wild-card peuvent \^etre sp\'ecifi\'ees et sont appliqu\'ees s\'equentiellement
jusqu'\`a ce que l'une d'elles corresponde.
Ce fichier est lu lorsque le fichier de configuration est parcouru au d\'emarrage
du Director. Notez bien que le fichier est lu sur sur la machine qui h\'eberge le
Director (autrement dit, le serveur de sauvegardes) et non sur le Client.
- En fait, le "@NomDeFichier" peut apparaître n'importe o\`u dans le fichier de
+ En fait, le "@NomDeFichier" peut appara\^itre n'importe o\`u dans le fichier de
configuration o\`u un objet pourrait \^etre lu, le contenu du fichier d\'esign\'e sera
logiquement ins\'er\'e \`a l'emplacement du "@NomDeFichier". Ce qui doit figurer dans le
fichier d\'epend de l'emplacement du "@NomDeFichier" au sein du fichier de
Sur les syst\`emes Win32, si vous d\'eplacez un r\'epertoire ou si vous renommez
un fichier de la liste \`a sauvegarder, et si une Full a d\'ej\`a eu lieu, Bacula
-ne saura reconnaître qu'il existe de nouveaux fichiers \`a sauvegarder lors d'une
+ne saura reconna\^itre qu'il existe de nouveaux fichiers \`a sauvegarder lors d'une
incr\'ementale ou d'une diff\'erentielle (faites-en le reproche \`a Microsoft, pas \`a moi !).
Pour pallier \`a ce probl\`eme, veuillez copier tout r\'epertoire ou fichier de la
zone sauvegard\'ee. Si vous ne disposez pas de suffisamment d'espace disque,
Si vous voulez vous faire une id\'ee pr\'ecise de ce qui sera effectivement
sauvegard\'e par un FileSet, ou si vous voulez vous assurer de l'efficacit\'e
d'une liste d'exclusion, vous pouvez utiliser la commande {\bf estimate}
-du programme Console. Voyez \ilink{estimate command}{estimate} dans le
+du programme Console. Voyez la commande \ilink{estimate}{estimate} dans le
chapitre Console de ce manuel.
\subsection*{Considerations sur le nommage Windows NTFS}
\index[general]{La ressource Client}
\addcontentsline{toc}{subsection}{La ressource Client}
-La ressource Client d\'efinit les attributs des clients servis (sauvegard\'es)
+La ressource Client d\'efinit les attributs des clients sauvegard\'es
par ce Director. Il faut une ressource Client par machine sauvegard\'ee.
\begin{description}
\item [Client (ou FileDaemon)]
- \index[dir]{Client (ou FileDaemon) }
+ \index[dir]{Client (ou FileDaemon)}
+ \index[dir]{Directive!Client (or FileDaemon)}
D\'ebut des directives Client.
\item [Name = \lt{}name\gt{}]
- \index[dir]{Name }
+ \index[dir]{Name}
+ \index[dir]{Directive!Name}
Le nom du client qui sera utilis\'e dans la directive Job de la ressource ou
dans une commande run de la Console. Cette directive est requise.
\item [Address = \lt{}address\gt{}]
- \index[dir]{Address }
-
+ \index[dir]{Address}
+ \index[dir]{Directive!Address}
+ \index[dir]{File Daemon Address}
+ \index[dir]{Client Address}
L'adresse d'un File Daemon Bacula est un nom d'h\^ote, un nom pleinement qualifi\'e
ou une adresse r\'eseau au format quatre octets point\'es. Cette directive est requise.
\item [FD Port = \lt{}port-number\gt{}]
- \index[dir]{FD Port }
+ \index[dir]{FD Port}
+ \index[dir]{Directive!FD Port}
O\`u le port est le num\'ero de port auquel le le File Daemon peut \^etre contact\'e.
La valeur par d\'efaut est 9102.
\item [Catalog = \lt{}Catalog-resource-name\gt{}]
- \index[dir]{Catalog }
+ \index[dir]{Catalog}
+ \index[dir]{Directive!Catalog}
Cette directive sp\'ecifie le nom de la ressource catalog \`a utiliser pour ce
client. Cette directive est requise.
\item [Password = \lt{}password\gt{}]
- \index[dir]{Password }
+ \index[dir]{Password}
+ \index[dir]{Directive!Password}
Il s'agit ici du mot de passe \`a utiliser lors de la connection avec le
File Daemon, aussi le fichier de configuration de la machine \`a sauvegarder
doit d\'efinir le m\^eme mot de passe pour \^etre connect\'e par ce Director.
\item [File Retention = \lt{}time-period-specification\gt{} ]
\index[dir]{File Retention }
-
+ \index[dir]{Directive!Password}
La directive File Retention d\'efinit la p\'eriode pendant laquelle Bacula conservera
les enregistrements File dans le catalogue. Lors de l'expiration de cette p\'eriode,
si la directive {\bf AutoPrune} est active ({\bf yes}), Bacula \'elague le catalogue
\item [Job Retention = \lt{}time-period-specification\gt{} ]
\index[dir]{Job Retention}
+ \index[dir]{Directive!Job Retention}
La directive Job Retention d\'efinit la p\'eriode pendant laquelle Bacula conservera
les enregistrements Job dans le catalogue. Lors de l'expiration de cette p\'eriode,
si la directive {\bf AutoPrune} est active ({\bf yes}), Bacula \'elague le catalogue
\item [AutoPrune = \lt{}yes|no\gt{}]
\index[dir]{AutoPrune}
-
+ \index[dir]{Directive!AutoPrune}
Si AutoPrune est r\'egl\'e \`a {\bf yes} (valeur par d\'efaut), Bacula (dans les versions au del\`a
de 1.20) applique automatiquement les p\'eriodes File retention et Job retention pour le
client \`a la fin du job. Si vous sp\'ecifiez {\bf AutoPrune = no}, l'\'elagage ne se fera pas
et non les donn\'ees stock\'ees sur les volumes.
\item [Maximum Concurrent Jobs = \lt{}number\gt{}]
- \index[dir]{Maximum Concurrent Jobs }
+ \index[dir]{Maximum Concurrent Jobs}
+ \index[dir]{Directive!Maximum Concurrent Jobs}
\lt{}number\gt{} d\'esigne le nombre maximum de jobs qui peuvent \^etre lanc\'es simultan\'ement
sur le client concern\'e. Notez que cette directive ne limite que les jobs pour les clients
-qui ont le m\^eme nom que la ressource dans laquelle elle apparaît. Toutes les autres restrictions
+qui ont le m\^eme nom que la ressource dans laquelle elle appara\^it. Toutes les autres restrictions
du nombre maximum de jobs simultan\'es telles que celles sp\'ecifi\'ees dans les ressources
Director, Job, ou Storage s'appliquent aussi en plus de toute limite fix\'ee ici. La valeur
par d\'efaut est 1, mais vous pouvez sp\'ecifier une valeur plus grande. Nous recommandons
Jobs}{DirMaxConJobs} du chapitre Configurer le Director.
-\item [*Priority = \lt{}number\gt{}]
- \index[dir]{*Priority }
+\item [Priority = \lt{}number\gt{}]
+ \index[dir]{Priority}
+ \index[dir]{Directive!Priority}
\lt{}number\gt{} sp\'ecifie la priorit\'e de ce client par rapport aux autres clients
que le Director sauvegarde simultan\'ement. La priorit\'e admet une valeur entre 1 et 1000.
Les clients sont ordonn\'es de sorte que ceux dont la valeur de priorit\'e sont les plus petites
\begin{verbatim}
Client {
Name = Minimatou
- Address = minimatou
+ FDAddress = minimatou
Catalog = MySQL
Password = very_good
}
\begin{description}
\item [Storage]
- \index[dir]{Storage }
+ \index[dir]{Storage}
+ \index[dir]{Directive!Storage}
D\'ebut des ressources Storage. Il faut en sp\'ecifier au moins une.
\item [Name = \lt{}name\gt{}]
- \index[sd]{Name }
-Le nom de la ressource Storage. Ce nom apparaît au niveau de la directive
+ \index[dir]{Name}
+ \index[dir]{Directive!Name}
+Le nom de la ressource Storage. Ce nom appara\^it au niveau de la directive
Storage sp\'ecifi\'ee dans la ressource Job et est requise.
\item [Address = \lt{}address\gt{}]
- \index[sd]{Address }
+ \index[dir]{Address}
+ \index[dir]{Directive!SD Address}
+ \index[dir]{Storage daemon Address}
O\`u l'adresse est un nom d'h\^ote, une {\bf adresse pleinement qualifi\'ee}, ou une
{\bf adresse IP}. Notez bien que l'adresse sp\'ecifi\'ee ici sera transmise au
File Daemon qui l'utilisera alors pour contacter le Storage Daemon. Aussi, ce
Cette directive est requise.
\item [SD Port = \lt{}port\gt{}]
- \index[sd]{SD Port }
+ \index[dir]{SD Port}
+ \index[dir]{Directive!SD Port}
O\`u "port" est le port \`a utiliser pour contacter le Storage Daemon pour les
informations et pour ex\'ecuter les jobs. Ce m\^eme num\'ero de port doit
-apparaître dans la ressource Storage du fichier de configuration du
+appara\^itre dans la ressource Storage du fichier de configuration du
Storage Daemon. Le port par d\'efaut est 9103.
\item [Password = \lt{}password\gt{}]
- \index[sd]{Password }
+ \index[dir]{Password}
+ \index[dir]{Directive!Password}
Il s'agit du mot de passe \`a utiliser lors de l'\'etablissement de la connection
-avec les services Storage. Ce m\^eme mot de passe doit aussi apparaître dans la
+avec les services Storage. Ce m\^eme mot de passe doit aussi appara\^itre dans la
ressource Director du fichier de configuration du Storage Daemon. Cette
directive est requise. Si vous avez soit {\bf /dev/random}, soit {\bf bc}
sur votre machine, Bacula g\'en\`erera un mot de passe al\'eatoire lors du processus
de configuration. Dans le cas contraire, ce champ sera laiss\'e blanc.
\item [Device = \lt{}device-name\gt{}]
- \index[sd]{Device }
-Cette directive sp\'ecifie le nom du p\'eriph\'erique \`a utiliser pour le stockage.
+ \index[dir]{Device}
+ \index[dir]{Directive!Device}
+Cette directive sp\'ecifie le nom (pour le Storage Daemon) du p\'eriph\'erique \`a
+utiliser pour le stockage.
Ce nom n'est pas le nom de p\'eriph\'erique physique, mais le nom de p\'eriph\'erique
logique qui a \'et\'e d\'efini par la directive {\bf Name} de la ressource {\bf Device}
du fichier de configuration du Storage Daemon. Si le p\'eriph\'erique est une librairie, vous
tente d'utiliser le m\^eme p\'eriph\'erique deux fois. Cette directive est requise.
\item [Media Type = \lt{}MediaType\gt{}]
- \index[dir]{Media Type }
+ \index[dir]{Media Type}
+ \index[dir]{Directive!Media Type}
Cette directive sp\'ecifie le type de m\'edia \`a utiliser pour stocker les donn\'ees.
-Il s'agit d'une chaîne de caract\`eres arbitraire n'exc\'edant pas 127 caract\`eres.
+Il s'agit d'une cha\^ine de caract\`eres arbitraire n'exc\'edant pas 127 caract\`eres.
Ce peut \^etre ce que vous voulez, cependant, il est pr\'ef\'erable de la choisir de
mani\`ere \`a d\'ecrire le m\'edium de stockage utilis\'e (par exemple : Fichier, DAT,
''HP DLT8000``, 8mm,...). D'autre part, il est esentiel d'avoir une sp\'ecification
certainement sp\'ecifier des {\bf Media Types} distincts. Lors d'une restauration,
supposons qu'un Media Type {\bf DDS-4} est associ\'e avec le le job, Bacula peut
d\'ecider d'utiliser tout Storage Daemon qui supporte le Media Type {\bf DDS-4} sur
-tout lecteur qui le supporte. Si vous voulez contraindre Bacula \`a utiliser un
+tout lecteur qui le supporte.
+
+Actuellement, Bacula n'autorise qu'un seul type de media. Par cons\'equent, si vous
+disposez d'un lecteur qui en supporte plusieurs, vous pouvez utiliser une cha\^ine
+unique pour d\'esigner les volumes de l'un ou l'autre type, par exemple Media Type = DDS-3-4
+pour les types DDS-3 et DDS-4, mais ces volumes ne seront mont\'es que sur les lecteurs
+sp\'ecifi\'es comme acceptant les deux types : DDS-3-4
+
+Si vous voulez contraindre Bacula \`a utiliser un
seul Storage Daemon ou un seul lecteur, vous devez sp\'ecifier un Media Type unique
pour ce lecteur. C'est un point important qui devrait \^etre bien compris. Notez que
ceci s'applique \'egalement aux volumes disque. Si vous d\'efinissez plus d'une ressource
\item [Autochanger = \lt{}yes|no\gt{} ]
\index[dir]{Autochanger }
+ \index[dir]{Directive!Autochanger}
Si vous sp\'ecifiez {\bf yes} pour cette commande (la valeur par d\'efaut est {\bf no}),
alors Bacula requ\'erira un num\'ero de Slot lorsque vous utiliserez les commandes
{\bf label} et {\bf add} pour cr\'eer un nouveau volume. Ceci simplifie la cr\'eation
\ilink{ Utiliser une librairie}{_ChapterStart18} de ce manuel.
\item [Maximum Concurrent Jobs = \lt{}number\gt{}]
- \index[dir]{Maximum Concurrent Jobs }
+ \index[dir]{Maximum Concurrent Jobs}
+ \index[dir]{Directive!Maximum Concurrent Jobs}
O\`u \lt{}number\gt{} est le nombre maximum de jobs utilisant la
ressource Storage courante qui peuvent \^etre ex\'ecut\'es simultan\'ement. Notez que cette
directive ne limite que les jobs qui utilisent ce Storage Daemon. Toute autre
\begin{description}
\item [Pool]
- \index[dir]{Pool }
+ \index[dir]{Pool}
+ \index[dir]{Directive!Pool}
D\'ebut de la ressource Pool. Il faut d\'efinir au moins une ressource Pool.
\item [Name = \lt{}name\gt{}]
- \index[dir]{Name }
+ \index[dir]{Name}
+ \index[dir]{Directive!Name}
Le nom du pool. Pour la plupart des applications, vous utiliserez le pool
par d\'efaut nomm\'e {\bf Default}. Cette directive est requise.
\label{MaxVolumes}
\item [Maximum Volumes = \lt{}number\gt{}]
- \index[dir]{Maximum Volumes }
-
+ \index[dir]{Maximum Volumes}
+ \index[dir]{Directive!Maximum Volumes}
Cette directive sp\'ecifie le nombre maximum de volumes contenus dans le pool.
-Cette directive est optionnelle. Si elle est omise ou rr\'egl\'ee \`a 0, tout nombre
+Cette directive est optionnelle. Si elle est omise ou r\'egl\'ee \`a 0, tout nombre
de volumes est permis. En g\'en\'eral, cette directive est utile pour les librairies,
o\`u il y a un nombre fix\'e de volumes, ou pour le stockage sur fichier si vous voulez
vous assurer que les sauvegardes sur disque ne deviennent pas trop nombreuses ou ne
\item [Pool Type = \lt{}type\gt{}]
\index[dir]{Pool Type }
+ \index[dir]{Directive!Pool Type}
Cette directive d\'efinit le type du pool, qui correspond au type du job
ex\'ecut\'e. Cette directive est requise et peut prendre l'une des valeurs suivantes :
\end{itemize}
\item [Use Volume Once = \lt{}yes|no\gt{}]
- \index[dir]{Use Volume Once }
+ \index[dir]{Use Volume Once}
+ \index[dir]{Directive!Use Volume Once}
Cette directive, si elle est active (valeur {\bf yes}) stipule que chaque volume
ne doit \^etre utilis\'e qu'une seule fois. C'est particuli\`erement utile si le
volume est un fichier et si vous voulez un nouveau fichier pour chaque nouvelle
existant, vous devez utiliser la commande {\bf update} du programme Console.
\item [Maximum Volume Jobs = \lt{}positive-integer\gt{}]
- \index[dir]{Maximum Volume Jobs }
+ \index[dir]{Maximum Volume Jobs}
+ \index[dir]{Directive!Maximum Volume Jobs}
Cette directive sp\'ecifie le nombre maximum de jobs qui peuvent \^etre \'ecrits sur le volume.
La valeur par d\'efaut est z\'ero, ce qui signifie que le nombre de jobs sur un volume
n'est pas limit\'e. Sinon, lorsque le nombre de jobs sauvegard\'es sur le volume atteint
existant, vous devez utiliser la commande {\bf update} du programme Console.
\item [Maximum Volume Files = \lt{}positive-integer\gt{}]
- \index[dir]{Maximum Volume Files }
+ \index[dir]{Maximum Volume Files}
+ \index[dir]{Directive!Maximum Volume Files}
Cette directive sp\'ecifie le nombre maximum de fichiers qui peuvent \^etre \'ecrits sur
le volume. La valeur par d\'efaut est z\'ero, ce qui signifie que le nombre de fichiers
sur un volume n'est pas limit\'e. Sinon, lorsque le nombre de fichiers sauvegard\'es sur
existant, vous devez utiliser la commande {\bf update} du programme Console.
\item [Maximum Volume Bytes = \lt{}size\gt{}]
- \index[dir]{Maximum Volume Bytes }
+ \index[dir]{Maximum Volume Bytes}
+ \index[dir]{Directive!Maximum Volume Bytes}
Cette directive sp\'ecifie le nombre maximum d'octets qui peuvent \^etre \'ecrits sur le
volume. La valeur par d\'efaut est z\'ero, ce qui signifie qu'il n'y a d'autre limite
que la capacit\'e physique du volume. Sinon, lorsque le nombre d'octets sauvegard\'es sur
existant, vous devez utiliser la commande {\bf update} du programme Console.
\item [Volume Use Duration = \lt{}time-period-specification\gt{}]
- \index[dir]{Volume Use Duration }
+ \index[dir]{Volume Use Duration}
+ \index[dir]{Directive!Volume Use Duration}
Cette directive d\'efinit la p\'eriode durant laquelle le volume peut \^etre utilis\'e en
\'ecriture, \`a compter de la premi\`ere op\'eration d'\'ecriture de donn\'ees.
La valeur par d\'efaut est z\'ero, ce qui signifie que le volume peut \^etre \'ecrit
{\bf time-period-specification} sp\'ecifi\'ee, le volume est marqu\'e
{\bf Used}. D\`es lors, il ne peut plus \^etre utilis\'e pour y ajouter des jobs, tout comme
dans le cas d'un volume avec le statut {\bf Full}, mais il peut \^etre recycl\'e si le
-recyclage est activ\'e.
+recyclage est activ\'e. L'usage de la commande {\bf status dir} applique des algorithmes
+similaires \`a l'\'execution de jobs, aussi lors d'une telle commande, le statut du volume
+peut \^etre modifi\'e. Lorsque le volume est recycl\'e, il peut \`a nouveau \^etre utilis\'e.
Vous pourriez utiliser cette directive, par exemple, si vous avez un volume d\'edi\'e
aux sauvegardes incr\'ementales, et un volume d\'edi\'e aux Fulls hebdomadaires. Une fois que
\item [Catalog Files = \lt{}yes|no\gt{}]
\index[dir]{Catalog Files}
+ \index[dir]{Directive!Catalog Files}
Cette directive pr\'ecise si les noms des fichiers sauvegard\'es doivent ou non \^etre
enregistr\'es dans le catalogue. La valeur par d\'efaut est {\bf yes}. L'avantage de
d\'esactiver cette option ({\bf Catalog Files = No}) est d'avoir un catalogue
\item [AutoPrune = \lt{}yes|no\gt{}]
\index[dir]{AutoPrune}
+ \index[dir]{Directive!AutoPrune}
Si AutoPrune est activ\'ee ({\bf yes}), ce qui est le cas par d\'efaut, Bacula
(depuis la version 1.20) applique automatiquement la p\'eriode de r\'etention des
volumes lorsqu'un nouveau volumes est requis ou lorsqu'il n'existe aucun volume
\item [Volume Retention = \lt{}time-period-specification\gt{}]
\index[dir]{Volume Retention}
+ \index[dir]{Directive!Volume Retention}
La directive Volume Retention d\'efinit la p\'eriode durant laquelle {\bf Bacula}
conserve les enregistrements Job associ\'es au volume dans le catalogue.
Lors de l'expiration de cette p\'eriode, si {\bf AutoPrune} est activ\'ee, Bacula
p\'eriode la plus courte est celle qui s'applique.Notez bien que lorsque la p\'eriode
{\bf Volume Retention} a \'et\'e atteinte les enregistrements de Job et ceux de fichiers
sont supprimm\'es les uns et les autres.
+Cet \'elagage peut aussi se produire \`a l'ex\'ecution de la commande {\bf status dir} car elle
+applique des algorithmes similaires \`a ceux utilis\'es pour d\'eterminer le prochain volume
+disponible.
Il est important de savoir que lorsque la p\'eriode Volume Retention expire,
Bacula ne recycle pas syst\'ematiquement le volume concern\'e. Il tente de conserver
\item [Recycle = \lt{}yes|no\gt{}]
\index[dir]{Recycle}
+ \index[dir]{Directive!Recycle}
Cette directive sp\'ecifie la valeur par d\'efaut pour le recyclage des volumes purg\'es.
Si elle est activ\'ee ({\bf yes}) et si Bacula a besoin d'un volume mais n'en trouve
aucun utilisable, il recherche alors les volumes purg\'es (c'est \`a dire ceux dont tous
\label{RecycleOldest}
\item [Recycle Oldest Volume = \lt{}yes|no\gt{}]
- \index[dir]{Recycle Oldest Volume }
+ \index[dir]{Recycle Oldest Volume}
+ \index[dir]{Directive!Recycle Oldest Volume}
Cette directive indique au Director de rechercher le volume le plus ancien
du pool lorsq'un nouveau est requis par le Storage Daemon et qu'aucun autre
n'est disponible. Le catalog est alors {\bf \'elagu\'e} dans le respect des
\label{RecycleCurrent}
\item [Recycle Current Volume = \lt{}yes|no\gt{}]
- \index[dir]{Recycle Current Volume }
+ \index[dir]{Recycle Current Volume}
+ \index[dir]{Directive!Recycle Current Volume}
Si Bacula a besoin d'un nouveau volume, cette directive lui indique d'\'elaguer
le volume dans le respect des p\'eriodes {\bf Job}, {\bf File} et
{\bf Volume Retention}. Si tous les jobs sont \'elagu\'es, (c'est \`a dire si le
\label{PurgeOldest}
\item [Purge Oldest Volume = \lt{}yes|no\gt{}]
- \index[dir]{Purge Oldest Volume }
+ \index[dir]{Purge Oldest Volume}
+ \index[dir]{Directive!Purge Oldest Volume}
Cette directive indique au Director de rechercher le volume utilis\'e le plus
ancien dans le pool lorsqu'un nouveau volume est requis par le Storage
Daemon et qu'aucun n'est disponible. Le catalogue est alors purg\'e sans
t\^ot ou tard, Bacula recyclera un volume contenant des donn\'ees valides et r\'ecentes.
La valeur par d\'efaut est {\bf no}
-\item [Accept Any Volume = \lt{}yes|no\gt{} (NDT : Paragraphe supprimm\'e ?)]
- \index[dir]{Accept Any Volume }
-Cette directive pr\'ecise si n'importe quel volume du pool peut \^etre utilis\'e pour
-sauvegarder. La valeur par d\'efaut est {\bf yes} depuis la version 1.27. Si cette
-option est d\'esactiv\'ee, alors seul le premier volume utilisable du pool sera
-accept\'e pour la sauvegarde, ainsi Bacula remplira s\'equentiellement chaque
-volume avant d'en utiliser un nouveau. Autrement dit, si vous montez un volume
-qui n'est pas le premier utilisable, il sera accept\'e et utilis\'e si la valeur
-de cette directive est {\bf yes} et refus\'e sinon.
-
-Si votre procedure de sauvegarde sur bandes vous dicte de monter
-manuellement le prochain volume, vous souhaiterez presque surement activer
-cette option.
-
-Si vous partez en vacances et craignez que le volume en cours d'utilisation
-n'ait pas assez d'espace disponible, vous pouvez en \'etiquetter un nouveau et
-le laisser dans le lecteur. Si {\bf Accept Any Volume} est activ\'ee ({\bf yes}),
-Bacula commencera \`a \'ecrire dessus. A votre retour, remontez simplement
-la cartouche pr\'ec\'edente et Bacula continuera \`a s'en servir jusqu'\`a ce qu'elle
-soit pleine. Vous pouvez alors remonter la cartouche de vos vacances pour que
-Bacula finisse de la remplir.
-
\item [Cleaning Prefix = \lt{}string\gt{}]
- \index[dir]{Cleaning Prefix }
+ \index[dir]{Cleaning Prefix}
+ \index[dir]{Directive!Cleaning Prefix}
Cette directive d\'efinit un pr\'efixe qui, s'il correspond au d\'ebut du nom d'un
volume lors de son \'etiquettage, indique \`a Bacula que le volume en question est
une cartouche de nettoyage, qui aura le statut {\bf VolStatus = Cleaning}.
\label{Label}
\item [Label Format = \lt{}format\gt{}]
- \index[dir]{Label Format }
+ \index[dir]{Label Format}
+ \index[dir]{Directive!Label Format}
Cette directive pr\'ecise le format des \'etiquettes des volumes de ce pool.
La directive {\bf Format} est utilis\'ee comme un patron pour cr\'eer de nouveaux
noms de volumes lors de l'\'etiquettage automatique.
Le {\bf format} devrait \^etre sp\'ecifi\'e entre guillemets, et consiste en une
-chaîne de lettres, chiffres et caract\`eres sp\'eciaux tiret ({\bf -}), soulign\'e
+cha\^ine de lettres, chiffres et caract\`eres sp\'eciaux tiret ({\bf -}), soulign\'e
({\bf \_}), double point ({\bf :}) et point ({\bf .}), qui sont consid\'er\'es valides
pour un nom de volume.
Pour plus de d\'etails sur ce sujet, veuillez consulter le chapitre
\ilink{Variable Expansion}{_ChapterStart50} de ce manuel.
-Si aucun caract\`ere variable n'est d\'ecouvert dans la chaîne, le nom de volume
-sera constitu\'e de la chaîne {\bf format} suffix\'ee du nombre de volumes dans le
+Si aucun caract\`ere variable n'est d\'ecouvert dans la cha\^ine, le nom de volume
+sera constitu\'e de la cha\^ine {\bf format} suffix\'ee du nombre de volumes dans le
pool plus un, au format 4 chiffres et avec des z\'eros en t\^ete. Par exemple,
avec {\bf Label Format = ''File-``}, les volumes seront nomm\'es
{\bf File-0001}, {\bf File-0002}, ...
\end{verbatim}
\normalsize
-\subsubsection*{The Scratch Pool}
+\subsubsection*{Le Scratch Pool}
\addcontentsline{toc}{subsection}{Scratch Pool}
\index[general]{Scratch Pool}
En g\'en\'eral, vous pouvez nommer vos pool \`a votre guise, il existe cependant
\begin{description}
\item [Catalog]
- \index[dir]{Catalog }
+ \index[dir]{Catalog}
+ \index[dir]{Directive!Catalog}
D\'ebut de la ressource Catalog. Il faut au moins une ressource Catalogue.
\item [Name = \lt{}name\gt{}]
- \index[dir]{Name }
+ \index[dir]{Name}
+ \index[dir]{Directive!Name}
Le nom du Catalog. Il n'a pas besoin d'\^etre en relation avec le nom sur le serveur
de base de donn\'ees. Ce nom sera repris dans la ressource Client, indiquant ainsi
que toutes les donn\'ees relatives \`a ce client sont maintenues dans ce catalogue.
\item [password = \lt{}password\gt{}]
- \index[dir]{password }
+ \index[dir]{password}
+ \index[dir]{Directive!password}
Cette directive sp\'ecifie le mot de passe \`a utiliser pour se connecter au
catalogue. Cette directive est requise.
\item [DB Name = \lt{}name\gt{}]
- \index[dir]{DB Name }
+ \index[dir]{DB Name}
+ \index[dir]{Directive!DB Name}
Cette directive sp\'ecifie le nom de la base de donn\'ees. Si vous utilisez plusieurs
catalogues, vous sp\'ecifiez lequel ici. Si vous utilisez un serveur de bases de
donn\'ees externe plut\^ot que l'int\'egr\'e, vous devez sp\'ecifier un nom connu du
tables Bacula.). Cette directive est requise.
\item [user = \lt{}user\gt{}]
- \index[dir]{user }
+ \index[dir]{user}
+ \index[dir]{Directive!user}
L'utilisateur habilit\'e \`a se connecter au catalogue. Cette directive est requise.
\item [DB Socket = \lt{}socket-name\gt{}]
- \index[dir]{DB Socket }
+ \index[dir]{DB Socket}
+ \index[dir]{Directive!DB Socket}
Il s'agit du nom d'un {\it socket} \`a utiliser sur la machine locale pour se
connecter au catalogue. Cette directive n'est utilis\'ee que par MySQL, elle est
ignor\'ee par SQLite. Normalement, si ni {\bf DB Socket}, ni {\bf DB Address} ne sont
sp\'ecifi\'ees, MySQL utilise le socket par d\'efaut.
\item [DB Address = \lt{}address\gt{}]
- \index[dir]{DB Address }
+ \index[dir]{DB Address}
+ \index[dir]{Directive!DB Address}
Il s'agit de l'adresse du serveur de bases de donn\'ees. En principe, vous
utiliserez cette directive plut\^ot que {\bf DB Socket} si le serveur de bases de
donn\'ees est une autre machine. Dans ce cas, vous sp\'ecifierez aussi le port {\bf DB Port}.
optionnelle.
\item [DB Port = \lt{}port\gt{}]
- \index[dir]{DB Port }
+ \index[dir]{DB Port}
+ \index[dir]{Directive!DB Port}
Cette directive d\'efinit le port \`a utiliser en conjonction avec {\bf DB Address} pour
acc\'eder au catalogue s'il est h\'eberg\'e sur une autre machine. Elle n'est utilis\'ee que par
MySQL, et ignor\'ee par SQLite. Elle est optionnelle.
%% \item [Multiple Connections = \lt{}yes|no\gt{}]
-%% \index[dir]{Multiple Connections }
+%% \index[dir]{Multiple Connections}
+%% \index[dir]{Directive!Multiple Connections}
%% Par d\'efaut, cette directive est d\'esactiv\'ee, ce qui implique que tous les jobs utilisant
%% le m\^eme catalogue se partagent une m\^eme connection au catalogue, et que Bacula n'autorise
%% qu'un job \`a la fois \`a communiquer. Si vous activez cette directive ({\bf yes}), Bacula
%% Pour MySQL, vous devez vous assurer {\bf attentivement} d'avoir la version {\it multi thread}
%% de la librairie cliente sur votre syst\`eme. Une fois cette directive activ\'ee, chaque job
%% disposera de sa propre connection au catalogue, la base de donn\'ees contr\^olant les interactions
-%% entre les diff\'erents jobs. Ceci peut accroître significativement les op\'erations de la
+%% entre les diff\'erents jobs. Ceci peut accro\^itre significativement les op\'erations de la
%% base de donn\'ees si vous ex\'ecutez plusieurs jobs simultan\'es. De plus, pour SQLite et PostgreSQL,
-%% Bacula activera automatiquement les transactions dans la base de donn\'ees. Ceci peut accroître
+%% Bacula activera automatiquement les transactions dans la base de donn\'ees. Ceci peut accro\^itre
%% significativement les insertions d'attributs dans le catalogue, que ce soit pour un job unique
%% ou pour plusieurs jobs simultan\'es.
-%% Cette directive n'a pas \'et\'e test\'ee. Veuillez, s'il vous plaît, la tester scrupuleusement avant
+%% Cette directive n'a pas \'et\'e test\'ee. Veuillez, s'il vous pla\^it, la tester scrupuleusement avant
%% de l'activer en production, et nous fournir un retour de vos tests.
\end{description}
\begin{description}
\item [Name = \lt{}name\gt{}]
- \index[dir]{Name }
+ \index[dir]{Name}
+ \index[dir]{Directive!Name}
Le nom de la console. Ce nom doit \^etre en conjonction avec celui sp\'ecifi\'e
dans le fichier de configuration de la Console (comme c'est le cas pour les
d\'efinitions de clients).
\item [Password = \lt{}password\gt{}]
- \index[dir]{Password }
+ \index[dir]{Password}
+ \index[dir]{Directive!Password}
Sp\'ecifie le mot de passe qu'une console nomm\'ee doit fournir pour \^etre autoris\'ee.
-Le m\^eme mot de passe doit apparaître dans la ressource Console du fichier
+Le m\^eme mot de passe doit appara\^itre dans la ressource Console du fichier
de configuration de la Console. Pour plus de s\'ecurit\'e, le mot de passe n'est
jamais r\'eellement transmis \`a travers le r\'eseau, mais plut\^ot un code de
hachage de type {\it challenge response} cr\'e\'e \`a partir du mot de passe.
processus de configuration, autrement, il sera laiss\'e blanc.
\item [JobACL = \lt{}name-list\gt{}]
- \index[dir]{JobACL }
+ \index[dir]{JobACL}
+ \index[dir]{Directive!JobACL}
Cette directive est utilis\'ee pour sp\'ecifier une liste de noms de ressources Job
qui peuvent \^etre acc\'ed\'es par la console. Sans cette directive, la console ne peut
acc\'eder \`a aucune des ressources Job d\'efinies dans le fichier de configuration
les quatre jobs d\'esign\'es par la directive JobACL, et uniquement \`a eux.
\item [ClientACL = \lt{}name-list\gt{}]
- \index[dir]{ClientACL }
+ \index[dir]{ClientACL}
+ \index[dir]{Directive!ClientACL}
Cette directive est utilis\'ee pour sp\'ecifier une liste de noms de ressources Client
iaccessibles par la console.
\item [StorageACL = \lt{}name-list\gt{}]
- \index[dir]{StorageACL }
+ \index[dir]{StorageACL}
+ \index[dir]{Directive!StorageACL}
Cette directive est utilis\'ee pour sp\'ecifier une liste de noms de ressources Storage
accessibles par la console.
\item [ScheduleACL = \lt{}name-list\gt{}]
- \index[dir]{ScheduleACL }
+ \index[dir]{ScheduleACL}
+ \index[dir]{Directive!ScheduleACL}
Cette directive est utilis\'ee pour sp\'ecifier une liste de noms de ressources Schedule
accessibles par la console.
\item [PoolACL = \lt{}name-list\gt{}]
- \index[dir]{PoolACL }
+ \index[dir]{PoolACL}
+ \index[dir]{Directive!PoolACL}
Cette directive est utilis\'ee pour sp\'ecifier une liste de noms de ressources Pool
accesibles ar la console.
\item [FileSetACL = \lt{}name-list\gt{}]
- \index[dir]{FileSetACL }
+ \index[dir]{FileSetACL}
+ \index[dir]{Directive!FileSetACL}
Cette directive est utilis\'ee pour sp\'ecifier une liste de noms de ressources FileSet
accessibles par la console.
\item [CatalogACL = \lt{}name-list\gt{}]
- \index[dir]{CatalogACL }
+ \index[dir]{CatalogACL}
+ \index[dir]{Directive!CatalogACL}
Cette directive est utilis\'ee pour sp\'ecifier une liste de noms de ressources Catalog
accessibles par la console.
\item [CommandACL = \lt{}name-list\gt{}]
- \index[dir]{CommandACL }
+ \index[dir]{CommandACL}
+ \index[dir]{Directive!CommandACL}
Cette directive est utilis\'ee pour sp\'ecifier une liste de commandes de la console
qui peuvent \^etre ex\'ecut\'ees par la console.
\begin{description}
\item [Counter]
- \index[dir]{Counter }
+ \index[dir]{Counter}
+ \index[dir]{Directive!Counter}
D\'ebut de la ressource Counter. les directives Counter sont optionnelles.
\item [Name = \lt{}name\gt{}]
- \index[dir]{Name }
+ \index[dir]{Name}
+ \index[dir]{Directive!Name}
iLe nom de la variable-compteur. Il s'agit du nom que vous utiliserez pour vous r\'ef\'erer
\`a cette variable et acc\'eder \`a sa valeur.
\item [Minimum = \lt{}integer\gt{}]
- \index[dir]{Minimum }
+ \index[dir]{Minimum}
+ \index[dir]{Directive!Minimum}
Sp\'ecifie la valeur minimale de la variable-compteur. Cette valeur devient celle par d\'efaut.
Si elle n'est pas fournie, sa valeur est z\'ero.
\item [Maximum = \lt{}integer\gt{}]
- \index[dir]{Maximum }
+ \index[dir]{Maximum}
+ \index[dir]{Directive!Maximum}
Sp\'ecifie la valeur maximale de la variable-compteur. Si elle n'est pas fournie, ou si elles
est r\'egl\'ee \`a z\'ero, la variable compteur peut prendre une valeur maximale de 2 147 483 648
($2^{31}$). Au del\`a de cette valeur, le compteur est remis au minimum.
\item [*WrapCounter = \lt{}counter-name\gt{}]
- \index[dir]{*WrapCounter }
+ \index[dir]{*WrapCounter}
+ \index[dir]{Directive!*WrapCounter}
Si cette valeur est sp\'ecifi\'ee, lorsque la variable-compteur d\'epasse le maximum et
est remise au minimum, le compteur sp\'ecifi\'e par la directive {\bf WrapCounter} est
-incr\'ement\'e. (Ceci n'est, pour le moment, pas impl\'ement\'e.
+incr\'ement\'e. (Ceci n'est, pour le moment, pas impl\'ement\'e.)
\item [Catalog = \lt{}catalog-name\gt{}]
- \index[dir]{Catalog }
+ \index[dir]{Catalog}
+ \index[dir]{Directive!Catalog}
Si cette directive est sp\'ecifi\'ee, le compteur et sa valeur sont sauvegard\'es dans le
catalogue sp\'ecifi\'e. Dans le cas contraire, le compteur est red\'efini \`a chaque
d\'emarrage de Bacula.