]> git.sur5r.net Git - bacula/docs/blobdiff - docs/manual-fr/consoleconf.tex
kes Implement grow tool to grow a file for testing very large databases.
[bacula/docs] / docs / manual-fr / consoleconf.tex
index 304c95afbee05a490cab3a76653a0d6f6c8efbe5..982e67da07b49f68777b8b42d2cf433a72c78864 100644 (file)
@@ -1,82 +1,70 @@
 %%
 %%
 
-\section*{Console Configuration}
-\label{_ChapterStart36}
-\index[general]{Configuration!Console }
-\index[general]{Console Configuration }
-\addcontentsline{toc}{section}{Console Configuration}
+\chapter{Configuration de la Console}
+\label{ConsoleConfChapter}
+\index[general]{Configuration!Console}
+\index[general]{Configuration de la Console}
 
-\subsection*{General}
-\index[general]{General }
-\addcontentsline{toc}{subsection}{General}
+\section{General}
+\index[general]{General}
 
-The Console configuration file is the simplest of all the configuration files,
-and in general, you should not need to change it except for the password. It
-simply contains the information necessary to contact the Director or
-Directors. 
+Le fichier de configuration de la console est le plus simple de tous, et en g\'en\'eral, 
+vous n'aurez rien d'autre \`a changer que le mot de passe. Il contient simplement les 
+informations n\'ecessaires pour se connecter au(x) Director(s).
 
-For a general discussion of configuration file and resources including the
-data types recognized by {\bf Bacula}, please see the 
-\ilink{Configuration}{_ChapterStart16} chapter of this manual. 
-
-The following Console Resource definition must be defined: 
-
-\begin{itemize}
-\item 
-   \ilink{Director}{DirectorResource3} -- to  define the
-   Director's name and his access password. Note,  you may define more than one
-Director resource in the  Console configuration file. If you do so, the
-Console program  will ask you which one you want to use. 
-\end{itemize}
+Pour une discussion g\'en\'erale sur les fichiers de configuration et leurs ressources  
+ainsi que les types de donn\'ees reconnus par {\bf Bacula}, consultez le chapitre 
+\ilink{Configuration}{ConfigureChapter} de ce manuel.
+Les ressources Console suivantes doivent \^etre d\'efinies :
 
-\subsection*{The Director Resource}
+\section{La ressource Director}
 \label{DirectorResource3}
-\index[general]{Director Resource }
-\index[general]{Resource!Director }
-\addcontentsline{toc}{subsection}{Director Resource}
+\index[general]{Director Ressource}
+\index[general]{Ressource!Director}
 
-The Director resource defines the attributes of the Director running on the
-network. You may have multiple Director resource specifications in a single
-Console configuration file. If you have more than one, you will be prompted to
-choose one when you start the {\bf Console} program. 
+La ressource Director d\'efinit les attributs du Director ex\'ecut\'e sur le r\'eseau. 
+Vous pouvez avoir plusieurs ressources Director dans un seul fichier de 
+configuration de console. Dans ce cas, le programme Console vous demandera 
+de choisir \`a son lancement le Director vous voulez contacter.
 
 \begin{description}
 
 \item [Director]
-   \index[console]{Director }
-   Start of the Director records. 
+   \index[console]{Director}
+   D\'ebut des directives relatives au Director.
 
 \item [Name = \lt{}name\gt{}]
-   \index[console]{Name  }
-   The director name used to select  among different Directors, otherwise, this
-name is not used. 
-
+   \index[console]{Name}
+   Le nom du Director utilis\'e pour choisir entre les diff\'erents Directors. 
+   (ce nom n'est utilis\'e que pour {\c c}a).
 \item [DIRPort = \lt{}port-number\gt{}]
-   \index[dir]{DIRPort  }
-   Specify the port to use to connect  to the Director. This value will most
-likely already be set to the value  you specified on the {\bf
-\verb{--{with-base-port} option of the  {\bf ./configure} command. This port must be
-identical to the  {\bf DIRport} specified in the {\bf Director} resource of
-the 
-\ilink{Director's configuration}{_ChapterStart40} file.  The
-default is 9101 so this record is not normally specified. 
-
+   \index[dir]{DIRPort}
+   Sp\'ecifie le num\'ero de port \`a utiliser pour contacter le Director. cette valeur 
+   sera fort probablement d\'ej\`a \'egale \`a celle que vous avez sp\'ecifi\'ee pour 
+   l'option {\bf \verb:--:with-base-port} de la commande {\bf configure}. Ce 
+   port doit \^etre identique \`a celui sp\'ecifi\'e par la directive {\bf DIRport} de la 
+   ressource {\bf Director} du fichier de \ilink{configuration du Director}{DirectorChapter}. 
+   La valeur par d\'efaut est 9101, aussi cet directive n'est normalement pas 
+   sp\'ecifi\'ee.
+   
 \item [Address = \lt{}address\gt{}]
-   \index[dir]{Address  }
-   Where the address is a host name,  a fully qualified domain name, or a network
-address used to connect  to the Director. 
+   \index[dir]{Address}
+   O\`u "adress" est un nom d'h\^ote, un nom de domaine pleinement qualifi\'e, ou une 
+   adresse r\'eseau utlis\'ee pour se connecter au Director.
 
 \item [Password = \lt{}password\gt{}]
-   \index[dir]{Password  }
-   Where the password is the  password needed for the Director to accept the
-Console connection.  This password must be identical to the {\bf Password}
-specified in  the {\bf Director} resource of th
-\ilink{Director's configuration}{_ChapterStart40} file. This 
-record is required. 
+   \index[dir]{Password}
+   Ce mot de passe est celui exig\'e par le Director pour accepter la connexion 
+   d'une console. Il doit \^etre identique \`a celui sp\'ecifi\'e dans la ressource Director 
+   du fichier de \ilink{configuration du Director}{DirectorChapter}. Cette directiv
+   est requise.
+
 \end{description}
 
-An actual example might be: 
+Voici un exemple r\'eel :
 
 \footnotesize
 \begin{verbatim}
@@ -88,100 +76,151 @@ Director {
 \end{verbatim}
 \normalsize
 
-\subsection*{The ConsoleFont Resource}
-\index[general]{Resource!ConsoleFont }
-\index[general]{ConsoleFont Resource }
-\addcontentsline{toc}{subsection}{ConsoleFont Resource}
+\section{La ressource ConsoleFont}
+\index[general]{Ressource!ConsoleFont}
+\index[general]{Ressource ConsoleFont}
 
-The ConsoleFont resource is available only in the GNOME version of the
-console. It permits you to define the font that you want used to display in
-the main listing window. 
+Cette ressource n'est disponible que dans la version GNOME de la console. 
+Elle vous permet de d\'efinir les fontes que vous voulez utiliser pour 
+l'affichage dans la fen\^etre principale.
 
 \begin{description}
 
 \item [ConsoleFont]
-   \index[console]{ConsoleFont }
-   Start of the ConsoleFont records. 
+   \index[console]{ConsoleFont}
+   D\'ebut des directives  ConsoleFont.
 
 \item [Name = \lt{}name\gt{}]
-   \index[console]{Name  }
-   The name of the font. 
+   \index[console]{Name}
+   Le nom de la fonte.
 
-\item [Font = \lt{}X-Window Font Specification\gt{}]
-   \index[console]{Font  }
-   The string value given here defines the desired font. It  is specified in the
-standard cryptic X Window format. For  example, the default specification is: 
+\item [Font = \lt{}Pango Font Name\gt{}]
+   \index[console]{Font}
+   La cha\^ine sp\'ecifi\'ee ici d\'efinit la fonte d\'esir\'ee. Elle est sp\'ecifi\'ee au 
+   format Pango. Par exemple, la sp\'ecification par d\'efaut est :
 
 \footnotesize
 \begin{verbatim}
-Font = "-misc-fixed-medium-r-normal-*-*-130-*-*-c-*-iso8859-1"
+Font = "LucidaTypewriter 9"
 \end{verbatim}
 \normalsize
 
 \end{description}
 
-Thanks to Phil Stracchino for providing the code for this feature. 
+Merci \`a Phil Stracchino d'avoir fourni le code pour cette fonctionnalit\'e.
 
-An actual example might be: 
+Un autre exemple :
 
 \footnotesize
 \begin{verbatim}
 ConsoleFont {
   Name = Default
-Font = "-misc-fixed-medium-r-normal-*-*-130-*-*-c-*-iso8859-1"
+Font = "Monospace 10"
 }
 \end{verbatim}
 \normalsize
 
-\subsection*{The Console Resource}
+\section{La ressource Console}
 \label{ConsoleResource}
-\index[general]{Console Resource }
-\index[general]{Resource!Console }
-\addcontentsline{toc}{subsection}{Console Resource}
+\index[general]{ressource Console}
+\index[general]{Ressource!Console}
 
-As of Bacula version 1.33 and higher, there are three different kinds of
-consoles, which the administrator or user can use to interact with the
-Director. These three kinds of consoles comprise three different security
-levels. 
+Depuis la version 1.33 de Bacula, il existe trois types de consoles 
+diff\'erents avec lesquels l'administrateur ou l'utilisateur peut 
+interagir avec le Director. Ces trois types de consoles comportent 
+trois niveaux de s\'ecurit\'e.
 
 \begin{itemize}
-\item The first console type is an {\bf anonymous} or {\bf default}  console,
-   which has full privileges. There is no console  resource necessary for this
-   type since the password is  specified in the Director resource. This is the
-kind of  console that was initially implemented in versions prior to  1.33 and
-remains valid. Typically you would use it only  for administrators.  
-\item The second type of console, and new to version 1.33 and  higher is a
-   ``named'' console defined within a  Console resource in both the Director's
-   configuration file  and in the Console's configuration file. Both the names 
-and the passwords in these two entries must match much as  is the case for
-Client programs. 
-
-This second type of  console begins with absolutely no privileges except those
-explicitly specified in the Director's Console resource.  Thus you can have
-multiple Consoles with different names  and passwords, sort of like multiple
-users, each with  different privileges. As a default, these consoles can do 
-absolutely nothing -- no commands what so ever. You give  them privileges or
-rather access to commands and resources  by specifying access control lists in
-the Director's  Console resource. Note, if you are specifying such a  console,
-you will want to put a null password in the  Director resource.  
-\item The third type of console is similar to the above mentioned  one in that
-   it requires a Console resource definition in  both the Director and the
-   Console. In addition, if the  console name, provided on the {\bf Name =}
-directive, is  the same as a Client name, the user of that console is 
-permitted to use the {\bf SetIP} command to change the  Address directive in
-the Director's client resource to the  IP address of the Console. This permits
-portables or other  machines using DHCP (non-fixed IP addresses) to 
-``notify'' the Director of their current IP  address. 
-\end{itemize}
+\item Le premier type de console est la console {\bf anonyme} ou 
+  {\bf par d\'efaut}, qui poss\`ede les pleins pouvoirs. Aucune ressource console 
+  n'est requise pour ce premier type puisque le mot de passe est sp\'ecifi\'e dans 
+  la ressource Director. Ce type de console est le premier \`a avoir \'et\'e 
+  impl\'ement\'e, et demeure fonctionnel. Vous le r\'eserverez, typiquement, \`a 
+  l'usage exclusif des administrateurs.
+
+\item Le second type, apparu avec la version 1.33, est une console "nomm\'ee" 
+  ou "restreinte" d\'efinie dans des ressources Console dans les fichiers de configuration du 
+  Director et dans celui de la console. Les noms et mot de passe dans ces 
+  deux fichiers doivent correspondre, comme c'est le cas pour les programmes 
+  clients.
+
+  Ce second type de console ne poss\`ede, par d\'efaut, aucun privil\`ege. Pour lui 
+  en accorder, vous devez les sp\'ecifier explicitement dans la ressource 
+  Console du Director.  
+  
+  Ainsi, vous pouvez avoir plusieurs consoles avec des 
+  noms et mots de passe distincts et avec, pour chacune, des privil\`eges 
+  diff\'erents. Ces consoles ne peuvent, par d\'efaut, absolument rien faire. 
+  C'est vous qui leur accordez des privil\`eges, ou plut\^ot l'acc\`es \`a des 
+  commandes et ressources en sp\'ecifiant des listes de contr\^ole d'acc\`es 
+  dans la ressource Console du Director. L'administrateur peut ainsi contrôler 
+  finement les actions permises à des consoles (ou utilisateurs) particuliers.
+  
+\item Le troisi\`eme type de console ressemble au pr\'ec\'edent en ce qu'il requiert 
+  une d\'efinition de ressource Console dans le fichier de configuration du 
+  Director et dans celui de la console. Mais cette console permet aussi, si 
+  le nom de la console (la directive {\bf name}) est le m\^eme que celui du client, 
+  d'utiliser la commande {\bf SetIP} pour changer la valeur de la directive 
+  {\bf Address} dans la ressource client du Director en l'adresse de la console. 
+  Ceci permet aux portables et autres machines utilisant DHCP (adresses IP 
+  dynamiques) de notifier au Director leur adresse IP courante.
 
-The Console resource is optional and need not be specified. However, if it is
-specified, you can use ACLs (Access Control Lists) in the Director's
-configuration file to restrict the particular console (or user) to see only
-information pertaining to his jobs or client machine. 
+\end{itemize}
 
-The following configuration files were supplied by Phil Stracchino. For
-example, if we define the following in the user's bconsole.conf file (or
-perhaps the wx-console.conf file): 
+La ressource Console est optionnelle. Cependant, si elle est sp\'ecifi\'ee, 
+vous pouvez utiliser les ACLs (listes de contr\^ole d'acc\`es) dans le fichier 
+de configuration du Director pour restreindre une console particuli\`ere 
+ou un utilisateur pour qu'ils ne voient que les informations relatives 
+\`a ses jobs ou \`a sa machine cliente.
+
+Vous pouvez spécifier autant de ressources Console que vous voulez dans 
+le fichier de configuration de la console. Cependant, si vous avez plusieurs 
+ressources Director (c'est à dire si vous vous connectez à plusieurs directors 
+distincts), vous pouvez associer l'une de ces ressources Console à une ressource 
+Director particulière. Ainsi, lorsque vous choisirez un Director particulier, 
+la configuration de console appropriée sera utilisée. Consultez le paragraphe 
+ci-dessous sur la directive "Director" de la ressource Console pour plus 
+d'informations sur le sujet.
+
+\begin{description}                                                                  <
+\item [Console]                                                                              <
+   \index[console]{Console}
+   Début de la ressource Console.
+
+\item [Name = \lt{}name\gt{}]                                                        <
+   \index[console]{Name}
+   Le nom de console utilisé pour permettre à une console restreinte de 
+   changer d'adresse IP à l'aide de la commande {\bf SetIp}. La commande 
+   SetIp doit aussi être définie dans la liste d'accès {\bf CommandACL} 
+   du fichier de configuration du Director.
+
+\item [Password = \lt{}password\gt{}]                                                <
+   \index[console]{Password}
+   Si ce champ est renseigné, le mot de passe spécifié au niveau de la ressource 
+   Director du fichier de configuration de la console est ignoré. Voyez 
+   ci-dessous pour plus de détails.
+
+\item [Director = \lt{}director-resource-name\gt{}]
+   Si cette directive est spécifiée, cette ressource de Console sera utilisée 
+   par bconsole lorsque ce Director particulier sera sélectionné au 
+   lancement de bconsole. Autrement dit, cette directive lie une console 
+   particulière avec son nom et son mot de passe à un Director particulier. 
+
+\item [Heartbeat Interval = \lt{}time-interval\gt{}]                                 <
+   \index[console]{Heartbeat Interval}                                               <
+   \index[console]{Directive!Heartbeat}
+   Cette directive est orpionnelle. Si elle est utilisée, elle fixe un délai 
+   {\it keepalive} -- ou {\it heartbeat} -- en secondes sur chacun des 
+   {\it sockets} pour communiquer avec le Director. Cette fonctionnalité 
+   n'est implémentée que sur les systèmes qui fournissent la fonction 
+    {\bf setsockopt} TCP\_KEEPIDLE (Par exemple Linux). La valeur par 
+   défaut est 0, ce qui signifie que le {\it socket} n'est pas modifié. 
+
+\end{description}                                                                    <
+               
+L'exemple ci-dessous nous a \'et\'e fournit par Phil Stracchino. Si nous 
+d\'efinissons ce qui suit dans le fichier bconsole.conf (ou bwx-console.conf) 
+d'un utilisateur :
 
 \footnotesize
 \begin{verbatim}
@@ -190,19 +229,19 @@ perhaps the wx-console.conf file):
    DIRport = 9101
    Address = myserver
    Password = "XXXXXXXXXXX"    # no, really.  this is not obfuscation.
- }
+}
  
  Console {
    Name = restricted-user
    Password = "UntrustedUser"
- }
+}
 \end{verbatim}
 \normalsize
 
-Where the Password in the Director section is deliberately incorrect, and the
-Console resource is given a name, in this case {\bf restricted-client}. Then
-in the Director's bacula-dir.conf file (not directly accessible by the user),
-we define: 
+O\`u le mot de passe dans la section Director est d\'elib\'er\'ement incorrect, et 
+la console a re{\c c}u le nom {\bf restricted-client}. Si d'autre part, dans le 
+fichier de configuration du Director (inaccessible diectement \`a l'utilisateur), 
+nous d\'efinissons :
 
 \footnotesize
 \begin{verbatim}
@@ -221,30 +260,82 @@ Console {
 \end{verbatim}
 \normalsize
 
-the user logging into the Director from his Console will get logged in as {\bf
-restricted-client}, and he will only be able to see or access a Job with the
-name {\bf Restricted Client Save} a Client with the name {\bf
-restricted-client}, a Storage device {\bf main-storage}, any Schedule or Pool,
-a FileSet named {\bf Restricted Client's File}, a Catalog named {\bf
-DefaultCatalog}, and the only command he can use in the Console is the {\bf
-run} command. In other words, this user is rather limited in what he can see
-and do with Bacula. 
+Alors, l'utilisateur de connectant au Director depuis cette console sera 
+connect\'e en tant que {\bf restricted-client}, et il ne sera en mesure 
+que de voir ou acc\'eder au job nomm\'e {\bf Restricted Client Save}, avec 
+le stockage {\bf main-storage}, n'importe quel planification ou pool, un 
+FileSet nomm\'e {\bf Restricted Client's File}, un catalogue nomm\'e 
+{\bf DefaultCatalog}, et la seule commande qu'il pourra utiliser dans la console 
+sera la commande {\bf run}. En d'autres termes, cet utilisateur est plut\^ot limit\'e 
+dans ce qu'il peut voir ou faire avec Bacula.
 
-\subsection*{Console Commands}
-\index[general]{Console Commands }
-\index[general]{Commands!Console }
-\addcontentsline{toc}{subsection}{Console Commands}
+Voici un exemple d'un fichier de configuration de bconsole qui permet 
+à plusieurs Directors avec différentes Consoles selon le Director :
 
-For more details on running the console and its commands, please see the 
-\ilink{Bacula Console}{_ChapterStart23} chapter of this manual. 
+\footnotesize
+\begin{verbatim}
+Director {
+   Name = MyDirector
+   DIRport = 9101
+   Address = myserver
+   Password = "XXXXXXXXXXX"    # no, really.  this is not obfuscation.
+}
 
-\subsection*{Sample Console Configuration File}
+Director {
+   Name = SecondDirector
+   DIRport = 9101
+   Address = secondserver
+   Password = "XXXXXXXXXXX"    # no, really.  this is not obfuscation.
+}
+
+Console {
+   Name = restricted-user
+   Password = "UntrustedUser"
+   Director = MyDirector
+}
+
+Console {
+   Name = restricted-user
+   Password = "A different UntrustedUser"
+   Director = SecondDirector
+}
+\end{verbatim}
+\normalsize
+
+Le second Director, référencé en tant que "secondserver" 
+pourrait ressembler à ceci :
+
+\footnotesize
+\begin{verbatim}
+Console {
+  Name = restricted-user
+  Password = "A different UntrustedUser"
+  JobACL = "Restricted Client Save"
+  ClientACL = restricted-client
+  StorageACL = second-storage
+  ScheduleACL = *all*
+  PoolACL = *all*
+  FileSetACL = "Restricted Client's FileSet"
+  CatalogACL = RestrictedCatalog
+  CommandACL = run, restore
+  WhereACL = "/"
+}
+\end{verbatim}
+\normalsize
+
+\section{Commandes de la Console}
+\index[general]{Commandes Console}
+\index[general]{Commandes!Console}
+
+Pour plus de d\'etails concernant la console et ses commandes, consultez le 
+chapitre \ilink{La console Bacula}{_ConsoleChapter} de ce manuel.
+\section{Un exemple de fichier de configuration de console}
 \label{SampleConfiguration2}
-\index[general]{File!Sample Console Configuration }
-\index[general]{Sample Console Configuration File }
-\addcontentsline{toc}{subsection}{Sample Console Configuration File}
+\index[general]{Fichier!exemple Console Configuration}
+\index[general]{Exemple Console Configuration Fichier}
 
-A example Console configuration file might be the following: 
+Voici un exemple de fichier de configuration de console :
 
 \footnotesize
 \begin{verbatim}