BCONSOLE

Comando

add [pool=<pool-name>
storage=<storage> jobid=<Jobid>]

automount on/off

cancel [jobid=<number>
job=<jobname>
ujobid=<unique-jobid>]

delete [volume=<vol-name>
pool=<pool-name> job jobid=id>]

disable job<job-name>

enable job<job-name>
estimate

Descripcin
Agrega un volumen a un pool existente. Es decir, crea
el nombre del volumen en el catalogo y lo adiciona al
pool, dentro del catalogo, sin embargo, no intenta
acceder al volumen fisico.
Generalmente, el comando label es utilizado en vez de
este comando, porque este ultimo etiqueta el medio
fsico (tape, disco, DVD, entre otros) y realiza el
equivalente al comando add.
Este comando acepta on y off como argumentos, y
activa el automontaje del volumen despus de un
comando label, segun este habilitado o deshabilitado.
Por defecto es on.
Este comando es utilizado para cancelar un job y
acepta como argumentos el id o el nombre del job. Si
no se indica ningn argumento, se muestra un listado
con todos los nombres de los jobs activos, para que se
pueda seleccionar alguno en particular.
El comando delete se utiliza para borrar registros de
volumen, pool o job del catalogo, as como los registros
asociados al volumen que hayan sido creados. Este
comando nicamente opera en la base de datos del
catalogo y no tiene efecto en la data escrita
actualmente en el volumen. Se recomienda no utilizar
este comando, debido a que puede ser muy peligroso.
Este comando permite deshabilitar un job en el
scheduling automtico de respaldos. El job tuvo que ser
previamente habilitado, bien sea utilizando la directiva
Enabled en el recurso de Job o el comando enable en
la consola.
Este comando permite habilitar un job en el scheduling
automtico de respaldos. El job se deshabilito
previamente, bien sea utilizando la directiva Enabled en
el recurso del Job o el comando disable en la consola.
El uso de este comando permite tener una idea de
cuantos archivos sern respaldados o ayudar a
determinar los elementos incluidos en el fileset del
respaldo, puesto que se permite probar sin realizar el
backup actual. Se asume por defecto un nivel de full
para la operacin de respaldo. Sin embargo, se puede
especificar un nivel, haciendo uso de los opciones
level=Incremental o level=Differential, en la linea de
comandos.

help

label

list

llist

messages

mount
prune

Se pueden indicar mas opciones, tomando en

consideracin el siguiente formato:
estimate job=<job-name> listing client=<client-name>
fileset=<fileset-name> level=<level-name>
Muestra un listado de ayuda con los comandos
disponibles.
Comando utilizado para etiquetar volumenes fsicos. La
sintaxis general para este comando es:
label storage=<storage-name> volume=<volumename>
slot=<slot>
El comando list se utiliza para listar el contenido del
catalog. Los campos que conforman cada registro se
muestran en una linea simple. Las formas diversas para
este comando pueden ser alguna de las siguientes:
list jobs
list jobid=<id>
list ujobid=<unique job name>
list job=<job-name>
list jobmedia
list jobmedia jobid=<id>
list jobmedia job=<job-name>
list files jobid=<id>
list files job=<job-name>
list pools
list clients
list jobtotals
list volumes
list volumes jobid=<id>
list volumes pool=<pool-name>
list volumes job=<job-name>
list volume=<volume-name>
list nextvolume job=<job-name>
list nextvol job=<job-name>
list nextvol job=<job-name> days=nnn
El comando de listado extendido, toma los mismos
argumentos que el comando list, descrito
anteriormente. Sin embargo, la diferencia radica en que
este ultimo muestra el contenido completo para cada
registro seleccionado de la base de datos de catalogo.
Muestra en consola los mensajes que se encuentran
pendientes.
Este comando le indica a bacula que puede leer un
volumen en un dispositivo fisico. De esta manera, se
senala que se ha montado un tape, y que la aplicacion
esta preparada para examinarla.
El comando prune permite remover del catalogo, de
manera segura, registros de jobs y volumenes

purgue

relabel

release

Reload

expirados. Trabaja nicamente en la base de datos del

catalogo, y no afecta la data escrita en los volumenes.
En cualquiera de los casos, este comando aplica los
periodos de retencion para los registros indicados. Para
que el comando se pueda aplicar, el status del volumen
(VolStatus), debe ser Full, Used o Append, en caso
contrario la operacion de pruning no se llevara a cabo.
El comando purge eliminara de la base de datos del
catalogo los registros de jobs y volumenes, sin
considerar el periodo de retencion. La operacion de
purgue trabaja unicamente en el catalogo, sin afectar la
data escrita en los volumenes. Este comando puede
ser muy danino, puesto que se pueden borrar registros
asociados con los respaldos actuales de archivos. Las
formas permitidas del comando son las siguientes:
purge files jobid=<jobid> job=<job-name>
client=<client-name>
purge jobs client=<client-name> (de todos los jobs)
purge volumevolume=<vol-name> (de todos los jobs)
La data escrita en el volumen no se vera afectada por
este comando.
Este comando es utilizado para etiquetar nuevamente
los volumenes fisicos. La forma completa para este
comando es:
relabel storage=<storage-name> oldvolume=<oldvolumenname> volume=,newvolume-name>
Para realizar esta operacion, el status del volumen
debe estar marcado como Purged o Recycle. Esto
sucede de manera automatica cuando se aplican los
periodos de retencion o se utiliza el comando purge de
manera explicita. Una vez que el volumen es
reetiquetado, la data escrita con anterioridad es
eliminada y no se puede recuperar.
El uso de este comando permite al storage daemon
realizar la operacion de rewind al tape montado
actualmente en el drive, y luego releer la etiqueta del
volumen la proxima vez que el tape es utilizado.
release storage=<storage-name>
El comando reload provoca que el director lea
nuevamente su archivo de configuracin y aplique los
ajustes realizados. Los nuevos valores tendrn de
manera inmediata para los nuevos jobs. Sin embargo,
si se realizan cambios en el schedule, hay que tener
presente que el scheduler, ejecuta una planificacin
previa de jobs de hasta dos (2) horas de preparacin,
por lo tanto, cualquier cambio que tenga lugar durante
las siguientes dos (2) horas se pueden retrasar.
Aunque es posible recargar la configuracin del director

restore

run

show

sqlquery

status

en caliente, mientras se asten ejecutando jobs, sin

efectos secundarios, se recomienda que se haga un
reinicio del director en una siguiente oportunidad mas
adecuada.
El comando restore permite que se puedan seleccionar
uno o mas jobs (JobIds) para ser restaurados utilizando
varios metodos. El formato general del comando es el
siguiente:
restore storage=<storage-name> client=<backup-clientname>
where=<path> pool=<pool-name>
fileset=<fileset-name> restoreclient=<restore-clientname>
select current all done
Este comando permite la planificacin de jobs para que
se ejecuten de manera inmediata. La sintaxis completa
del mismo es la siguiente:
run job=<job-name> client=<client-name>
fileset=<FileSet-name> level=<level-keyword>
storage=<storage-name> where=<directory-prefix>
when=<universal-time-specification> yes
Cualquier informacin que sea necesaria, y no sea
indicada, sera listada para su seleccion por parte del
usuario, y antes de arrancar el job, se le preguntara si
desea aceptar, rechazar o modificar los parametros del
mismo, a menos que se haya especificado la opcion de
yes, en cuyo caso, el job se enviara inmediatamente al
scheduler de respaldo.
El comando show muestra un listado de los registros de
recursos definidos en el director, tal como se
encuentran en al archivo de configuracin
(generalmente, [Link]). Las siguientes
opciones son permitidas para el show en linea de
comandos: catalogs, clients, countes, devices,
directors, filesets, jobs, messages, pools, schedules,
storages, all, help.
Este comando coloca el programa de consola en modo
consultas de SQL, donde cada linea se concatena a la
anterior hasta que se presiona el caracter ;. Esta
sentencia se pasa al engine SQL de la base de datos,
para su ejecucion respectiva. Para terminar el modo
SQL query y retornar al prompt de consola de
comandos, se pulsa la tecla . en la columna 1.
Permite desplegar el status de los jobs planificados
para ser ejecutados en las proximas 24 horas, asi como
el status de los jobs actualmente en ejecucion. La
sintaxis general del comando es la siguiente:
status [all dir=<dir-name> director client=<clientname>
storage=<storage-name> days=nnn

unmount

update

Permite sealar al demonio de almacenamiento de

bacula (storage daemon) desmontar el dispositivo
indicado. Las formas que puede tomar el comando son
las mismas de mount:
unmount storage=<storage-name> [drive=<num>]
unmount [ jobid=<id> | job=<job-name> ]
Luego de haber desmontado un dispositivo de
almacenamiento, bacula no podra utilizarlo hasta que
se corra un comando mount para este dispositivo. Si
bacula necesita este recurso, el mismo estara
bloqueado y se enviaran notificaciones al operador para
que lleve a cabo la operacion de montaje respectiva.
Si el dispositivo que se esta desmontando es un
autochanger (robotica de respaldo), se hara el unload
del drive indicado en la linea de comandos. Si no se
especifica ninguno, se asume el drive 1.
Modifica el catalogo para los registros de pools,
volmenes o slots en una robotica con capacidad de
etiquetado de codigo de barras. En el caso de
modificacin de un registro de pool, la nueva
informacin se tomara de manera automatica del
recurso de configuracin correspondiente en el director.
Se puede utilizar para incrementar el numero mximo
de volumenes permitidos o establecer un numero
maximo de volumenes. Las siguientes opciones pueden
ser especificadas:
media, volume, pool, slots
En el caso de modificar un volumen, se preguntara por
el valor que se desea modificar. Los siguientes
parametros pueden ser ajustados:
Volume Status
Volume Retention Period
Volume Use Duration
Maximum Volume Jobs
Maximum Volume Files
Maximum Volume Bytes
Recycle Flag
Recycle Pool
Slot
Inchanger Flag
Pool
Volume Files
Volume From Pool
All Volumes from Pool
All Volumes from all Pools
Para slots, con la opcion update slots, bacula obtendra
una lista de slots y sus respectivas etiquetas de codigos
de barra desde el storage daemon, y para cada codigo

use

var

version

quit

query

de barra encontrado, se modificara automaticamente el

slot el registro de Media en el catalogo con el nuevo
valor correspondiente.
Para la opcion de pool, update pool, bacula movera los
registros de volumenes desde el pool existente al pool
indicado.
Para las opciones Volume from Pool, All Volumes from
Pool y All Volumes from all Pools, los valores siguientes
son modificados del registro de Pool: Recycle,
RecyclePool, VolRetention, VolUseDuration,
MaxVolJobs, MaxVolFiles y MaxVolBytes.
La sintaxis completa para la accion update desde la
linea de comandos, es la siguiente:
update volume=xxx pool=yyy slots volstatus=xxx
VolRetention=ddd VolUse=ddd MaxVolJobs=nnn
MaxVolBytes=nnn Recycle=yes|no slot=nnn enabled=n
recyclepool=zzz
Este comando permite especificar el catalogo de base
de datos a utilizar. Normalmente, se utiliza una unica
base de datos. En el caso de utilizar mas de una base
de datos, se puede utilizar este comando para
cambiarse entre una y la otra:
use <database-name>
Este comando toma una cadena de caracteres y realiza
una expansion de variables, de la misma manera como
es hecha con el string LabelFormat. De esta manera,
se puede hacer una prueba con las cadenas para la
accion de Label Format. La diferencia entre el
comando var y el proceso de Label Format, es que
durante el primero no existe ningun job en ejecucion.
Imprime la version del director.
Termina el programa de consola, enviando un
requerimiento de quit al director, y espera confirmacion
por parte de este. Si el director, esta ocupado con un
comando previo que no ha terminado de ejecutarse,
puede tomar algun tiempo. Se puede salir de la consola
de manera inmediata, ejecutando el comando .quit.
Este comando lee unas consultas predefinidas de SQL
desde un archivo (el nombre y ubicacion del mismo se
define en el recurso QueryFile, indicado en el archivo
de configuracin del director). Cuando se selecciona
esta opcion, se solicita al usuario escoger una consulta
desde el archivo de querys, y posiblemente ingresar
uno o mas parametros, que sera enviada al engine de
SQL a la base de datos del catalogo.
Las opciones configuradas por defecto para este
comando son las siguientes:

exit

wait

Available queries:
1: List up to 20 places where a File is saved regardless of the
directory
2: List where the most recent copies of a file are saved
3: List last 20 Full Backups for a Client
4: List all backups for a Client after a specified time
5: List all backups for a Client
6: List Volume Attributes for a selected Volume
7: List Volumes used by selected JobId
8: List Volumes to Restore All Files
9: List Pool Attributes for a selected Pool
10: List total files/bytes by Job
11: List total files/bytes by Volume
12: List Files for a selected JobId
13: List Jobs stored on a selected MediaId
14: List Jobs stored for a given Volume name
15: List Volumes Bacula thinks are in changer
16: List Volumes likely to need replacement from age or errors
Choose a query (1-16):
Termina el programa de consola.
El comando wait provoca que el director haga una
pausa hasta que no haya jobs en ejecucion. Cuenta
con las siguientes opciones:
wait [jobid=nn] [jobuid=unique jobid] [job=job
name]
Si se indica un JobId, el comando wait esperara por la
terminacion del job en particular para continuar.

Existen unos comandos especiales que tienen como prefijo un punto (.), que se utilizan en programas
batch o en interfaces de usuario, bien sea grficas o en consolas de texto:
Comando
.backups job=xxx
.clients

Descripcin
Lista los backups para un job especifico
Lista todos los nombres de clientes.
Muestra los valores por defecto para cliente
.defaults client=xxx fileset=yyy
determinado.
Provoca que el director genera un segment fault (para
.die
debugging).
Equivalente al comando dir, pero la salida muestra
.dir
campos separados por comas en vez de espacios.
.exit
Equivalente al comando quit.
.filesets
Lista todos los nombres de los filesets.
.help
Salida del comando help.
.jobs
Lista todos los nombres de los jobs.
.levels
Muestra todos los niveles de respaldos.
.messages
Muestra un listado de los mensajes.
.msgs
Retorna cualquier mensaje encolado.
.pools
Lista los nombres de los pools.
.quit
Equivalente al comando quit.
.status
Muestra la salida del status.
Retorna los nombres de los recursos de
.storage
almacenamiento.
.types
Muestra los tipos de jobs.

SCHEDULE
Schedules
Los schedules son las programaciones horarias con las que se realizaran los trabajos. Yo he optado
por dejar la que trae Bacula, ya que me parece buena para los servidores de los que tengo que realizar
copias de seguridad. Por defecto, hace copias completas el primer domingo de cada mes, diferenciales
el resto de domingos del mes e incrementales todos los dems das.

Schedule {
Name = CicloSemanal
Run = Full 1st sun at 02:00
Run = Differential 2nd-5th sun at 02:00
Run = Incremental mon-sat at 02:00
}