Translate tutorial into Spanish

[bacula/docs] / docs / manuals / es / concepts / tutorial.tex

%%
%%

\chapter{Tutorial resumido} 
\label{TutorialChapter}
\index[general]{Tutorial Resumido} 
\index[general]{Tutorial!Resumido } 

Este capítulo lo guiará en el proceso de ejecución de Bacula. Para esto, hemos asumido
que usted ya instaló Bacula, posiblemente en un simple archivo tal como se mostró
en el capítulo anterior, en cuyo caso, se puede correr Bacula con un usuario no root
para estas pruebas. De igual manera, asumimos que usted no ha cambiado los archivos
.conf. Si usted ha modificado estos archivo, por favor desinstale Bacula, y reinstalelo,
y no haga ningún cambio en la configuración Los ejemplos de este capítulo utilizan
los archivos de configuración creados por defecto, y escribirán los volúmenes a disco
en el directorio /tmp, de igual manera, la data almacenada en las operaciones de
respaldo está representada por el directorio de fuentes, en el cual se configuró
y compiló Bacula. Como consecuencia de esto, para estas pruebas se pueden correr
todos los demonios de Bacula como usuario no root. Por favor, tenga en cuenta que
en ambientes de producción, los demonios de clientes (file daemon(s)) deben correr
como root. Vea el capítulo de Seguridad para mayor información acerca de este tópico.

El flujo general de ejecución de Bacula es el siguiente:
\begin{enumerate}
\item cd \lt{}directorio-instalación\gt{} 
\item Arrancar los servicios de base de datos (si esta utilizando MySQL o PostgreSQL). 
\item Iniciar los demonios con el comando ./bacula start.
\item Iniciar el programa de consola, para interactuar con el Director. 
\item Correr un job. 
\item Cuando el volumen este full, desmonte el volumen, si este es una cinta (tape), etiquete
uno nuevo, y continúe con la corrida. En este capítulo, únicamente escribiremos a
archivos en disco, por lo tanto, no necesitará preocuparse por las cintas en este
momento. 
\item Pruebe recuperar algunos archivos desde el volumen escrito, y asegúrese que el backup
sea consistente y que contenga la información requerida. Es mejor realizar varias
pruebas, antes de una falla verdadera. 
\item Agregar un segundo cliente.
\end{enumerate}

Cada uno de estos pasos, se describe con mas detalle a continuación.


\section{Antes de correr Bacula}
\index[general]{Antes de !correr Bacula }
\index[general]{Antes de correr Bacula }

Antes de ejecutar Bacula por primera vez en producción, recomendamos correr el comando
\textbf{test} en el programa \textbf{btape}, tal como se describe en el capítulo
de \ilink{Programas Utilitarios}{btape}de este manual. Esto permitirá determinar
si Bacula funciona correctamente con su unidad de cinta. Si usted cuenta con una
unidad moderna de cinta HP, Sony o Quantum, bien sea DDS, DLT o LTO, corriendo en
Linux o Solaris, probablemente pueda pasar estas pruebas, puesto que Bacula ha sido
probado con estos drives y sistemas. Para todos los demás casos, se recomienda \textbf{encarecidamente}
correr el test antes de continuar. \textbf{btape }también tiene el comando \textbf{fill},
que intenta duplicar las acciones que Bacula realiza cuando se llena un tape, y se
necesita escribir en otra cinta. Usted debería considerar probar este comando también,
pero sea precavido puesto que esto puede tomar horas, para llenar un tape a su máxima
capacidad.


\section{Arrancando la Base de Datos}
\label{StartDB} 
\index[general]{Arrancando la base de datos } 
\index[general]{Arrancando!la base de datos } 

Si está utilizando MySQL o PostgreSQL, como la base de datos para Bacula, debería
arrancarla antes de intentar correr un job, para evitar mensajes de error, cuando
este se inicie. Los scripts \textbf{startmysql} y \textbf{stopmysql}, son los que
utiliza (Kern), para iniciar y detener MySQL en forma local. Note, que si está utilizando
SQLite, no se necesita utilizar \textbf{startmysql }o \textbf{stopmysql}. Si está
en un ambiente de producción, probablemente necesitará configurar alguna manera para
arrancar MySQL o PostgreSQL, de manera automática, después de cada reinicio del sistema.

Si está utilizando SQLite (es decir, si usted indico la opción \textbf{--with-sqlite=xxx}
en el comando \textbf{./configure}), no necesita hacer nada. SQLite es iniciado de
manera automática por \textbf{Bacula}.


\section{\noindent Iniciando los demonios}
\label{InicioDemonios} 
\index[general]{Iniciando los demonios } 
\index[general]{Inicio!de los demonios } 

Asumiendo que usted instaló y configuró desde los fuentes o ha instalado desde los
archivos rpms, para iniciar los tres demonios, desde el directorio de instalación,
simplemente ingrese:

./bacula start

El script \textbf{bacula }inicia los demonios de Storage, File y Director, los cuales,
generalmente, corren en background. Si usted está utilizando la funcionalidad de
autostart de Bacula, los demonios serán iniciados automáticamente en cada reinicio,
o puede controlarlos de manera individual, con los archivos \textbf{bacula-dir},
\textbf{bacula-fd }y \textbf{bacula-sd}, que están ubicados generalmente en el directorio
/etc/init.d, aunque las ubicaciones actuales dependen del sistema operativo utilizado.
Algunas distribuciones pueden manejar esto de manera diferente.

Observe que en Windows, actualmente, el demonio File (File daemon), está probado,
y el mismo debe ser iniciado en forma diferente. Por favor, revise el capítulo de
Versión Windows de Bacula, de este manual.

Los paquetes rpm configuran los demonios para correr como usuario=root y grupo=bacula.
La instalación del rpm, también crea el grupo bacula, si no existe en el sistema.
Los usuarios que se agregan al grupo bacula tendrán acceso a los archivos creados
por los demonios. Para deshabilitar o modificar este comportamiento, edite los scripts
para arranque de los demonios:

\begin{itemize}
\item /etc/bacula/bacula 
\item /etc/init.d/bacula-dir 
\item /etc/init.d/bacula-sd 
\item /etc/init.d/bacula-fd
\end{itemize}

y luego debe reiniciarlos, como se indico anteriormente.

El \ilink{capítulo de Instalación}{CapituloInstalacion}de este manual, explica como
se pueden instalar los scripts que automáticamente reiniciarán los demonios cuando
el sistema arranca.


\section{Usando el programa de consola}
\index[general]{Utilizando!el Programa de Consola} 
\index[general]{Utilizando el Programa de Consola

Para comunicarse con el director y consultar el estado de Bacula o correr los jobs,
desde el directorio superior de los binarios, simplemente ingrese:

./bconsole

Alternativamente, si esta en la consola de linea de comandos, y si tiene Qt4 instalado
y utilizo la opción \textbf{\textendash{}enable-bat} en el comando configure, usted
podría usar la herramienta de administración de bacula (Bacula Administration Tool)
\textbf{(bat)}:

./bat

El cual brinda una interfaz gráfica, y muchas funcionalidades adicionales a bconsole.

Otras dos opciones consiste en: correr la consola de GNOME \textbf{bgnome-console
}o el programa wxWidgets \textbf{bwx-console.}

Por simplicidad, aquí se describe únicamente el programa \textbf{./bconsole.} La
mayoría de lo descrito también aplica para \textbf{./bat}, \textbf{./bgnome-console}
y \textbf{./bwx-console}.

El comando \textbf{./bconsole} corre el programa de consola de Bacula, el cual se
conecta con el demonio del Director. Dado que Bacula es un programa de red, este
se puede correr desde cualquier equipo en la red. Sin embargo, por lo general, uno
se ejecuta en la misma maquina del Director. Normalmente, el programa de consola
mostrará una salida similar a lo siguiente:

\footnotesize
\begin{verbatim}
[kern@polymatou bin]$./bconsole
Connecting to Director lpmatou:9101
1000 OK: HeadMan Version: 2.1.8 (14 May 2007)
*
\end{verbatim}
\normalsize

El símbolo asterisco ('{*}'), es el prompt de la consola de comandos.

Cuando se tipea \textbf{help}, se despliega una lista de comandos disponibles:

\footnotesize
\begin{verbatim}
*help
  Command    Description
  =======    ===========
  add        add media to a pool
  autodisplay autodisplay [on|off] -- console messages
  automount  automount [on|off] -- after label
  cancel     cancel [<jobid=nnn> | <job=name>] -- cancel a job
  create     create DB Pool from resource
  delete     delete [pool=<pool-name> | media volume=<volume-name>]
  disable    disable <job=name> -- disable a job
  enable     enable <job=name> -- enable a job
  estimate   performs FileSet estimate, listing gives full listing
  exit       exit = quit
  gui        gui [on|off] -- non-interactive gui mode
  help       print this command
  list       list [pools | jobs | jobtotals | media <pool=pool-name> |
files <jobid=nn>]; from catalog
  label      label a tape
  llist      full or long list like list command
  memory     print current memory usage
  messages   messages
  mount      mount <storage-name>
  prune      prune expired records from catalog
  purge      purge records from catalog
  python     python control commands
  quit       quit
  query      query catalog
  restore    restore files
  relabel    relabel a tape
  release    release <storage-name>
  reload     reload conf file
  run        run <job-name>
  status     status [[slots] storage | dir | client]=<name>
  setdebug   sets debug level
  setip      sets new client address -- if authorized
  show       show (resource records) [jobs | pools | ... | all]
  sqlquery   use SQL to query catalog
  time       print current time
  trace      turn on/off trace to file
  unmount    unmount <storage-name>
  umount     umount <storage-name> for old-time Unix guys
  update     update Volume, Pool or slots
  use        use catalog xxx
  var        does variable expansion
  version    print Director version
  wait       wait until no jobs are running [<jobname=name> | <jobid=nnn> | <ujobid=complete_name>]
*
\end{verbatim}
\normalsize

Los detalles de los programas de la consola, se explican en el \ilink{Capitulo Consola}{_Capítulo de Consola}
de este manual.

\section{Corriendo un job}
\label{Corriendo} 
\index[general]{Corriendo un!Job } 
\index[general]{Corriendo un Job } 

En este punto, asumimos que usted ha hecho lo siguiente:
\begin{itemize}
\item Configuró Bacula con \textbf{./configure }\textendash{}sus-opciones. 
\item Compiló Bacula utilizando el comando\textbf{ make}. 
\item Instaló Bacula utilizando \textbf{make install. }
\item Ha creado su base de datos corriendo \textbf{./create\_sqlite\_database}, por ejemplo. 
\item Ha creado las tablas de la base de datos de Bacula con \textbf{./make\_bacula\_tables}. 
\item Probablemente, editó su archivo de configuración \textbf{bacula-dir.conf}, para personalizarlo.
Hay que ser CUIDADOSO! Si usted cambia el nombre del Director o el password, necesitará
hacer los mismos cambios en los otros archivos de configuración (.conf). Para este
momento, puede ser conveniente, no hacer cambios. 
\item Inició Bacula, con el comando \textbf{./bacula start.} 
\item Usted invocó el programa de Consola, ejecutando .\textbf{/bconsole.}
\end{itemize}

Adicionalmente, estamos asumiendo que usted está utilizando los archivos de configuración
por defecto.

\footnotesize
\begin{verbatim}
show filesets
\end{verbatim}
\normalsize

Y se mostraría algo similar a lo siguiente:

\footnotesize
\begin{verbatim}
FileSet: name=Full Set
      O M
      N
      I /home/kern/bacula/regress/build
      N
      E /proc
      E /tmp
      E /.journal
      E /.fsck
      N
FileSet: name=Catalog
      O M
      N
      I /home/kern/bacula/regress/working/bacula.sql
      N
\end{verbatim}
\normalsize

Este es un \textbf{FileSet }predefinido, que le hará backup al directorio de fuentes
de Bacula. Los nombres actuales de directorios se corresponden con la configuración
de su sistema. Para propósitos de prueba, se ha seleccionado un directorio de tamaño
moderado (cerca de 40 Megabytes) y de complejidad relativamente sencilla. El FileSet
\textbf{Catalog} se utiliza para hacer respaldo del catálogo de Bacula, y no es de
mucho interés en este momento. Las entradas \textbf{\textquotedblleft{}I\textquotedblright{}},
son los archivos o directorios que serán incluidos en el respaldo y las entradas
\textbf{\textquotedblleft{}E\textquotedblright{}}, son aquellas que estarán excluidas.
Las entradas \textbf{\textquotedblleft{}O\textquotedblright{}}, son las opciones
especificas para el FileSet. Se puede cambiar a los objetos a los cuales se les hace
backup, editando el archivo de configuración \textbf{bacula-dir.conf}, y se modifica
la linea \textbf{File=}, en el recurso \textbf{FileSet}.

Ahora es tiempo de correr su primer respaldo. Se hará un backup del directorio de
fuentes de Bacula a un volumen de archivo, ubicado en el directorio \textbf{/tmp},
para mostrarle lo fácil que es esto. Ahora tipee:

\footnotesize
\begin{verbatim}
status dir
\end{verbatim}
\normalsize

Y debería obtener la siguiente salida:

\footnotesize
\begin{verbatim}
rufus-dir Version: 1.30 (28 April 2003)
Daemon started 28-Apr-2003 14:03, 0 Jobs run.
Console connected at 28-Apr-2003 14:03
No jobs are running.
Level          Type     Scheduled          Name
=================================================================
Incremental    Backup   29-Apr-2003 01:05  Client1
Full           Backup   29-Apr-2003 01:10  BackupCatalog
====
\end{verbatim}
\normalsize

Donde los tiempos y los nombres para el Director serán diferentes, de acuerdo a su
configuración Por ejemplo, este indica que un job Incremental está planificado para
correr a la 1:05am para el cliente \textbf{Client1}, y a la 1:10, esta planificada
la ejecución del job para \textbf{BackupCatalog}. Note, que usted probablemente cambiara
el nombre de \textbf{Client1 }al nombre de su equipo, si no lo hace, cuando se adicionen
nuevos clientes, esto puede generar confusiones. Para esta prueba, se utilizó Rufus
en vez de \textbf{Client1}.

Ahora ingrese:

\footnotesize
\begin{verbatim}
status client
\end{verbatim}
\normalsize

Y se mostrará algo parecido a la siguiente salida:

\footnotesize
\begin{verbatim}
The defined Client resources are:
     1: rufus-fd
Item 1 selected automatically.
Connecting to Client rufus-fd at rufus:8102
rufus-fd Version: 1.30 (28 April 2003)
Daemon started 28-Apr-2003 14:03, 0 Jobs run.
Director connected at: 28-Apr-2003 14:14
No jobs running.
====
\end{verbatim}
\normalsize

En este caso, el cliente se llama \textbf{rufus-fd}, y su nombre puede ser diferente,
pero la línea que comienza con \textbf{rufus-fd Version....}, se muestra para el
demonio de archivo (File daemon), por lo tanto, ahora se puede estar seguro que está
configurado y corriendo.

Finalmente, se puede hacer lo mismo con el demonio de almacenamiento (Storage daemon)
con:

\footnotesize
\begin{verbatim}
status storage
\end{verbatim}
\normalsize

Y debería mostrarse algo como:

The defined Storage resources are: 

\footnotesize
\begin{verbatim}
The defined Storage resources are:
     1: File
Item 1 selected automatically.
Connecting to Storage daemon File at rufus:8103
rufus-sd Version: 1.30 (28 April 2003)
Daemon started 28-Apr-2003 14:03, 0 Jobs run.
Device /tmp is not open.
No jobs running.
====
\end{verbatim}
\normalsize

Usted puede notar que el dispositivo por defecto para el demonio de almacenamiento
se denomina \textbf{file}, y que utilizará el directorio \textbf{/tmp}, el cual no
esta actualmente abierto. 

Ahora, se puede correr un job con:

\footnotesize
\begin{verbatim}
run
\end{verbatim}
\normalsize

Luego de la corrida, la salida que se despliega es la siguiente: 

\footnotesize
\begin{verbatim}
Using default Catalog name=MyCatalog DB=bacula
A job name must be specified.
The defined Job resources are:
     1: Client1
     2: BackupCatalog
     3: RestoreFiles
Select Job resource (1-3):
\end{verbatim}
\normalsize 

En este punto, Bacula lista los tres diferentes Jobs que usted puede correr, y usted
debe seleccionar \textbf{1} y pulsar la tecla Enter, y obtendrá lo siguiente:

\footnotesize
\begin{verbatim}
Run Backup job
JobName:  Client1
FileSet:  Full Set
Level:    Incremental
Client:   rufus-fd
Storage:  File
Pool:     Default
When:     2003-04-28 14:18:57
OK to run? (yes/mod/no):
\end{verbatim}
\normalsize

En este punto, hay que tomarse algo de tiempo para observar cuidadosamente lo que
está impreso y comprender todas las opciones. Se está consultando si esta listo OK
para correr un job denominado \textbf{Client1} con un FileSet \textbf{FullSet }(listado
anteriormente) para un job Incremental en su Cliente (su nombre de cliente puede
ser diferente), utiliza un almacenamiento \textbf{File }y un pool \textbf{Default}.
Finalmente, se pregunta si se desea correrlo en este momento (la hora actual será
desplegada en su consola).

Se puede seleccionar correr \textbf{(yes)}, modificar uno o mas parámetros \textbf{(mod)}
o no correr el job \textbf{(no)}. Por favor, tipear \textbf{yes}, y en este momento
se mostrará el prompt de comandos, de manera inmediata (un asterisco). Si espera
unos pocos segundos, y luego ingresa el comando \textbf{messages}, se mostrará algo
parecido a lo siguiente:

\footnotesize
\begin{verbatim}
28-Apr-2003 14:22 rufus-dir: Last FULL backup time not found. Doing
                  FULL backup.
28-Apr-2003 14:22 rufus-dir: Start Backup JobId 1,
                  Job=Client1.2003-04-28_14.22.33
28-Apr-2003 14:22 rufus-sd: Job Client1.2003-04-28_14.22.33 waiting.
                  Cannot find any appendable volumes.
Please use the "label"  command to create a new Volume for:
    Storage:      FileStorage
    Media type:   File
    Pool:         Default
\end{verbatim}
\normalsize

El primer mensaje, indica que no hay respaldos previos de tipo Full que se hayan
realizado, por lo tanto Bacula se hará upgrade del job Incremental a un respaldo
Full (esto es normal). El segundo mensaje, indica que el job se inició con un JobId
de 1, y el tercer mensaje nos dice que Bacula no puede encontrar ningún volumen en
el Pool para escribir la salida (el respaldo). Esto es normal, puesto que todavía
no se ha creado (etiquetado) ningún volumen. Bacula nos muestra todos los detalles
que el volumen necesita.

En este punto, el job esta BLOQUEADO (BLOCKED) esperando por un volumen. Si desea
puede chequearlo, ejecutando el comando \textbf{status dir}. Para poder continuar,
se debe crear un volumen que Bacula pueda escribir. Esto se puede hacer con:

\footnotesize
\begin{verbatim}
label
\end{verbatim}
\normalsize

Y Bacula mostrará:

\footnotesize
\begin{verbatim}
The defined Storage resources are:
     1: File
Item 1 selected automatically.
Enter new Volume name:
\end{verbatim}
\normalsize

En este punto, se debería ingresar algún nombre comenzando con una letra y que contenga
únicamente letras y números (puntos, guiones y underscore son permitidos). Por ejemplo,
escriba \textbf{TestVolume001}, y obtendrá lo siguiente:

\footnotesize
\begin{verbatim}
Defined Pools:
     1: Default
Item 1 selected automatically.
Connecting to Storage daemon File at rufus:8103 ...
Sending label command for Volume "TestVolume001" Slot 0 ...
3000 OK label. Volume=TestVolume001 Device=/tmp
Catalog record for Volume "TestVolume002", Slot 0  successfully created.
Requesting mount FileStorage ...
3001 OK mount. Device=/tmp
\end{verbatim}
\normalsize

Finalmente, ingresando el comando \textbf{messages }se mostrara la siguiente salida:

\footnotesize
\begin{verbatim}
28-Apr-2003 14:30 rufus-sd: Wrote label to prelabeled Volume
   "TestVolume001" on device /tmp
28-Apr-2003 14:30 rufus-dir: Bacula 1.30 (28Apr03): 28-Apr-2003 14:30
JobId:                  1
Job:                    Client1.2003-04-28_14.22.33
FileSet:                Full Set
Backup Level:           Full
Client:                 rufus-fd
Start time:             28-Apr-2003 14:22
End time:               28-Apr-2003 14:30
Files Written:          1,444
Bytes Written:          38,988,877
Rate:                   81.2 KB/s
Software Compression:   None
Volume names(s):        TestVolume001
Volume Session Id:      1
Volume Session Time:    1051531381
Last Volume Bytes:      39,072,359
FD termination status:  OK
SD termination status:  OK
Termination:            Backup OK
28-Apr-2003 14:30 rufus-dir: Begin pruning Jobs.
28-Apr-2003 14:30 rufus-dir: No Jobs found to prune.
28-Apr-2003 14:30 rufus-dir: Begin pruning Files.
28-Apr-2003 14:30 rufus-dir: No Files found to prune.
28-Apr-2003 14:30 rufus-dir: End auto prune.
\end{verbatim}
\normalsize

Si usted no puede ver la salida inmediatamente, usted puede ejecutar el comando \textbf{messages
}hasta que el job termine, o puede ingresar, \textbf{autodisplay on} y sus mensajes
serán desplegados automáticamente tan pronto como estén listos.

Si usted hace un \textbf{ls -l} al directorio \textbf{/tmp}, verá una salida parecida
a lo siguiente:

\footnotesize
\begin{verbatim}
-rw-r-----    1 kern     kern     39072153 Apr 28 14:30 TestVolume001
\end{verbatim}
\normalsize

Este es el archivo de Volumen que se creo y escribió, y contiene toda la data del
job que se ejecutó. Si se corren jobs adicionales, la información se adicionará al
Volumen, a menos que usted indique otro.

Usted puede preguntarse si tiene que etiquetar todos los Volúmenes que Bacula va
a utilizar. La respuesta para Volúmenes de disco, como el que hemos utilizado, es
no. Es posible hacer que Bacula etiquete los volúmenes de manera automática. Para
Volúmenes de tapes (cintas), probablemente usted tenga que etiquetar cada uno de
los volúmenes que desee utilizar.

Si desea terminar en este punto, simplemente ingrese el comando \textbf{quit }en
el programa de Consola, y detenga Bacula con \textbf{./bacula stop}. Para realizar
una limpieza del catalogo y del volumen, simplemente borre el archivo \textbf{/tmp/TestVolume001},
y también debe reinicializar la base de datos, utilizando:

\footnotesize
\begin{verbatim}
./drop_bacula_tables
./make_bacula_tables
\end{verbatim}
\normalsize

Por favor, note que esto borrará toda la información acerca de los jobs previos que
se ejecutaron, y ahora, que estamos en prueba, podrá hacer esto, sin embargo, generalmente,
no se desea reinicializar la base de datos en ambientes de producción.

Si le gustaría probar la restauración de los archivos, a los cuales se les hizo backup,
por favor, lea la siguiente sección.

\label{Restaurando}

\section{Restaurando sus archivos}
\index{Files!Restoring Your}
\index{Restoring Your Files}

Si usted, ejecutó la configuración por defecto y respaldó el código fuente de Bacula,
tal como se indicó, usted puede recuperar estos archivos en la consola, ingresando
lo siguiente:

\footnotesize
\begin{verbatim}
restore all
\end{verbatim}
\normalsize

Luego de esto, se mostrará:

\footnotesize
\begin{verbatim}
First you select one or more JobIds that contain files
to be restored. You will be presented several methods
of specifying the JobIds. Then you will be allowed to
select which files from those JobIds are to be restored.

To select the JobIds, you have the following choices:
     1: List last 20 Jobs run
     2: List Jobs where a given File is saved
     3: Enter list of comma separated JobIds to select
     4: Enter SQL list command
     5: Select the most recent backup for a client
     6: Select backup for a client before a specified time
     7: Enter a list of files to restore
     8: Enter a list of files to restore before a specified time
     9: Find the JobIds of the most recent backup for a client
    10: Find the JobIds for a backup for a client before a specified time
    11: Enter a list of directories to restore for found JobIds
    12: Cancel
Select item:  (1-12): 
\end{verbatim}
\normalsize

Como puede observar, hay una gran cantidad de opciones, sin embargo, para la demostración
actual, por favor, pulse \textbf{5} para hacer una restauración del último backup
que usted hizo, y obtendrá la siguiente salida:

\footnotesize
\begin{verbatim}
Defined Clients:
     1: rufus-fd
Item 1 selected automatically.
The defined FileSet resources are:
     1: 1  Full Set  2003-04-28 14:22:33
Item 1 selected automatically.
+-------+-------+----------+---------------------+---------------+
| JobId | Level | JobFiles | StartTime           | VolumeName    |
+-------+-------+----------+---------------------+---------------+
| 1     | F     | 1444     | 2003-04-28 14:22:33 | TestVolume002 |
+-------+-------+----------+---------------------+---------------+
You have selected the following JobId: 1
Building directory tree for JobId 1 ...
1 Job inserted into the tree and marked for extraction.
The defined Storage resources are:
     1: File
Item 1 selected automatically.
You are now entering file selection mode where you add and
remove files to be restored. All files are initially added.
Enter "done" to leave this mode.
cwd is: /
$
\end{verbatim}
\normalsize

Donde, se ha truncado el listado del lado derecho, para hacerlo mas legible. Como
puede ver, en el tope del listado, Bacula conoce con cuales clientes usted cuenta,
y debido a que existe uno solo, el demonio de almacenamiento (Storage daemon) lo
selecciona de manera automática, igual ocurre para el FileSet. Luego, se muestra
un listado de todos los jobs que conforman el respaldo actual, en este caso, únicamente,
existe uno, y el demonio de almacenamiento, también lo selecciona. Luego, Bacula
tomó los archivos que estaban en el job numero 1, y se ingresó a un \textbf{árbol
de directorios }(representación ordenada en memoria de su filesystem). En este punto,
se pueden utilizar los comandos \textbf{cd}, \textbf{ls }y/o \textbf{dir}, para navegar
en el árbol de directorios y visualizar que archivos serán restaurados. Por ejemplo,
si se ingresa \textbf{cd /home/kern/bacula/bacula-1.30 }y luego se tipea \textbf{dir},
se obtendrá un listado de todos los archivos en el directorio de fuentes de Bacula.
En su sistema, esta ruta puede ser diferente. Para mayor información acerca de esto,
por favor revise el \ilink{Capítulo de Comandos de Restauración}{RestoreChapter}.

Para salir de este modo, simplemente ingrese:

\footnotesize
\begin{verbatim}
done
\end{verbatim}
\normalsize

Y se mostrará la siguiente salida:

\footnotesize
\begin{verbatim}
Bootstrap records written to
   /home/kern/bacula/testbin/working/restore.bsr
The restore job will require the following Volumes:
   
   TestVolume001
1444 files selected to restore.
Run Restore job
JobName:         RestoreFiles
Bootstrap:      /home/kern/bacula/testbin/working/restore.bsr
Where:          /tmp/bacula-restores
Replace:        always
FileSet:        Full Set
Backup Client:  rufus-fd
Restore Client: rufus-fd
Storage:        File
JobId:          *None*
When:           2005-04-28 14:53:54
OK to run? (yes/mod/no):
\end{verbatim}
\normalsize

Si la respuesta es \textbf{yes}, los archivos serán restaurados al directorio \textbf{/tmp/bacula-restores}.
Si desea restaurar los archivos a sus directorios originales, se debe utilizar la
opción \textbf{mod}, y de manera explícita definir \textbf{Where:} a ningún valor
(o a /). Recomendamos,que siga hacia adelante y responda \textbf{yes}, y luego de
un corto tiempo, ingresar \textbf{messages}, y en este punto debe tener un listado
de todos los archivos recuperados, así como un resumen del job, similar a esto:

\footnotesize
\begin{verbatim}
28-Apr-2005 14:56 rufus-dir: Bacula 2.1.8 (08May07): 08-May-2007 14:56:06
Build OS:               i686-pc-linux-gnu suse 10.2
JobId:                  2
Job:                    RestoreFiles.2007-05-08_14.56.06
Restore Client:         rufus-fd
Start time:             08-May-2007 14:56
End time:               08-May-2007 14:56
Files Restored:         1,444
Bytes Restored:         38,816,381
Rate:                   9704.1 KB/s
FD Errors:              0
FD termination status:  OK
SD termination status:  OK
Termination:            Restore OK
08-May-2007 14:56 rufus-dir: Begin pruning Jobs.
08-May-2007 14:56 rufus-dir: No Jobs found to prune.
08-May-2007 14:56 rufus-dir: Begin pruning Files.
08-May-2007 14:56 rufus-dir: No Files found to prune.
08-May-2007 14:56 rufus-dir: End auto prune.
\end{verbatim}
\normalsize

Luego de salir de la consola, usted puede examinar los archivos en el directorio
\textbf{/tmp/bacula-restores}, el cual contendrá un pequeño árbol de directorios
con todos los archivos. Al finalizar, asegúrese de dejar limpio el directorio con:

\footnotesize
\begin{verbatim}
rm -rf /tmp/bacula-restore
\end{verbatim}
\normalsize


\section{Saliendo del programa de Consola}
\index[general]{Saliendo!del programa de Consola } 
\index[general]{Saliendo del programa de Consola } 

Simplemente, ingrese el comando \textbf{quit}.


\section{Agregando un segundo cliente}
\index[general]{Agregando!un segundo cliente } 
\index[general]{Agregando un segundo cliente } 

Si usted ha seguido el ejemplo indicado para su sistema, ya está listo para agregar
un segundo cliente (Demonio de archivo o File daemon). Es decir, si usted cuenta
con una segunda máquina a la cual le gustaría hacer respaldo, el único componente
que usted necesita instalar en este equipo, es el binario de \textbf{bacula-fd }(o
\textbf{bacula-fd.exe }para Windows) y su archivo de configuración \textbf{bacula-fd.conf}.
Usted puede iniciar con el mismo archivo \textbf{bacula-fd.conf}, que está utilizando
actualmente, y hacer una modificación menor para crear el archivo de configuración
para el segundo cliente. Cambie el nombre del demonio de archivo (File daemon) que
está configurado, \textbf{rufus-fd }en el ejemplo anterior, quizás su sistema tendrá
un nombre diferente. Para este paso, lo mejor es cambiar el nombre en su segundo
equipo. Por ejemplo:

\footnotesize
\begin{verbatim}
...
#
# "Global" File daemon configuration specifications
#
FileDaemon {                          # this is me
  Name = rufus-fd
  FDport = 9102                  # where we listen for the director
  WorkingDirectory = /home/kern/bacula/working
  Pid Directory = /var/run
}
...
\end{verbatim}
\normalsize

Quedaría así:

\footnotesize
\begin{verbatim}
...
#
# "Global" File daemon configuration specifications
#
FileDaemon {                          # this is me
  Name = matou-fd
  FDport = 9102                  # where we listen for the director
  WorkingDirectory = /home/kern/bacula/working
  Pid Directory = /var/run
}
...
\end{verbatim}
\normalsize

Donde se muestra una porción del archivo y se ha cambiado \textbf{rufus-fd }por \textbf{matou-fd}.
Usted escoge los nombres que desee. Por el momento, se recomienda no cambiar nada
mas. Después, usted querrá cambiar el password.

Ahora que usted hizo los cambios en su segunda máquina, necesita hacer algunas adiciones
al archivo de configuración del Director, con la finalidad de definir el nuevo demonio
de archivo (File daemon) o cliente. Tomando el ejemplo original que está configurado
en el sistema, se deben añadir las siguientes lineas (básicamente, copie la información
existente, pero con nombres diferentes) al archivo de configuración del Director
(\textbf{bacula-dir.conf}).

\footnotesize
\begin{verbatim}
#
# Define the main nightly save backup job
#   By default, this job will back up to disk in /tmp
Job {
  Name = "Matou"
  Type = Backup
  Client = matou-fd
  FileSet = "Full Set"
  Schedule = "WeeklyCycle"
  Storage = File
  Messages = Standard
  Pool = Default
  Write Bootstrap = "/home/kern/bacula/working/matou.bsr"
}
# Client (File Services) to backup
Client {
  Name = matou-fd
  Address = matou
  FDPort = 9102
  Catalog = MyCatalog
  Password = "xxxxx"                  # password for
  File Retention = 30d                # 30 days
  Job Retention = 180d                # six months
  AutoPrune = yes                     # Prune expired Jobs/Files
}
\end{verbatim}
\normalsize

Luego, asegúrese que el parámetro de Address en el recurso de Storage esté definido
como un nombre completo de dominio calificado (fully qualified domain name) y no
a algo como \textquotedblleft{}localhost\textquotedblright{}. La dirección indicada
es enviada al File daemon (cliente) y debe ser un nombre completo de dominio. Si
usted utiliza \textquotedblleft{}localhost\textquotedblright{}, esto no se resolverá
de manera correcta y se generará un timeout cuando el File daemon falle al conectarse
al Storage daemon (demonio de almacenamiento).

Esto es todo lo que hay que hacer. Se copia el recurso existente para crear el segundo
Job (Matou) para el backup del segundo cliente (matou-fd). Su nombre es \textbf{Matou},
el cliente se denomina \textbf{matou-fd }y el nombre del archivo de bootstrap se
cambia, pero todo lo demás, es lo mismo.Esto significa que Matou sera respaldado
con la misma planificación, y utilizando el mismo conjunto de volúmenes. Mas adelante,
usted cambiará estos valores, sin embargo, por ahora se mantendrá esta configuración
sencilla.

El segundo cambio, consiste en agregar un nuevo recurso Cliente que defina a \textbf{matou-fd
}y tenga la dirección correcta para matou, pero en ambientes reales, usted podría
requerir un nombre completo de dominio calificado o una dirección IP. Se mantendrá
el mismo password (mostrado como xxxxx en el ejemplo).

En este punto, si usted detiene e inicia Bacula, e inicia el cliente en la otra maquina,
todo estará listo, y el prompt que se mostró anteriormente, ahora incluirá el segundo
equipo.

Cuando se hace la instalación en entornos de producción reales, probablemente se
quiera utilizar pools diferentes o distintas planificaciones (schedules). Las personalizaciones
ahora dependen de usted. En cualquier caso, se debería cambiar el password en los
archivos de configuración del Director y del Cliente, por razones de seguridad adicionales.

Para algunos tips importantes para los cambios de passwords y nombres, y un diagrama
de cuales nombres y passwords deben coincidir, por favor revise el capítulo \ilink{Errores de Autorización}{ErroresAutorizacion},de
este manual.


\section{Cuando el tape está lleno}
\label{FullTape}
\index[general]{Fills!When The Tape } 
\index[general]{When The Tape Fills }

Si usted planificó su job, generalmente en las noches, llegará el momento en que
la cinta se llene y \textbf{Bacula }no pueda continuar. En este caso, Bacula le enviará
un mensaje similar al siguiente:

\footnotesize
\begin{verbatim}
rufus-sd: block.c:337 === Write error errno=28: ERR=No space left
          on device
\end{verbatim}
\normalsize

Esto indica que existe un error de escritura porque el tape está full. Bacula buscará
el Pool especificado por el Job, intentando conseguir un volumen disponible (appendable).
En el mejor de los casos, usted habrá definido de manera apropiada sus Períodos de
Retención y tendrá todos los tapes marcados para ser reciclados (Recycled), y con
esto se reciclararán de manera automática las cintas en el pool indicado y se reescribirán
los volúmenes mas viejos. Para mayor información acerca del reciclado, por favor
revise el capítulo de \ilink{Reciclaje}{CapituloReciclaje} de este manual. Si usted
observa que los volúmenes no son reciclados en forma adecuada (generalmente, debido
a un error de configuración), por favor, revise la sección de \ilink{Reciclaje Manual de Volúmenes}{reciclajemanuel} 
del capítulo de Reciclaje.

Si usted tiene una gran cantidad de volúmenes y los etiquetó con la fecha del volumen
cuando se escribió por primera vez, o no ha definido sus periodos de Retención, Bacula
no conseguirá un tape en el pool, y se enviara un mensaje similar al siguiente:

\footnotesize
\begin{verbatim}
rufus-sd: Job kernsave.2002-09-19.10:50:48 waiting. Cannot find any
          appendable volumes.
Please use the "label"  command to create a new Volume for:
    Storage:      SDT-10000
    Media type:   DDS-4
    Pool:         Default
\end{verbatim}
\normalsize

Hasta que usted cree un nuevo volumen, este mensaje se repetirá una hora después,
luego dos horas mas tarde, y doblando el intervalo cada vez, hasta un máximo de un
día

La pregunta obvia en este punto es: Qué hacer ahora?

La respuesta es simple: Primero, utilizando el programa de consola, cierre el tape
utilizando el comando \textbf{unmount}. Si usted tiene un solo drive, este es seleccionado
automáticamente, de lo contrario, asegúrese que libere el que se indica en el mensaje
(en este caso, \textbf{STD-10000}).

A continuación, remueva el tape del drive e inserte uno nuevo en blanco. Tenga en
cuenta, que en algunas unidades de tape viejas, se necesita escribir una marca de
fin de archivo (\textbf{mt -f /dev/nst0 weof}) para prevenir al drive de otras corridas
cuando Bacula intente leer la etiqueta.

Finalmente, utilice el comando \textbf{label }en la Consola para escribir una etiqueta
al nuevo volumen. El comando \textbf{label }contactará al demonio de almacenamiento
(Storage daemon) para escribir la etiqueta de software. Si este proceso es exitoso,
se agregará el nuevo volumen al Pool, luego se emite un comando \textbf{mount }al
demonio de almacenamiento. Vea las secciones previas de este capítulo para mayores
detalles acerca del etiquetado de cintas.

El resultado es que Bacula continuará el Job previo, escribiendo el respaldo en el
nuevo Volumen.

Si usted tiene un pool de volúmenes y Bacula está ciclando con estos, en vez del
mensaje \textquotedbl{}Cannot find any appendable volumes.\textquotedbl{}, (\textquotedblleft{}Bacula
no puede hallar volúmenes disponibles\textquotedblright{}), se solicitará montar
un volumen especifico. En este caso, usted debe intentar realizar esta acción. Si
no cuenta con otro volumen (debido a cualquier razón), simplemente puede montar otro
volumen del mismo pool, que se encuentre disponible para escritura, y Bacula hará
uso del mismo. Puede utilizar el comando \textbf{list volumes }en la consola para
determinar cuáles son los volúmenes que pueden ser usados.

Si usted ha definido sus períodos de retención para los Volúmenes de manera correcta,
pero no cuenta con mas volúmenes disponibles para agregar data, se pueden reetiquetar
y reutilizar los existentes, considerando el siguiente procedimiento:
\begin{itemize}
\item Ejecutar \textbf{list volumes }en la consola, y seleccionar el volumen más viejo
para el reetiquetado. 
\item Si usted definió sus períodos de retención correctamente, el volumen tendría status
(VolStatus) \textbf{Purged}. 
\item Si el status del volumen no está como Purged, se necesitará purgar de la base de
datos los Jobs que están escritos en él. Usted puede hacer esto usando el comando
\textbf{purge jobs volume }en la consola. Si usted cuenta con múltiples Pools, se
le preguntará por el Pool, para luego ingresar el nombre del volumen (o MediaId),
cuando sea necesario. 
\item Luego, simplemente use el comando \textbf{relabel }para reetiquetar el volumen.
\end{itemize}
Para reetiquetar un volumen de manera manual, se deben ejecutar los siguientes pasos
adicionales:
\begin{itemize}
\item Para borrar el volumen del catálogo, utilice el comando \textbf{delete volume }en
la consola, y seleccione el nombre del Volumen (o MediaId) que será eliminado.
\item Use el comando \textbf{unmount }en la consola para desmontar el viejo tape.
\item Reetiquete físicamente el viejo Volumen que usted borró, para que el mismo pueda
ser reutilizado.
\item Inserte el viejo Volumen en la unidad de tape.
\item Desde la línea de comandos, ejecute: \textbf{mt -f /dev/st0 rewind }y \textbf{mt
-f /dev/st0 weof}, donde usted necesitará escoger el nombre apropiado para la unidad
de cinta de su sistema, en lugar de \textbf{/dev/st0}.
\item Utilice el comando \textbf{label }en la consola, para escribir una nueva etiqueta
de Bacula al tape.
\item Use el comando \textbf{mount }en la consola, si esto no se hace de manera automática,
para que Bacula inicie las operaciones con el nuevo tape etiquetado.
\end{itemize}

\section{Otros comandos útiles de Consola}
\index[general]{Otros!comandos útiles de consola } 
\index[general]{Otros comandos útiles de consola }

\begin{description}

\item [status dir]
   \index[console]{status dir }
   Muestra el status de todos los jobs que se están ejecutando y los planificados en las próximas 24 horas.

\item [status]
   \index[console]{status }
El programa de consola solicitará seleccionar un tipo de demonio, luego de esto, se muestra su status.

\item [status jobid=nn]
   \index[console]{status jobid }
 Muestra el status del JobId nn, si este se encuentra en ejecución El demonio de almacenamiento es contactado y se le consulta para imprimir el status del job también.

\item [list pools]
   \index[console]{list pools }
Lista los pools definidos en el Catálogo (generalmente, se utiliza el pool por defecto Default). Aunque esto puede variar según el ambiente configurado. 

\item [list media]
   \index[console]{list media }
Lista todas las medias definidas en el Catálogo.

\item [list jobs]
   \index[console]{list jobs }
Muestra todos los jobs en el Catálogo que se han ejecutado.  

\item [list jobid=nn]
   \index[console]{list jobid }
   Lista los jobs identificados con el jobid nn en el Catálogo. 

\item [list jobtotals]
   \index[console]{list jobtotals }
Muestra los totales de todos los jobs que se encuentran en el Catálogo.  

\item [list files jobid=nn]
   \index[console]{list files jobid }
Lista los archivos que fueron grabados para el job identificado con el JobId nn.

\item [list jobmedia]
   \index[console]{list jobmedia }
Muestra la información de la media (Volumen) para cada Job ejecutado.

\item [messages]
   \index[console]{messages }
Imprime los mensajes que han sido enviados a la consola.

\item [unmount storage=storage-name]
   \index[console]{unmount storage }
Desmonta el drive asociado con el dispositivo de almacenamiento indicado con el nombre {\bf
storage-name}, si este no se encuentra actualmente en uso. Este comando es utilizado cuando se desea que Bacula 
libere la unidad configurada para etiquetar un tape.

\item [mount storage=storage-name]
   \index[sd]{mount storage }
Permite que el drive asociado con el dispositivo de almacenamiento sea montado nuevamente. Cuando Bacula llegue 
al final de un volumen, y le solicite montar uno nuevo, debe ejecutar este comando luego de colocar un nuevo 
volumen en  la unidad. En efecto, esta es la señal que Bacula necesita conocer para iniciar la lectura o 
escritura en el nuevo volumen.

\item [quit]
   \index[sd]{quit }
   Salir del programa de consola.
\end{description}

La mayoría de los comandos señalados anteriormente, con excepción de {\bf list}, solicitarán los argumentos 
necesarios, si usted ingresa únicamente el nombre del comando.


\section{Depuración de la salida de un demonio}
\index[general]{Depuración de la salida de un demonio } 
\index[general]{Depuración!Salida Demonio }

Si usted desea depurar la salida de los demonios que se están ejecutando, estos se
deben iniciar desde el directorio de instalación de la siguiente manera:

\footnotesize
\begin{verbatim}
./bacula start -d100
\end{verbatim}
\normalsize

Esto puede muy útil, si los demonios no se inician correctamente, puesto que la salida
directa de estos a la consola se direcciona al dispositivo NULL. Sin embargo, con
nivel de depuración (debug) mayor que cero, la salida es enviada al terminal donde
se corren los comandos.

Para detener los tres demonios, ingrese lo siguiente desde el directorio de instalación:

\footnotesize
\begin{verbatim}
./bacula stop
\end{verbatim}
\normalsize

La ejecución de \textbf{bacula stop }puede indicar que algunos pids no fueron encontrados.
Esto puede ser ser normal, especialmente si alguno de los demonios ha \textquotedblleft{}muerto\textquotedblright{}
(died), lo cual es muy raro.

Para realizar un respaldo full de un sistema, cada demonio en el cliente (File daemon),
debe estar corriendo como usuario root, para que este tenga permisos para acceder
a todos los archivos. Ninguno de los otros demonios, requiere privilegios de root.
Sin embargo, el demonio de almacenamiento (Storage daemon), debe ser capaz de abrir
las unidades de tape. En la mayoría de los sistemas, únicamente el usuario root puede
acceder estos dispositivos. Para esto, usted puede correr el demonio de almacenamiento
como root o cambiar los permisos de los dispositivos de cinta, para permitir el acceso
a usuarios no root. MySQL y PostgreSQL pueden ser instalados con cualquier id de
usuario; y no se requieren privilegios de superusuario.


\section{Paciencia al iniciar los demonios o al montar tapes en blanco}

Cuando se inician los demonios de Bacula, el demonio de almacenamiento intenta abrir
todos los dispositivos de almacenamiento definidos y verificar el Volumen que está
montado actualmente (y si está configurado). Hasta que todos los dispositivos de
almacenamiento no sean verificados, el demonio de almacenamiento no aceptará conexiones
desde la Consola. Si la cinta ha sido utilizada con anterioridad, esta será rebobinada,
y en algunos dispositivos esto puede tomar varios minutos. Como consecuencia de esto,
usted debe tener un poco de paciencia la primera vez que se contacte al demonio de
almacenamiento, luego del arranque de estos. Si puede ver su unidad de cinta, una
vez que las luces dejen de parpadear, la misma estará disponible para su uso.

Las mismas consideraciones aplican si usted ha montado una cinta en blanco en una
unidad de drive, tal como una DLT HP. Esta acción puede tomar uno o dos minutos antes
que la unidad reconozca de manera adecuada, que el tape esta en blanco. Si usted
intenta ejecutar el comando \textbf{mount }en el programa de Consola durante el proceso
de reconocimiento, es muy probable que inhiba su driver SCSI (al menos en mi sistema
Red Hat Linux). Por esto, se le recuerda, nuevamente, tener paciencia cuando se inserten
cintas en blanco. Se debe esperar que el dispositivo no muestre actividad antes de
intentar accederlo.


\section{Dificultades conectando el FD con el SD}
\index[general]{Dificultades conectando el FD con el SD} 
\index[general]{Dificultades!conectando el FD con el SD} 

Si está teniendo dificultades para conectar uno o mas demonios de archivos con el
demonio de almacenamiento, probablemente esto se deba a que no utilizó un nombre
de dominio completamente calificado en la directiva \textbf{Address }en el recurso
de almacenamiento en el Director. Es decir, que el demonio de archivo del equipo
(no en el Director) debe ser capaz de resolver el nombre que se indique con la dirección
IP. Un ejemplo de una dirección que está garantizado no trabajará es:\textbf{ localhost}.
Un ejemplo de una que podría trabajar es: \textbf{megalon}. Otro ejemplo de otra
que probablemente pueda funcionar es: \textbf{magalon.mydomain.com}. En equipos Win32,
si usted no cuenta con una buena resolución (frecuentemente en sistemas muy viejos,
como Windows 98), usted puede probar utilizar una dirección IP en lugar de un nombre.

Si su dirección IP es correcta, asegúrese que ningún otro programa esté utilizando
el puerto 9103 en el equipo donde corre el demonio de almacenamiento (Storage daemon).
Los números de puertos de Bacula están autorizadas por la IANA, y no deberían ser
utilizados por otros programas, sin embargo, algunas impresoras HP utilizan estos
números de puertos. La ejecución del comando \textbf{netstat -a }en el equipo con
el demonio de almacenamiento, puede indicar quien está usando el puerto 9103 (utilizado
para las comunicaciones desde el FD al SD en Bacula).


\section{Opciones del demonio en linea de comandos}
\index[general]{Daemon Command Line Options } 
\index[general]{Options!Daemon Command Line }

Cada uno de los tres demonios (Director, Archivo y Almacenamiento), aceptan un pequeño
conjunto de opciones en linea de comandos. En general, cada uno de estos, así como
el programa de consola, acepta las siguientes opciones:

\begin{description}

\item [-c \lt{}file\gt{}]
   \index[sd]{-c \lt{}file\gt{} }
 Define el archivo a utilizar como archivo de configuración El defecto es el nombre del demonio seguido por la 
extensión {\bf .conf}, es decir, {\bf bacula-dir.conf} para el Director, {\bf bacula-fd.conf} para el demonio de 
archivo y {\bf bacula-sd.conf} para el demonio de almacenamiento. 

\item [-d nn]
   \index[sd]{-d nn }
   Define el nivel de depuración a {\bf nn}. Niveles más altos de depuración, provocan que mayor información sea 
desplegada en STDOUT, notificando lo que el demonio está haciendo.

\item [-f]
   Corre el demonio en el foreground. Esta opción es necesaria cuando se corre el demonio bajo el depurador.  

\item [-g <group>]
   Corre el demonio con este grupo. Debe ser un nombre de grupo, no su identificador GID.

\item [-s]
   No se le hace un trap a las señales. Esta opción es necesaria cuando se corre el demonio bajo el depurador.

\item [-t]
   Lee el archivo de configuración e imprime cualquier mensaje de error, luego termina inmediatamente. Es muy 
útil para chequear la sintaxis de nuevos archivos de configuración.  

\item [-u <user>]
   Corre el demonio con este usuario. Debe ser un nombre de un usuario, y no un UID.

\item [-v]
   Impresión mas detallada y completa de los errores y mensajes de información Se recomienda su uso.

\item [-?]
   Imprime la versión y la lista de opciones.

\end{description}


\section{Creando un Pool}
\label{Pool}
\index[general]{Pool!Creating a }
\index[general]{Creating a Pool }

La creación del Pool se hace de manera automática cuando \textbf{Bacula }arranca,
por lo tanto, si usted entiende los Pools, puede proseguir con la próxima sección

Cuando se ejecuta un job, una de las cosas que \textbf{Bacula }debe conocer es que
volúmenes se utilizarán para respaldar el conjunto de objetos (FileSet). En vez de
especificar un volumen (tape) directamente, se indica cuál es el pool de volúmenes
que \textbf{Bacula }consulta cuando se necesita una cinta para las escritura de los
backups. Bacula seleccionará el primer volumen disponible para el pool, apropiado
para el dispositivo de almacenamiento seleccionado para la ejecución del job. Cuando
un volumen está lleno, \textbf{Bacula }cambiar su atributo VolStatus de \textbf{Append
}a \textbf{Full}, luego se utilizará el siguiente volumen y así sucesivamente. Si
no existen volúmenes disponibles para escritura en el pool, el Director intentará
reciclar un volumen viejo, y si todavía no existen volúmenes, se enviará un mensaje
al operador solicitándole crear un nuevo volumen, de manera apropiada.

\textbf{Bacula }mantiene un registro del nombre del pool, los volúmenes contenidos
en el pool y un número determinado de atributos para cada uno de estos.

Cuando los servicios de Bacula se inician, se asegura que todas las definiciones
de los recursos de pool hayan sido grabadas en el catálogo. Esto se puede verificar
ingresando el siguiente comando:

\footnotesize
\begin{verbatim}
list pools
\end{verbatim}
\normalsize

En la consola de Bacula, y se mostraría algo parecido a lo siguiente:

\footnotesize
\begin{verbatim}
*list pools
Using default Catalog name=MySQL DB=bacula
+--------+---------+---------+---------+----------+-------------+
| PoolId | Name    | NumVols | MaxVols | PoolType | LabelFormat |
+--------+---------+---------+---------+----------+-------------+
| 1      | Default | 3       | 0       | Backup   | *           |
| 2      | File    | 12      | 12      | Backup   | File        |
+--------+---------+---------+---------+----------+-------------+
*
\end{verbatim}
\normalsize


Si usted intenta crear un pool con el mismo nombre, por segunda vez, se mostrará:

\footnotesize
\begin{verbatim}
Error: Pool Default already exists.
Once created, you may use the {\bf update} command to
modify many of the values in the Pool record.
\end{verbatim}
\normalsize

\section{Etiquetando sus volúmenes}
\label{Labeling}
\index[general]{Volumes!Labeling Your } 
\index[general]{Labeling Your Volumes }

Bacula requiere que cada volumen contenga una etiqueta de software. Hay varias estrategias
para el etiquetado de volúmenes Una de estas, consiste en etiquetarlos cuando sea
necesario, utilizando la consola. Es decir, cuando se necesita un nuevo volumen,
y no se consigue ninguno disponible en el catálogo, se envía un mensaje de correo
donde se solicita la adición de nuevos volúmenes al pool. Luego se utiliza el comando
\textbf{label}, en el programa de consola, para etiquetarlo y definirlo en la base
de datos del pool. Luego de esto, Bacula comenzará a escribir en el nuevo volumen.
De manera análoga, se puede utilizar el comando \textbf{relabel}, para reetiquetar
un volumen, que no ha sido usado por largos períodos de tiempo. Para esto, el atributo
VolStatus debe estar definido como \textbf{Purged}.

Otra estrategia, consiste en etiquetar un conjunto de volúmenes al inicio, para que
puedan ser utilizados cuando \textbf{Bacula }los necesite. Esta es la forma mas frecuente
de hacerlo en el caso de contar con un conjunto de cintas para reciclaje, por ejemplo,
cuando se utiliza una librería de cambio automático de cintas. Para mayores detalles
del reciclado, por favor, revise el capítulo \ilink{Reciclado automático de Volúmenes }{RecyclingChapter},
de este manual.

Si usted corre un job, y no cuenta con tapes etiquetados en el pool, Bacula le informará
esta situación, y estos se pueden crear \textquotedblleft{}en el vuelo\textquotedblright{}
y continuar. Por ejemplo, se pueden etiquetar las cintas con la fecha, es decir:
\textbf{DLT-18Apr09}. Mas abajo, se muestran más detalles en el uso del comando \textbf{label.}


\section{Etiquetando volúmenes con el programa de consola}
\index[general]{Labeling Volumes with the Console Program }
\index[general]{Program!Labeling Volumes with the Console }

El etiquetado de volúmenes, generalmente, se realiza utilizando el programa de consola.
\begin{enumerate}
\item ./bconsole
\item label
\end{enumerate}

Si Bacula, muestra que no puede etiquetar la cinta, porque esta ha sido etiquetada
previamente, simplemente desmóntelo, utilizando el comando \textbf{unmount }en la
consola, y seguidamente, monte una cinta en blanco y ejecute nuevamente el comando\textbf{
label.}

\footnotesize
\begin{verbatim}
The defined Storage resources are:
     1: File
     2: 8mmDrive
     3: DLTDrive
     4: SDT-10000
Select Storage resource (1-4):
\end{verbatim}
\normalsize

En este punto, usted debe tener una cinta vacía en el drive correspondiente al recurso
de almacenamiento que seleccionó.

Luego se pregunta por el nombre del volumen:

\footnotesize
\begin{verbatim}
Enter new Volume name:
\end{verbatim}
\normalsize

Si Bacula muestra:

\footnotesize
\begin{verbatim}
Media record for Volume xxxx already exists.
\end{verbatim}
\normalsize

Significa que el volumen con nombre \textbf{xxxx }que se ingresó, ya existe en la
base de datos de medios. Se pueden listar todas las medias (volúmenes) definidas,
con el comando \textbf{list media}. Observe, que la última columna LastWritten, se
ha truncado para mostrar una salida apropiada.

\footnotesize
\begin{verbatim}
+---------------+---------+--------+----------------+-----/~/-+------------+-----+
| VolumeName    | MediaTyp| VolStat| VolBytes       | LastWri | VolReten   | Recy|
+---------------+---------+--------+----------------+---------+------------+-----+
| DLTVol0002    | DLT8000 | Purged | 56,128,042,217 | 2001-10 | 31,536,000 |   0 |
| DLT-07Oct2001 | DLT8000 | Full   | 56,172,030,586 | 2001-11 | 31,536,000 |   0 |
| DLT-08Nov2001 | DLT8000 | Full   | 55,691,684,216 | 2001-12 | 31,536,000 |   0 |
| DLT-01Dec2001 | DLT8000 | Full   | 55,162,215,866 | 2001-12 | 31,536,000 |   0 |
| DLT-28Dec2001 | DLT8000 | Full   | 57,888,007,042 | 2002-01 | 31,536,000 |   0 |
| DLT-20Jan2002 | DLT8000 | Full   | 57,003,507,308 | 2002-02 | 31,536,000 |   0 |
| DLT-16Feb2002 | DLT8000 | Full   | 55,772,630,824 | 2002-03 | 31,536,000 |   0 |
| DLT-12Mar2002 | DLT8000 | Full   | 50,666,320,453 | 1970-01 | 31,536,000 |   0 |
| DLT-27Mar2002 | DLT8000 | Full   | 57,592,952,309 | 2002-04 | 31,536,000 |   0 |
| DLT-15Apr2002 | DLT8000 | Full   | 57,190,864,185 | 2002-05 | 31,536,000 |   0 |
| DLT-04May2002 | DLT8000 | Full   | 60,486,677,724 | 2002-05 | 31,536,000 |   0 |
| DLT-26May02   | DLT8000 | Append |  1,336,699,620 | 2002-05 | 31,536,000 |   1 |
+---------------+---------+--------+----------------+-----/~/-+------------+-----+
\end{verbatim}
\normalsize

Una vez que Bacula verifica que el volumen aún no ha sido creado, se solicitará el
nombre del pool al cual se agregará el volumen (cinta). Si existe un pool único (Default),
este se seleccionará de manera automática 

Si la cinta es etiquetada de manera exitosa, un registro de volumen también es creado
en el pool. Es decir, el nombre del volumen y todos sus atributos aparecerán cuando
se liste el pool. Adicionalmente, estará disponible para los respaldos, si el campo
MediaType coincide con el requerido por el demonio de almacenamiento.

Cuando se etiquetó el tape, se le hicieron varias preguntas, básicamente el nombre
y quizás el slot. Sin embargo, el registro del volumen en la base de datos del catálogo
(conocido internamente como MediaRecord), contiene poco atributos. La mayoría de
los cuales se definen de los valores por defecto configurados para el pool ( es decir,
el pool mantiene la mayoría de los atributos por defecto utilizados para la creación
del volumen).

También es posible agregar medias a un pool sin etiquetar físicamente el volumen.
Esto se hace con el comando \textbf{add}. Para mas información, por favor revise
el capítulo de \ilink{Consola}{_ConsoleChapter} , de este manual.