Mirrors/vchanger
1
0
Fork 0
mirror of https://github.com/wanderleihuttel/vchanger.git synced 2025-09-16 08:31:16 +00:00
Code Issues Actions Packages Projects Releases Wiki Activity

Add vchanger 1.0.3 code

Browse Source
This commit is contained in:
Wanderlei Hüttel
2020-05-27 10:23:25 -03:00
parent 7490e52578
commit d7a0e39e91
44 changed files with 3448 additions and 2309 deletions
Download Patch File Download Diff File Expand all files Collapse all files

3
doc/example-vchanger-udev.rules
View File

@@ -1,4 +1,5 @@
# This file contains udev rules for automounting drives assigned to vchanger
# This file contains example udev rules for automounting filesystems assigned to vchanger
# See vchangerHowto.html for details on generating udev rules for vchanger magazines.
#
# Rules for magazine 0 (uuid:7b4526c4-d8e9-48ba-b227-f67f855a0dc7)
ACTION=="add",SUBSYSTEM=="block", ENV{ID_FS_UUID}=="7b4526c4-d8e9-48ba-b227-f67f855a0dc7", RUN+="/usr/libexec/vchanger/vchanger-launch-mount.sh 7b4526c4-d8e9-48ba-b227-f67f855a0dc7"

25
doc/vchanger-example.conf
View File

@@ -1,4 +1,4 @@
# Example vchanger 1.0.0 config file
# Example vchanger 1.0.2 config file
#
# Storage Resource Name of the Storage resource defined in bacula-dir.conf
@@ -10,27 +10,27 @@
# User User to run as when invoked by root. This must be the
# owner of the volume files controlled by this changer, and
# so will need to be the same user that bacula-sd runs as.
# [Default: none ]
User = bacula
# [Default: bacula ]
#User = bacula
#
# Group Group to run as when invoked by root. This should be the
# owner group of the volume files controlled by this changer,
# and should also be the default group pf the user that
# and should also be the default group of the user that
# bacula-sd runs as.
# [Default: none ]
group = tape
# [Default: tape ]
#group = tape
#
# Work Dir Directory where virtual drive and magazine state information
# and symlinks for this changer are stored.
# [Default: /var/spool/vchanger/[StorageResource] ]
# [Default: /var/spool/vchanger/{StorageResource} ]
#work dir = "/var/spool/vchanger/vcahnger"
#
# Logfile Path to log file for this changer.
# [Default: /var/log/vchanger/[StorageResource].log ]
#logfile = "/var/log/vchanger/vchanger.log"
# [Default: {WorkDir}/{StorageResource}.log ]
#logfile = "/var/spool/vchanger/vchanger.log"
#
# Log Level Sets the level of detail being logged. An integer value from
@@ -50,7 +50,8 @@ group = tape
#
# bconsole config Path to the config file bconsole will use when vchanger
# invokes bconsole. By default, bconsole will be invoked
# without the -c flag.
# without the -c flag. The file must be readable by the user
# vchanger is run as.
# [Default: none ]
#bconsole config = /etc/bacula/bconsole.conf
@@ -69,7 +70,9 @@ group = tape
# by prefixing the string "UUID:" to the filesystem's UUID.
# For magazines specified by UUID, the mountpoint of the
# filesystem will be queried from the system. Note that vchanger
# does not attempt to mount the filesystem.
# does not attempt to mount the magazines that are specified
# by filesystem UUID. Vchanger utilizes all magazines that are
# already mounted at the time it is invoked.
# [Default: none ]
#magazine = "uuid:4fcb1422-f15c-4d7a-8a32-a4dcc0af5e00"
#Magazine = "/mnt/backup2"

14
doc/vchanger.8
View File

@@ -2,12 +2,12 @@
.\" Title: vchanger
.\" Author: Josh Fisher <jfisher@jaybus.com>
.\" Generator: DocBook XSL Stylesheets v1.78.1 <http://docbook.sf.net/>
.\" Date: 06/03/2015
.\" Date: 05/11/2020
.\" Manual: vchanger Manual
.\" Source: vchanger 1.0.1
.\" Source: vchanger 1.0.3
.\" Language: English
.\"
.TH "VCHANGER" "8" "06/03/2015" "vchanger 1\&.0\&.1" "vchanger Manual"
.TH "VCHANGER" "8" "05/11/2020" "vchanger 1\&.0\&.3" "vchanger Manual"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
@@ -40,7 +40,7 @@ vchanger \- Virtual disk\-based autochanger for Bacula network backup system
\fBvchanger\fR [\fIOptions\fR] config REFRESH
.SH "DESCRIPTION"
.sp
The \fBvchanger(8)\fR utility is used to emulate and control a virtual autochanger within the Bacula network backup system environment\&. Backup volumes stored on multiple disk filesystems are mapped to a single set of virtual slots, allowing an unlimited number of virtual drives for concurrent backup jobs and easy, unlimited scaling to any size by simply adding additional disks/filesystems,
The \fBvchanger(8)\fR utility is used to emulate and control a virtual autochanger within the Bacula network backup system environment\&. Backup volumes stored on multiple disk filesystems are mapped to a single set of virtual slots\&. This allows an unlimited number of virtual drives and an unlimited number of virtual slots spread across an unlimited number of physical disk drives to be assigned to a single autochanger\&. This allows unlimited scaling of the cirtual autochanger simply by adding additional disk drives\&.
.sp
Vchanger is primarily deigned for use with removable disk drives\&. Its ability to interact with Bacula and determine removable drive mount points through udev allow for plug\-n\-play operation when attaching and detaching removable disk drives\&.
.sp
@@ -142,9 +142,9 @@ command to Bacula if required\&.
.sp
\fBBacula Interaction\fR
.sp
By default, vcahgner will invoke bconsole and issue commands to Bacula when certain operator actions are needed\&. When anything happens that changes the current set of volume files being used, vchanger will invoke bconsole and issue an \fIupdate slots\fR command\&. For example, when the operator attaches a removable drive defined as one of the changer\(cqs magazines, the volume files on the removable drive must be mapped to virtual slots\&. Since the volume\-to\-slot mapping will have changed, Bacula will need to be informed of the change via the \fIupdate slots\fR command\&. The \fBREFRESH\fR command can be invoked to force vchanger to update state info and trigger \fIupdate slots\fR if needed\&.
By default, vcahgner will invoke bconsole and issue commands to Bacula when certain operator actions are needed\&. When anything happens that changes the current set of volume files being used, (the virtual slot to volume file mapping), vchanger will invoke bconsole and issue an \fIupdate slots\fR command\&. For example, when the operator attaches a removable drive defined as one of the changer\(cqs magazines, the volume files on the removable drive must be mapped to virtual slots\&. Since the slot\-to\-volume mapping will have changed, Bacula will need to be informed of the change via the \fIupdate slots\fR command\&. The \fBREFRESH\fR command can be invoked to force vchanger to update state info and trigger \fIupdate slots\fR if needed\&.
.sp
Additionally, when new volumes are created with the \fBCREATEVOLS\fR command, vchanger will invoke bconsole and issue a \fIlabel barcodes\fR command to write volume labels on the newly created volume files\&.
Additionally, when new volumes are created with the \fBCREATEVOLS\fR command, vchanger will invoke bconsole and issue a \fIlabel barcodes\fR command to allow Bacula to write volume labels on the newly created volume files\&.
.SH "COMMAND LINE OPTIONS"
.PP
\fB\-u, \-\-user\fR=\fIuid\fR
@@ -195,7 +195,7 @@ See the vchangerHowto\&.html file included in the doc directory of the source di
\fBvchanger\&.conf(5)\fR
.SH "COPYRIGHT"
.sp
Copyright 2006\-2015 Josh Fisher
Copyright 2006\-2020 Josh Fisher
.sp
This is free software; See the source for copying conditions\&. There is NO warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE\&.
.SH "AUTHOR"

31
doc/vchanger.8.asciidoc
View File

@@ -3,7 +3,7 @@ VCHANGER(8)
Josh Fisher <jfisher@jaybus.com>
:doctype: manpage
:man source: vchanger
:man version: 1.0.1
:man version: 1.0.3
:man manual: vchanger Manual
NAME
@@ -27,9 +27,11 @@ DESCRIPTION
The *vchanger(8)* utility is used to emulate and control a virtual
autochanger within the Bacula network backup system environment.
Backup volumes stored on multiple disk filesystems are mapped to a
single set of virtual slots, allowing an unlimited number of virtual
drives for concurrent backup jobs and easy, unlimited scaling to any
size by simply adding additional disks/filesystems,
single set of virtual slots. This allows an unlimited number of
virtual drives and an unlimited number of virtual slots spread
across an unlimited number of physical disk drives to be assigned
to a single autochanger. This allows unlimited scaling of the cirtual
autochanger simply by adding additional disk drives.
Vchanger is primarily deigned for use with removable disk drives. Its
ability to interact with Bacula and determine removable drive mount
@@ -115,18 +117,19 @@ Additionally, the following extended commands are supported.
By default, vcahgner will invoke bconsole and issue commands to Bacula
when certain operator actions are needed. When anything happens that
changes the current set of volume files being used, vchanger will
invoke bconsole and issue an 'update slots' command. For example,
when the operator attaches a removable drive defined as one of the
changer's magazines, the volume files on the removable drive must be
mapped to virtual slots. Since the volume-to-slot mapping will have
changed, Bacula will need to be informed of the change via the
'update slots' command. The *REFRESH* command can be invoked to force
vchanger to update state info and trigger 'update slots' if needed.
changes the current set of volume files being used, (the virtual slot
to volume file mapping), vchanger will invoke bconsole and issue an
'update slots' command. For example, when the operator attaches a
removable drive defined as one of the changer's magazines, the volume
files on the removable drive must be mapped to virtual slots. Since
the slot-to-volume mapping will have changed, Bacula will need to be
informed of the change via the 'update slots' command. The *REFRESH*
command can be invoked to force vchanger to update state info and
trigger 'update slots' if needed.
Additionally, when new volumes are created with the *CREATEVOLS* command,
vchanger will invoke bconsole and issue a 'label barcodes' command to
write volume labels on the newly created volume files.
allow Bacula to write volume labels on the newly created volume files.
COMMAND LINE OPTIONS
--------------------
@@ -172,7 +175,7 @@ SEE ALSO
COPYRIGHT
---------
Copyright 2006-2015 Josh Fisher
Copyright 2006-2020 Josh Fisher
This is free software;
See the source for copying conditions.

8
doc/vchanger.conf.5
View File

@@ -2,12 +2,12 @@
.\" Title: vchanger.conf
.\" Author: Josh Fisher <jfisher@jaybus.com>
.\" Generator: DocBook XSL Stylesheets v1.78.1 <http://docbook.sf.net/>
.\" Date: 06/03/2015
.\" Date: 05/11/2020
.\" Manual: vchanger Manual
.\" Source: vchanger.conf 1.0.1
.\" Source: vchanger.conf 1.0.3
.\" Language: English
.\"
.TH "VCHANGER\&.CONF" "5" "06/03/2015" "vchanger\&.conf 1\&.0\&.1" "vchanger Manual"
.TH "VCHANGER\&.CONF" "5" "05/11/2020" "vchanger\&.conf 1\&.0\&.3" "vchanger Manual"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
@@ -134,7 +134,7 @@ See the vchangerHowto\&.html file included in the doc directory of the source di
\fBvchanger(8)\fR
.SH "COPYRIGHT"
.sp
Copyright 2006\-2015 Josh Fisher
Copyright 2006\-2020 Josh Fisher
.sp
This is free software; See the source for copying conditions\&. There is NO warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE\&.
.SH "AUTHOR"

4
doc/vchanger.conf.5.asciidoc
View File

@@ -3,7 +3,7 @@ VCHANGER.CONF(5)
Josh Fisher <jfisher@jaybus.com>
:doctype: manpage
:man source: vchanger.conf
:man version: 1.0.1
:man version: 1.0.3
:man manual: vchanger Manual
NAME
@@ -112,7 +112,7 @@ SEE ALSO
COPYRIGHT
---------
Copyright 2006-2015 Josh Fisher
Copyright 2006-2020 Josh Fisher
This is free software;
See the source for copying conditions.

3555
doc/vchangerHowto.html
View File

File diff suppressed because it is too large Load Diff