Skip to content
This repository has been archived by the owner on Mar 19, 2021. It is now read-only.

Commit

Permalink
add notes about glusterfs storage backend
Browse files Browse the repository at this point in the history
  • Loading branch information
joergsteffens committed Dec 15, 2014
1 parent e1a4610 commit 8fe9b8c
Showing 1 changed file with 32 additions and 5 deletions.
37 changes: 32 additions & 5 deletions manuals/en/main/storedconf.tex
Expand Up @@ -380,7 +380,7 @@ \section{Device Resource}
\nameref{DirectorResourceStorage} in its Storage
resource.

\directive{sd}{Archive Device}{device {\textbar} directory {\textbar} fifo {\textbar} Ceph object store}{required}{}{}
\directive{sd}{Archive Device}{device {\textbar} directory {\textbar} fifo {\textbar} GlusterFS storage {\textbar} Ceph object store}{required}{}{}
Specifies where to read and write the backup data.
The type of the Archive Device can be specified by the {\bf Device Type} directive.
If Device Type is not specified, Bareos tries to guess the Device Type
Expand All @@ -396,13 +396,15 @@ \section{Device Resource}
conventions with the device. The {\bf b} in the Solaris (Sun) archive
specification \path|/dev/rmt/0mbn| is what is needed in this case.
Bareos does not support SysV tape drive behavior.

\item[directory] If a directory is specified, it is used as file storage.
The directory must be existing and be specified as absolute path.
Bareos will write to file storage in the specified
directory and the filename used will be the Volume name as specified in the
Catalog. If you want to write into more than one directory (i.e. to spread
the load to different disk drives), you will need to define two Device
resources, each containing an Archive Device with a different directory.

\item[fifo] \label{SetupFifo}
A FIFO is a special kind of file that connects two programs
via kernel memory. If a FIFO device is specified for a backup operation, you
Expand Down Expand Up @@ -442,9 +444,31 @@ \section{Device Resource}

A FIFO device can also be used to test your configuration, see the \ilink{Howto section}{TestUsingFifoDevice}.

\item[GlusterFS Storage] \label{GlusterArchiveType}
A GlusterFS Storage can be used as Storage backend of Bareos.
Prerequistes are a working GlusterFS storage system and the package \package{bareos-storage-glusterfs}.
See \url{//http://www.gluster.org/} for more information regarding GlusterFS installation and configuration.
You can use following snippet to configure it as storage device:
\begin{bconfig}{GlusterFS device}
Device {
Name = GlusterStorage
Archive Device = gluster://server.example.com/volumename/bareos
Device Type = gfapi
Media Type = GlusterFile
Label Media = yes
Random Access = yes
Automatic Mount = yes
Removable Media = no
Always Open = no
}
\end{bconfig}
Adapt server and volume name to your environment.

\sinceVersion{sd}{GlusterFS Storage}{14.2.2}

\item[Ceph Object Store] \label{CephArchiveType}
Here you configure the Ceph object store, which is accessed by the SD using the Rados library. Prerequistes are a
working Ceph object store and the package \file{bareos-storage-ceph}. See \url{http://ceph.com} for more information regarding Ceph installation and configuration.
working Ceph object store and the package \package{bareos-storage-ceph}. See \url{http://ceph.com} for more information regarding Ceph installation and configuration.
Assuming that you have an object store with name \file{your_bareos_store}
and your Ceph access is configured in \file{/etc/ceph/ceph.conf}, you can use following snippet to configure it as storage device:
\begin{bconfig}{Ceph Object Store Device}
Expand All @@ -460,12 +484,12 @@ \section{Device Resource}
AlwaysOpen = no
}
\end{bconfig}
\sinceVersion{sd}{Ceph Backend}{14.2.2}
\sinceVersion{sd}{Ceph Storage}{14.2.2}

\end{description}


\directive{sd}{Device Type}{tape {\textbar} file {\textbar} fifo {\textbar} rados }{}{}{}
\directive{sd}{Device Type}{tape {\textbar} file {\textbar} fifo {\textbar} gfapi {\textbar} rados}{}{}{}
The Device Type specification allows you to explicitly tell Bareos
what kind of device you are defining. It the {\bf type-specification}
may be one of the following:
Expand All @@ -478,8 +502,11 @@ \section{Device Resource}
file defined on fixed medium or a removable filesystem such as
USB. All files must be random access devices.
\item [Fifo]
The device is a first-in-first out sequential access read-only
The device is a first-in-first-out sequential access read-only
or write-only device.
\item [gfapi]
The gfapi device is used to access a GlusterFS storeage.
\sinceVersion{sd}{GlusterFS (gfapi)}{14.2.2}
\item [Rados]
The Rados device is used to access a Ceph object store.
\sinceVersion{sd}{Ceph (Rados)}{14.2.2}
Expand Down

0 comments on commit 8fe9b8c

Please sign in to comment.