From b7a71e9daacff6c45dc790631abda1f20e311d2c Mon Sep 17 00:00:00 2001 From: Kern Sibbald Date: Mon, 29 Aug 2005 17:30:48 +0000 Subject: [PATCH] Update doc + add make release --- docs/Makefile | 4 ++-- docs/Makefile.in | 4 ++-- docs/README | 4 +++- docs/developers/version.tex | 2 +- docs/home-page/news.txt | 22 +++++++++++++++++ docs/manual-de/version.tex | 2 +- docs/manual/critical.tex | 47 ++++++++++++++++++++++++++++--------- docs/manual/dirdconf.tex | 24 +------------------ docs/manual/fileset.tex | 35 +++++++++++++++++---------- docs/manual/version.tex | 2 +- 10 files changed, 91 insertions(+), 55 deletions(-) diff --git a/docs/Makefile b/docs/Makefile index 57a3be81..00908a21 100644 --- a/docs/Makefile +++ b/docs/Makefile @@ -4,9 +4,9 @@ # autoconf/Make.common.in -*- Makefile -*- # release date (man), LSM date, version number/name, current maintainer -DATE="18 August 2005" +DATE="24 August 2005" LSMDATE=@LSMDATE@ -VERSION=1.37.36 +VERSION=1.37.37 VERNAME=bacula-$(VERSION)# MAINT=Kern Sibbald# MAINTEMAIL=# diff --git a/docs/Makefile.in b/docs/Makefile.in index d0b043c7..8a593c9c 100644 --- a/docs/Makefile.in +++ b/docs/Makefile.in @@ -79,7 +79,7 @@ install: uninstall: # -cd $(mandir); $(RMF) $(manprefix)bacula.$(manext) -distribution: +release: rm -rf bacula-doc-* mkdir -p bacula-doc-$(VERSION) cp -ap manual/bacula bacula-doc-$(VERSION)/web-manual @@ -93,5 +93,5 @@ distribution: tar cvfz bacula-doc-$(VERSION).tar.gz bacula-doc-$(VERSION) rm -rf bacula-doc-$(VERSION) @echo " " - @echo "Distribution document is in: bacula-doc-$(VERSION).tar.gz" + @echo "Release document is in: bacula-doc-$(VERSION).tar.gz" @echo " " diff --git a/docs/README b/docs/README index a22f2672..f6d4f612 100644 --- a/docs/README +++ b/docs/README @@ -58,8 +58,10 @@ developer's manual: To create a distribution tar file: cd + ./configure --with-bacula= + make clean make - make distribution + make release The output will be a .tar.gz file in the current directory with the name bacula-doc-.tar.gz diff --git a/docs/developers/version.tex b/docs/developers/version.tex index 44bdee0e..770fdddb 100644 --- a/docs/developers/version.tex +++ b/docs/developers/version.tex @@ -1 +1 @@ -1.37.36 (18 August 2005) +1.37.37 (24 August 2005) diff --git a/docs/home-page/news.txt b/docs/home-page/news.txt index 1d54f208..8d27ebe8 100644 --- a/docs/home-page/news.txt +++ b/docs/home-page/news.txt @@ -1,3 +1,25 @@ +Kern;;;2005/08/23;;;10:20 +Results to date of donations for the Data Encryption project +24 August 2005 + Donor: Amount: + WingNET Internet $500 + Timo Neuvonen $250 + Ed Grether $25 + Charles Reinehr $100 + Michael Proto $25 + Phil Cordier $100 + Dan Langille $100 + Tom Plancon $65 + Felix Schwarz $60 + ClarkConnect $500 + Goal: $3000 Total: $1,725 + +Note, the official list is kept by Landon at: + + http://landonf.bikemonkey.org/code/bacula + +Read on for details of the project. + Kern;;;2005/07/26;;;14:30 BACULA COMMUNITY NEWS RELEASE Backup Data Encryption Development Project diff --git a/docs/manual-de/version.tex b/docs/manual-de/version.tex index 44bdee0e..770fdddb 100644 --- a/docs/manual-de/version.tex +++ b/docs/manual-de/version.tex @@ -1 +1 @@ -1.37.36 (18 August 2005) +1.37.37 (24 August 2005) diff --git a/docs/manual/critical.tex b/docs/manual/critical.tex index 6a4a4fa8..de4d1549 100644 --- a/docs/manual/critical.tex +++ b/docs/manual/critical.tex @@ -20,7 +20,7 @@ product. If you follow the instructions in this chapter, you will have covered most of the major problems that can occur. It goes without saying that if you ever -find that we have left out an important point, please point it out to us, so +find that we have left out an important point, please inform us, so that we can document it to the benefit of everyone. \label{Critical} @@ -33,19 +33,21 @@ The following assumes that you have installed Bacula, you more or less understand it, you have at least worked through the tutorial or have equivalent experience, and that you have set up a basic production configuration. If you haven't done the above, please do so and then come back -here. The following is a sort of checklist that points you elsewhere in the -manual with perhaps a brief explanation of why you should do it. The order is -more or less the order you would use in setting up a production system (if you -already are in production, use the checklist anyway). +here. The following is a sort of checklist that points with perhaps a brief +explanation of why you should do it. You will find the details elsewhere in the +manual. The order is more or less the order you would use in setting up a +production system (if you already are in production, use the checklist anyway). \begin{itemize} -\item Test your tape drive with compatibility with Bacula by using the test +\item Test your tape drive for compatibility with Bacula by using the test command in the \ilink{btape}{btape} program. \item Better than doing the above is to walk through the nine steps in the \ilink{Tape Testing}{_ChapterStart27} chapter of the manual. It may take you a bit of time, but it will eliminate surprises. -\item Make sure that /lib/tls is disabled. Bacula does not work with this - library. See the second point under +\item Test your the end of tape handling of your tape drive by using the + fill command in the \ilink{btape}{btape} program. +\item If you are using a 2.4 kernel, make sure that /lib/tls is disabled. Bacula + does not work with this library. See the second point under \ilink{ Supported Operating Systems.}{SupportedOSes} \item Do at least one restore of files. If you backup both Unix and Win32 systems, restore files from each system type. The @@ -70,6 +72,8 @@ already are in production, use the checklist anyway). CDROM}{_ChapterStart38} chapter. It is trivial to make such a CDROM, and it can make system recovery in the event of a lost hard disk infinitely easier. +\item After doing your first backup restore some or all the data. Do this for + at least one client on each different OS (e.g. Linux, FreeBSD, Solaris, Win32). \end{itemize} \subsection*{Recommended Items} @@ -85,12 +89,33 @@ you avoid problems. \item After installing and experimenting with Bacula, read and work carefully through the examples in the \ilink{Tutorial}{_ChapterStart1} chapter of this manual. -\item Learn what each of the \ilink{Bacula Utility Programs}{_ChapterStart9} does. +\item Learn what each of the \ilink{Bacula Utility Programs}{_ChapterStart9} +does. \item Set up reasonable retention periods so that your catalog does not grow to be too big. See the following three chapters:\\ \ilink{Recycling your Volumes}{_ChapterStart22},\\ \ilink{Basic Volume Management}{_ChapterStart39},\\ \ilink{Using Pools to Manage Volumes}{_ChapterStart11}. \item Perform a bare metal recovery using the Bacula Rescue CDROM. See the - \ilink{Disaster Recovery Using a Bacula Rescue CDROM}{_ChapterStart38} chapter. - \end{itemize} + \ilink{Disaster Recovery Using a Bacula Rescue CDROM}{_ChapterStart38} + chapter. +\end{itemize} + +If you absolutely must implement a system where you write a different +tape each night and take it offsite in the morning. We recommend that you do +several things: +\begin{itemize} +\item Write a bootstrap file of your backed up data and a bootstrap file + of your catalog backup to a floppy disk or a CDROM, and take that with + the tape. If this is not possible, try to write those files to another + computer or offsite computer, or send them as email to a friend. If none + of that is possible, at least print the bootstrap files and take that + offsite with the tape. Having the bootstrap files will make recovery + much easier. +\item It is better not to force Bacula to load a particular tape each day. + Instead, let Bacula choose the tape. If you need to know what tape to + mount, you can print a list of recycled and appendable tapes daily, and + select any tape from that list. Bacula may propose a particular tape + for use that it considers optimal, but it will accept any valid tape + from the correct pool. +\end{itemize} diff --git a/docs/manual/dirdconf.tex b/docs/manual/dirdconf.tex index e45adae7..4b488775 100644 --- a/docs/manual/dirdconf.tex +++ b/docs/manual/dirdconf.tex @@ -895,7 +895,7 @@ program we believe that only the System environment will be available to bacula-fd, if it is running as a service.) - System environment variables can be called out using the \%var\% syntax and + System environment variables can be referenced with \%var\% and used as either part of the command name or arguments. When specifying a full path to an executable if the path or executable name @@ -2181,28 +2181,6 @@ directive (see above). We {\bf highly} recommend against using this directive, because it is sure that some day, Bacula will recycle a Volume that contains current data. -\item [Accept Any Volume = \lt{}yes|no\gt{}] - \index[dir]{Accept Any Volume } - This directive specifies whether or not any volume from the Pool may be -used -for backup. The default is {\bf yes} as of version 1.27 and later. If it is -{\bf no} then only the first writable volume in the Pool will be accepted for -writing backup data, thus Bacula will fill each Volume sequentially in turn -before using any other appendable volume in the Pool. If this is {\bf no} and -you mount a volume out of order, Bacula will not accept it. If this is {\bf -yes} any appendable volume from the pool mounted will be accepted. - -If your tape backup procedure dictates that you manually mount the next -volume, you will almost certainly want to be sure this directive is turned -on. - -If you are going on vacation and you think the current volume may not have -enough room on it, you can simply label a new tape and leave it in the drive, -and assuming that {\bf Accept Any Volume} is {\bf yes} Bacula will begin -writing on it. When you return from vacation, simply remount the last tape, -and Bacula will continue writing on it until it is full. Then you can remount - your vacation tape and Bacula will fill it in turn. - \item [Cleaning Prefix = \lt{}string\gt{}] \index[dir]{Cleaning Prefix } This directive defines a prefix string, which if it matches the beginning diff --git a/docs/manual/fileset.tex b/docs/manual/fileset.tex index 6051cc40..764c0fee 100644 --- a/docs/manual/fileset.tex +++ b/docs/manual/fileset.tex @@ -114,7 +114,7 @@ filesystem) will cause /usr to be backed up twice. In this case, on Bacula versions prior to 1.32f-5-09Mar04 due to a bug, you will not be able to restore hard linked files that were backed up twice. -If you have used Bacula prior to version 1.34.3, you will note three things in +If you have used Bacula prior to version 1.36.3, you will note three things in the new FileSet syntax: \begin{enumerate} @@ -154,6 +154,9 @@ the last Options resource. As a consequence, if you want a particular set of "default" options, you should put them in an Options resource after any other Options. +It is a good idea to put all your wild-card and regex expressions inside +double quotes to prevent conf file scanning problems. + This is perhaps a bit overwhelming, so there are a number of examples included below to illustrate how this works. @@ -392,6 +395,7 @@ The directives within an Options resource may be one of the following: Multiple wild-card directives may be specified, and they will be applied in turn until the first one that matches. Note, if you exclude a directory, no files or directories below it will be matched. + It is recommended to enclose the string in double quotes. \item [wildfile=\lt{}string\gt{}] \index[dir]{wildfile } @@ -402,6 +406,7 @@ The directives within an Options resource may be one of the following: which files are to be excluded. Multiple wild-card directives may be specified, and they will be applied in turn until the first one that matches. + It is recommended to enclose the string in double quotes. \item [wilddir=\lt{}string\gt{}] \index[dir]{wilddir } @@ -413,6 +418,7 @@ The directives within an Options resource may be one of the following: specified, and they will be applied in turn until the first one that matches. Note, if you exclude a directory, no files or directories below it will be matched. + It is recommended to enclose the string in double quotes. \item [regex=\lt{}string\gt{}] @@ -426,6 +432,7 @@ The directives within an Options resource may be one of the following: specified within an Options resource, and they will be applied in turn until the first one that matches. Note, if you exclude a directory, no files or directories below it will be matched. + It is recommended to enclose the string in double quotes. \item [regexfile=\lt{}string\gt{}] \index[dir]{regexfile } @@ -436,6 +443,7 @@ The directives within an Options resource may be one of the following: which files are to be excluded. Multiple regex directives may be specified, and they will be applied in turn until the first one that matches. + It is recommended to enclose the string in double quotes. \item [regexdir=\lt{}string\gt{}] \index[dir]{regexdir } @@ -447,6 +455,7 @@ The directives within an Options resource may be one of the following: regex directives may be specified, and they will be applied in turn until the first one that matches. Note, if you exclude a directory, no files or directories below it will be matched. + It is recommended to enclose the string in double quotes. \item [exclude=yes|no] \index[dir]{exclude } @@ -731,8 +740,8 @@ FileSet { } Include { Options { - wildfile = *.o - wildfile = *.exe + wildfile = "*.o" + wildfile = "*.exe" Exclude = yes } File = /root/myfile @@ -768,8 +777,8 @@ FileSet { } Include { Options { - wildfile = *.o - wildfile = *.exe + wildfile = "*.o" + wildfile = "*.exe" Exclude = yes } File = /root/myfile @@ -833,8 +842,8 @@ FileSet { Options { wilddir = /proc wilddir = /tmp - wildfile = \.journal - wildfile = \.autofsck + wildfile = ".journal" + wildfile = ".autofsck" exclude = yes } File = / @@ -864,8 +873,8 @@ FileSet { Name = "Full Set" Include { !!!!!!!!!!!! Options { This - wildfile = *.Z example - wildfile = *.gz doesn't + wildfile = "*.Z" example + wildfile = "*.gz" doesn't Include = yes work } !!!!!!!!!!!! File = /myfile @@ -887,8 +896,8 @@ FileSet { Name = "Full Set" Include { Options { - wildfile = *.Z - wildfile = *.gz + wildfile = "*.Z" + wildfile = "*.gz" Include = yes } Options { @@ -1016,8 +1025,8 @@ FileSet { Name = "Windows Set" Include { Options { - WildFile = *.obj - WildFile = *.exe + WildFile = "*.obj" + WildFile = "*.exe" exclude = yes } File = "c:/My Documents" diff --git a/docs/manual/version.tex b/docs/manual/version.tex index 44bdee0e..770fdddb 100644 --- a/docs/manual/version.tex +++ b/docs/manual/version.tex @@ -1 +1 @@ -1.37.36 (18 August 2005) +1.37.37 (24 August 2005) -- 2.39.5