toute cartouche de code barres CLNxxxx sera trait\'ee en tant que cartouche de
nettoyage, et ne sera pas mont\'ee.
+\subsection*{Changer des cartouches}
+\index[general]{Changer des cartouches}
+\addcontentsonline{toc}{subsection}{Changer des cartouches}
+Si vous voulez insérer ou retirer des cartouches de votre librairie, ou encore
+exécuter manuellement le programme {\bf mtx}, vous devez "informer" Bacula de ces opérations :
+
+\footnotesize
+\begin{verbatim}
+unmount
+(changez vos cartouches et/ou exécutez mtx)
+mount
+\end{verbatim}
+\normalsize
+
+Si vous omettez de faire "unmount" avant de telles changements, Bacula ne saura plus
+ce qui est dans la librairie, et ce qui n'y est pas, et peut même cesser de fonctionner
+parce qu'il s'attend à avoir le contrôle exclusif de la librairie tandis quie le lecteur
+est monté.
+
Notez que les volumes doivent \^etre pr\'e-\'etiquet\'es pour pouvoir \^etre utilis\'es
automatiquement dans la librairie lors d'une sauvegarde. Si vous ne disposez
pas d'un lecteur de code barres, ceci se fait manuellement, ou \`a l'aide d'un
\index[console]{Console!Utiliser la}
\addcontentsline{toc}{subsection}{Utiliser la Console}
+Le programme Console admet les options suivantes :
+\footnotesize
+\begin{verbatim}
+Usage: bconsole [-s] [-c config_file] [-d debug_level]
+ -c <file> set configuration file to file
+ -dnn set debug level to nn
+ -n no conio
+ -s no signals
+ -t test - read configuration and exit
+ -? print this message.
+\end{verbatim}
+\normalsize
+
Apr\`es son d\'emarrage, la Console est en attente de vos commandes, ce qui
est indiqu\'e par une ast\'erisque (*) (ce n'est pas le cas dans la version
GNOME o\`u vous saisissez vos commandes dans la boite texte en bas de l'\'ecran).
\item [current]
Utilis\'e dans la commande {\it restore}. Ne prend pas d'arguments.
\item [days]
+ Utilisé pour définir le nombre de jours que la commande "list nextvol" doit
+ prendre en compte dans son évaluation des prochains jobs à exécuter.
+ Le mot-clef "day" peut aussi être utilisé avec la commande "status dir"
+ afin qu'elle affiche les jobs planifiés pour la période spécifiés.
\item [devices]
Utilis\'e dans la commande {\it show}. Ne prend pas d'arguments.
\item [dir | director]
\item [directors]
Utilis\'e dans la commande {\it show}. Ne prend pas d'arguments.
\item [directory]
- Utilis\'e dans la commande {\it restore}.
+ Utilis\'e dans la commande {\it restore}. Son argument spécifie
+ le répertoire à restaurer.
+\item [enabled]
+ Ce mot-clef peut être utilisé avec la commande {\bf update volume} et admet
+ l'un des arguments suivants : yes, true, no, false, archived, 0, 1, 2, où
+ 0 correspond à "no" ou "false", 1 à "yes" ou "true" et 2 à "archived". Les volumes
+ avec le statut "archived" ne seront pas utilisés, pas plus que ne seront élagués leurs
+ enregistrements dans le catalogue. Les volumes qui n'ont pas le statut "enabled"
+ ne seront pas utilisés pour des sauvegardes ou des restaurations.
\item [done]
Utilis\'e dans la commande {\it restore}. Ne prend pas d'arguments.
\item [file]
Voici la forme compl\`ete de cette commande :
+\begin{verbatim}
delete pool=\lt{}pool-name\gt{}
-
+\end{verbatim}
+
supprime un pool du catalogue.
+\begin{verbatim}
delete volume=\lt{}volume-name\gt{} pool=\lt{}pool-name\gt{}
+\end{verbatim}
supprime du catalogue un volume du pool sp\'ecifi\'e.
+\begin{verbatim}
delete JobId=\lt{}job-id\gt{} JobId=\lt{}job-id2\gt{} ...
+\end{verbatim}
supprime du catalogue le job sp\'ecifi\'e.
+\begin{verbatim}
delete Job JobId=n,m,o-r,t ...
-
+\end{verbatim}
+
supprime les job de JobIds m,n,o,p,q,r et t (o\`u m,n,... sont, bien sur, des
nombres). Ainsi, la commande "delete jobid" accepte les listes et les plages
de jobids.
peut prendre un certain temps s'il s'agit d'une grosse sauvegarde.
Voici la forme compl\`ete de cette commande :
-
-estimate job=\lt{}job-name\gt{} listing client=\lt{}client-name\gt{}
-fileset=\lt{}fileset-name\gt{} level=\lt{}level-name\gt{}
+\begin{verbatim}
+estimate job=\lt{}job-name\gt{} listing client=\lt{}client-name\gt{}
+ fileset=\lt{}fileset-name\gt{} level=\lt{}level-name\gt{}
+\end{verbatim}
La sp\'ecification du {\bf job} est suffisante, mais vous pouvez aussi
passer outre le client, le FileSet et/ou le niveau en les
ce qui produirait une liste compl\`ete de tous les fichiers \`a sauvegarder pour
le job {\bf NightlySave} au cours d'une sauvegarde incr\'ementale, et qui
-consignerait cette liste dans le fichier {\bf /tmp/listing}.
+consignerait cette liste dans le fichier {\bf /tmp/listing}. Notez que l'évaluation
+produite par cette commande se base sur les tailles de fichiers contenues dans
+l'objet "répertoire", aussi l'estimation peut être très éloignée de la réalité si vous
+avez des fichiers creux (NDT : sparse files) sur votre système. Ce type de fichiers se
+rencontre souvent sur les systèmes 64 bits avec certains systèmes de fichiers.
+Le volume obtenu par l'évaluation est celui que sauvegardera Bacula si l'option
+sparse est désactivée. Il n'y a actuellement aucun moyen d'évaluer le volume de
+ce qui serait sauvegardé avec l'option sparse activée.
\item [help]
\index[console]{help}
\index[general]{relabel}
Cette commande est utilis\'ee pour \'etiqueter les volumes. La forme compl\`ete est :
-label storage=\lt{}storage-name\gt{} volume=\lt{}volume-name\gt{}
-slot=\lt{}slot\gt{}
+\begin{verbatim}
+ label storage=\lt{}storage-name\gt{} volume=\lt{}volume-name\gt{}
+ slot=\lt{}slot\gt{}
+\end{verbatim}
Si vous omettez l'un quelconque des arguments, il vous sera r\'eclam\'e.
Le type de m\'edia est automatiquement r\'ecup\'er\'e de la ressource Storage.
\begin{verbatim}
update volume=xxx pool=yyy slots volstatus=xxx VolRetention=ddd
VolUse=ddd MaxVolJobs=nnn MaxVolBytes=nnn Recycle=yes|no
- slot=nnn
+ slot=nnn enabled=n
\end{verbatim}
\normalsize
aucun job en ex\'ecution. Cette commande est utile dans des situation
d'utilisation automatis\'ee par scripts telles que les tests de r\'egression
o\`u vous voulez d\'emarrer un job, et attendre qu'il se termine avant de
- poursuivre.
+ poursuivre. Cette commande admet les options suivantes :
+
+\footnotesize
+\begin{verbatim}
+ wait [jobid=nn] [jobuid=unique id] [job=job name]
+\end{verbatim}
+\normalsize
\end{description}
\item [Director]
\index[console]{Director}
- D\'ebut des enregistrements du Director.
+ D\'ebut des directives relatives au Director.
\item [Name = \lt{}name\gt{}]
\index[console]{Name}
\item [ConsoleFont]
\index[console]{ConsoleFont}
- D\'ebut de la ressource ConsoleFont.
+ D\'ebut des directives ConsoleFont.
\item [Name = \lt{}name\gt{}]
\index[console]{Name}
\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
}
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.
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 :
+ Vous disposez des options suivantes : \\
\begin{tabular}{|c|c|c|l}
Options & Valeur & Defaut & Informations \\
Avant de soumettre la commande sp\'ecifi\'ee au syst\`eme d'exploitation, Bacula
effectue les substitutions suivantes :
+\label{character substitution}
+
\footnotesize
\begin{verbatim}
%% = %
Aussi, si vous l'utilisez dans une ligne de commande, il vous faudra l'encadrer
de quotes.
-Vous disposez des raccourcis suivants :
+Vous disposez des raccourcis suivants :\\
\begin{tabular}{|c|c|c|c|c|c}
Mot clef & RunsOnSuccess & RunsOnFailure & AbortJobOnError & Runs On Client & RunsWhen \\
\hline
\item [Address = \lt{}address\gt{}]
\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.
\begin{verbatim}
Client {
Name = Minimatou
- Address = minimatou
+ FDAddress = minimatou
Catalog = MySQL
Password = very_good
}
\item [Address = \lt{}address\gt{}]
\index[dir]{Address}
- \index[dir]{Directive!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
\footnotesize
\begin{verbatim}
- FDAddresses = { ip = {
- addr = 1.2.3.4; port = 1205; }
+ FDAddresses = {
+ 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 = 1.2.3.4 }
ip = {
addr = 201:220:222::2
}
+img8.png\ 1./bimagemgr1.eps
+img15.png\ 1./win32-service.eps
+img9.png\ 1./bimagemgr2.eps
+img20.png\ 1./tray-icon.eps
+img6.png\ 1./Conf-Diagram.eps
img23.png\ 1./error.eps
img3.png\ 1./bacula-objects.eps
+img22.png\ 1./running.eps
+img25.png\ 1./view-only.eps
img12.png\ 1./win32-welcome.eps
-img2.png\ 1./bacula-applications.eps
-img11.png\ 1./win32-nsis.eps
-img8.png\ 1./bimagemgr1.eps
img21.png\ 1./menu.eps
-img13.png\ 1./win32-pkg.eps
-img17.png\ 1./win32-start.eps
-img28.png\ 1./confirm.eps
-img6.png\ 1./Conf-Diagram.eps
+img2.png\ 1./bacula-applications.eps
+img26.png\ 1./properties-security.eps
+img1.png\ 1./bacula-logo.eps
+img24.png\ 1./access-is-denied.eps
img27.png\ 1./properties-security-advanced-owner.eps
-img9.png\ 1./bimagemgr2.eps
-img22.png\ 1./running.eps
img5.png\ 1./Bacula-tray-monitor.eps
-img15.png\ 1./win32-service.eps
+img14.png\ 1./win32-location.eps
+img11.png\ 1./win32-nsis.eps
img4.png\ 1./flow.eps
-img16.png\ 1./win32-service-ok.eps
-img25.png\ 1./view-only.eps
img19.png\ 1./idle.eps
-img18.png\ 1./win32-finish.eps
-img24.png\ 1./access-is-denied.eps
-img1.png\ 1./bacula-logo.eps
-img20.png\ 1./tray-icon.eps
+img16.png\ 1./win32-service-ok.eps
+img17.png\ 1./win32-start.eps
img10.png\ 1./bimagemgr3.eps
-img14.png\ 1./win32-location.eps
-img26.png\ 1./properties-security.eps
+img13.png\ 1./win32-pkg.eps
+img18.png\ 1./win32-finish.eps
+img28.png\ 1./confirm.eps
\item [winbacula-1.38.0.exe]
Ce fichier est l'installeur 32 bits Windows pour l'installation du
client Windows (File Daemon) sur une machine Windows.
+ A partir de la version 1.39.20, cet exécutable contiendra aussi
+ le Director Win32 et le Storage Daemon Win32.
\end{description}
\label{upgrading1}
Si vous faites une mise \`a jour de Bacula, vous devriez d'abord lire
attentivement les ReleaseNotes de toutes les versions entre votre version
install\'ee et celle vers laquelle vous souhaitez mettre \`a jour. Si la base
-de donn\'ees du catalogue a \'et\'e mise \`a jour, vous devrez soit
+de donn\'ees du catalogue a \'et\'e mise \`a jour (c'est presque toujours le cas
+à chaque nouvelle version majeure), vous devrez soit
r\'einitialiser votre base de donn\'ees et repartir de z\'ero, soit en
sauvegarder une copie au format ASCII avant de proc\'eder \`a sa mise \`a
jour. Ceci est normalement fait lorsque Bacula est compil\'e et install\'e par :
make install
\end{verbatim}
- En principe, aucun de vos fichiers .conf ou .sql ne devrait \^etre \'ecras\'e.
-
+ En principe, aucun de vos fichiers .conf ou .sql ne devrait \^etre \'ecras\'e,
+ et vous devez exécuter les deux commandes {\bf make} et {\bf make install}.
+ {\bf make install} sans un {\bf make} préalable ne fonctionnera pas.
+
Pour plus d'informations sur les mises \`a jour, veuillez consulter la partie
\ilink{Upgrading Bacula Versions}{upgrading} du chapitre Astuces de ce manuel
La composition exacte des paquetages de d\'ependance est susceptible de
changer de temps en temps, voici sa composition actuelle :
-\begin{longtable}{|l|l|l|l|}
+\begin{longtable}{|l|l|l|}
\hline
\multicolumn{1}{|c| }{\bf Paquets externes } & \multicolumn{1}{c| }{\bf depkgs
-} & \multicolumn{1}{c| }{\bf depkgs1 } & \multicolumn{1}{c| }{\bf depkgs-win32
- } \\
+} & \multicolumn{1}{c| }{\bf depkgs1 } \\
\hline
-{SQLite } & \multicolumn{1}{c| }{X } & \multicolumn{1}{c| }{- } &
-\multicolumn{1}{c| }{- } \\
+{SQLite } & \multicolumn{1}{c| }{X } & \multicolumn{1}{c| }{- } \\
\hline
-{mtx } & \multicolumn{1}{c| }{X } & \multicolumn{1}{c| }{- } &
-\multicolumn{1}{c| }{- } \\
+{SQLite3 } & \multicolumn{1}{c| }{X } & \multicolumn{1}{c| }{- } \\
+ \hline
+{mtx } & \multicolumn{1}{c| }{X } & \multicolumn{1}{c| }{- } \\
\hline
-{readline } & \multicolumn{1}{c| }{- } & \multicolumn{1}{c| }{X } &
-\multicolumn{1}{c| }{- } \\
+{readline } & \multicolumn{1}{c| }{- } & \multicolumn{1}{c| }{X } \\
\hline
-{pthreads } & \multicolumn{1}{c| }{- } & \multicolumn{1}{c| }{- } &
-\multicolumn{1}{c| }{X } \\
+{pthreads } & \multicolumn{1}{c| }{- } & \multicolumn{1}{c| }{- } \\
\hline
-{zlib } & \multicolumn{1}{c| }{- } & \multicolumn{1}{c| }{- } &
-\multicolumn{1}{c| }{X } \\
+{zlib } & \multicolumn{1}{c| }{- } & \multicolumn{1}{c| }{- } \\
\hline
-{wxWidgets } & \multicolumn{1}{c| }{- } & \multicolumn{1}{c| }{- } &
-\multicolumn{1}{c| }{X }
-\\ \hline
+{wxWidgets } & \multicolumn{1}{c| }{- } & \multicolumn{1}{c| }{- } \\
+\hline
\end{longtable}
vient avec peut souvent vous fournir de pr\'ecieuses informations sur vos
lecteurs de bandes SCSI (e.g. compression, taille min/max des blocks,...).
-Le paquet {\bf depkgs-win32} contient le code source pour les librairies
-pthreads et zlib utilis\'ees par le client Win32 natif. Vous n'en aurez besoin
-que si vous pr\'evoyez de construire le client Win32 depuis les sources.
+Le paquet {\bf depkgs-win32} est obsolète à partir de la version 1.39 de Bacula.
+Il était autrefois utilisé pour compiler le client natif Win32 qui est
+désormais construit sur Linux grâce à un mécanisme de compilation croisée.
+Tous les outils et librairies tierces sont automatiquement téléchargées
+par l'exécution de scripts apropriés. Lisez le fichier src/win32/README.mingw32
+pour plus de détails.
\subsection*{Syst\`emes Support\'es}
\label{Systems}
\begin{enumerate}
\item Installez et construisez chaque {\bf depkgs} comme indiqu\'e plus haut.
+
\item Configurez et installez MySQL ou PostgreSQL (si vous le souhaitez):
\ilink{Installer et configurer MySQL Phase I}{_ChapterStart} ou
\ilink{Installer et configurer PostgreSQL Phase
pour vous assurer que tous les modules que vous souhaitez soient construits et
que tout soit plac\'e dans les bons r\'epertoires.
-Par exemple, sur RedHat, on pourrait utiliser ceci:
+Par exemple, sur Fedora, RedHat ou SuSE, on pourrait utiliser ceci:
\footnotesize
\begin{verbatim}
--sysconfdir=$HOME/bacula/bin \
--with-pid-dir=$HOME/bacula/bin/working \
--with-subsys-dir=$HOME/bacula/bin/working \
- --with-mysql=$HOME/mysql \
+ --with-mysql \
--with-working-dir=$HOME/bacula/bin/working \
--with-dump-email=$USER
\end{verbatim}
\footnotesize
\begin{verbatim}
LDFLAGS="-lssl -lcyrpto" \
- ./configure \
- <vos-options>
+ ./configure <vos-options>
\end{verbatim}
\normalsize
{-}{-}with-mysql, ou {-}{-}with-postgresql, faute de quoi ./configure \'echouera.
\item [ {-}{-}with-openssl=\lt{}path\gt{}]
- Cette option est requise si vous souhaitez activer TLS (ssl) dans Bacula. Normalement,
- la sp\'ecification du chemin {\bf path} n'est pas n\'ecessaire car le processus de
+ Cette option est requise si vous souhaitez activer TLS (ssl) qui chiffre les
+ communications entre les daemons Bacula ou si vous voulez utiliser le chiffrement
+ PKI des données du File Daemon.Normalement, la sp\'ecification du chemin {\bf path}
+ n'est pas n\'ecessaire car le processus de
configuration recherche les librairies OpenSSL dans les emplacements standard du
syst\`eme. L'activation d'OpenSSL dans Bacula permet des communications s\'ecuris\'ees
entre les {\it daemons}. Pour plus d'informations sur l'usage de TLS, consultez le
- chapitre \ilink{Bacula TLS}{_ChapterStart61} de ce manuel.
-
+ chapitre \ilink{Bacula TLS}{_ChapterStart61} de ce manuel. Pour plus d'informations
+ sur l'usage du chiffrement des données PKI, veuillez consulter le chapitre
+ \ilink{Bacula PKI -- Data Encryption}{Chiffrement des données} de ce manuel.
\item [ {-}{-}with-python=\lt{}path\gt{}]
\index[general]{{-}{-}with-python }
projects / bacula / docs / commitdiff