git.sur5r.net Git - bacula/docs/blob - docs/manual-fr/filedconf.tex

   1 %%
   2 %%
   3
   4 \section*{Configuration du Client/File Daemon}
   5 \label{_ChapterStart25}
   6 \index[general]{Configuration!Client/File daemon }
   7 \index[general]{Client/File daemon Configuration }
   8 \addcontentsline{toc}{section}{Client/File daemon Configuration}
   9
  10 \subsection*{General}
  11 \index[general]{General }
  12 \addcontentsline{toc}{subsection}{General}
  13
  14 La configuration du Client (ou File Daemon) est l'une des plus simples \`a
  15 effectuer. En principe, vous n'aurez rien \`a modifier au fichier par d\'efaut
  16 en dehors du nom du Client afin d'identifier clairement les messages d'erreur.
  17
  18 Pour un discours g\'en\'eral sur les fichiers de configuration et ressources
  19 incluant les types de donn\'ees reconnues par Bacula, veuillez consulter
  20 le chapitre \ilink{Configuration}{_ChapterStart16} de ce manuel.
  21 Les ressources suivantes doivent \^etre d\'efinies :
  22
  23 \begin{itemize}
  24 \item
  25    \ilink{Client}{ClientResource} -- pour d\'efinir les clients qui doivent \^etre
  26    sauvegard\'es.
  27 \item
  28    \ilink{Director}{DirectorResource} -- pour d\'efinir le nom du Director et son
  29    mot de passe.
  30 \item
  31    \ilink{Messages}{_ChapterStart15} -- pour d\'efinir o\`u les messages d'erreur et
  32    d'information doivent \^etre envoy\'es.
  33 \end{itemize}
  34
  35 \subsection*{La ressource Client}
  36 \label{ClientRessource}
  37 \index[general]{Ressource!Client }
  38 \index[general]{Client Ressource }
  39 \addcontentsline{toc}{subsection}{Ressource Client}
  40
  41 La ressource Client (ou File Daemon) d\'efinit le nom du Client (en tant que
  42 client du Director), ainsi que le port sur lequel le Client \'ecoute les
  43 connections du Director.
  44
  45 \begin{description}
  46
  47 \item [Client (ou FileDaemon)]
  48    \index[fd]{Client (ou FileDaemon)}
  49    \index[fd]{Directive!Client (or FileDaemon)}
  50 D\'ebut des enregistrements du client. Il ne doit y avoir qu'une seule ressource
  51 Client dans le fichier de configuration puisqu'il d\'efinit les propri\'et\'es du
  52 programme client courrant.
  53
  54 \item [Name = \lt{}name\gt{}]
  55    \index[fd]{Name}
  56    \index[fd]{Directive!Name}
  57    Le nom du client qui doit \^etre utilis\'e par le Director lors de la connection.
  58    G\'en\'eralement, c'est une bonne id\'ee d'utiliser un nom en relation avec la
  59    machine de fa\\ 3on \`a identifier facilement les messages d'erreur si vous avez
  60    plusieurs clients. Cette directive est requise.
  61
  62 \item [Working Directory = \lt{}Directory\gt{}]
  63    \index[fd]{Working Directory}
  64    \index[fd]{Directive!Working Directory}
  65    Cette directive sp\'ecifie le r\'epertoire dans lequel le File Daemon peut placer
  66    ses fichiers de statuts. Il ne devrait \^etre utilis\'e que par Bacula, mais il
  67    peut \^etre partag\'e par d'autres daemons Bacula, pourvu que les noms de daemons
  68    d\'efinis par la directive {\bf Name} soient uniques pour chaque daemon. Cette
  69    directive est requise.
  70
  71    Sur les syst\`emes Win32, vous pouvez, dans certaines circonstances, \^etre
  72    amen\'e \`a sp\'ecifier une lettre de disque au niveau de la sp\'ecification
  73    du r\'epertoire. Aussi, assurez-vous que ce r\'epertoire est bien accessible
  74    en \'ecriture par l'utilisateur SYSTEM, faute de quoi les restaurations
  75    peuvent \'echouer (le fichier bootstrap transf\'er\'e au File Daemon par le
  76    Director est temporairement plac\'e dans ce r\'epertoire avant d'\^etre
  77    transmis au Storage Daemon).
  78
  79 \item [Pid Directory = \lt{}Directory\gt{}]
  80    \index[fd]{Pid Directory}
  81    \index[fd]{Directive!Pid Directory}
  82     Cette directive sp\'ecifie le r\'epertoire dans lequel le Director peut placer
  83     son fichier d'Id de processus. Le fichier d'Id de processus est utilis\'e
  84     pour stopper Bacula et pr\'evenir l'ex\'ecution simultan\'ee de plusieurs copies
  85     de Bacula. Cette directive est requise. L'\'evaluation standard du shell de
  86     {\bf Directory} est faite lorsque le fichier de configuration est lu, de
  87     sorte que des valeurs telles que {\bf \$HOME} seront correctement
  88     substitu\'ees.
  89
  90    Typiquement, sur les syst\`emes Linux, vous utiliserez la valeur {\bf /var/run}
  91    pour cette directive. Si vous n'installez pas Bacula dans les r\'epertoires du
  92    syst\`eme, vous pouvez utiliser le {\bf Working Directory} tel que d\'efini
  93    ci-dessus.
  94
  95 \item [Heartbeat Interval = \lt{}time-interval\gt{}]
  96    \index[fd]{Heartbeat Interval}
  97    \index[fd]{Directive!Heartbeat Interval}
  98    \index[general]{Heartbeat Interval}
  99    \index[general]{Broken pipe}
 100    \index[general]{Lenteur}
 101    \index[general]{Sauvegarde!lenteur}
 102    Cette directive d\'efinit un intervalle de temps. Chaque "pulsation"
 103    du Storage Daemon re\\ 3ue par le File Daemon est transmise au Director.
 104    De plus, si aucune pulsation n'est re\\ 3ue du Storage Daemon (et donc
 105    pas transmise au Director) le File Daemon envoie une pulsation \`a ces
 106    deux daemons afin de conserver les canaux actifs. La valeur par d\'efaut est
 107    z\'ero, ce qui d\'esactive les pulsations. Cette fonction est particuli\`erement
 108    utile si vous avez un routeur tels que les 3com qui ne suivent pas les
 109    standards Internet et expirent une connection valide apr\`es une courte p\'eriode
 110    en d\'epit de l'activation de {\it keepalive}. Il en r\'esulte en g\'en\'eral
 111    un message "broken pipe error".
 112
 113    Si vous continuez de recevoir de messages broken pipe malgr\'e
 114    {\bf Heartbeat Interval}, et si vous utilisez Windows, vous devriez envisager
 115    de mettre \`a jour votre pilote ethernet. Il s'agit d'un probl\`eme connu
 116    des pilotes NVidia NForce 3 (4.4.2 17/05/2004). Vous pouvez aussi essayer
 117    la proc\'edure suivante sugg\'er\'ee par Thomas Simmons pour les machines
 118    Win32 :
 119
 120    D\'emarrer \gt{} Panneau de configuration \gt{} connections r\'eseau
 121
 122    Faites un click droit sur connection pour l'adaptateur nvidia et
 123    s\'electionnez "propri\'et\'es". Sous l'onglet "G\'en\'eral", cliquez "Configurer...".
 124    Sous l'onglet "Avanc\'e", d\'esactivez l'option "Checksum Offload" et cliquez
 125    "Ok" pour sauvegarder la modification.
 126
 127    L'absence de communication, ou des interruptions dans les communications
 128    peuvent aussi \^etre caus\'ees par des firewalls Linux si vous avez une r\`egle
 129    qui limite les connections ou le trafic.
 130
 131    Right click the connection for the nvidia adapter and select properties.
 132    Under the General tab, click "Configure...". Under the Advanced tab set
 133    "Checksum Offload" to disabled and click OK to save the change.
 134
 135    Lack of communications, or communications that get interrupted can
 136    also be caused by Linux firewalls where you have a rule that throttles
 137    connections or traffic.
 138
 139
 140 \item [Maximum Concurrent Jobs = \lt{}number\gt{}]
 141    \index[fd]{Maximum Concurrent Jobs}
 142    \index[fd]{Directive!Maximum Concurrent Jobs}
 143    O\`u \lt{}number\gt{} est le nombre maximum de jobs qui peuvent \^etre
 144    ex\'ecut\'es simultan\'ement. La valeur par d\'efaut est 2, mais vous pouvez
 145    mettre une valeur plus importante. Tout contact du Director (par exemple :
 146    requ\^ete de statut, de lancement de job...) est consid\'er\'e comme un job,
 147    aussi, si vous souhaitez garder la possibilit\'e de faire une requ\^ete de
 148    statut {\bf status} dans la console alors qu'un job est en cours, vous
 149    devez r\'egler cette valeur sup\'erieure \`a 1.
 150
 151
 152 \item [FDAddresses = \lt{}IP-address-specification\gt{}]
 153    \index[fd]{FDAddresses}
 154    \index[fd]{Directive!FDAddresses}
 155    Sp\'ecifie les ports et adresses sur lesquels le Director \'ecoute les connections
 156    de consoles Bacula. La meilleure explication est probalement un exemple :
 157
 158 \footnotesize
 159 \begin{verbatim}
 160  FDAddresses  = { ip = {
 161         addr = 1.2.3.4; port = 1205; }
 162     ipv4 = {
 163         addr = 1.2.3.4; port = http; }
 164     ipv6 = {
 165         addr = 1.2.3.4;
 166         port = 1205;
 167     }
 168     ip = {
 169         addr = 1.2.3.4
 170         port = 1205
 171     }
 172     ip = {
 173         addr = 1.2.3.4
 174     }
 175     ip = {
 176         addr = 201:220:222::2
 177     }
 178     ip = {
 179         addr = bluedot.thun.net
 180     }
 181  }
 182 \end{verbatim}
 183 \normalsize
 184
 185 o\`u ip, ip4, ip6, addr, et port sont tous des mots-clef. Notez que les adresses
 186 peuvent \^etre sp\'ecifi\'ees aussi bien en quadruplets point\'es qu'en notation IPv6
 187 double point\'ee ou avec des noms symboliques (seulement pour la la sp\'ecification
 188 d'ip). De m\^eme, les ports peuvent \^etre sp\'ecifi\'e sous forme de nombres, ou avec
 189 les valeurs mn\'emoniques du fichier /etc/services. Si un port n'est pas sp\'ecifi\'e,
 190 la valeur par d\'efaut est utilis\'ee. Si une section ip est sp\'ecifi\'ee, la r\'esolution
 191 peut s'effectuer avec IPv4 et IPv6. Si ip4 est sp\'ecifi\'e, alors seule la r\'esolution
 192 IPv4 est permise, il en va de m\^eme avec ip6.
 193
 194 \item [FDPort = \lt{}port-number\gt{}]
 195    \index[fd]{FDPort}
 196    \index[fd]{Directive!FDPort}
 197 Cette directive sp\'ecifie le num\'ero de port sur lequel le Client est en attente de
 198 connections du Director. Le num\'ero sp\'ecifi\'e ici doit s'accorder avec le num\'ero
 199 FDPort sp\'ecifi\'e dans la ressource Client du fichier de configuration du Director.
 200 La valeur par d\'efaut est 9102.
 201
 202 \item [FDAddress = \lt{}IP-Address\gt{}]
 203    \index[fd]{FDAddress}
 204    \index[fd]{Directive!FDAddress}
 205   Cette directive est optionnelle. Si elle est sp\'ecifi\'ee, le serveur File Daemon
 206 (serveur pour les connections du Director) est alors li\'e \`a l'adresse sp\'ecifi\'ee
 207 {\bf IP-Address}, qui est soit un nom de domaine, soit une adresse IP sp\'ecifi\'ee
 208 au format quadruplet point\'e. Si cet enregistrement n'est pas sp\'ecifi\'e, le File
 209 Daemon se lie alors \`a toute adresse disponible (c'est le comportement par d\'efaut).
 210
 211 \item [SDConnectTimeout = \lt{}time-interval\gt{}]
 212    \index[fd]{SDConnectTimeout}
 213    \index[fd]{Directive!SDConnectTimeout}
 214 Cette directive d\'efinit l'intervalle de temps durant lequel le File Daemon tente
 215 de se connecter au Storage Daemon. La valeur par d\'efaut est 30 minutes Si aucune
 216 connection n'est \'etablie durant cet intervalle, le File Daemon efface le Job.
 217
 218 \item [Maximum Network Buffer Size = \lt{}bytes\gt{}]
 219    \index[fd]{Maximum Network Buffer Size}
 220    \index[fd]{Directive!Maximum Network Buffer Size}
 221 O\`u \lt{}bytes\gt{} sp\'ecifie la taille initiale du tampon r\'eseau \`a utiliser
 222 avec le File Daemon. Cette taille sera revue \`a la baisse si elle est trop
 223 importante jusqu'\`a ce qu'elle soit accept\'ee par le syst\`eme d'exploitation.
 224 Soyez circonspect avec cette directive car si la valeur est trop importante,
 225 elle sera diminu\'ee par pas de 512 octets jusqu'\`a ce qu'elle convienne au
 226 syst\`eme d'exploitation, ce qui peut requ\'erir un grand nombre d'appels
 227 syst\`emes. La valeur par d\'efaut est 32 768 octets.
 228 \end{description}
 229
 230 Voici un exemple d'une d\'efinition de ressource Client valide :
 231
 232 \footnotesize
 233 \begin{verbatim}
 234 Client {                              # this is me
 235   Name = rufus-fd
 236   WorkingDirectory = $HOME/bacula/bin/working
 237   Pid Directory = $HOME/bacula/bin/working
 238 }
 239 \end{verbatim}
 240 \normalsize
 241
 242 \subsection*{La ressource Director}
 243 \label{DirectorResource}
 244 \index[general]{La ressource Director}
 245 \index[general]{Resource!Director }
 246 \addcontentsline{toc}{subsection}{Director Ressource}
 247 La ressource Director d\'efinit le nom et le mot de passe des Directors
 248 autoris\'es \`a contacter ce client.
 249
 250 \begin{description}
 251
 252 \item [Director]
 253    \index[fd]{Director}
 254    \index[fd]{Directive!Director}
 255    D\'ebut des enregistrements de Director. Il peut y avoir un nombre quelconque
 256    de ressources Director dans le fichier de configuration du Client. Chacune
 257    d\'efinit un Director autoris\'e \`a contacter ce Client.
 258
 259 \item [Name = \lt{}name\gt{}]
 260    \index[fd]{Name}
 261    \index[fd]{Directive!Name}
 262    Le nom du Director qui peut contacter ce Client. Ce nom doit \^etre le m\^eme
 263    que celui sp\'ecifi\'e au niveau de la ressource Director dans le fichier de
 264    configuration du Director. Cette directive est requise.
 265
 266 \item [Password = \lt{}password\gt{}]
 267    \index[fd]{Password}
 268    \index[fd]{Directive!Password}
 269    Sp\'ecifie le mot de passe qui doit \^etre fourni par le Director pour \^etre
 270    autoris\'e. Ce mot de passe doit \^etre le m\^eme que celui sp\'ecifi\'e dans la
 271    ressource Client du fichier de configuration du Director. Cette directive
 272    est requise.
 273
 274 \item [Monitor = \lt{}yes|no\gt{}]
 275    \index[fd]{Monitor}
 276    \index[fd]{Directive!Monitor}
 277    Si cette directive est r\'egl\'ee \`a {\bf no} (valeur par d\'efaut), ce Director
 278    dispose d'un acc\`es total \`a ce Client. Dans le cas contraire ({\bf yes}), ce
 279    Director est seulement autoris\'e \`a relever le statut courant de ce Client.
 280
 281    Veuillez noter que si ce Director est utilis\'e \`a des fins de surveillance, nous
 282    vous recommandons fortement de mettre cette directive \`a {\bf yes} pour
 283    \'eviter de s\'erieux probl\`emes de s\'ecurit\'e.
 284 \end{description}
 285
 286 Ainsi, plusieurs Directors peuvent \^etre autoris\'es \`a utiliser les services de
 287 ce Client. Chaque Director aura un nom diff\'erent, et, en principe, un mot de passe
 288 diff\'erent.
 289
 290 Voici un exemple d'une d\'efinition de ressource Director valide :
 291
 292 \footnotesize
 293 \begin{verbatim}
 294 #
 295 # List Directors who are permitted to contact the File daemon
 296 #
 297 Director {
 298   Name = HeadMan
 299   Password = very_good                # password HeadMan must supply
 300 }
 301 Director {
 302   Name = Worker
 303   Password = not_as_good
 304   Monitor = Yes
 305 }
 306 \end{verbatim}
 307 \normalsize
 308
 309 \subsection*{La ressource Message}
 310 \label{MessagesResource}
 311 \index[general]{La ressource Message}
 312 \index[general]{Ressource!Message }
 313 \addcontentsline{toc}{subsection}{Ressource Message}
 314 Voyez le chapitre \ilink{La ressource Messages}{_ChapterStart15} de ce manuel
 315 pour plus de d\'etails sur la ressource Messages.
 316
 317 Il doit y avoir au moins une ressource Messages d\'efinie dans le fichier de
 318 configuration du Client.
 319
 320 \subsection*{Un exemple de fichier de configuration de Client}
 321 \label{SampleClientConfiguration}
 322 \index[general]{Exemple fichier configuration Client }
 323 \index[general]{Fichier!Exemple configuration Client}
 324 \addcontentsline{toc}{subsection}{Exemple fichier de configuration Client}
 325
 326 Voici un exemple de fichier de configuration de Client :
 327
 328 \footnotesize
 329 \begin{verbatim}
 330 #
 331 # Default  Bacula File Daemon Configuration file
 332 #
 333 #  For Bacula release 1.35.2 (16 August 2004) -- gentoo 1.4.16
 334 #
 335 # There is not much to change here except perhaps to
 336 #   set the Director's name and File daemon's name
 337 #   to something more appropriate for your site.
 338 #
 339 #
 340 # List Directors who are permitted to contact this File daemon
 341 #
 342 Director {
 343   Name = rufus-dir
 344   Password = "/LqPRkX++saVyQE7w7mmiFg/qxYc1kufww6FEyY/47jU"
 345 }
 346 #
 347 # Restricted Director, used by tray-monitor to get the
 348 #   status of the file daemon
 349 #
 350 Director {
 351   Name = rufus-mon
 352   Password = "FYpq4yyI1y562EMS35bA0J0QC0M2L3t5cZObxT3XQxgxppTn"
 353   Monitor = yes
 354 }
 355 #
 356 # "Global" File daemon configuration specifications
 357 #
 358 FileDaemon {                          # this is me
 359   Name = rufus-fd
 360   WorkingDirectory = $HOME/bacula/bin/working
 361   Pid Directory = $HOME/bacula/bin/working
 362 }
 363 # Send all messages except skipped files back to Director
 364 Messages {
 365   Name = Standard
 366   director = rufus-dir = all, !skipped
 367 }
 368 \end{verbatim}
 369 \normalsize