From: <ri...@us...> - 2007-02-19 17:20:55
|
Revision: 4210 http://bacula.svn.sourceforge.net/bacula/?rev=4210&view=rev Author: ricozz Date: 2007-02-19 09:20:55 -0800 (Mon, 19 Feb 2007) Log Message: ----------- ebl add RecyclePool notes Modified Paths: -------------- trunk/docs/manual/console.tex trunk/docs/manual/dirdconf.tex trunk/docs/manual/recycling.tex Modified: trunk/docs/manual/console.tex =================================================================== --- trunk/docs/manual/console.tex 2007-02-19 17:18:58 UTC (rev 4209) +++ trunk/docs/manual/console.tex 2007-02-19 17:20:55 UTC (rev 4210) @@ -1196,6 +1196,7 @@ Maximum Volume Files Maximum Volume Bytes Recycle Flag + Recycle Pool Slot InChanger Flag Pool @@ -1227,8 +1228,9 @@ existing pool to the pool specified. For {\bf Volume from Pool} and {\bf All Volumes from Pool}, the - following values are updated from the Pool record: Recycle, + following values are updated from the Pool record: Recycle, RecyclePool, VolRetention, VolUseDuration, MaxVolJobs, MaxVolFiles, and MaxVolBytes. + (RecyclePool feature is available with bacula 2.1.4 or higher.) The full form of the update command with all command line arguments is: @@ -1236,7 +1238,7 @@ \begin{verbatim} update volume=xxx pool=yyy slots volstatus=xxx VolRetention=ddd VolUse=ddd MaxVolJobs=nnn MaxVolBytes=nnn Recycle=yes|no - slot=nnn enabled=n + slot=nnn enabled=n recyclepool=zzz \end{verbatim} \normalsize Modified: trunk/docs/manual/dirdconf.tex =================================================================== --- trunk/docs/manual/dirdconf.tex 2007-02-19 17:18:58 UTC (rev 4209) +++ trunk/docs/manual/dirdconf.tex 2007-02-19 17:20:55 UTC (rev 4210) @@ -2484,6 +2484,14 @@ created, changing the value in the bacula-dir.conf file will not change what is stored for the Volume. To change the value for an existing Volume you must use the {\bf update} command in the Console. + +\label{PoolRecyclePool} +\item [RecyclePool = \lt{}pool-resource-name\gt{}] + \index[dir]{RecyclePool} + \index[dir]{Directive!RecyclePool} + + On versions 2.1.4 or greater, Bacula can recycle media in the pool of your + choice. The most useful setup is to use \ilink{Scratch}{TheScratchPool}. \label{PoolRecycle} \item [Recycle = \lt{}yes|no\gt{}] @@ -2667,6 +2675,7 @@ \normalsize \subsection{The Scratch Pool} +\label{TheScratchPool} \index[general]{Scratch Pool} In general, you can give your Pools any name you wish, but there is one important restriction: the Pool named {\bf Scratch}, if it exists behaves Modified: trunk/docs/manual/recycling.tex =================================================================== --- trunk/docs/manual/recycling.tex 2007-02-19 17:18:58 UTC (rev 4209) +++ trunk/docs/manual/recycling.tex 2007-02-19 17:20:55 UTC (rev 4210) @@ -29,14 +29,15 @@ By properly defining your Volume Pools with appropriate Retention periods, Bacula can manage the recycling (such as defined above) automatically. -Automatic recycling of Volumes is controlled by three records in the {\bf -Pool} resource definition in the Director's configuration file. These three +Automatic recycling of Volumes is controlled by four records in the {\bf +Pool} resource definition in the Director's configuration file. These four records are: \begin{itemize} \item AutoPrune = yes \item VolumeRetention = \lt{}time\gt{} -\item Recycle = yes +\item Recycle = yes +\item RecyclePool = \lt{}APool\gt{} (\textit{This require bacula 2.1.4 or greater}) \end{itemize} The above three directives are all you need assuming that you fill This was sent by the SourceForge.net collaborative development platform, the world's largest Open Source development site. |
From: <ri...@us...> - 2007-02-24 22:13:59
|
Revision: 4240 http://bacula.svn.sourceforge.net/bacula/?rev=4240&view=rev Author: ricozz Date: 2007-02-24 14:13:57 -0800 (Sat, 24 Feb 2007) Log Message: ----------- ebl update with Fifo virtual device (to test backup) Modified Paths: -------------- trunk/docs/manual/faq.tex trunk/docs/manual/storedconf.tex Modified: trunk/docs/manual/faq.tex =================================================================== --- trunk/docs/manual/faq.tex 2007-02-24 21:55:19 UTC (rev 4239) +++ trunk/docs/manual/faq.tex 2007-02-24 22:13:57 UTC (rev 4240) @@ -360,6 +360,24 @@ explain how to write to disk, but was expanded to include volume management. It is, however, still quite a good chapter to read. +\label{testbackup} +\section{Can i use Dummy device to test backup?} + Yes, to have a {\sl Virtual} device which just drop data, you can use a + Fifo Device (see \ilink{Stored configuration}{SetupFifo}), and you have to + run this script. It's useful to test backup. +\footnotesize +\begin{verbatim} +#!/bin/sh + +[! -p /tmp/fifo ] && mkfifo /tmp/fifo + +while cat /tmp/fifo > /dev/null +do + true # do nothing +done +\end{verbatim} +\normalsize + \label{bigfiles} \section{Can Bacula Backup and Restore Files Greater than 2 Gigabytes?} \item [Can Bacula Backup and Restore Files Greater than 2 Gigabytes in Modified: trunk/docs/manual/storedconf.tex =================================================================== --- trunk/docs/manual/storedconf.tex 2007-02-24 21:55:19 UTC (rev 4239) +++ trunk/docs/manual/storedconf.tex 2007-02-24 22:13:57 UTC (rev 4240) @@ -285,7 +285,7 @@ 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. - + \label{SetupFifo} In addition to a tape device name or a directory name, Bacula will accept the name of a FIFO. 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 @@ -299,8 +299,25 @@ set it to {\bf No}. Since a FIFO is a one way device, Bacula will not attempt to read a label of a FIFO device, but will simply write on it. To create a FIFO Volume in the catalog, use the {\bf add} command rather than then {\bf - label} command to avoid attempting to write a label. - + label} command to avoid attempting to write a label. + +\footnotesize +\begin{verbatim} +Device { + Name = FifoStorage + Media Type = Fifo + Device Type = Fifo + Archive Device = /tmp/fifo + LabelMedia = yes + Random Access = no + AutomaticMount = no + RemovableMedia = no + MaximumOpenWait = 60 + AlwaysOpen = no +} +\end{verbatim} +\normalsize + During a restore operation, if the Archive Device is a FIFO, Bacula will attempt to read from the FIFO, so you must have an external program that writes into the FIFO. Bacula will wait {\bf MaximumOpenWait} seconds for the This was sent by the SourceForge.net collaborative development platform, the world's largest Open Source development site. |
From: <ke...@us...> - 2007-02-26 20:29:28
|
Revision: 4269 http://bacula.svn.sourceforge.net/bacula/?rev=4269&view=rev Author: kerns Date: 2007-02-26 12:29:25 -0800 (Mon, 26 Feb 2007) Log Message: ----------- Fix a couple of typos Modified Paths: -------------- trunk/docs/manual/faq.tex trunk/docs/manual/storedconf.tex Modified: trunk/docs/manual/faq.tex =================================================================== --- trunk/docs/manual/faq.tex 2007-02-26 20:28:56 UTC (rev 4268) +++ trunk/docs/manual/faq.tex 2007-02-26 20:29:25 UTC (rev 4269) @@ -361,10 +361,10 @@ management. It is, however, still quite a good chapter to read. \label{testbackup} -\section{Can i use Dummy device to test backup?} - Yes, to have a {\sl Virtual} device which just drop data, you can use a - Fifo Device (see \ilink{Stored configuration}{SetupFifo}). - It's useful to test backup. +\section{Can I use a dummy device to test the backup?} + Yes, to have a {\sl Virtual} device which just consumes data, you can use a + FIFO device (see \ilink{Stored configuration}{SetupFifo}). + It's useful to test a backup. \footnotesize \begin{verbatim} Device { @@ -383,13 +383,12 @@ \normalsize \label{bigfiles} -\section{Can Bacula Backup and Restore Files Greater than 2 Gigabytes?} -\item [Can Bacula Backup and Restore Files Greater than 2 Gigabytes in - Size? ] +\section{Can Bacula Backup and Restore Files Bigger than 2 Gigabytes?} +\item [Can Bacula Backup and Restore Files Bigger than 2 Gigabytes?] \index[general]{Large file support} If your operating system permits it, and you are running Bacula version 1.26 or later, the answer is yes. To the best of our knowledge all client -system supported by Bacula can handle files larger than 2 Gigabytes. +system supported by Bacula can handle files bigger 2 Gigabytes. \label{cancel} \section{I want to stop a job.} @@ -415,9 +414,9 @@ in all respects with the program defined here. \label{docversion} -\section{Why is Your Online Document for Version 1.39 but the Released Version is 1.38?} -\item [Why is Your Online Document for Version 1.39 of Bacula when the - Currently Release Version is 1.38?] +\section{Why is the Online Document for Version 1.39 but the Released Version is 1.38?} +\item [Why is the Online Document for Version 1.39 of Bacula when the + Current Version is 1.38?] \index[general]{Multiple manuals} As Bacula is being developed, the document is also being enhanced, more often than not it has clarifications of existing features that can be very Modified: trunk/docs/manual/storedconf.tex =================================================================== --- trunk/docs/manual/storedconf.tex 2007-02-26 20:28:56 UTC (rev 4268) +++ trunk/docs/manual/storedconf.tex 2007-02-26 20:29:25 UTC (rev 4269) @@ -298,7 +298,7 @@ the Storage daemon to open it only when a job starts, so you must explicitly set it to {\bf No}. Since a FIFO is a one way device, Bacula will not attempt to read a label of a FIFO device, but will simply write on it. To create a - FIFO Volume in the catalog, use the {\bf add} command rather than then {\bf + FIFO Volume in the catalog, use the {\bf add} command rather than the {\bf label} command to avoid attempting to write a label. \footnotesize This was sent by the SourceForge.net collaborative development platform, the world's largest Open Source development site. |
From: <ke...@us...> - 2007-03-03 07:47:33
|
Revision: 4295 http://bacula.svn.sourceforge.net/bacula/?rev=4295&view=rev Author: kerns Date: 2007-03-02 23:47:32 -0800 (Fri, 02 Mar 2007) Log Message: ----------- Update Modified Paths: -------------- trunk/docs/manual/autochangers.tex trunk/docs/manual/dirdconf.tex trunk/docs/manual/dvd.tex trunk/docs/manual/storedconf.tex trunk/docs/manual/supportedchangers.tex trunk/docs/manual/win32.tex Modified: trunk/docs/manual/autochangers.tex =================================================================== --- trunk/docs/manual/autochangers.tex 2007-03-02 18:02:46 UTC (rev 4294) +++ trunk/docs/manual/autochangers.tex 2007-03-03 07:47:32 UTC (rev 4295) @@ -60,10 +60,10 @@ just a question of adapting the {\bf mtx-changer} script (or selecting one already adapted) for proper interfacing. You can find a list of autochangers supported by {\bf mtx} at the following link: -\elink{http://mtx.badtux.net/compatibility.php} -{http://mtx.badtux.net/compatibility.php}. +\elink{http://mtx.opensource-sw.net/compatibility.php} +{http://mtx.opensource-sw.net/compatibility.php}. The home page for the {\bf mtx} project can be found at: -\elink{http://mtx.badtux.net/}{http://mtx.badtux.net/}. +\elink{http://mtx.opensource-sw.net/}{http://mtx.opensource-sw.net/}. If you are having troubles, please use the {\bf auto} command in the {\bf btape} program to test the functioning of your autochanger with Bacula. When Modified: trunk/docs/manual/dirdconf.tex =================================================================== --- trunk/docs/manual/dirdconf.tex 2007-03-02 18:02:46 UTC (rev 4294) +++ trunk/docs/manual/dirdconf.tex 2007-03-03 07:47:32 UTC (rev 4295) @@ -2366,6 +2366,10 @@ after recycling. This value is checked and the {\bf Used} status set while the job is writing to the particular volume. + This directive is particularly useful for restricting the size + of disk volumes, and will work correctly even in the case of + multiple simultaneous jobs writing to the volume. + The value defined by this directive in the bacula-dir.conf file is the default value used when a Volume is created. Once the volume is created, changing the value in the bacula-dir.conf file will not change @@ -2403,8 +2407,12 @@ The use duration is checked and the {\bf Used} status is set only at the end of a job that writes to the particular volume, which means that even though the use duration may have expired, the catalog entry will not be - updated until the next job that uses this volume is run. - + updated until the next job that uses this volume is run. This + directive is not intended to be used to limit volume sizes + and will not work correctly (i.e. will fail jobs) if the use + duration expires while multiple simultaneous jobs are writing + to the volume. + Please note that the value defined by this directive in the bacula-dir.conf file is the default value used when a Volume is created. Once the volume is created, changing the value in the bacula-dir.conf file will not change what @@ -2440,13 +2448,14 @@ \index[dir]{Volume Retention} \index[dir]{Directive!Volume Retention} The Volume Retention directive defines the length of time that {\bf - Bacula} will keep Job and Files records associated with the Volume in + Bacula} will keep records associated with the Volume in the Catalog database after the End time of each Job written to the Volume. When this time period expires, and if {\bf AutoPrune} is set to {\bf yes} Bacula may prune (remove) Job records that are older than the specified Volume Retention period if it is necessary to free up a Volume. Recycling will not occur until it is absolutely necessary to - free up a volume. All File records associated with pruned Jobs are also + free up a volume (i.e. no other writable volume exists). + All File records associated with pruned Jobs are also pruned. The time may be specified as seconds, minutes, hours, days, weeks, months, quarters, or years. The {\bf Volume Retention} is applied independently of the {\bf Job Retention} and the {\bf File @@ -2462,10 +2471,6 @@ Bacula does not automatically recycle a Volume. It attempts to keep the Volume data intact as long as possible before over writing the Volume. - The default Volume retention period is 365 days. Note, this directive - sets the default value for each Volume entry in the Catalog when the - Volume is created. The value in the catalog may be later individually - changed for each Volume using the Console program. By defining multiple Pools with different Volume Retention periods, you may effectively have a set of tapes that is recycled weekly, another @@ -2479,11 +2484,12 @@ This means that if you do a Full backup once a month, the minimum Volume retention period should be two months. - Please note that the value defined by this directive in the bacula-dir.conf - file is the default value used when a Volume is created. Once the volume is - created, changing the value in the bacula-dir.conf file will not change what - is stored for the Volume. To change the value for an existing Volume you - must use the {\bf update} command in the Console. + The default Volume retention period is 365 days, and either the default + or the value defined by this directive in the bacula-dir.conf file is + the default value used when a Volume is created. Once the volume is + created, changing the value in the bacula-dir.conf file will not change + what is stored for the Volume. To change the value for an existing + Volume you must use the {\bf update} command in the Console. \label{PoolRecyclePool} \item [RecyclePool = \lt{}pool-resource-name\gt{}] Modified: trunk/docs/manual/dvd.tex =================================================================== --- trunk/docs/manual/dvd.tex 2007-03-02 18:02:46 UTC (rev 4294) +++ trunk/docs/manual/dvd.tex 2007-03-03 07:47:32 UTC (rev 4295) @@ -162,6 +162,17 @@ {\bf /dev/dvd} depending on your system. It will not be a name such as {\bf /mnt/cdrom}. +Finally, for {\bf growisofs} to work, it must be able to lock +a certain amount of memory in RAM. If you have restrictions on +this function, you may have failures. Under {\bf bash}, you can +set this with the following command: + +\footnotesize +\begin{verbatim} +ulimit -l unlimited +\end{verbatim} +\normalsize + \section{Edit Codes for DVD Directives} \index[general]{Directives!DVD Edit Codes} \index[general]{Edit Codes for DVD Directives } Modified: trunk/docs/manual/storedconf.tex =================================================================== --- trunk/docs/manual/storedconf.tex 2007-03-02 18:02:46 UTC (rev 4294) +++ trunk/docs/manual/storedconf.tex 2007-03-03 07:47:32 UTC (rev 4295) @@ -83,15 +83,26 @@ \index[sd]{Directive!Heartbeat Interval} \index[general]{Heartbeat Interval} \index[general]{Broken pipe} - This directive defines an interval of time. When the Storage daemon is - waiting for the operator to mount a tape, each time interval, it will - send a heartbeat signal to the File daemon. The default interval is - zero which disables the heartbeat. This feature is particularly useful - if you have a router such as 3Com that does not follow Internet - standards and times out an valid connection after a short duration - despite the fact that keepalive is set. This usually results - in a broken pipe error message. + This directive defines an interval of time in seconds. When + the Storage daemon is waiting for the operator to mount a + tape, each time interval, it will send a heartbeat signal to + the File daemon. The default interval is zero which disables + the heartbeat. This feature is particularly useful if you + have a router such as 3Com that does not follow Internet + standards and times out an valid connection after a short + duration despite the fact that keepalive is set. This usually + results in a broken pipe error message. +\item [Client Connect Wait = \lt{}time-interval\gt{}] + \index[sd]{Connect Wait} + \index[sd]{Directive!Connect Wait} + \index[general]{Client Connect Wait} + This directive defines an interval of time in seconds that + the Storage daemon will wait for a Client (the File daemon) + to connect. The default is 30 seconds. Be aware that the + longer the Storage daemon waits for a Client, the more + resources will be tied up. + \item [Maximum Concurrent Jobs = \lt{}number\gt{}] \index[sd]{Maximum Concurrent Jobs} \index[sd]{Directive!Maximum Concurrent Jobs} Modified: trunk/docs/manual/supportedchangers.tex =================================================================== --- trunk/docs/manual/supportedchangers.tex 2007-03-02 18:02:46 UTC (rev 4294) +++ trunk/docs/manual/supportedchangers.tex 2007-03-03 07:47:32 UTC (rev 4295) @@ -13,7 +13,18 @@ Capacity/Slot column below, I quote the Compressed capacity per tape (or Slot). +Since on most systems (other than FreeBSD), Bacula uses {\bf mtx} +through the {\bf mtx-changer} script, in principle, if {\bf mtx} +will operate your changer correctly, then it is just a question +of adapting the {\bf mtx-changer} script (or selecting one +already adapted) for proper interfacing. You can find a list of +autochangers supported by {\bf mtx} at the following link: +\elink{http://mtx.opensource-sw.net/compatibility.php} +{http://mtx.opensource-sw.net/compatibility.php}. +The home page for the {\bf mtx} project can be found at: +\elink{http://mtx.opensource-sw.net/}{http://mtx.opensource-sw.net/}. + \addcontentsline{lot}{table}{Autochangers Known to Work with Bacula} \begin{longtable}{|p{0.6in}|p{0.8in}|p{1.9in}|p{0.8in}|p{0.5in}|p{0.75in}|} \hline Modified: trunk/docs/manual/win32.tex =================================================================== --- trunk/docs/manual/win32.tex 2007-03-02 18:02:46 UTC (rev 4294) +++ trunk/docs/manual/win32.tex 2007-03-03 07:47:32 UTC (rev 4295) @@ -176,6 +176,11 @@ \index[general]{Win32!Dealing with Problems} \index[general]{Dealing with Win32 Problems} +Sometimes Win32 machines the File daemon may have very slow +backup transfer rates compared to other machines. To you might +try setting the Maximum Network Buffer Size to 32,768 in both the +File daemon and in the Storage daemon. + If you are not using the portable option, and you have VSS (Volume Shadow Copy) enabled in the Director, and you experience problems with Bacula not being able to open files, it is most This was sent by the SourceForge.net collaborative development platform, the world's largest Open Source development site. |
From: <ke...@us...> - 2007-04-24 19:29:21
|
Revision: 4620 http://bacula.svn.sourceforge.net/bacula/?rev=4620&view=rev Author: kerns Date: 2007-04-24 12:29:22 -0700 (Tue, 24 Apr 2007) Log Message: ----------- Some doc updates Modified Paths: -------------- trunk/docs/manual/bootstrap.tex trunk/docs/manual/dirdconf.tex trunk/docs/manual/progs.tex trunk/docs/manual/restore.tex trunk/docs/manual/rpm-faq.tex trunk/docs/manual/supportedoses.tex trunk/docs/manual/win32.tex Modified: trunk/docs/manual/bootstrap.tex =================================================================== --- trunk/docs/manual/bootstrap.tex 2007-04-24 16:56:21 UTC (rev 4619) +++ trunk/docs/manual/bootstrap.tex 2007-04-24 19:29:22 UTC (rev 4620) @@ -16,13 +16,14 @@ Jobs, and thus you will never need to know the details of this file. The {\bf bootstrap} file contains ASCII information that permits precise -specification of what files should be restored. It is a relatively compact +specification of what files should be restored, what volume they are on, +and where they are on the volume. It is a relatively compact form of specifying the information, is human readable, and can be edited with any text editor. -\section{File Format} -\index[general]{Format!File } -\index[general]{File Format } +\section{Bootstrap File Format} +\index[general]{Format!Bootstrap} +\index[general]{Bootstrap File Format } The general format of a {\bf bootstrap} file is: @@ -63,98 +64,108 @@ \begin{description} \item [Volume] - \index[fd]{Volume } - The value field specifies what Volume the following commands apply to. Each -Volume specification becomes the current Volume, to which all the following -commands apply until a new current Volume (if any) is specified. If the -Volume name contains spaces, it should be enclosed in quotes. + \index[general]{Volume } + The value field specifies what Volume the following commands apply to. + Each Volume specification becomes the current Volume, to which all the + following commands apply until a new current Volume (if any) is + specified. If the Volume name contains spaces, it should be enclosed in + quotes. At lease one Volume specification is required. \item [Count] - \index[fd]{Count } + \index[general]{Count} The value is the total number of files that will be restored for this Volume. -This allows the Storage daemon to know when to stop reading the Volume. + This allows the Storage daemon to know when to stop reading the Volume. + This value is optional. \item [VolFile] - \index[fd]{VolFile } - The value is a file number, a list of file numbers, or a range of file -numbers to match on the current Volume. The file number represents -the physical file on the Volume where the data is stored. For a tape volume, -this record is used to position to the correct starting file, and once the -tape is past the last specified file, reading will stop. + \index[general]{VolFile} + The value is a file number, a list of file numbers, or a range of file + numbers to match on the current Volume. The file number represents the + physical file on the Volume where the data is stored. For a tape + volume, this record is used to position to the correct starting file, + and once the tape is past the last specified file, reading will stop. \item [VolBlock] - \index[fd]{VolBlock } - The value is a block number, a list of block numbers, or a range of block -numbers to match on the current Volume. The block number represents -the physical block on the Volume where the data is stored. This record is -currently not used. + \index[general]{VolBlock} + The value is a block number, a list of block numbers, or a range of + block numbers to match on the current Volume. The block number + represents the physical block within the file on the Volume where the + data is stored. + \item [VolSessionTime] - \index[fd]{VolSessionTime } + \index[general]{VolSessionTime } The value specifies a Volume Session Time to be matched from the current -volume. + volume. \item [VolSessionId] - \index[fd]{VolSessionId } - The value specifies a VolSessionId, a list of volume session ids, or a range -of volume session ids to be matched from the current Volume. Each -VolSessionId and VolSessionTime pair corresponds to a unique Job that is -backed up on the Volume. + \index[general]{VolSessionId } + The value specifies a VolSessionId, a list of volume session ids, or a + range of volume session ids to be matched from the current Volume. Each + VolSessionId and VolSessionTime pair corresponds to a unique Job that is + backed up on the Volume. \item [JobId] - \index[fd]{JobId } + \index[general]{JobId } The value specifies a JobId, list of JobIds, or range of JobIds to be -selected from the current Volume. Note, the JobId may not be unique if you -have multiple Directors, or if you have reinitialized your database. The -JobId filter works only if you do not run multiple simultaneous jobs. + selected from the current Volume. Note, the JobId may not be unique if you + have multiple Directors, or if you have reinitialized your database. The + JobId filter works only if you do not run multiple simultaneous jobs. + This value is optional and not used by Bacula to restore files. \item [Job] - \index[fd]{Job } + \index[general]{Job } The value specifies a Job name or list of Job names to be matched on the -current Volume. The Job corresponds to a unique VolSessionId and -VolSessionTime pair. However, the Job is perhaps a bit more readable by -humans. Standard regular expressions (wildcards) may be used to match Job -names. The Job filter works only if you do not run multiple simultaneous -jobs. + current Volume. The Job corresponds to a unique VolSessionId and + VolSessionTime pair. However, the Job is perhaps a bit more readable by + humans. Standard regular expressions (wildcards) may be used to match Job + names. The Job filter works only if you do not run multiple simultaneous + jobs. + This value is optional and not used by Bacula to restore files. \item [Client] - \index[fd]{Client } + \index[general]{Client } The value specifies a Client name or list of Clients to will be matched on -the current Volume. Standard regular expressions (wildcards) may be used to -match Client names. The Client filter works only if you do not run multiple -simultaneous jobs. + the current Volume. Standard regular expressions (wildcards) may be used to + match Client names. The Client filter works only if you do not run multiple + simultaneous jobs. + This value is optional and not used by Bacula to restore files. \item [FileIndex] - \index[fd]{FileIndex } + \index[general]{FileIndex } The value specifies a FileIndex, list of FileIndexes, or range of FileIndexes -to be selected from the current Volume. Each file (data) stored on a Volume -within a Session has a unique FileIndex. For each Session, the first file -written is assigned FileIndex equal to one and incremented for each file -backed up. + to be selected from the current Volume. Each file (data) stored on a Volume + within a Session has a unique FileIndex. For each Session, the first file + written is assigned FileIndex equal to one and incremented for each file + backed up. -This for a given Volume, the triple VolSessionId, VolSessionTime, and -FileIndex uniquely identifies a file stored on the Volume. Multiple copies of -the same file may be stored on the same Volume, but for each file, the triple -VolSessionId, VolSessionTime, and FileIndex will be unique. This triple is -stored in the Catalog database for each file. + This for a given Volume, the triple VolSessionId, VolSessionTime, and + FileIndex uniquely identifies a file stored on the Volume. Multiple copies of + the same file may be stored on the same Volume, but for each file, the triple + VolSessionId, VolSessionTime, and FileIndex will be unique. This triple is + stored in the Catalog database for each file. + To restore a particular file, this value (or a range of FileIndexes) is + required. + \item [Slot] - \index[fd]{Slot } + \index[general]{Slot } The value specifies the autochanger slot. There may be only a single {\bf -Slot} specification for each Volume. + Slot} specification for each Volume. \item [Stream] - \index[fd]{Stream } + \index[general]{Stream } The value specifies a Stream, a list of Streams, or a range of Streams to be -selected from the current Volume. Unless you really know what you are doing -(the internals of {\bf Bacula}, you should avoid this specification. + selected from the current Volume. Unless you really know what you are doing + (the internals of {\bf Bacula}, you should avoid this specification. + This value is optional and not used by Bacula to restore files. \item [*JobType] - \index[fd]{*JobType } + \index[general]{*JobType } Not yet implemented. \item [*JobLevel] - \index[fd]{*JobLevel } + \index[general]{*JobLevel } Not yet implemented. \end{description} Modified: trunk/docs/manual/dirdconf.tex =================================================================== --- trunk/docs/manual/dirdconf.tex 2007-04-24 16:56:21 UTC (rev 4619) +++ trunk/docs/manual/dirdconf.tex 2007-04-24 19:29:22 UTC (rev 4620) @@ -368,6 +368,12 @@ example, no File database entries are generated since no Files are saved. + {\bf Restore} jobs cannot be + automatically started by the scheduler as is the case for Backup, Verify + and Admin jobs. To restore files, you must use the {\bf restore} command + in the console. + + \item [Verify] \index[dir]{Verify} Run a verify Job. In general, {\bf verify} jobs permit you to compare the Modified: trunk/docs/manual/progs.tex =================================================================== --- trunk/docs/manual/progs.tex 2007-04-24 16:56:21 UTC (rev 4619) +++ trunk/docs/manual/progs.tex 2007-04-24 19:29:22 UTC (rev 4620) @@ -328,7 +328,10 @@ Please note that one of the current limitations of bextract is that it will not restore access control lists (ACL) that have been backed up along -with the file data. +with the file data, also the command line length is relatively limited, +which means that you cannot enter a huge number of volumes. If you need to +enter more volumes than the command line supports, please use a bootstrap +file (see below). It is called: @@ -432,7 +435,8 @@ command line by separating them with a vertical bar. See the section above under the {\bf bls} program entitled {\bf Listing Multiple Volumes} for more information. The same techniques apply equally well to the {\bf bextract} -program. +program or read the \ilink{Bootstrap}{BootstrapChapter} +chapter of this document. \section{bscan} \label{bscan} @@ -1018,7 +1022,8 @@ \footnotesize \begin{verbatim} -Usage: dbcheck [-c config] [-C catalog name] [-d debug_level] [] +Usage: dbcheck [-c config] [-C catalog name] [-d debug_level] +<working-directory> <bacula-database> <user> <password> [<dbhost>] -b batch mode -C catalog name in the director conf file -c director conf filename Modified: trunk/docs/manual/restore.tex =================================================================== --- trunk/docs/manual/restore.tex 2007-04-24 16:56:21 UTC (rev 4619) +++ trunk/docs/manual/restore.tex 2007-04-24 19:29:22 UTC (rev 4620) @@ -1,24 +1,25 @@ %% %% - -\section*{The Bacula Console Restore Command} +\chapter{The Restore Command} \label{RestoreChapter} -\index[general]{Command!Bacula Console Restore } -\index[general]{Bacula Console Restore Command } +\index[general]{Command!Console Restore} +\index[general]{Console Restore Command} \section{General} \index[general]{General } Below, we will discuss restoring files with the Console {\bf restore} command, -which is the recommended way of doing it. However, there is a standalone -program named {\bf bextract}, which also permits restoring files. For more -information on this program, please see the -\ilink{Bacula Utility Programs}{bextract} chapter of this manual. -You will also want to look at the {\bf bls} program in the same chapter, which -allows you to list the contents of your Volumes. Finally, if you have an old -Volume that is no longer in the catalog, you can restore the catalog entries -using the program named {\bf bscan}, documented in the same -\ilink{Bacula Utility Programs}{bextract} chapter. +which is the recommended way of doing restoring files. It is not possible +to restore files by automatically starting a job as you do with Backup, +Verify, ... jobs. However, in addition to the console restore command, +there is a standalone program named {\bf bextract}, which also permits +restoring files. For more information on this program, please see the +\ilink{Bacula Utility Programs}{bextract} chapter of this manual. You will +also want to look at the {\bf bls} program in the same chapter, which +allows you to list the contents of your Volumes. Finally, if you have an +old Volume that is no longer in the catalog, you can restore the catalog +entries using the program named {\bf bscan}, documented in the same +\ilink{Bacula Utility Programs}{bextract} chapter. In general, to restore a file or a set of files, you must run a {\bf restore} job. That is a job with {\bf Type = Restore}. As a consequence, you will need @@ -44,8 +45,8 @@ \label{Example1} \section{The Restore Command} -\index[general]{Command!Restore } -\index[general]{Restore Command } +\index[general]{Command!Restore} +\index[general]{Restore Command} Since Bacula maintains a catalog of your files and on which Volumes (disk or tape), they are stored, it can do most of the bookkeeping work, allowing you Modified: trunk/docs/manual/rpm-faq.tex =================================================================== --- trunk/docs/manual/rpm-faq.tex 2007-04-24 16:56:21 UTC (rev 4619) +++ trunk/docs/manual/rpm-faq.tex 2007-04-24 19:29:22 UTC (rev 4620) @@ -205,7 +205,15 @@ \item \label{faq8} - {\bf I just upgraded from 1.36.x to 1.38.x and now my director daemon won't start. It appears to start but dies silently and I get a "connection refused" error when starting the console. What is wrong?} Beginning with 1.38 the rpm packages are configured to run the director and storage daemons as a non-root user. The file daemon runs as user root and group bacula, the storage daemon as user bacula and group disk, and the director as user bacula and group bacula. If you are upgrading you will need to change some file permissions for things to work. Execute the following commands as root: + {\bf I just upgraded from 1.36.x to 1.38.x and now my director daemon +won't start. It appears to start but dies silently and I get a "connection +refused" error when starting the console. What is wrong?} Beginning with +1.38 the rpm packages are configured to run the director and storage +daemons as a non-root user. The file daemon runs as user root and group +bacula, the storage daemon as user bacula and group disk, and the director +as user bacula and group bacula. If you are upgrading you will need to +change some file permissions for things to work. Execute the following +commands as root: \footnotesize \begin{verbatim} @@ -216,11 +224,20 @@ \end{verbatim} \normalsize -Further, if you are using File storage volumes rather than tapes those files will also need to have ownership set to user bacula and group bacula. +Further, if you are using File storage volumes rather than tapes those +files will also need to have ownership set to user bacula and group bacula. \item \label{faq9} - {\bf There are a lot of rpm packages. Which packages do I need for what?} For a bacula server you need to select the packsge based upon your preferred catalog database: one of bacula-mysql, bacula-postgresql or bacula-sqlite. If your system does not provide an mtx package you also need bacula-mtx to satisfy that dependancy. For a client machine you need only install bacula-client. Optionally, for either server or client machines, you may install a graphical console bacula-gconsole and/or bacula-wxconsole. One last package, bacula-updatedb is required only when upgrading a server more than one database revision level. + {\bf There are a lot of rpm packages. Which packages do I need for +what?} For a bacula server you need to select the packsge based upon your +preferred catalog database: one of bacula-mysql, bacula-postgresql or +bacula-sqlite. If your system does not provide an mtx package you also +need bacula-mtx to satisfy that dependancy. For a client machine you need +only install bacula-client. Optionally, for either server or client +machines, you may install a graphical console bacula-bgnome-console and/or +bacula-bwxconsole. One last package, bacula-updatedb is required only when +upgrading a server more than one database revision level. @@ -316,12 +333,12 @@ X86-64 support: --define "build_x86_64 1" -Supress build of gnome-console: ---define "nobuild_gconsole 1" +Supress build of bgnome-console: +--define "nobuild_bgconsole 1" Build the WXWindows console: requires wxGTK >= 2.6 ---define "build_wxconsole 1" +--define "build_bwxconsole 1" Build python scripting support: --define "build_python 1" Modified: trunk/docs/manual/supportedoses.tex =================================================================== --- trunk/docs/manual/supportedoses.tex 2007-04-24 16:56:21 UTC (rev 4619) +++ trunk/docs/manual/supportedoses.tex 2007-04-24 19:29:22 UTC (rev 4620) @@ -15,6 +15,11 @@ \ilink{ Tape Modes on FreeBSD}{FreeBSDTapes} section of the Tape Testing chapter of this manual.) \item Windows (Win98/Me, WinNT/2K/XP) Client (File daemon) binaries. +\item Windows Vista VSS (Volume Shadow Copy) is reported not to work + with Bacula. +\item The Windows servers (Director and Storage daemon) are available + in the binary Client installer. The are reported to work in + many cases. However they are NOT supported. \item MacOS X/Darwin (see \elink{ http://fink.sourceforge.net/}{http://fink.sourceforge.net/} for obtaining the packages) \item OpenBSD Client (File daemon). Modified: trunk/docs/manual/win32.tex =================================================================== --- trunk/docs/manual/win32.tex 2007-04-24 16:56:21 UTC (rev 4619) +++ trunk/docs/manual/win32.tex 2007-04-24 19:29:22 UTC (rev 4620) @@ -15,9 +15,10 @@ of installing not just the Client program, but also the Director and the Storage daemon and all the other programs that were previously available only on Unix systems. These additional -programs, notably the Director and Storage daemon, have been -tested, but still need to be documented. As a consequence, if you -install and use them, please test them carefully before putting +programs, notably the Director and Storage daemon, have been partially +tested, are reported to have some bugs, and still need to be documented. +They are not yet supported, and we cannot currently accept or fix +bug reports on them. Consequently, please test them carefully before putting them into a critical production environment. The Windows version of the Bacula File daemon has been tested on Win98, WinMe, This was sent by the SourceForge.net collaborative development platform, the world's largest Open Source development site. |
From: <ke...@us...> - 2007-05-03 09:41:38
|
Revision: 4683 http://bacula.svn.sourceforge.net/bacula/?rev=4683&view=rev Author: kerns Date: 2007-05-03 02:41:39 -0700 (Thu, 03 May 2007) Log Message: ----------- Update Modified Paths: -------------- trunk/docs/manual/console.tex trunk/docs/manual/dirdconf.tex trunk/docs/manual/install.tex trunk/docs/manual/version.tex trunk/docs/manual-de/install.tex trunk/docs/manual-fr/install.tex Modified: trunk/docs/manual/console.tex =================================================================== --- trunk/docs/manual/console.tex 2007-05-03 07:55:25 UTC (rev 4682) +++ trunk/docs/manual/console.tex 2007-05-03 09:41:39 UTC (rev 4683) @@ -369,17 +369,17 @@ form of this command is: \begin{verbatim} -delete pool=\lt{}pool-name\gt{} +delete pool=<pool-name> \end{verbatim} or \begin{verbatim} -delete volume=\lt{}volume-name\gt{} pool=\lt{}pool-name\gt{} or +delete volume=>volume-name> pool=>pool-name> or \end{verbatim} \begin{verbatim} -delete JobId=\lt{}job-id\gt{} JobId=\lt{}job-id2\gt{} ... or +delete JobId=>job-id> JobId=>job-id2> ... or \end{verbatim} \begin{verbatim} @@ -434,8 +434,8 @@ \begin{verbatim} -estimate job=\lt{}job-name\gt{} listing client=\lt{}client-name\gt{} - fileset=\lt{}fileset-name\gt{} level=\lt{}level-name\gt{} +estimate job=<job-name> listing client=<client-name> + fileset=<fileset-name> level=<level-name> \end{verbatim} Specification of the {\bf job} is sufficient, but you can also override @@ -478,8 +478,8 @@ is: \begin{verbatim} -label storage=\lt{}storage-name\gt{} volume=\lt{}volume-name\gt{} - slot=\lt{}slot\gt{} +label storage=>storage-name> volume=>volume-name> + slot=>slot> \end{verbatim} If you leave out any part, you will be prompted for it. The media type @@ -1153,7 +1153,7 @@ specified device. The forms of the command are the same as the mount command: \footnotesize \begin{verbatim} -unmount storage=<storage-name> [ drive=\lt{}num\gt{} ] +unmount storage=<storage-name> [ drive=<num> ] unmount [ jobid=<id> | job=<job-name> ] \end{verbatim} Modified: trunk/docs/manual/dirdconf.tex =================================================================== --- trunk/docs/manual/dirdconf.tex 2007-05-03 07:55:25 UTC (rev 4682) +++ trunk/docs/manual/dirdconf.tex 2007-05-03 09:41:39 UTC (rev 4683) @@ -23,6 +23,9 @@ Job, JobDefs, Client, Storage, Catalog, Schedule, FileSet, Pool, Director, or Messages. We present them here in the most logical order for defining them: +Note, everything revolves around a job and is tied to a job in one +way or another. + \begin{itemize} \item \ilink{Director}{DirectorResource4} -- to define the Director's @@ -34,31 +37,50 @@ \item \ilink{Job}{JobResource} -- to define the backup/restore Jobs and to tie together the Client, FileSet and Schedule resources to be used - for each Job. + for each Job. Normally, you will Jobs of different names corresponding + to each client (i.e. one Job per client, but a different one with a different name + for each client). \item \ilink{JobDefs}{JobDefsResource} -- optional resource for providing defaults for Job resources. \item \ilink{Schedule}{ScheduleResource} -- to define when a Job is to - be automatically run by {\bf Bacula's} internal scheduler. + be automatically run by {\bf Bacula's} internal scheduler. You + may have any number of Schedules, but each job will reference only + one. \item \ilink{FileSet}{FileSetResource} -- to define the set of files - to be backed up for each Client. + to be backed up for each Client. You may have any number of + FileSets but each Job will reference only one. \item - \ilink{Client}{ClientResource2} -- to define what Client is to be - backed up. + \ilink{Client}{ClientResource2} -- to define what Client is to be + backed up. You will generally have multiple Client definitions. Each + Job will reference only a single client. \item \ilink{Storage}{StorageResource2} -- to define on what physical - device the Volumes should be mounted. + device the Volumes should be mounted. You may have one or + more Storage definitions. \item \ilink{Pool}{PoolResource} -- to define the pool of Volumes - that can be used for a particular Job. + that can be used for a particular Job. Most people use a + single default Pool. However, if you have a large number + of clients or volumes, you may want to have multiple Pools. + Pools allow you to restrict a Job (or a Client) to use + only a particular set of Volumes. \item \ilink{Catalog}{CatalogResource} -- to define in what database to keep the list of files and the Volume names where they are backed up. + Most people only use a single catalog. However, if you want to + scale the Director to many clients, multiple catalogs can be helpful. + Multiple catalogs require a bit more management because in general + you must know what catalog contains what data. Currently, all + Pools are defined in each catalog. This restriction will be removed + in a later release. \item - \ilink{Messages}{MessagesChapter} -- to define where error and - information messages are to be sent or logged. + \ilink{Messages}{MessagesChapter} -- to define where error and + information messages are to be sent or logged. You may define + multiple different message resources and hence direct particular + classes of messages to different users or locations (files, ...). \end{itemize} \section{The Director Resource} @@ -93,14 +115,15 @@ \item [Password = \lt{}UA-password\gt{}] \index[dir]{Password} \index[dir]{Directive!Password} - Specifies the password that must be supplied for the default Bacula Console - to be authorized. The same password must appear in the {\bf Director} - resource of the Console configuration file. For added security, the password - is never actually passed across the network but rather a challenge response - hash code created with the password. This directive is required. If you have - either {\bf /dev/random} or {\bf bc} on your machine, Bacula will generate a - random password during the configuration process, otherwise it will be left - blank and you must manually supply it. + Specifies the password that must be supplied for the default Bacula + Console to be authorized. The same password must appear in the {\bf + Director} resource of the Console configuration file. For added + security, the password is never passed across the network but instead a + challenge response hash code created with the password. This directive + is required. If you have either {\bf /dev/random} or {\bf bc} on your + machine, Bacula will generate a random password during the configuration + process, otherwise it will be left blank and you must manually supply + it. \item [Messages = \lt{}Messages-resource-name\gt{}] \index[dir]{Messages} Modified: trunk/docs/manual/install.tex =================================================================== --- trunk/docs/manual/install.tex 2007-05-03 07:55:25 UTC (rev 4682) +++ trunk/docs/manual/install.tex 2007-05-03 09:41:39 UTC (rev 4683) @@ -1145,12 +1145,11 @@ --with-mysql \ --with-working-dir=/var/bacula \ --with-pid-dir=/var/run \ - --with-subsys-dir=/var/lock/subsys \ --enable-conio \end{verbatim} \normalsize -Note, Bacula assumes that /var/bacula, /var/run, and /var/loc/subsys exist so +Note, Bacula assumes that /var/bacula, /var/run, and /var/lock/subsys exist so it will not automatically create them during the install process. Note, with gcc (GCC) 4.0.1 20050727 (Red Hat 4.0.1-5) on Modified: trunk/docs/manual/version.tex =================================================================== --- trunk/docs/manual/version.tex 2007-05-03 07:55:25 UTC (rev 4682) +++ trunk/docs/manual/version.tex 2007-05-03 09:41:39 UTC (rev 4683) @@ -1 +1 @@ -2.1.8 (28 April 2007) +2.1.8 (02 May 2007) Modified: trunk/docs/manual-de/install.tex =================================================================== --- trunk/docs/manual-de/install.tex 2007-05-03 07:55:25 UTC (rev 4682) +++ trunk/docs/manual-de/install.tex 2007-05-03 09:41:39 UTC (rev 4683) @@ -569,11 +569,12 @@ --with-mysql \ --with-working-dir=/var/bacula \ --with-pid-dir=/var/run \ - --with-subsys-dir=/var/lock/subsys \ --enable-conio \end{verbatim} \normalsize -Beachten Sie bitte, dass Bacula davon ausgeht, dass die Verzeichnisse /var/bacula, /var/run, und /var/loc/subsys bereits existieren und es diese w\xE4hrend der Installation nicht automatisch erzeugt. +Beachten Sie bitte, dass Bacula davon ausgeht, dass die Verzeichnisse +/var/bacula, /var/run, und /var/lock/subsys bereits existieren und es diese +w\xE4hrend der Installation nicht automatisch erzeugt. Beachten Sie bitte, dass bei Benutzung einer AMD64 CPU, die unter 64 bit CentOS4 l\xE4uft, mit gcc (GCC) 4.0.1 20050727 (Red Hat 4.0.1-5) ein Compiler Bug auftritt, so dass Code erzeugt wird, der eine Segmentverletzung verusacht. Typischerweise macht sich dies zuerst beim Storage-D\xE4mon bemerkbar. Eine L\xF6sung ist es, Bacula ohne Optimierung zu kompilieren (normalerweise ist dies -O2). Modified: trunk/docs/manual-fr/install.tex =================================================================== --- trunk/docs/manual-fr/install.tex 2007-05-03 07:55:25 UTC (rev 4682) +++ trunk/docs/manual-fr/install.tex 2007-05-03 09:41:39 UTC (rev 4683) @@ -1077,16 +1077,15 @@ \footnotesize \begin{verbatim} CFLAGS="-g -Wall" ./configure \ - --prefix=/usr + --prefix=/usr \ --sbindir=/usr/sbin \ --sysconfdir=/etc/bacula \ --with-scriptdir=/etc/bacula \ --enable-smartalloc \ --enable-gnome \ - --with-mysql\ - --with-working-dir=/var/bacula + --with-mysql \ + --with-working-dir=/var/bacula \ --with-pid-dir=$HOME/var/run \ - --with-subsys-dir=/var/lock/subsys --enable-conio \end{verbatim} \normalsize This was sent by the SourceForge.net collaborative development platform, the world's largest Open Source development site. |
From: <ke...@us...> - 2007-05-08 15:51:30
|
Revision: 4729 http://bacula.svn.sourceforge.net/bacula/?rev=4729&view=rev Author: kerns Date: 2007-05-08 08:51:31 -0700 (Tue, 08 May 2007) Log Message: ----------- Update Modified Paths: -------------- trunk/docs/manual/console.tex trunk/docs/manual/install.tex trunk/docs/manual/tutorial.tex Modified: trunk/docs/manual/console.tex =================================================================== --- trunk/docs/manual/console.tex 2007-05-08 15:51:16 UTC (rev 4728) +++ trunk/docs/manual/console.tex 2007-05-08 15:51:31 UTC (rev 4729) @@ -878,8 +878,9 @@ to be restored. This mode is somewhat similar to the standard Unix {\bf restore} program's interactive file selection mode. -restore storage=\lt{}storage-name\gt{} client=\lt{}client-name\gt{} +restore storage=\lt{}storage-name\gt{} client=\lt{}backup-client-name\gt{} where=\lt{}path\gt{} pool=\lt{}pool-name\gt{} fileset=\lt{}fileset-name\gt{} + restoreclient=\lt{}restore-client-name\gt{} select current all done Where {\bf current}, if specified, tells the restore command to @@ -890,6 +891,11 @@ command, please see the \ilink{Restore Chapter}{RestoreChapter} of this manual. + The client keyword initially specifies the client from which the backup + was made and the client to which the restore will be make. However, + if the restoreclient keyword is specified, then the restore is written + to that client. + \item [run] \index[console]{run} This command allows you to schedule jobs to be run immediately. The full form @@ -1323,10 +1329,10 @@ \normalsize If specified with a specific JobId, ... the wait command will wait for that particular job to terminate before continuing. + \end{description} \label{dotcommands} - \section{Special dot Commands} \index[general]{Commands!Special dot} \index[general]{Special dot Commands} Modified: trunk/docs/manual/install.tex =================================================================== --- trunk/docs/manual/install.tex 2007-05-08 15:51:16 UTC (rev 4728) +++ trunk/docs/manual/install.tex 2007-05-08 15:51:31 UTC (rev 4729) @@ -23,7 +23,7 @@ \index[general]{Release Files} Beginning with Bacula 1.38.0, the source code has been broken into four separate tar files each corresponding to a different module in -the Bacula CVS. The released files are: +the Bacula SVN. The released files are: \begin{description} \item [bacula-1.38.0.tar.gz] @@ -657,12 +657,12 @@ keeping this option enabled as it helps detect memory leaks. This configuration parameter is used while building Bacula -\item [ {-}{-}enable-GNOME ] - \index[general]{{-}{-}enable-GNOME} +\item [ {-}{-}enable-gnome ] + \index[general]{{-}{-}enable-gnome} If you have GNOME installed on your computer including the GNOME development libraries, and you want to use the GNOME GUI Console interface to Bacula, you must specify this option. - Doing so will build everything in the {\bf src/GNOME-console} directory. + Doing so will build everything in the {\bf src/gnome-console} directory. \item [ {-}{-}enable-bwx-console ] \index[general]{{-}{-}enable-bwx-console} @@ -691,7 +691,6 @@ not enabled this option, or explicitly disable static linking by adding {\bf \verb:--:disable-static-tools}. - \item [ {-}{-}enable-static-fd] \index[general]{{-}{-}enable-static-fd} This option causes the make process to build a {\bf static-bacula-fd} in @@ -731,7 +730,6 @@ libraries. You may be able to enable those options, but you will need to load additional static libraries. - \item [ {-}{-}enable-static-dir] \index[general]{{-}{-}enable-static-dir} @@ -828,9 +826,9 @@ \item [ {-}{-}with-sqlite=\lt{}sqlite-path\gt{}] \index[general]{{-}{-}with-sqlite} - This enables use of the SQLite version 2.8.x database. The {\bf sqlite-path} is not - normally specified as Bacula looks for the necessary components in a - standard location ({\bf depkgs/sqlite}). See + This enables use of the SQLite version 2.8.x database. The {\bf + sqlite-path} is not normally specified as Bacula looks for the necessary + components in a standard location ({\bf depkgs/sqlite}). See \ilink{Installing and Configuring SQLite}{SqlLiteChapter} chapter of this manual for more details. @@ -882,17 +880,14 @@ \ilink{Bacula PKI -- Data Encryption}{DataEncryption} chapter of this manual. - - \item [ {-}{-}with-python=\lt{}path\gt{}] \index[general]{{-}{-}with-python} - This option enables Bacula support for Python. If no path is - supplied, configure will search the - standard library locations for Python 2.2, 2.3, or 2.4. If it cannot - find the library, you will need to supply a path to your Python - library directory. Please see the - \ilink{Python chapter}{PythonChapter} for the details of using - Python scripting. + This option enables Bacula support for Python. If no path is supplied, + configure will search the standard library locations for Python 2.2, + 2.3, 2.4, or 2.5. If it cannot find the library, you will need to + supply a path to your Python library directory. Please see the + \ilink{Python chapter}{PythonChapter} for the details of using Python + scripting. \item [ {-}{-}with-libintl-prefix=\lt{}DIR\gt{}] \index[general]{{-}{-}with-libintl-prefix} @@ -991,7 +986,7 @@ \item [ {-}{-}with-dir-password=\lt{}Password\gt{}] \index[general]{{-}{-}with-dir-password} - This option allows you to specify the password used to access the Directory + This option allows you to specify the password used to access the Director (normally from the Console program). If it is not specified, configure will automatically create a random password. @@ -1003,7 +998,7 @@ \item [ {-}{-}with-sd-password=\lt{}Password\gt{} ] \index[general]{{-}{-}with-sd-password} - This option allows you to specify the password used to access the Directory + This option allows you to specify the password used to access the Storage daemon (normally called from the Director). If it is not specified, configure will automatically create a random password. @@ -1017,7 +1012,6 @@ create the User prior to running {\bf make install}, because the working directory owner will be set to {\bf User}. - \item [ {-}{-}with-dir-group=\lt{}Group\gt{} ] \index[general]{{-}{-}with-dir-group} This option allows you to specify the GroupId used to run the Director. The @@ -1059,6 +1053,34 @@ root, however, after doing preliminary initializations, it can "drop" to the GroupId specified on this option. +\item [ {-}{-}with-mon-dir-password=\lt{}Password\gt{}] + \index[general]{{-}{-}with-mon-dir-password} + This option allows you to specify the password used to access the Directory + from the monitor. If it is not specified, configure will + automatically create a random password. + +\item [ {-}{-}with-mon-fd-password=\lt{}Password\gt{} ] + \index[general]{{-}{-}with-mon-fd-password} + This option allows you to specify the password used to access the File daemon + from the Monitor. If it is not specified, configure will + automatically create a random password. + +\item [ {-}{-}with-mon-sd-password=\lt{}Password\gt{} ] + \index[general]{{-}{-}with-mon-sd-password} + This option allows you to specify the password used to access the + Storage daemon from the Monitor. If it is not specified, configure will + automatically create a random password. + +\item [ {-}{-}with-db-name=\lt{}database-name\gt{} ] + \index[general]{{-}{-}with-db-name} + This option allows you to specify the database name to be used in + the conf files. The default is bacula. + +\item [ {-}{-}with-db-user=\lt{}database-user\gt{} ] + \index[general]{{-}{-}with-db-user} + This option allows you to specify the database user name to be used in + the conf files. The default is bacula. + \end{description} Note, many other options are presented when you do a {\bf ./configure Modified: trunk/docs/manual/tutorial.tex =================================================================== --- trunk/docs/manual/tutorial.tex 2007-05-08 15:51:16 UTC (rev 4728) +++ trunk/docs/manual/tutorial.tex 2007-05-08 15:51:31 UTC (rev 4729) @@ -657,15 +657,16 @@ 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 -Client: rufus-fd -Storage: File -JobId: *None* -When: 2005-04-28 14:53:54 +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 @@ -680,22 +681,25 @@ \footnotesize \begin{verbatim} -28-Apr-2005 14:56 rufus-dir: Bacula 1.30 (28Apr03): 28-Apr-2003 14:56 +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.2005-04-28_14.56.06 -Client: rufus-fd -Start time: 28-Apr-2005 14:56 -End time: 28-Apr-2005 14:56 +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 -28-Apr-2005 14:56 rufus-dir: Begin pruning Jobs. -28-Apr-2005 14:56 rufus-dir: No Jobs found to prune. -28-Apr-2005 14:56 rufus-dir: Begin pruning Files. -28-Apr-2005 14:56 rufus-dir: No Files found to prune. -28-Apr-2005 14:56 rufus-dir: End auto prune. +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 @@ -1118,14 +1122,14 @@ \item [-c \lt{}file\gt{}] \index[sd]{-c \lt{}file\gt{} } Define the file to use as a configuration file. The default is the daemon -name followed by {\bf .conf} i.e. {\bf bacula-dir.conf} for the Director, -{\bf bacula-fd.conf} for the File daemon, and {\bf bacula-sd} for the Storage -daemon. + name followed by {\bf .conf} i.e. {\bf bacula-dir.conf} for the Director, + {\bf bacula-fd.conf} for the File daemon, and {\bf bacula-sd} for the Storage + daemon. \item [-d nn] \index[sd]{-d nn } Set the debug level to {\bf nn}. Higher levels of debug cause more -information to be displayed on STDOUT concerning what the daemon is doing. + information to be displayed on STDOUT concerning what the daemon is doing. \item [-f] Run the daemon in the foreground. This option is needed to run the daemon @@ -1154,6 +1158,7 @@ \item [-r \lt{}job\gt{}] \index[fd]{-r \lt{}job\gt{} } Run the named job immediately. This is for debugging and should not be used. + \end{description} The File daemon has the following File daemon specific option: This was sent by the SourceForge.net collaborative development platform, the world's largest Open Source development site. |
From: <ke...@us...> - 2007-05-12 06:46:28
|
Revision: 4756 http://bacula.svn.sourceforge.net/bacula/?rev=4756&view=rev Author: kerns Date: 2007-05-11 23:46:30 -0700 (Fri, 11 May 2007) Log Message: ----------- Update Modified Paths: -------------- trunk/docs/manual/dataencryption.tex trunk/docs/manual/version.tex Modified: trunk/docs/manual/dataencryption.tex =================================================================== --- trunk/docs/manual/dataencryption.tex 2007-05-12 06:42:28 UTC (rev 4755) +++ trunk/docs/manual/dataencryption.tex 2007-05-12 06:46:30 UTC (rev 4756) @@ -111,6 +111,31 @@ streaming DER decoder/encoder was not available. +\section{Decrypting with a Master Key} +\index[general]{Decrypting with a Master Key} + +It is preferable to retain a secure, non-encrypted copy of the +client's own encryption keypair. However, should you lose the +client's keypair, recovery with the master keypair is possible. + +You must: +\begin{itemize} +\item Concatenate the master private and public key into a single + keypair file, ie: + cat master.key master.cert >master.keypair + +\item 2) Set the PKI Keypair statement in your bacula configuration file: + +\begin{verbatim} + PKI Keypair = master.keypair +\end{verbatim} + +\item Start the restore. The master keypair will be used to decrypt + the file data. + +\end{itemize} + + \section{Generating Private/Public Encryption Keys} \index[general]{Generating Private/Public Encryption Keypairs} @@ -151,7 +176,6 @@ \index[general]{Example!Data Encryption Configuration File} \index[general]{Example Data Encryption Configuration} - {\bf bacula-fd.conf} \footnotesize \begin{verbatim} Modified: trunk/docs/manual/version.tex =================================================================== --- trunk/docs/manual/version.tex 2007-05-12 06:42:28 UTC (rev 4755) +++ trunk/docs/manual/version.tex 2007-05-12 06:46:30 UTC (rev 4756) @@ -1 +1 @@ -2.1.8 (08 May 2007) +2.1.8 (09 May 2007) This was sent by the SourceForge.net collaborative development platform, the world's largest Open Source development site. |
From: <ke...@us...> - 2007-09-12 09:03:18
|
Revision: 5533 http://bacula.svn.sourceforge.net/bacula/?rev=5533&view=rev Author: kerns Date: 2007-09-12 02:03:20 -0700 (Wed, 12 Sep 2007) Log Message: ----------- Update Modified Paths: -------------- trunk/docs/manual/dirdconf.tex trunk/docs/manual/dvd.tex trunk/docs/manual/install.tex Modified: trunk/docs/manual/dirdconf.tex =================================================================== --- trunk/docs/manual/dirdconf.tex 2007-09-12 08:49:52 UTC (rev 5532) +++ trunk/docs/manual/dirdconf.tex 2007-09-12 09:03:20 UTC (rev 5533) @@ -2424,6 +2424,9 @@ what is stored for the Volume. To change the value for an existing Volume you must use the {\bf update} command in the Console. + Please see the notes below under {\bf Maximum Volume Jobs} concerning + using this directive with multiple simultaneous jobs. + \item [Maximum Volume Jobs = \lt{}positive-integer\gt{}] \index[dir]{Maximum Volume Jobs} \index[dir]{Directive!Maximum Volume Jobs} @@ -2442,6 +2445,13 @@ is stored for the Volume. To change the value for an existing Volume you must use the {\bf update} command in the Console. + If you are running multiple simultaneous jobs, this directive may not + work correctly because when a drive is reserved for a job, this + directive is not taken into account, so multiple jobs may try to + start writing to the Volume. At some point, when the Media record is + updated, multiple simultaneous jobs may fail since the Volume can no + longer be written. + \item [Maximum Volume Files = \lt{}positive-integer\gt{}] \index[dir]{Maximum Volume Files} \index[dir]{Directive!Maximum Volume Files} Modified: trunk/docs/manual/dvd.tex =================================================================== --- trunk/docs/manual/dvd.tex 2007-09-12 08:49:52 UTC (rev 5532) +++ trunk/docs/manual/dvd.tex 2007-09-12 09:03:20 UTC (rev 5533) @@ -322,5 +322,8 @@ \item For more information about DVD writing, please look at the \elink{dvd+rw-tools homepage}{http://fy.chalmers.se/~appro/linux/DVD+RW/}. +\item According to bug #912, bscan cannot read multi-volume DVDs. This is +on our TODO list, but unless someone submits a patch it is not likely to be +done any time in the near future. (9 Sept 2007). \end{itemize} Modified: trunk/docs/manual/install.tex =================================================================== --- trunk/docs/manual/install.tex 2007-09-12 08:49:52 UTC (rev 5532) +++ trunk/docs/manual/install.tex 2007-09-12 09:03:20 UTC (rev 5533) @@ -766,7 +766,11 @@ environment or a window manager compatible with the FreeDesktop system tray standard (like KDE and GNOME) and you want to use a GUI to monitor Bacula daemons, you must specify this option. Doing so will build - everything in the {\bf src/tray-monitor} directory. + everything in the {\bf src/tray-monitor} directory. Note, due to + restrictions on what can be linked with GPLed code, we were forced to + remove the egg code that dealt with the tray icons and replace it by + calls to the GTK+ API, and unfortunately, the tray icon API necessary + was not implemented until GTK version 2.10 or later. \item [ {-}{-}enable-static-tools] \index[general]{{-}{-}enable-static-tools} This was sent by the SourceForge.net collaborative development platform, the world's largest Open Source development site. |
From: <ke...@us...> - 2007-09-14 18:21:42
|
Revision: 5567 http://bacula.svn.sourceforge.net/bacula/?rev=5567&view=rev Author: kerns Date: 2007-09-14 11:21:45 -0700 (Fri, 14 Sep 2007) Log Message: ----------- Fix build Modified Paths: -------------- trunk/docs/manual/dvd.tex trunk/docs/manual/version.tex Modified: trunk/docs/manual/dvd.tex =================================================================== --- trunk/docs/manual/dvd.tex 2007-09-14 18:17:05 UTC (rev 5566) +++ trunk/docs/manual/dvd.tex 2007-09-14 18:21:45 UTC (rev 5567) @@ -322,7 +322,7 @@ \item For more information about DVD writing, please look at the \elink{dvd+rw-tools homepage}{http://fy.chalmers.se/~appro/linux/DVD+RW/}. -\item According to bug #912, bscan cannot read multi-volume DVDs. This is +\item According to bug \#912, bscan cannot read multi-volume DVDs. This is on our TODO list, but unless someone submits a patch it is not likely to be done any time in the near future. (9 Sept 2007). Modified: trunk/docs/manual/version.tex =================================================================== --- trunk/docs/manual/version.tex 2007-09-14 18:17:05 UTC (rev 5566) +++ trunk/docs/manual/version.tex 2007-09-14 18:21:45 UTC (rev 5567) @@ -1 +1 @@ -2.2.1 (30 August 2007) +2.3.4 (14 September 2007) This was sent by the SourceForge.net collaborative development platform, the world's largest Open Source development site. |
From: <ke...@us...> - 2007-09-23 07:08:08
|
Revision: 5624 http://bacula.svn.sourceforge.net/bacula/?rev=5624&view=rev Author: kerns Date: 2007-09-23 00:08:11 -0700 (Sun, 23 Sep 2007) Log Message: ----------- Fix escaping Modified Paths: -------------- trunk/docs/manual/install.tex trunk/docs/manual/version.tex Modified: trunk/docs/manual/install.tex =================================================================== --- trunk/docs/manual/install.tex 2007-09-22 09:08:48 UTC (rev 5623) +++ trunk/docs/manual/install.tex 2007-09-23 07:08:11 UTC (rev 5624) @@ -736,7 +736,7 @@ SQLite2 is not thread safe. Batch insert cannot be enabled when using SQLite2 - On most systems, PostgreSQL and SQLite3 are thread safe. + On most systems, MySQL, PostgreSQL and SQLite3 are thread safe. To verify that your PostgreSQL is thread safe, you can try this (change the path to point to your particular installed libpq.a; @@ -754,7 +754,7 @@ \end{verbatim} The above example shows a libpq that contains the required function - PQputCopyData and is thread enabled (i.e. the pthread_mutex* entries). + PQputCopyData and is thread enabled (i.e. the pthread\_mutex* entries). If you do not see PQputCopyData, your version of PostgreSQL is too old to allow batch insert. If you do not see the mutex entries, then thread support has not been enabled. Our tests indicate you usually need to Modified: trunk/docs/manual/version.tex =================================================================== --- trunk/docs/manual/version.tex 2007-09-22 09:08:48 UTC (rev 5623) +++ trunk/docs/manual/version.tex 2007-09-23 07:08:11 UTC (rev 5624) @@ -1 +1 @@ -2.2.4 (14 September 2007) +2.2.5 (20 September 2007) This was sent by the SourceForge.net collaborative development platform, the world's largest Open Source development site. |
From: <jun...@us...> - 2007-09-24 19:12:53
|
Revision: 5641 http://bacula.svn.sourceforge.net/bacula/?rev=5641&view=rev Author: junkmale Date: 2007-09-24 12:12:54 -0700 (Mon, 24 Sep 2007) Log Message: ----------- Let people know that Bacula passwords are plain text and are not generated though any special magic process. We're getting this question more often now. Modified Paths: -------------- trunk/docs/manual/configure.tex trunk/docs/manual/dirdconf.tex trunk/docs/manual/faq.tex Modified: trunk/docs/manual/configure.tex =================================================================== --- trunk/docs/manual/configure.tex 2007-09-24 19:04:15 UTC (rev 5640) +++ trunk/docs/manual/configure.tex 2007-09-24 19:12:54 UTC (rev 5641) @@ -348,7 +348,9 @@ In order for one daemon to contact another daemon, it must authorize itself with a password. In most cases, the password corresponds to a particular name, -so both the name and the password must match to be authorized. +so both the name and the password must match to be authorized. Passwords are +plain text, any text. They are not generated by any special process; just +use random text. The default configuration files are automatically defined for correct authorization with random passwords. If you add to or modify these files, you Modified: trunk/docs/manual/dirdconf.tex =================================================================== --- trunk/docs/manual/dirdconf.tex 2007-09-24 19:04:15 UTC (rev 5640) +++ trunk/docs/manual/dirdconf.tex 2007-09-24 19:12:54 UTC (rev 5641) @@ -125,6 +125,9 @@ process, otherwise it will be left blank and you must manually supply it. + The password is plain text. It is not generated through any special + process. + \item [Messages = \lt{}Messages-resource-name\gt{}] \index[dir]{Messages} \index[dir]{Directive!Messages} @@ -1984,6 +1987,9 @@ Bacula will generate a random password during the configuration process, otherwise it will be left blank. + The password is plain text. It is not generated through any special + process. + \label{FileRetention} \item [File Retention = \lt{}time-period-specification\gt{}] \index[dir]{File Retention} @@ -2130,6 +2136,9 @@ Bacula will generate a random password during the configuration process, otherwise it will be left blank. + The password is plain text. It is not generated through any special + process. + \item [Device = \lt{}device-name\gt{}] \index[dir]{Device} \index[dir]{Directive!Device} @@ -3037,6 +3046,9 @@ machine, Bacula will generate a random password during the configuration process, otherwise it will be left blank. + The password is plain text. It is not generated through any special + process. + \item [JobACL = \lt{}name-list\gt{}] \index[dir]{JobACL} \index[dir]{Directive!JobACL} Modified: trunk/docs/manual/faq.tex =================================================================== --- trunk/docs/manual/faq.tex 2007-09-24 19:04:15 UTC (rev 5640) +++ trunk/docs/manual/faq.tex 2007-09-24 19:12:54 UTC (rev 5641) @@ -851,4 +851,22 @@ work that backs up say one directory, or even one file. You will quickly find out what tape it wants, and you can mount it before you go home ... +\label{Password generation} +\section{Password generation} +\item [How do I generate a password?] +\index[general]{MaxVolumeSize} + + Each daemon needs a password. This password occurs in the configuration + file for that daemon and in the bacula-dir.conf file. These passwords are + plain text. There is no special generation procedure. Most people just + use random text. + + Passwords are never sent over the wire in plain text. They are always + encrypted. + + Security surrounding these passwords is best left security to your + operating system. Passwords are not encrypted within Bacula + configuration files. + \end{description} + \ No newline at end of file This was sent by the SourceForge.net collaborative development platform, the world's largest Open Source development site. |
From: <ke...@us...> - 2007-09-25 12:32:05
|
Revision: 5646 http://bacula.svn.sourceforge.net/bacula/?rev=5646&view=rev Author: kerns Date: 2007-09-25 05:32:09 -0700 (Tue, 25 Sep 2007) Log Message: ----------- Update Modified Paths: -------------- trunk/docs/manual/autochangers.tex trunk/docs/manual/dirdconf.tex Modified: trunk/docs/manual/autochangers.tex =================================================================== --- trunk/docs/manual/autochangers.tex 2007-09-25 12:28:00 UTC (rev 5645) +++ trunk/docs/manual/autochangers.tex 2007-09-25 12:32:09 UTC (rev 5646) @@ -825,7 +825,7 @@ \footnotesize \begin{verbatim} -./console +./bconsole Connecting to Director rufus:8101 1000 OK: rufus-dir Version: 1.26 (4 October 2002) *label Modified: trunk/docs/manual/dirdconf.tex =================================================================== --- trunk/docs/manual/dirdconf.tex 2007-09-25 12:28:00 UTC (rev 5645) +++ trunk/docs/manual/dirdconf.tex 2007-09-25 12:32:09 UTC (rev 5646) @@ -126,7 +126,8 @@ it. The password is plain text. It is not generated through any special - process. + process but as noted above, it is better to use random text for + security reasons. \item [Messages = \lt{}Messages-resource-name\gt{}] \index[dir]{Messages} @@ -1988,7 +1989,8 @@ otherwise it will be left blank. The password is plain text. It is not generated through any special - process. + process, but it is preferable for security reasons to make the text + random. \label{FileRetention} \item [File Retention = \lt{}time-period-specification\gt{}] @@ -2137,7 +2139,7 @@ otherwise it will be left blank. The password is plain text. It is not generated through any special - process. + process, but it is preferable for security reasons to use random text. \item [Device = \lt{}device-name\gt{}] \index[dir]{Device} @@ -3047,7 +3049,8 @@ process, otherwise it will be left blank. The password is plain text. It is not generated through any special - process. + process. However, it is preferable for security reasons to choose + random text. \item [JobACL = \lt{}name-list\gt{}] \index[dir]{JobACL} This was sent by the SourceForge.net collaborative development platform, the world's largest Open Source development site. |
From: <ke...@us...> - 2007-10-18 21:32:26
|
Revision: 5766 http://bacula.svn.sourceforge.net/bacula/?rev=5766&view=rev Author: kerns Date: 2007-10-18 14:32:30 -0700 (Thu, 18 Oct 2007) Log Message: ----------- Update Modified Paths: -------------- trunk/docs/manual/dirdconf.tex trunk/docs/manual/filedconf.tex trunk/docs/manual/fileset.tex trunk/docs/manual/kaboom.tex trunk/docs/manual/restore.tex trunk/docs/manual/version.tex trunk/docs/manual/win32.tex Modified: trunk/docs/manual/dirdconf.tex =================================================================== --- trunk/docs/manual/dirdconf.tex 2007-10-18 21:27:51 UTC (rev 5765) +++ trunk/docs/manual/dirdconf.tex 2007-10-18 21:32:30 UTC (rev 5766) @@ -1528,6 +1528,18 @@ A cloned job will not start additional clones, so it is not possible to recurse. + Please note that all cloned jobs, as specified in the Run directives are + submitted for running before the original job is run (while it is being + initialized). This means that any clone job will actually start before + the original job, and may even block the original job from starting + until the original job finishes unless you allow multiple simultaneous + jobs. Even if you set a lower priority on the clone job, if no other + jobs are running, it will start before the original job. + + If you are trying to prioritize jobs by using the clone feature (Run + directive), you will find it much easier to do using a RunScript + resource, or a RunBeforeJob directive. + \label{Priority} \item [Priority = \lt{}number\gt{}] \index[dir]{Priority} Modified: trunk/docs/manual/filedconf.tex =================================================================== --- trunk/docs/manual/filedconf.tex 2007-10-18 21:27:51 UTC (rev 5765) +++ trunk/docs/manual/filedconf.tex 2007-10-18 21:32:30 UTC (rev 5766) @@ -218,6 +218,19 @@ (Linux, ...) that provide the {\bf setsockopt} TCP\_KEEPIDLE function. The default value is zero, which means no change is made to the socket. + +\item [PKI Encryption] + See the \ilink{Data Encryption}{DataEncryption} chapter of this manual. + +\item [PKI Signatures] + See the \ilink{Data Encryption}{DataEncryption} chapter of this manual. + +\item [PKI Keypair] + See the \ilink{Data Encryption}{DataEncryption} chapter of this manual. + +\item [PKI Master Key] + See the \ilink{Data Encryption}{DataEncryption} chapter of this manual. + \end{description} The following is an example of a valid Client resource definition: Modified: trunk/docs/manual/fileset.tex =================================================================== --- trunk/docs/manual/fileset.tex 2007-10-18 21:27:51 UTC (rev 5765) +++ trunk/docs/manual/fileset.tex 2007-10-18 21:32:30 UTC (rev 5766) @@ -18,8 +18,6 @@ of the Include/Exclude contents). Each time a new FileSet is created, Bacula will ensure that the next backup is always a Full save. -\section{Character Sets} -\index[general]{Character Sets} Bacula is designed to handle most character sets of the world, US ASCII, German, French, Chinese, ... However, it does this by encoding everything in UTF-8, and it expects all configuration files Modified: trunk/docs/manual/kaboom.tex =================================================================== --- trunk/docs/manual/kaboom.tex 2007-10-18 21:27:51 UTC (rev 5765) +++ trunk/docs/manual/kaboom.tex 2007-10-18 21:32:30 UTC (rev 5766) @@ -35,6 +35,9 @@ your system: \begin{enumerate} +\item You must have a version of Bacula built with debug information turned + on and not stripped of debugging symbols. + \item You must have an installed copy of {\bf gdb} (the GNU debugger), and it must be on {\bf Bacula's} path. On some systems such as Solaris, {\bf gdb} may be replaced by {\bf dbx}. Modified: trunk/docs/manual/restore.tex =================================================================== --- trunk/docs/manual/restore.tex 2007-10-18 21:27:51 UTC (rev 5765) +++ trunk/docs/manual/restore.tex 2007-10-18 21:32:30 UTC (rev 5766) @@ -978,7 +978,7 @@ where the files will be restored. \item [find] - \index[dir]{find } + \index[dir]{find} The {\bf find} command accepts one or more arguments and displays all files in the tree that match that argument. The argument may have wildcards. It is somewhat similar to the Unix command {\bf find / -name arg}. @@ -987,19 +987,20 @@ The {\bf ls} command produces a listing of all the files contained in the current directory much like the Unix {\bf ls} command. You may specify an argument containing wildcards, in which case only those files will be -listed. + listed. + Any file that is marked to be restored will have its name preceded by an asterisk ({\bf *}). Directory names will be terminated with a forward slash ({\bf /}) to distinguish them from filenames. \item [lsmark] - \index[fd]{lsmark } + \index[fd]{lsmark} The {\bf lsmark} command is the same as the {\bf ls} except that it will print only those files marked for extraction. The other distinction is that it will recursively descend into any directory selected. \item [mark] - \index[dir]{mark } + \index[dir]{mark} The {\bf mark} command allows you to mark files to be restored. It takes a single argument which is the filename or directory name in the current directory to be marked for extraction. The argument may be a wildcard Modified: trunk/docs/manual/version.tex =================================================================== --- trunk/docs/manual/version.tex 2007-10-18 21:27:51 UTC (rev 5765) +++ trunk/docs/manual/version.tex 2007-10-18 21:32:30 UTC (rev 5766) @@ -1 +1 @@ -2.2.5 (20 September 2007) +2.2.5 (09 October 2007) Modified: trunk/docs/manual/win32.tex =================================================================== --- trunk/docs/manual/win32.tex 2007-10-18 21:27:51 UTC (rev 5765) +++ trunk/docs/manual/win32.tex 2007-10-18 21:32:30 UTC (rev 5766) @@ -320,6 +320,18 @@ \end{verbatim} \normalsize +You may wish to start the daemon with debug mode on rather than doing it +using bconsole. To do so, edit the following registry key: + +\footnotesize +\begin{verbatim} +HKEY_LOCAL_MACHINE\HARDWARE\SYSTEM\CurrentControlSet\Services\Bacula-dir +\end{verbatim} +\normalsize + +using regedit, then add -dnn after the /service option, where nn represents +the debug level you want. + \label{Compatibility} \section{Windows Compatibility Considerations} \index[general]{Windows Compatibility Considerations} This was sent by the SourceForge.net collaborative development platform, the world's largest Open Source development site. |
From: <jun...@us...> - 2007-10-22 23:43:08
|
Revision: 5783 http://bacula.svn.sourceforge.net/bacula/?rev=5783&view=rev Author: junkmale Date: 2007-10-22 16:43:12 -0700 (Mon, 22 Oct 2007) Log Message: ----------- Add a section on Security Considations when backing up the Bacula database. Refer to this section from the Tips page. Modified Paths: -------------- trunk/docs/manual/catmaintenance.tex trunk/docs/manual/tips.tex Modified: trunk/docs/manual/catmaintenance.tex =================================================================== --- trunk/docs/manual/catmaintenance.tex 2007-10-22 23:00:35 UTC (rev 5782) +++ trunk/docs/manual/catmaintenance.tex 2007-10-22 23:43:12 UTC (rev 5783) @@ -586,6 +586,8 @@ Storage = DLTDrive Messages = Standard Pool = Default + # WARNING!!! Passing the password via the command line is insecure. + # see comments in make_catalog_backup for details. RunBeforeJob = "/home/kern/bacula/bin/make_catalog_backup" RunAfterJob = "/home/kern/bacula/bin/delete_catalog_backup" Write Bootstrap = "/home/kern/bacula/working/BackupCatalog.bsr" @@ -614,6 +616,33 @@ you do not have a bootstrap file, it is still possible to recover your database backup, but it will be more work and take longer. + +\label{BackingUpBaculaSecurityConsiderations} +\section{Security considerations} +\index[general]{Backing Up Your Bacula Database - Security Considerations } +\index[general]{Database!Backing Up Your Bacula Database - Security Considerations } + +We provide make_catalog_backup as an example of what can be used to backup +your Bacula database. We expect you to take security precautions relevant +to your situation. make_catalog_backup is designed to take a password on +the command line. This is fine on machines with only trusted users. It is +not acceptable on machines without trusted users. Most database systems +provide a alternative method, which does not place the password on the +command line. + +The make_catalog_backup contains some warnings about how to use it. Please +read those tips. + +To help you get started, we know PostgreSQL has a password file, +\elink{ +.pgpass}{http://www.postgresql.org/docs/8.2/static/libpq-pgpass.html}, and +we know MySQL has +\elink{ .my.cnf}{http://dev.mysql.com/doc/refman/4.1/en/password-security.html}. + +Only you can decide what is appropriate for your situation. We have provided +you with a starting point. We hope it helps. + + \label{BackingUPOtherDBs} \section{Backing Up Third Party Databases} \index[general]{Backing Up Third Party Databases } Modified: trunk/docs/manual/tips.tex =================================================================== --- trunk/docs/manual/tips.tex 2007-10-22 23:00:35 UTC (rev 5782) +++ trunk/docs/manual/tips.tex 2007-10-22 23:43:12 UTC (rev 5783) @@ -602,6 +602,11 @@ assign the user {\bf bacula} a userid and add it to your Director's configuration file in the appropriate Catalog resource. +If you use the make_catalog_backup script provided by Bacula, remember that +you should take care when supplying passwords on the command line. Read the +\ilink{BackingUpBaculaSecurityConsiderations}{Backing Up Your Bacula +Database - Security Considerations } for more information. + \section{Creating Holiday Schedules} \label{holiday} \index[general]{Schedules!Creating Holiday } This was sent by the SourceForge.net collaborative development platform, the world's largest Open Source development site. |
From: <jun...@us...> - 2007-10-23 14:06:53
|
Revision: 5785 http://bacula.svn.sourceforge.net/bacula/?rev=5785&view=rev Author: junkmale Date: 2007-10-23 07:06:53 -0700 (Tue, 23 Oct 2007) Log Message: ----------- When mentioning catalog backups, link to the Catalog Maintenance page. Modified Paths: -------------- trunk/docs/manual/critical.tex trunk/docs/manual/tips.tex Modified: trunk/docs/manual/critical.tex =================================================================== --- trunk/docs/manual/critical.tex 2007-10-23 09:12:51 UTC (rev 5784) +++ trunk/docs/manual/critical.tex 2007-10-23 14:06:53 UTC (rev 5785) @@ -54,10 +54,12 @@ \ilink{Bootstrap File}{BootstrapChapter} chapter. Also, the default bacula-dir.conf comes with a Write Bootstrap directive defined. This allows you to recover the state of your system as of the last backup. -\item Backup your catalog. An example of this is found in the default - bacula-dir.conf file. The backup script is installed by default and should - handle any database, though you may want to make your own local - modifications. +\item Backup your catalog. An example of this is found in the default + bacula-dir.conf file. The backup script is installed by default and + should handle any database, though you may want to make your own local + modifications. See also \ilink{Backing Up Your Bacula Database - + Security Considerations }{BackingUpBaculaSecurityConsiderations} for more + information. \item Write a bootstrap file for the catalog. An example of this is found in the default bacula-dir.conf file. This will allow you to quickly restore your catalog in the event it is wiped out -- otherwise it is many excruciating Modified: trunk/docs/manual/tips.tex =================================================================== --- trunk/docs/manual/tips.tex 2007-10-23 09:12:51 UTC (rev 5784) +++ trunk/docs/manual/tips.tex 2007-10-23 14:06:53 UTC (rev 5785) @@ -604,8 +604,8 @@ If you use the make\_catalog\_backup script provided by Bacula, remember that you should take care when supplying passwords on the command line. Read the -\ilink{BackingUpBaculaSecurityConsiderations}{Backing Up Your Bacula -Database - Security Considerations } for more information. +\ilink{Backing Up Your Bacula +Database - Security Considerations }{BackingUpBaculaSecurityConsiderations} for more information. \section{Creating Holiday Schedules} \label{holiday} This was sent by the SourceForge.net collaborative development platform, the world's largest Open Source development site. |
From: <jun...@us...> - 2007-10-23 14:21:30
|
Revision: 5787 http://bacula.svn.sourceforge.net/bacula/?rev=5787&view=rev Author: junkmale Date: 2007-10-23 07:21:34 -0700 (Tue, 23 Oct 2007) Log Message: ----------- White space changes only. Align the comments and be consistent. Modified Paths: -------------- trunk/docs/manual/postgresql.tex trunk/docs/manual/strategies.tex Modified: trunk/docs/manual/postgresql.tex =================================================================== --- trunk/docs/manual/postgresql.tex 2007-10-23 14:08:20 UTC (rev 5786) +++ trunk/docs/manual/postgresql.tex 2007-10-23 14:21:34 UTC (rev 5787) @@ -230,8 +230,8 @@ \begin{verbatim} dbname = bacula; user = bacula; password = "secret" ... and ... - # WARNING!!! Passing the password via the command line is insecure. - # see comments in make_catalog_backup for details. + # WARNING!!! Passing the password via the command line is insecure. + # see comments in make_catalog_backup for details. RunBeforeJob = "/etc/make_catalog_backup bacula bacula secret" \end{verbatim} \normalsize Modified: trunk/docs/manual/strategies.tex =================================================================== --- trunk/docs/manual/strategies.tex 2007-10-23 14:08:20 UTC (rev 5786) +++ trunk/docs/manual/strategies.tex 2007-10-23 14:21:34 UTC (rev 5787) @@ -231,11 +231,11 @@ Storage = Tape Messages = Standard Pool = Default - # This creates an ASCII copy of the catalog - # WARNING!!! Passing the password via the command line is insecure. - # see comments in make_catalog_backup for details. + # This creates an ASCII copy of the catalog + # WARNING!!! Passing the password via the command line is insecure. + # see comments in make_catalog_backup for details. RunBeforeJob = "/usr/lib/bacula/make_catalog_backup -u bacula" - # This deletes the copy of the catalog, and ejects the tape + # This deletes the copy of the catalog, and ejects the tape RunAfterJob = "/etc/bacula/end_of_backup.sh" Write Bootstrap = "/var/lib/bacula/BackupCatalog.bsr" Max Start Delay = 22h This was sent by the SourceForge.net collaborative development platform, the world's largest Open Source development site. |
From: <ke...@us...> - 2007-11-02 11:21:29
|
Revision: 5830 http://bacula.svn.sourceforge.net/bacula/?rev=5830&view=rev Author: kerns Date: 2007-11-02 04:21:33 -0700 (Fri, 02 Nov 2007) Log Message: ----------- Update Modified Paths: -------------- trunk/docs/manual/console.tex trunk/docs/manual/gui.tex trunk/docs/manual/install.tex Modified: trunk/docs/manual/console.tex =================================================================== --- trunk/docs/manual/console.tex 2007-11-02 10:21:04 UTC (rev 5829) +++ trunk/docs/manual/console.tex 2007-11-02 11:21:33 UTC (rev 5830) @@ -1047,10 +1047,9 @@ hours, and a listing of the last ten terminated jobs with their statuses. The scheduled jobs summary will include the Volume name to be used. You should be aware of two things: 1. to obtain the volume name, the code -% TODO: use bullets here or be consistent with numbering items - goes through the same code that will be used when the job runs, which - means that it may prune or recycle a Volume; 2. The Volume listed is - only a best guess. The Volume actually used may be different because of + goes through the same code that will be used when the job runs, but it + does not do pruning nor recycling of Volumes; 2. The Volume listed is + at best a guess. The Volume actually used may be different because of the time difference (more durations may expire when the job runs) and another job could completely fill the Volume requiring a new one. Modified: trunk/docs/manual/gui.tex =================================================================== --- trunk/docs/manual/gui.tex 2007-11-02 10:21:04 UTC (rev 5829) +++ trunk/docs/manual/gui.tex 2007-11-02 11:21:33 UTC (rev 5830) @@ -34,7 +34,7 @@ To build bat, you will need to have Qt4 >= 4.2 loaded (libraries and the devel libraries) as well as the QWT graphics package. Please see the \ilink{enable-bat}{enablebat} section of the Installation - chapter of this manual for the details. + chapter of this manual for the details of how to build it. The major bat features are: \begin{itemize} Modified: trunk/docs/manual/install.tex =================================================================== --- trunk/docs/manual/install.tex 2007-11-02 10:21:04 UTC (rev 5829) +++ trunk/docs/manual/install.tex 2007-11-02 11:21:33 UTC (rev 5830) @@ -694,9 +694,11 @@ libqt4 and libqt4-devel (libqt4-dev on Debian) libraries, and you want to use the Bacula Administration Tool (bat) GUI Console interface to Bacula, you must specify this option. Doing so will build everything in - the {\bf src/qt-console} directory. In addition to the Qt4 libraries, - bat needs the qwt package installed on your system. Please see the next - configure item for the details. + the {\bf src/qt-console} directory. The build with enable-bat will work + only with a full Bacula build (i.e. it will not work with a client-only + build). In addition to the Qt4 libraries, linking bat requires + the qwt package installed on your system. Please see the next + configure option (with-qwt) for how to build the qwt package. Qt4 is available on OpenSUSE 10.2, CentOS 5, Fedora, and Debian. If it is not available on your system, you can download the {\bf depkgs-qt} This was sent by the SourceForge.net collaborative development platform, the world's largest Open Source development site. |
From: <ke...@us...> - 2007-11-11 15:28:01
|
Revision: 5908 http://bacula.svn.sourceforge.net/bacula/?rev=5908&view=rev Author: kerns Date: 2007-11-11 07:28:01 -0800 (Sun, 11 Nov 2007) Log Message: ----------- Updates from Tobias Rautenkranz Modified Paths: -------------- trunk/docs/manual/verify.tex trunk/docs/manual-de/verify.tex trunk/docs/manual-fr/verify.tex Modified: trunk/docs/manual/verify.tex =================================================================== --- trunk/docs/manual/verify.tex 2007-11-11 15:14:39 UTC (rev 5907) +++ trunk/docs/manual/verify.tex 2007-11-11 15:28:01 UTC (rev 5908) @@ -327,34 +327,38 @@ # FileSet { Name = "Verify Set" - Include = verify=pins1 signature=SHA1 { - /boot - /bin - /sbin - /usr/bin - /lib - /root/.ssh - /home/kern/.ssh - /var/named - /etc/sysconfig - /etc/ssh - /etc/security - /etc/exports - /etc/rc.d/init.d - /etc/sendmail.cf - /etc/sysctl.conf - /etc/services - /etc/xinetd.d - /etc/hosts.allow - /etc/hosts.deny - /etc/hosts - /etc/modules.conf - /etc/named.conf - /etc/pam.d - /etc/resolv.conf + Include { + Options { + verify=pins1 + signature=SHA1 + } + File = /boot + File = /bin + File = /sbin + File = /usr/bin + File = /lib + File = /root/.ssh + File = /home/kern/.ssh + File = /var/named + File = /etc/sysconfig + File = /etc/ssh + File = /etc/security + File = /etc/exports + File = /etc/rc.d/init.d + File = /etc/sendmail.cf + File = /etc/sysctl.conf + File = /etc/services + File = /etc/xinetd.d + File = /etc/hosts.allow + File = /etc/hosts.deny + File = /etc/hosts + File = /etc/modules.conf + File = /etc/named.conf + File = /etc/pam.d + File = /etc/resolv.conf } Exclude = { } -} +P Client { Name = MatouVerify Address = lmatou Modified: trunk/docs/manual-de/verify.tex =================================================================== --- trunk/docs/manual-de/verify.tex 2007-11-11 15:14:39 UTC (rev 5907) +++ trunk/docs/manual-de/verify.tex 2007-11-11 15:28:01 UTC (rev 5908) @@ -1,12 +1,15 @@ %% %% -\section*{Using Bacula to Improve Computer Security} -\label{_ChapterStart45} +% TODO: this chapter name is confusing ... maybe rename to +% TODO: "File Integrity Checking with Bacula"? +\chapter{Using Bacula to Improve Computer Security} +\label{VerifyChapter} \index[general]{Security!Using Bacula to Improve Computer } \index[general]{Using Bacula to Improve Computer Security } -\addcontentsline{toc}{section}{Using Bacula to Improve Computer Security} +% TODO: only those two digest algorithms? +% TODO: can it use multiple at a time? (record and use both SHA1 and MD5?) Since Bacula maintains a catalog of files, their attributes, and either SHA1 or MD5 signatures, it can be an ideal tool for improving computer security. This is done by making a snapshot of your system files with a {\bf Verify} Job @@ -47,9 +50,8 @@ comparison options on the {\bf Include} statements that you use in the {\bf FileSet} resource of your {\bf Catalog} Jobs. -\subsection*{The Details} +\section{The Details} \index[general]{Details } -\addcontentsline{toc}{subsection}{Details} In the discussion that follows, we will make reference to the Verify Configuration Example that is included below in the {\bf A Verify @@ -102,15 +104,14 @@ changed, you will be notified, and you can determine if it changed because you loaded a new package, or because someone has broken into your computer and modified your files. The example below shows a list of files that I use on my -RedHat 7.3 system. Since I didn't spend a lot of time working on it, it +Red Hat 7.3 system. Since I didn't spend a lot of time working on it, it probably is missing a few important files (if you find one, please send it to me). On the other hand, as long as I don't load any new packages, none of these files change during normal operation of the system. -\subsection*{Running the Verify} +\section{Running the Verify} \index[general]{Running the Verify } \index[general]{Verify!Running the } -\addcontentsline{toc}{subsection}{Running the Verify} The first thing you will want to do is to run an {\bf InitCatalog} level Verify Job. This will initialize the catalog to contain the file information @@ -199,10 +200,9 @@ Verify {\bf Catalog} which will be the default. No differences should be found. -\subsection*{What To Do When Differences Are Found} +\section{What To Do When Differences Are Found} \index[general]{What To Do When Differences Are Found } \index[general]{Found!What To Do When Differences Are } -\addcontentsline{toc}{subsection}{What To Do When Differences Are Found} If you have setup your messages correctly, you should be notified if there are any differences and exactly what they are. For example, below is the email @@ -296,14 +296,13 @@ to modify the {\bf FileSet} to exclude that file (or not to Include it), and then re-run the {\bf InitCatalog}. -The FileSet that is shown below is what I use on my RedHat 7.3 system. With a +The FileSet that is shown below is what I use on my Red Hat 7.3 system. With a bit more thought, you can probably add quite a number of additional files that should be monitored. -\subsection*{A Verify Configuration Example} +\section{A Verify Configuration Example} \index[general]{Verify Configuration Example } \index[general]{Example!Verify Configuration } -\addcontentsline{toc}{subsection}{Verify Configuration Example} \footnotesize \begin{verbatim} @@ -328,34 +327,38 @@ # FileSet { Name = "Verify Set" - Include = verify=pins1 signature=SHA1 { - /boot - /bin - /sbin - /usr/bin - /lib - /root/.ssh - /home/kern/.ssh - /var/named - /etc/sysconfig - /etc/ssh - /etc/security - /etc/exports - /etc/rc.d/init.d - /etc/sendmail.cf - /etc/sysctl.conf - /etc/services - /etc/xinetd.d - /etc/hosts.allow - /etc/hosts.deny - /etc/hosts - /etc/modules.conf - /etc/named.conf - /etc/pam.d - /etc/resolv.conf + Include { + Options { + verify=pins1 + signature=SHA1 + } + File = /boot + File = /bin + File = /sbin + File = /usr/bin + File = /lib + File = /root/.ssh + File = /home/kern/.ssh + File = /var/named + File = /etc/sysconfig + File = /etc/ssh + File = /etc/security + File = /etc/exports + File = /etc/rc.d/init.d + File = /etc/sendmail.cf + File = /etc/sysctl.conf + File = /etc/services + File = /etc/xinetd.d + File = /etc/hosts.allow + File = /etc/hosts.deny + File = /etc/hosts + File = /etc/modules.conf + File = /etc/named.conf + File = /etc/pam.d + File = /etc/resolv.conf } Exclude = { } -} +P Client { Name = MatouVerify Address = lmatou Modified: trunk/docs/manual-fr/verify.tex =================================================================== --- trunk/docs/manual-fr/verify.tex 2007-11-11 15:14:39 UTC (rev 5907) +++ trunk/docs/manual-fr/verify.tex 2007-11-11 15:28:01 UTC (rev 5908) @@ -1,12 +1,15 @@ %% %% -\section*{Using Bacula to Improve Computer Security} -\label{_ChapterStart45} +% TODO: this chapter name is confusing ... maybe rename to +% TODO: "File Integrity Checking with Bacula"? +\chapter{Using Bacula to Improve Computer Security} +\label{VerifyChapter} \index[general]{Security!Using Bacula to Improve Computer } \index[general]{Using Bacula to Improve Computer Security } -\addcontentsline{toc}{section}{Using Bacula to Improve Computer Security} +% TODO: only those two digest algorithms? +% TODO: can it use multiple at a time? (record and use both SHA1 and MD5?) Since Bacula maintains a catalog of files, their attributes, and either SHA1 or MD5 signatures, it can be an ideal tool for improving computer security. This is done by making a snapshot of your system files with a {\bf Verify} Job @@ -47,9 +50,8 @@ comparison options on the {\bf Include} statements that you use in the {\bf FileSet} resource of your {\bf Catalog} Jobs. -\subsection*{The Details} +\section{The Details} \index[general]{Details } -\addcontentsline{toc}{subsection}{Details} In the discussion that follows, we will make reference to the Verify Configuration Example that is included below in the {\bf A Verify @@ -102,15 +104,14 @@ changed, you will be notified, and you can determine if it changed because you loaded a new package, or because someone has broken into your computer and modified your files. The example below shows a list of files that I use on my -RedHat 7.3 system. Since I didn't spend a lot of time working on it, it +Red Hat 7.3 system. Since I didn't spend a lot of time working on it, it probably is missing a few important files (if you find one, please send it to me). On the other hand, as long as I don't load any new packages, none of these files change during normal operation of the system. -\subsection*{Running the Verify} +\section{Running the Verify} \index[general]{Running the Verify } \index[general]{Verify!Running the } -\addcontentsline{toc}{subsection}{Running the Verify} The first thing you will want to do is to run an {\bf InitCatalog} level Verify Job. This will initialize the catalog to contain the file information @@ -199,10 +200,9 @@ Verify {\bf Catalog} which will be the default. No differences should be found. -\subsection*{What To Do When Differences Are Found} +\section{What To Do When Differences Are Found} \index[general]{What To Do When Differences Are Found } \index[general]{Found!What To Do When Differences Are } -\addcontentsline{toc}{subsection}{What To Do When Differences Are Found} If you have setup your messages correctly, you should be notified if there are any differences and exactly what they are. For example, below is the email @@ -296,14 +296,13 @@ to modify the {\bf FileSet} to exclude that file (or not to Include it), and then re-run the {\bf InitCatalog}. -The FileSet that is shown below is what I use on my RedHat 7.3 system. With a +The FileSet that is shown below is what I use on my Red Hat 7.3 system. With a bit more thought, you can probably add quite a number of additional files that should be monitored. -\subsection*{A Verify Configuration Example} +\section{A Verify Configuration Example} \index[general]{Verify Configuration Example } \index[general]{Example!Verify Configuration } -\addcontentsline{toc}{subsection}{Verify Configuration Example} \footnotesize \begin{verbatim} @@ -328,34 +327,38 @@ # FileSet { Name = "Verify Set" - Include = verify=pins1 signature=SHA1 { - /boot - /bin - /sbin - /usr/bin - /lib - /root/.ssh - /home/kern/.ssh - /var/named - /etc/sysconfig - /etc/ssh - /etc/security - /etc/exports - /etc/rc.d/init.d - /etc/sendmail.cf - /etc/sysctl.conf - /etc/services - /etc/xinetd.d - /etc/hosts.allow - /etc/hosts.deny - /etc/hosts - /etc/modules.conf - /etc/named.conf - /etc/pam.d - /etc/resolv.conf + Include { + Options { + verify=pins1 + signature=SHA1 + } + File = /boot + File = /bin + File = /sbin + File = /usr/bin + File = /lib + File = /root/.ssh + File = /home/kern/.ssh + File = /var/named + File = /etc/sysconfig + File = /etc/ssh + File = /etc/security + File = /etc/exports + File = /etc/rc.d/init.d + File = /etc/sendmail.cf + File = /etc/sysctl.conf + File = /etc/services + File = /etc/xinetd.d + File = /etc/hosts.allow + File = /etc/hosts.deny + File = /etc/hosts + File = /etc/modules.conf + File = /etc/named.conf + File = /etc/pam.d + File = /etc/resolv.conf } Exclude = { } -} +P Client { Name = MatouVerify Address = lmatou This was sent by the SourceForge.net collaborative development platform, the world's largest Open Source development site. |
From: <ke...@us...> - 2007-12-03 20:08:19
|
Revision: 6018 http://bacula.svn.sourceforge.net/bacula/?rev=6018&view=rev Author: kerns Date: 2007-12-03 12:08:21 -0800 (Mon, 03 Dec 2007) Log Message: ----------- Remove html.sty Modified Paths: -------------- trunk/docs/manual/version.tex Removed Paths: ------------- trunk/docs/manual/html.sty Deleted: trunk/docs/manual/html.sty =================================================================== --- trunk/docs/manual/html.sty 2007-12-03 19:27:38 UTC (rev 6017) +++ trunk/docs/manual/html.sty 2007-12-03 20:08:21 UTC (rev 6018) @@ -1,1166 +0,0 @@ -% -% $Id: html.sty,v 1.39 2001/10/01 22:47:06 RRM Exp $ -% LaTeX2HTML Version 2K.1 : html.sty -% -% This file contains definitions of LaTeX commands which are -% processed in a special way by the translator. -% For example, there are commands for embedding external hypertext links, -% for cross-references between documents or for including raw HTML. -% This file includes the comments.sty file v2.0 by Victor Eijkhout -% In most cases these commands do nothing when processed by LaTeX. -% -% Place this file in a directory accessible to LaTeX (i.e., somewhere -% in the TEXINPUTS path.) -% -% NOTE: This file works with LaTeX 2.09 or (the newer) LaTeX2e. -% If you only have LaTeX 2.09, some complex LaTeX2HTML features -% like support for segmented documents are not available. - -% Changes: -% See the change log at end of file. - - -% Exit if the style file is already loaded -% (suggested by Lee Shombert <la...@po...> -\ifx \htmlstyloaded\relax \endinput\else\let\htmlstyloaded\relax\fi -\makeatletter - -% allow for the hyperref package to be cleanly loaded -% either before or after this package, -% and ensure it is already loaded, when using pdf-TeX - -\ifx\undefined\hyperref - \ifx\pdfoutput\undefined \let\pdfunknown\relax - \let\html@new=\newcommand - \else - \ifx\pdfoutput\relax \let\pdfunknown\relax - \RequirePackage{hyperref}\let\html@new=\renewcommand - \else - \RequirePackage{hyperref}\let\html@new=\newcommand - \fi - \fi -\else - \let\html@new=\renewcommand -\fi - -\providecommand{\latextohtml}{\LaTeX2\texttt{HTML}} - -%%% LINKS TO EXTERNAL DOCUMENTS -% -% This can be used to provide links to arbitrary documents. -% The first argumment should be the text that is going to be -% highlighted and the second argument a URL. -% The hyperlink will appear as a hyperlink in the HTML -% document and as a footnote in the dvi or ps files. -% -\ifx\pdfunknown\relax - \html@new{\htmladdnormallinkfoot}[2]{#1\footnote{#2}} -\else - \def\htmladdnormallinkfoot#1#2{\footnote{\href{#2}{#1}}} -\fi - -% This is an alternative definition of the command above which -% will ignore the URL in the dvi or ps files. -\ifx\pdfunknown\relax - \html@new{\htmladdnormallink}[2]{#1} -\else - \def\htmladdnormallink#1#2{\href{#2}{#1}} -\fi - -% This command takes as argument a URL pointing to an image. -% The image will be embedded in the HTML document but will -% be ignored in the dvi and ps files. -% -\ifx\pdfunknown\relax - \html@new{\htmladdimg}[1]{} -\else - \def\htmladdimg#1{\hyperimage{#1}} -\fi - - -%%% CROSS-REFERENCES BETWEEN (LOCAL OR REMOTE) DOCUMENTS -% -% This can be used to refer to symbolic labels in other Latex -% documents that have already been processed by the translator. -% The arguments should be: -% #1 : the URL to the directory containing the external document -% #2 : the path to the labels.pl file of the external document. -% If the external document lives on a remote machine then labels.pl -% must be copied on the local machine. -% -%e.g. \externallabels{http://cbl.leeds.ac.uk/nikos/WWW/doc/tex2html/latex2html} -% {/usr/cblelca/nikos/tmp/labels.pl} -% The arguments are ignored in the dvi and ps files. -% -\newcommand{\externallabels}[2]{} - - -% This complements the \externallabels command above. The argument -% should be a label defined in another latex document and will be -% ignored in the dvi and ps files. -% -\newcommand{\externalref}[1]{} - - -% Suggested by Uffe Engberg (http://www.brics.dk/~engberg/) -% This allows the same effect for citations in external bibliographies. -% An \externallabels command must be given, locating a labels.pl file -% which defines the location and keys used in the external .html file. -% -\newcommand{\externalcite}{\nocite} - -% This allows a section-heading in the TOC or mini-TOC to be just -% a hyperlink to an external document. -% -% \htmladdTOClink[<path_to_labels>]{<section-level>}{<title>}{<URL>} -% where <section-level> is 'chapter' , 'section' , 'subsection' etc. -% and <path_to_labels> is the path to find a labels.pl file, -% so that external cross-referencing may work, as with \externallabels -% -%\ifx\pdfunknown\relax - \newcommand{\htmladdTOClink}[4][]{} -% -% can do something here, using the \pdfoutline primitive -%\else -% \def\htmladdTOClink#1#2#3#4{\pdfoutline user {/S /URI /URI #4} -% name{#2} count{#1}{#3}} -%\fi - - -%%% HTMLRULE -% This command adds a horizontal rule and is valid even within -% a figure caption. -% Here we introduce a stub for compatibility. -\newcommand{\htmlrule}{\protect\HTMLrule} -\newcommand{\HTMLrule}{\@ifstar\htmlrulestar\htmlrulestar} -\newcommand{\htmlrulestar}[1]{} - -%%% HTMLCLEAR -% This command puts in a <BR> tag, with CLEAR="ALL" -\newcommand{\htmlclear}{} - -% This command adds information within the <BODY> ... </BODY> tag -% -\newcommand{\bodytext}[1]{} -\newcommand{\htmlbody}{} - - -%%% HYPERREF -% Suggested by Eric M. Carol <eric@ca.utoronto.utcc.enfm> -% Similar to \ref but accepts conditional text. -% The first argument is HTML text which will become ``hyperized'' -% (underlined). -% The second and third arguments are text which will appear only in the paper -% version (DVI file), enclosing the fourth argument which is a reference to a label. -% -%e.g. \hyperref{using the tracer}{using the tracer (see Section}{)}{trace} -% where there is a corresponding \label{trace} -% -% avoid possible confict with hyperref package -\ifx\undefined\hyperref - \newcommand{\hyperrefhyper}[4]{#4}% - \def\next{\newcommand}% -\else - \let\hyperrefhyper\hyperref - \def\next{\renewcommand}% -\fi -\next{\hyperref}{\hyperrefi[]}\let\next=\relax - -\def\hyperrefi[#1]{{\def\next{#1}\def\tmp{}% - \ifx\next\tmp\aftergroup\hyperrefdef - \else\def\tmp{ref}\ifx\next\tmp\aftergroup\hyperrefref - \else\def\tmp{pageref}\ifx\next\tmp\aftergroup\hyperrefpageref - \else\def\tmp{page}\ifx\next\tmp\aftergroup\hyperrefpage - \else\def\tmp{noref}\ifx\next\tmp\aftergroup\hyperrefnoref - \else\def\tmp{no}\ifx\next\tmp\aftergroup\hyperrefno - \else\def\tmp{hyper}\ifx\next\tmp\aftergroup\hyperrefhyper - \else\def\tmp{html}\ifx\next\tmp\aftergroup\hyperrefhtml - \else\typeout{*** unknown option \next\space to hyperref ***}% - \fi\fi\fi\fi\fi\fi\fi\fi}} -\newcommand{\hyperrefdef}[4]{#2\ref{#4}#3} -\newcommand{\hyperrefpageref}[4]{#2\pageref{#4}#3} -\newcommand{\hyperrefnoref}[3]{#2} -\let\hyperrefref=\hyperrefdef -\let\hyperrefpage=\hyperrefpageref -\let\hyperrefno=\hyperrefnoref -\ifx\undefined\hyperrefhyper\newcommand{\hyperrefhyper}[4]{#4}\fi -\let\hyperrefhtml=\hyperrefdef - -%%% HYPERCITE --- added by RRM -% Suggested by Stephen Simpson <si...@ma...> -% effects the same ideas as in \hyperref, but for citations. -% It does not allow an optional argument to the \cite, in LaTeX. -% -% \hypercite{<html-text>}{<LaTeX-text>}{<opt-text>}{<key>} -% -% uses the pre/post-texts in LaTeX, with a \cite{<key>} -% -% \hypercite[ext]{<html-text>}{<LaTeX-text>}{<key>} -% \hypercite[ext]{<html-text>}{<LaTeX-text>}[<prefix>]{<key>} -% -% uses the pre/post-texts in LaTeX, with a \nocite{<key>} -% the actual reference comes from an \externallabels file. -% -\newcommand{\hypercite}{\hypercitei[]} -\def\hypercitei[#1]{{\def\next{#1}\def\tmp{}% - \ifx\next\tmp\aftergroup\hypercitedef - \else\def\tmp{int}\ifx\next\tmp\aftergroup\hyperciteint - \else\def\tmp{cite}\ifx\next\tmp\aftergroup\hypercitecite - \else\def\tmp{ext}\ifx\next\tmp\aftergroup\hyperciteext - \else\def\tmp{nocite}\ifx\next\tmp\aftergroup\hypercitenocite - \else\def\tmp{no}\ifx\next\tmp\aftergroup\hyperciteno - \else\typeout{*** unknown option \next\space to hypercite ***}% - \fi\fi\fi\fi\fi\fi}} -\newcommand{\hypercitedef}[4]{#2{\def\tmp{#3}\def\emptyopt{}% - \ifx\tmp\emptyopt\cite{#4}\else\cite[#3]{#4}\fi}} -\newcommand{\hypercitenocite}[2]{#2\hypercitenocitex[]} -\def\hypercitenocitex[#1]#2{\nocite{#2}} -\let\hypercitecite=\hypercitedef -\let\hyperciteint=\hypercitedef -\let\hyperciteext=\hypercitenocite -\let\hyperciteno=\hypercitenocite - -%%% HTMLREF -% Reference in HTML version only. -% Mix between \htmladdnormallink and \hyperref. -% First arg is text for in both versions, second is label for use in HTML -% version. -\ifx\pdfunknown\relax - \html@new{\htmlref}[2]{#1} -\else - \def\htmlref#1#2{\hyperefhyper[#2]{#1}} -\fi - -%%% HTMLCITE -% Reference in HTML version only. -% Mix between \htmladdnormallink and \hypercite. -% First arg is text for both versions, second is citation for use in HTML -% version. -\newcommand{\htmlcite}[2]{#1} - - -%%% HTMLIMAGE -% This command can be used inside any environment that is converted -% into an inlined image (eg a "figure" environment) in order to change -% the way the image will be translated. The argument of \htmlimage -% is really a string of options separated by commas ie -% [scale=<scale factor>],[external],[thumbnail=<reduction factor> -% The scale option allows control over the size of the final image. -% The ``external'' option will cause the image not to be inlined -% (images are inlined by default). External images will be accessible -% via a hypertext link. -% The ``thumbnail'' option will cause a small inlined image to be -% placed in the caption. The size of the thumbnail depends on the -% reduction factor. The use of the ``thumbnail'' option implies -% the ``external'' option. -% -% Example: -% \htmlimage{scale=1.5,external,thumbnail=0.2} -% will cause a small thumbnail image 1/5th of the original size to be -% placed in the final document, pointing to an external image 1.5 -% times bigger than the original. -% -\newcommand{\htmlimage}[1]{} - - -% \htmlborder causes a border to be placed around an image or table -% when the image is placed within a <TABLE> cell. -\newcommand{\htmlborder}[1]{} - -% Put \begin{makeimage}, \end{makeimage} around LaTeX to ensure its -% translation into an image. -% This shields sensitive text from being translated. -\newenvironment{makeimage}{}{} - - -% A dummy environment that can be useful to alter the order -% in which commands are processed, in LaTeX2HTML -\newenvironment{tex2html_deferred}{}{} - - -%%% HTMLADDTONAVIGATION -% This command appends its argument to the buttons in the navigation -% panel. It is ignored by LaTeX. -% -% Example: -% \htmladdtonavigation{\htmladdnormallink -% {\htmladdimg{http://server/path/to/gif}} -% {http://server/path}} -\newcommand{\htmladdtonavigation}[1]{} - - -%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% -% based upon Eijkhout's comment.sty v2.0 -% with modifications to avoid conflicts with later versions -% of this package, should a user be requiring it. -% Ross Moore, 10 March 1999 -%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% -% Comment.sty version 2.0, 19 June 1992 -% selectively in/exclude pieces of text: the user can define new -% comment versions, and each is controlled separately. -% This style can be used with plain TeX or LaTeX, and probably -% most other packages too. -% -% Examples of use in LaTeX and TeX follow \endinput -% -% Author -% Victor Eijkhout -% Department of Computer Science -% University Tennessee at Knoxville -% 104 Ayres Hall -% Knoxville, TN 37996 -% USA -% -% eij...@cs... -% -% Usage: all text included in between -% \comment ... \endcomment -% or \begin{comment} ... \end{comment} -% is discarded. The closing command should appear on a line -% of its own. No starting spaces, nothing after it. -% This environment should work with arbitrary amounts -% of comment. -% -% Other 'comment' environments are defined by -% and are selected/deselected with -% \includecomment{versiona} -% \excludecoment{versionb} -% -% These environments are used as -% \versiona ... \endversiona -% or \begin{versiona} ... \end{versiona} -% with the closing command again on a line of its own. -% -% Basic approach: -% to comment something out, scoop up every line in verbatim mode -% as macro argument, then throw it away. -% For inclusions, both the opening and closing comands -% are defined as noop -% -% Changed \next to \html@next to prevent clashes with other sty files -% (mi...@em...) -% Changed \html@next to \htmlnext so the \makeatletter and -% \makeatother commands could be removed (they were causing other -% style files - changebar.sty - to crash) (ni...@cb...) -% Changed \htmlnext back to \html@next... - -\def\makeinnocent#1{\catcode`#1=12 } -\def\csarg#1#2{\expandafter#1\csname#2\endcsname} - -\def\ThrowAwayComment#1{\begingroup - \def\CurrentComment{#1}% - \let\do\makeinnocent \dospecials - \makeinnocent\^^L% and whatever other special cases -%%RRM -%% use \xhtmlComment for \xComment -%% use \html@next for \next - \endlinechar`\^^M \catcode`\^^M=12 \xhtmlComment} -{\catcode`\^^M=12 \endlinechar=-1 % - \gdef\xhtmlComment#1^^M{\def\test{#1}\edef\test{\meaning\test} - \csarg\ifx{PlainEnd\CurrentComment Test}\test - \let\html@next\endgroup - \else \csarg\ifx{LaLaEnd\CurrentComment Test}\test - \edef\html@next{\endgroup\noexpand\end{\CurrentComment}} - \else \csarg\ifx{LaInnEnd\CurrentComment Test}\test - \edef\html@next{\endgroup\noexpand\end{\CurrentComment}} - \else \let\html@next\xhtmlComment - \fi \fi \fi \html@next} -} - -%%\def\includecomment %%RRM -\def\htmlincludecomment - #1{\expandafter\def\csname#1\endcsname{}% - \expandafter\def\csname end#1\endcsname{}} -%%\def\excludecomment %%RRM -\def\htmlexcludecomment - #1{\expandafter\def\csname#1\endcsname{\ThrowAwayComment{#1}}% - {\escapechar=-1\relax - \edef\tmp{\string\\end#1}% - \csarg\xdef{PlainEnd#1Test}{\meaning\tmp}% - \edef\tmp{\string\\end\string\{#1\string\}}% - \csarg\xdef{LaLaEnd#1Test}{\meaning\tmp}% - \edef\tmp{\string\\end \string\{#1\string\}}% - \csarg\xdef{LaInnEnd#1Test}{\meaning\tmp}% - }} - -%%\excludecomment{comment} %%RRM -\htmlexcludecomment{comment} -%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% -% end Comment.sty -%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% -\let\includecomment=\htmlincludecomment -\let\excludecomment=\htmlexcludecomment - -% -% Alternative code by Robin Fairbairns, 22 September 1997 -% revised to cope with % and unnested { }, by Ross Moore, 4 July 1998 -% further revised to cope with & and # in tables, 10 March 1999 -% -\def\raw@catcodes{\catcode`\%=12 \catcode`\{=12 \catcode`\}=12 - \catcode`\&=12 \catcode`\#=12 } -\newcommand\@gobbleenv{\bgroup\raw@catcodes - \let\reserved@a\@currenvir\@gobble@nv} -\bgroup - \def\expansionhead{\gdef\@gobble@nv@i##1} - \def\expansiontail{{\def\reserved@b{##1}\@gobble@nv@ii}} - \def\expansionheadii{\long\gdef\@gobble@nv##1\end} - \def\expansiontailii{{\@gobble@nv@i}} - \def\expansionmidii{##2} - \raw@catcodes\relax - \expandafter\expansionhead\expandafter}\expansiontail -\egroup -\long\gdef\@gobble@nv#1\end#2{\@gobble@nv@i} -%\long\def\@gobble@nv#1\end#2{\def\reserved@b{#2}% -\def\@gobble@nv@ii{% - \ifx\reserved@a\reserved@b - \edef\reserved@a{\egroup\noexpand\end{\reserved@a}}% - \expandafter\reserved@a - \else - \expandafter\@gobble@nv - \fi} - -\renewcommand{\htmlexcludecomment}[1]{% - \csname newenvironment\endcsname{#1}{\@gobbleenv}{}} -\newcommand{\htmlreexcludecomment}[1]{% - \csname renewenvironment\endcsname{#1}{\@gobbleenv}{}} - -%%% RAW HTML -% -% Enclose raw HTML between a \begin{rawhtml} and \end{rawhtml}. -% The html environment ignores its body -% -\htmlexcludecomment{rawhtml} - - -%%% HTML ONLY -% -% Enclose LaTeX constructs which will only appear in the -% HTML output and will be ignored by LaTeX with -% \begin{htmlonly} and \end{htmlonly} -% -\htmlexcludecomment{htmlonly} -% Shorter version -\newcommand{\html}[1]{} - -% for images.tex only -\htmlexcludecomment{imagesonly} - -%%% LaTeX ONLY -% Enclose LaTeX constructs which will only appear in the -% DVI output and will be ignored by latex2html with -%\begin{latexonly} and \end{latexonly} -% -\newenvironment{latexonly}{}{} -% Shorter version -\newcommand{\latex}[1]{#1} - - -%%% LaTeX or HTML -% Combination of \latex and \html. -% Say \latexhtml{this should be latex text}{this html text} -% -%\newcommand{\latexhtml}[2]{#1} -\long\def\latexhtml#1#2{#1} - - -%%% tracing the HTML conversions -% This alters the tracing-level within the processing -% performed by latex2html by adjusting $VERBOSITY -% (see latex2html.config for the appropriate values) -% -\newcommand{\htmltracing}[1]{} -\newcommand{\htmltracenv}[1]{} - - -%%% \strikeout for HTML only -% uses <STRIKE>...</STRIKE> tags on the argument -% LaTeX just gobbles it up. -\newcommand{\strikeout}[1]{} - -%%% \htmlurl and \url -% implement \url as the simplest thing, if not already defined -% let \htmlurl#1 be equivalent to it -% -\def\htmlurlx#1{\begin{small}\texttt{#1}\end{small}}% -\expandafter\ifx\csname url\endcsname\relax - \let\htmlurl=\htmlurlx \else \let\htmlurl=\url \fi - - -%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% -%%% JCL - stop input here if LaTeX2e is not present -%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% -\ifx\if@compatibility\undefined - %LaTeX209 - \makeatother\relax\expandafter\endinput -\fi -\if@compatibility - %LaTeX2e in LaTeX209 compatibility mode - \makeatother\relax\expandafter\endinput -\fi - -%\let\real@TeXlogo = \TeX -%\DeclareRobustCommand{\TeX}{\relax\real@TeXlogo} - -%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% -% -% Start providing LaTeX2e extension: -% This is currently: -% - additional optional argument for \htmladdimg -% - support for segmented documents -% - -\ProvidesPackage{html} - [1999/07/19 v1.38 hypertext commands for latex2html (nd, hws, rrm)] - -% -% Ensure that \includecomment and \excludecomment are bound -% to the version defined here. -% -\AtBeginDocument{% - \let\includecomment=\htmlincludecomment - \let\excludecomment=\htmlexcludecomment - \htmlreexcludecomment{comment}} - -%%% bind \htmlurl to \url if that is later loaded -% -\expandafter\ifx\csname url\endcsname\relax - \AtBeginDocument{\@ifundefined{url}{}{\let\htmlurl=\url}}\fi - -%%%%MG - -% This command takes as argument a URL pointing to an image. -% The image will be embedded in the HTML document but will -% be ignored in the dvi and ps files. The optional argument -% denotes additional HTML tags. -% -% Example: \htmladdimg[ALT="portrait" ALIGN=CENTER]{portrait.gif} -% -\ifx\pdfunknown\relax - \renewcommand{\htmladdimg}[2][]{} -\else - \renewcommand{\htmladdimg}[2][]{\hyperimage{#2}} -\fi - -%%% HTMLRULE for LaTeX2e -% This command adds a horizontal rule and is valid even within -% a figure caption. -% -% This command is best used with LaTeX2e and HTML 3.2 support. -% It is like \hrule, but allows for options via key--value pairs -% as follows: \htmlrule[key1=value1, key2=value2, ...] . -% Use \htmlrule* to suppress the <BR> tag. -% Eg. \htmlrule[left, 15, 5pt, "none", NOSHADE] produces -% <BR CLEAR="left"><HR NOSHADE SIZE="15">. -% Renew the necessary part. -\renewcommand{\htmlrulestar}[1][all]{} - -%%% HTMLCLEAR for LaTeX2e -% This command puts in a <BR> tag, with optional CLEAR="<attrib>" -% -\renewcommand{\htmlclear}[1][all]{} - -%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% -% -% renew some definitions to allow optional arguments -% -% The description of the options is missing, as yet. -% -\renewcommand{\latextohtml}{\textup{\LaTeX2\texttt{HTML}}} -\ifx\pdfunknown\relax - \renewcommand{\htmladdnormallinkfoot}[3][]{#2\footnote{#3}} - \renewcommand{\htmladdnormallink}[3][]{#2} -\else - \renewcommand{\htmladdnormallinkfoot}[1][]{\def\next{#1}% - \ifx\next\@empty\def\next{\htmladdnonamedlinkfoot}% - \else\def\next{\htmladdnamedlinkfoot{#1}}\fi \next} - \newcommand{\htmladdnonamedlinkfoot}[2]{% - #1\footnote{\href{#2}{#2}}} - \newcommand{\htmladdnamedlinkfoot}[3]{% - \hypertarget{#1}{#2}\footnote{\href{#3}{#3}}} - \renewcommand{\htmladdnormallink}[1][]{\def\next{#1}% - \ifx\next\@empty\def\next{\htmladdnonamedlink}% - \else\def\next{\htmladdnamedlink{#1}}\fi \next} - \newcommand{\htmladdnonamedlink}[2]{\href{#2}{#1}} - \newcommand{\htmladdnamedlink}[3]{% - \hypertarget{#1}{\hskip2bp}\href{#3}{#2}} -\fi - -\renewcommand{\htmlbody}[1][]{} -\renewcommand{\htmlborder}[2][]{} -\renewcommand{\externallabels}[3][]{} -\renewcommand{\externalref}[2][]{} -\renewcommand{\externalcite}[1][]{\nocite} -\renewcommand{\hyperref}[1][]{\hyperrefi[#1]} -\renewcommand{\hypercite}[1][]{\hypercitei[#1]} -\renewcommand{\hypercitenocite}[2]{#2\hypercitenocitex} -\renewcommand{\hypercitenocitex}[2][]{\nocite{#2}} -\let\hyperciteno=\hypercitenocite -\let\hyperciteext=\hypercitenocite - -\ifx\pdfunknown\relax - \renewcommand{\htmlimage}[2][]{} - \renewcommand{\htmlref}[2][]{#2{\def\tmp{#1}\ifx\tmp\@empty - \aftergroup\htmlrefdef\else\aftergroup\htmlrefext\fi}} - \newcommand{\htmlrefdef}[1]{} - \newcommand{\htmlrefext}[2][]{} - \renewcommand{\htmlcite}[2][]{#2{\def\tmp{#1}\ifx\tmp\@empty - \aftergroup\htmlcitedef\else\aftergroup\htmlciteext\fi}} - \newcommand{\htmlciteext}[2][]{} -\else - \renewcommand{\htmlimage}[2][]{\hyperimage{#2}} - \renewcommand{\htmlref}[1][]{\def\htmp@{#1}\ifx\htmp@\@empty - \def\htmp@{\htmlrefdef}\else\def\htmp@{\htmlrefext{#1}}\fi\htmp@} - \newcommand{\htmlrefdef}[2]{\hyperref[hyper][#2]{#1}} - \newcommand{\htmlrefext}[3]{% - \hypertarget{#1}{\hskip2bp}\hyperref[hyper][#3]{#2}} - \renewcommand{\htmlcite}[2][]{#2{\def\htmp@{#1}\ifx\htmp@\@empty - \aftergroup\htmlcitedef\else\aftergroup\htmlciteext\fi}} - \newcommand{\htmlciteext}[1][]{\cite} -\fi -\newcommand{\htmlcitedef}[1]{ \nocite{#1}} - -%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% -% -% HTML HTMLset HTMLsetenv -% -% These commands do nothing in LaTeX, but can be used to place -% HTML tags or set Perl variables during the LaTeX2HTML processing; -% They are intended for expert use only. - -\newcommand{\HTMLcode}[2][]{} -\ifx\undefined\HTML\newcommand{\HTML}[2][]{}\else -\typeout{*** Warning: \string\HTML\space had an incompatible definition ***}% -\typeout{*** instead use \string\HTMLcode\space for raw HTML code ***}% -\fi -\newcommand{\HTMLset}[3][]{} -\newcommand{\HTMLsetenv}[3][]{} - -%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% -% -% The following commands pertain to document segmentation, and -% were added by Herbert Swan <dp...@ed...> (with help from -% Michel Goossens <goo...@ce...>): -% -% -% This command inputs internal latex2html tables so that large -% documents can to partitioned into smaller (more manageable) -% segments. -% -\newcommand{\internal}[2][internals]{} - -% -% Define a dummy stub \htmlhead{}. This command causes latex2html -% to define the title of the start of a new segment. It is not -% normally placed in the user's document. Rather, it is passed to -% latex2html via a .ptr file written by \segment. -% -\newcommand{\htmlhead}[3][]{} - -% In the LaTeX2HTML version this will eliminate the title line -% generated by a \segment command, but retains the title string -% for use in other places. -% -\newcommand{\htmlnohead}{} - - -% In the LaTeX2HTML version this put a URL into a <BASE> tag -% within the <HEAD>...</HEAD> portion of a document. -% -\ifx\pdfunknown\relax - \newcommand{\htmlbase}[1]{} -\else - \let\htmlbase=\hyperbaseurl -\fi - - -% Include style information into the stylesheet; e.g. CSS -% -\newcommand{\htmlsetstyle}[3][]{} -\newcommand{\htmladdtostyle}[3][]{} - -% Define a style-class for information in a particular language -% -\newcommand{\htmllanguagestyle}[2][]{} - - -% -% The dummy command \endpreamble is needed by latex2html to -% mark the end of the preamble in document segments that do -% not contain a \begin{document} -% -\newcommand{\startdocument}{} - - -% \tableofchildlinks, \htmlinfo -% by Ross Moore --- extensions dated 27 September 1997 -% -% These do nothing in LaTeX but for LaTeX2HTML they mark -% where the table of child-links and info-page should be placed, -% when the user wants other than the default. -% \tableofchildlinks % put mini-TOC at this location -% \tableofchildlinks[off] % not on current page -% \tableofchildlinks[none] % not on current and subsequent pages -% \tableofchildlinks[on] % selectively on current page -% \tableofchildlinks[all] % on current and all subsequent pages -% \htmlinfo % put info-page at this location -% \htmlinfo[off] % no info-page in current document -% \htmlinfo[none] % no info-page in current document -% *-versions omit the preceding <BR> tag. -% -\newcommand{\tableofchildlinks}{% - \@ifstar\tableofchildlinksstar\tableofchildlinksstar} -\newcommand{\tableofchildlinksstar}[1][]{} - -\newcommand{\htmlinfo}{\@ifstar\htmlinfostar\htmlinfostar} -\newcommand{\htmlinfostar}[1][]{} - - -% This redefines \begin to allow for an optional argument -% which is used by LaTeX2HTML to specify `style-sheet' information - -\let\realLaTeX@begin=\begin -\renewcommand{\begin}[1][]{\realLaTeX@begin} - - -% -% Allocate a new set of section counters, which will get incremented -% for "*" forms of sectioning commands, and for a few miscellaneous -% commands. -% - -\@ifundefined{c@part}{\newcounter{part}}{}% -\newcounter{lpart} -\newcounter{lchapter}[part] -\@ifundefined{c@chapter}% - {\let\Hchapter\relax \newcounter{chapter}\let\thechapter\relax - \newcounter{lsection}[part]}% - {\let\Hchapter=\chapter \newcounter{lsection}[chapter]} -\newcounter{lsubsection}[section] -\newcounter{lsubsubsection}[subsection] -\newcounter{lparagraph}[subsubsection] -\newcounter{lsubparagraph}[paragraph] -%\newcounter{lequation} - -% -% Redefine "*" forms of sectioning commands to increment their -% respective counters. -% -\let\Hpart=\part -%\let\Hchapter=\chapter -\let\Hsection=\section -\let\Hsubsection=\subsection -\let\Hsubsubsection=\subsubsection -\let\Hparagraph=\paragraph -\let\Hsubparagraph=\subparagraph -\let\Hsubsubparagraph=\subsubparagraph - -\ifx\c@subparagraph\undefined - \newcounter{lsubsubparagraph}[lsubparagraph] -\else - \newcounter{lsubsubparagraph}[subparagraph] -\fi - -% -% The following definitions are specific to LaTeX2e: -% (They must be commented out for LaTeX 2.09) -% -\expandafter\ifx\csname part\endcsname\relax\else -\renewcommand{\part}{\@ifstar{\stepcounter{lpart}% - \bgroup\def\tmp{*}\H@part}{\bgroup\def\tmp{}\H@part}}\fi -\newcommand{\H@part}[1][]{\def\tmp@a{#1}\check@align - \expandafter\egroup\expandafter\Hpart\tmp} - -\ifx\Hchapter\relax\else - \def\chapter{\resetsections \@ifstar{\stepcounter{lchapter}% - \bgroup\def\tmp{*}\H@chapter}{\bgroup\def\tmp{}\H@chapter}}\fi -\newcommand{\H@chapter}[1][]{\def\tmp@a{#1}\check@align - \expandafter\egroup\expandafter\Hchapter\tmp} - -\renewcommand{\section}{\resetsubsections - \@ifstar{\stepcounter{lsection}\bgroup\def\tmp{*}% - \H@section}{\bgroup\def\tmp{}\H@section}} -\newcommand{\H@section}[1][]{\def\tmp@a{#1}\check@align - \expandafter\egroup\expandafter\Hsection\tmp} - -\renewcommand{\subsection}{\resetsubsubsections - \@ifstar{\stepcounter{lsubsection}\bgroup\def\tmp{*}% - \H@subsection}{\bgroup\def\tmp{}\H@subsection}} -\newcommand{\H@subsection}[1][]{\def\tmp@a{#1}\check@align - \expandafter\egroup\expandafter\Hsubsection\tmp} - -\renewcommand{\subsubsection}{\resetparagraphs - \@ifstar{\stepcounter{lsubsubsection}\bgroup\def\tmp{*}% - \H@subsubsection}{\bgroup\def\tmp{}\H@subsubsection}} -\newcommand{\H@subsubsection}[1][]{\def\tmp@a{#1}\check@align - \expandafter\egroup\expandafter\Hsubsubsection\tmp} - -\renewcommand{\paragraph}{\resetsubparagraphs - \@ifstar{\stepcounter{lparagraph}\bgroup\def\tmp{*}% - \H@paragraph}{\bgroup\def\tmp{}\H@paragraph}} -\newcommand\H@paragraph[1][]{\def\tmp@a{#1}\check@align - \expandafter\egroup\expandafter\Hparagraph\tmp} - -\ifx\Hsubparagraph\relax\else\@ifundefined{subparagraph}{}{% -\renewcommand{\subparagraph}{\resetsubsubparagraphs - \@ifstar{\stepcounter{lsubparagraph}\bgroup\def\tmp{*}% - \H@subparagraph}{\bgroup\def\tmp{}\H@subparagraph}}}\fi -\newcommand\H@subparagraph[1][]{\def\tmp@a{#1}\check@align - \expandafter\egroup\expandafter\Hsubparagraph\tmp} - -\ifx\Hsubsubparagraph\relax\else\@ifundefined{subsubparagraph}{}{% -\def\subsubparagraph{% - \@ifstar{\stepcounter{lsubsubparagraph}\bgroup\def\tmp{*}% - \H@subsubparagraph}{\bgroup\def\tmp{}\H@subsubparagraph}}}\fi -\newcommand\H@subsubparagraph[1][]{\def\tmp@a{#1}\check@align - \expandafter\egroup\expandafter\Hsubsubparagraph\tmp} - -\def\check@align{\def\empty{}\ifx\tmp@a\empty - \else\def\tmp@b{center}\ifx\tmp@a\tmp@b\let\tmp@a\empty - \else\def\tmp@b{left}\ifx\tmp@a\tmp@b\let\tmp@a\empty - \else\def\tmp@b{right}\ifx\tmp@a\tmp@b\let\tmp@a\empty - \else\expandafter\def\expandafter\tmp@a\expandafter{\expandafter[\tmp@a]}% - \fi\fi\fi \def\empty{}\ifx\tmp\empty\let\tmp=\tmp@a \else - \expandafter\def\expandafter\tmp\expandafter{\expandafter*\tmp@a}% - \fi\fi} -% -\def\resetsections{\setcounter{section}{0}\setcounter{lsection}{0}% - \reset@dependents{section}\resetsubsections } -\def\resetsubsections{\setcounter{subsection}{0}\setcounter{lsubsection}{0}% - \reset@dependents{subsection}\resetsubsubsections } -\def\resetsubsubsections{\setcounter{subsubsection}{0}\setcounter{lsubsubsection}{0}% - \reset@dependents{subsubsection}\resetparagraphs } -% -\def\resetparagraphs{\setcounter{lparagraph}{0}\setcounter{lparagraph}{0}% - \reset@dependents{paragraph}\resetsubparagraphs } -\def\resetsubparagraphs{\ifx\c@subparagraph\undefined\else - \setcounter{subparagraph}{0}\fi \setcounter{lsubparagraph}{0}% - \reset@dependents{subparagraph}\resetsubsubparagraphs } -\def\resetsubsubparagraphs{\ifx\c@subsubparagraph\undefined\else - \setcounter{subsubparagraph}{0}\fi \setcounter{lsubsubparagraph}{0}} -% -\def\reset@dependents#1{\begingroup\let \@elt \@stpelt - \csname cl@#1\endcsname\endgroup} - -% ignore optional *-version of \tableofcontents -\let\ltx@tableofcontents\tableofcontents -\renewcommand{\tableofcontents}{% - \@ifstar\ltx@tableofcontents\ltx@tableofcontents} -% -% -% Define a helper macro to dump a single \secounter command to a file. -% -\newcommand{\DumpPtr}[2]{% -\count255=\csname c@#1\endcsname\relax\def\dummy{dummy}\def\tmp{#2}% -\ifx\tmp\dummy\def\ctr{#1}\else - \def\ctr{#2}\advance\count255 by \csname c@#2\endcsname\relax\fi -\immediate\write\ptrfile{% -\noexpand\setcounter{\ctr}{\number\count255}}} -%\expandafter\noexpand\expandafter\setcounter\expandafter{\ctr}{\number\count255}}} - -% -% Define a helper macro to dump all counters to the file. -% The value for each counter will be the sum of the l-counter -% actual LaTeX section counter. -% Also dump an \htmlhead{section-command}{section title} command -% to the file. -% -\newwrite\ptrfile -\def\DumpCounters#1#2#3#4{% -\begingroup\let\protect=\noexpand -\immediate\openout\ptrfile = #1.ptr -\DumpPtr{part}{lpart}% -\ifx\Hchapter\relax\else\DumpPtr{chapter}{lchapter}\fi -\DumpPtr{section}{lsection}% -\DumpPtr{subsection}{lsubsection}% -\DumpPtr{subsubsection}{lsubsubsection}% -\DumpPtr{paragraph}{lparagraph}% -\DumpPtr{subparagraph}{lsubparagraph}% -\DumpPtr{equation}{dummy}% -\DumpPtr{footnote}{dummy}% -\def\tmp{#4}\ifx\tmp\@empty -\immediate\write\ptrfile{\noexpand\htmlhead{#2}{#3}}\else -\immediate\write\ptrfile{\noexpand\htmlhead[#4]{#2}{#3}}\fi -\dumpcitestatus \dumpcurrentcolor -\immediate\closeout\ptrfile -\endgroup } - - -%% interface to natbib.sty - -\def\dumpcitestatus{} -\def\loadcitestatus{\def\dumpcitestatus{% - \ifciteindex\immediate\write\ptrfile{\noexpand\citeindextrue}% - \else\immediate\write\ptrfile{\noexpand\citeindexfalse}\fi }% -} -\@ifpackageloaded{natbib}{\loadcitestatus}{% - \AtBeginDocument{\@ifpackageloaded{natbib}{\loadcitestatus}{}}} - - -%% interface to color.sty - -\def\dumpcurrentcolor{} -\def\loadsegmentcolors{% - \let\real@pagecolor=\pagecolor - \let\pagecolor\segmentpagecolor - \let\segmentcolor\color - \ifx\current@page@color\undefined \def\current@page@color{{}}\fi - \def\dumpcurrentcolor{\bgroup\def\@empty@{{}}% - \expandafter\def\expandafter\tmp\space####1@{\def\thiscol{####1}}% - \ifx\current@color\@empty@\def\thiscol{}\else - \expandafter\tmp\current@color @\fi - \immediate\write\ptrfile{\noexpand\segmentcolor{\thiscol}}% - \ifx\current@page@color\@empty@\def\thiscol{}\else - \expandafter\tmp\current@page@color @\fi - \immediate\write\ptrfile{\noexpand\segmentpagecolor{\thiscol}}% - \egroup}% - \global\let\loadsegmentcolors=\relax -} - -% These macros are needed within images.tex since this inputs -% the <segment>.ptr files for a segment, so that counters are -% colors are synchronised. -% -\newcommand{\segmentpagecolor}[1][]{% - \@ifpackageloaded{color}{\loadsegmentcolors\bgroup - \def\tmp{#1}\ifx\@empty\tmp\def\next{[]}\else\def\next{[#1]}\fi - \expandafter\segmentpagecolor@\next}% - {\@gobble}} -\def\segmentpagecolor@[#1]#2{\def\tmp{#1}\def\tmpB{#2}% - \ifx\tmpB\@empty\let\next=\egroup - \else - \let\realendgroup=\endgroup - \def\endgroup{\edef\next{\noexpand\realendgroup - \def\noexpand\current@page@color{\current@color}}\next}% - \ifx\tmp\@empty\real@pagecolor{#2}\def\model{}% - \else\real@pagecolor[#1]{#2}\def\model{[#1]}% - \fi - \edef\next{\egroup\def\noexpand\current@page@color{\current@page@color}% - \noexpand\real@pagecolor\model{#2}}% - \fi\next} -% -\newcommand{\segmentcolor}[2][named]{\@ifpackageloaded{color}% - {\loadsegmentcolors\segmentcolor[#1]{#2}}{}} - -\@ifpackageloaded{color}{\loadsegmentcolors}{\let\real@pagecolor=\@gobble - \AtBeginDocument{\@ifpackageloaded{color}{\loadsegmentcolors}{}}} - - -% Define the \segment[align]{file}{section-command}{section-title} command, -% and its helper macros. This command does four things: -% 1) Begins a new LaTeX section; -% 2) Writes a list of section counters to file.ptr, each -% of which represents the sum of the LaTeX section -% counters, and the l-counters, defined above; -% 3) Write an \htmlhead{section-title} command to file.ptr; -% 4) Inputs file.tex. - -\newcommand{\segment}{\@ifstar{\@@htmls}{\@@html}} -%\tracingall -\newcommand{\@endsegment}[1][]{} -\let\endsegment\@endsegment -\newcommand{\@@htmls}[1][]{\@@htmlsx{#1}} -\newcommand{\@@html}[1][]{\@@htmlx{#1}} -\def\@@htmlsx#1#2#3#4{\csname #3\endcsname* {#4}% - \DumpCounters{#2}{#3*}{#4}{#1}\input{#2}} -\def\@@htmlx#1#2#3#4{\csname #3\endcsname {#4}% - \DumpCounters{#2}{#3}{#4}{#1}\input{#2}} - -\makeatother -\endinput - - -% Modifications: -% -% (The listing of Initiales see Changes) - -% $Log: html.sty,v $ -% Revision 1.39 2001/10/01 22:47:06 RRM -% -- somehow revision 1.39 was not committed earlier -% -- it allows a * version of \tableofcontents (used with frames) to be -% treated as un-starred by LaTeX -% -% Revision 1.39 2000/09/10 12:23:20 RRM -% -- added *-argument for \tableofcontents in frames.perl -% LaTeX should just ignore it -% -% Revision 1.38 1999/07/19 13:23:20 RRM -% -- compatibility with pdflatex and hyperref.sty -% citations are not complete yet, I think -% -- ensure that \thechapter remains undefined; some packages use it -% as a test for the type of documentclass being used. -% -% Revision 1.37 1999/03/12 07:02:38 RRM -% -- change macro name from \addTOCsection to \htmladdTOClink -% -- it has 3 + 1 optional argument, to allow a local path to a labels.pl -% file for the external document, for cross-references -% -% Revision 1.36 1999/03/10 05:46:00 RRM -% -- extended the code for compatibilty with comment.sty -% -- allow excluded environments to work within tables, -% with the excluded material spanning headers and several cells -% thanks Avinash Chopde for recognising the need for this. -% -- added LaTeX support (ignores it) for \htmladdTOCsection -% thanks to Steffen Klupsch and Uli Wortmann for this idea. -% -% Revision 1.35 1999/03/08 11:16:16 RRM -% html.sty for LaTeX2HTML V99.1 -% -% -- ensure that html.sty can be loaded *after* hyperref.sty -% -- support new command \htmlclear for <BR> in HTML, ignored by LaTeX -% -- ensure {part} and {chapter} counters are defined, even if not used -% -% Revision 1.34 1998/09/19 10:37:29 RRM -% -- fixed typo with \next{\hyperref}{....} -% -% Revision 1.33 1998/09/08 12:47:51 RRM -% -- changed macro-names for the \hyperref and \hypercite options -% allows easier compatibility with other packages -% -% Revision 1.32 1998/08/24 12:15:14 RRM -% -- new command \htmllanguagestyle to associate a style class -% with text declared as a particular language -% -% Revision 1.31 1998/07/07 14:15:41 RRM -% -- new commands \htmlsetstyle and \htmladdtostyle -% -% Revision 1.30 1998/07/04 02:42:22 RRM -% -- cope with catcodes of % { } in rawhtml/comment/htmlonly environments -% -% Revision 1.29 1998/06/23 13:33:23 RRM -% -- use \begin{small} with the default for URLs -% -% Revision 1.28 1998/06/21 09:38:39 RRM -% -- implement \htmlurl to agree with \url if already defined -% or loaded subsequently (LaTeX-2e only) -% -- get LaTeX to print the revision number when loading -% -% Revision 1.27 1998/06/20 15:13:10 RRM -% -- \TeX is already protected in recent versions of LaTeX -% so \DeclareRobust doesn't work --- causes looping -% -- \part and \subparagraph need not be defined in some styles -% -% Revision 1.26 1998/06/01 08:36:49 latex2html -% -- implement optional argument for \endsegment -% -- made the counter value output from \DumpPtr more robust -% -% Revision 1.25 1998/05/09 05:43:35 latex2html -% -- conditionals for avoiding undefined counters -% -% Revision 1.23 1998/02/26 10:32:24 latex2html -% -- use \providecommand for \latextohtml -% -- implemented \HTMLcode to do what \HTML did previously -% \HTML still works, unless already defined by another package -% -- fixed problems remaining with undefined \chapter -% -- defined \endsegment -% -% Revision 1.22 1997/12/05 11:38:18 RRM -% -- implemented an optional argument to \begin for style-sheet info. -% -- modified use of an optional argument with sectioning-commands -% -% Revision 1.21 1997/11/05 10:28:56 RRM -% -- replaced redefinition of \@htmlrule with \htmlrulestar -% -% Revision 1.20 1997/10/28 02:15:58 RRM -% -- altered the way some special html-macros are defined, so that -% star-variants are explicitly defined for LaTeX -% -- it is possible for these to occur within images.tex -% e.g. \htmlinfostar \htmlrulestar \tableofchildlinksstar -% -% Revision 1.19 1997/10/11 05:47:48 RRM -% -- allow the dummy {tex2html_nowrap} environment in LaTeX -% use it to make its contents be evaluated in environment order -% -% Revision 1.18 1997/10/04 06:56:50 RRM -% -- uses Robin Fairbairns' code for ignored environments, -% replacing the previous comment.sty stuff. -% -- extensions to the \tableofchildlinks command -% -- extensions to the \htmlinfo command -% -% Revision 1.17 1997/07/08 11:23:39 RRM -% include value of footnote counter in .ptr files for segments -% -% Revision 1.16 1997/07/03 08:56:34 RRM -% use \textup within the \latextohtml macro -% -% Revision 1.15 1997/06/15 10:24:58 RRM -% new command \htmltracenv as environment-ordered \htmltracing -% -% Revision 1.14 1997/06/06 10:30:37 RRM -% - new command: \htmlborder puts environment into a <TABLE> cell -% with a border of specified width, + other attributes. -% - new commands: \HTML for setting arbitrary HTML tags, with attributes -% \HTMLset for setting Perl variables, while processing -% \HTMLsetenv same as \HTMLset , but it gets processed -% as if it were an environment. -% - new command: \latextohtml --- to set the LaTeX2HTML name/logo -% - fixed some remaining problems with \segmentcolor & \segmentpagecolor -% -% Revision 1.13 1997/05/19 13:55:46 RRM -% alterations and extra options to \hypercite -% -% Revision 1.12 1997/05/09 12:28:39 RRM -% - Added the optional argument to \htmlhead, also in \DumpCounters -% - Implemented \HTMLset as a no-op in LaTeX. -% - Fixed a bug in accessing the page@color settings. -% -% Revision 1.11 1997/03/26 09:32:40 RRM -% - Implements LaTeX versions of \externalcite and \hypercite commands. -% Thanks to Uffe Engberg and Stephen Simpson for the suggestions. -% -% Revision 1.10 1997/03/06 07:37:58 RRM -% Added the \htmltracing command, for altering $VERBOSITY . -% -% Revision 1.9 1997/02/17 02:26:26 RRM -% - changes to counter handling (RRM) -% - shuffled around some definitions -% - changed \htmlrule of 209 mode -% -% Revision 1.8 1997/01/26 09:04:12 RRM -% RRM: added optional argument to sectioning commands -% \htmlbase sets the <BASE HREF=...> tag -% \htmlinfo and \htmlinfo* allow the document info to be positioned -% -% Revision 1.7 1997/01/03 12:15:44 L2HADMIN -% % - fixes to the color and natbib interfaces -% % - extended usage of \hyperref, via an optional argument. -% % - extended use comment environments to allow shifting expansions -% % e.g. within \multicolumn (`bug' reported by Luc De Coninck). -% % - allow optional argument to: \htmlimage, \htmlhead, -% % \htmladdimg, \htmladdnormallink, \htmladdnormallinkfoot -% % - added new commands: \htmlbody, \htmlnohead -% % - added new command: \tableofchildlinks -% -% Revision 1.6 1996/12/25 03:04:54 JCL -% added patches to segment feature from Martin Wilck -% -% Revision 1.5 1996/12/23 01:48:06 JCL -% o introduced the environment makeimage, which may be used to force -% LaTeX2HTML to generate an image from the contents. -% There's no magic, all what we have now is a defined empty environment -% which LaTeX2HTML will not recognize and thus pass it to images.tex. -% o provided \protect to the \htmlrule commands to allow for usage -% within captions. -% -% Revision 1.4 1996/12/21 19:59:22 JCL -% - shuffled some entries -% - added \latexhtml command -% -% Revision 1.3 1996/12/21 12:22:59 JCL -% removed duplicate \htmlrule, changed \htmlrule back not to create a \hrule -% to allow occurrence in caption -% -% Revision 1.2 1996/12/20 04:03:41 JCL -% changed occurrence of \makeatletter, \makeatother -% added new \htmlrule command both for the LaTeX2.09 and LaTeX2e -% sections -% -% -% jcl 30-SEP-96 -% - Stuck the commands commonly used by both LaTeX versions to the top, -% added a check which stops input or reads further if the document -% makes use of LaTeX2e. -% - Introduced rrm's \dumpcurrentcolor and \bodytext -% hws 31-JAN-96 - Added support for document segmentation -% hws 10-OCT-95 - Added \htmlrule command -% jz 22-APR-94 - Added support for htmlref -% nd - Created Modified: trunk/docs/manual/version.tex =================================================================== --- trunk/docs/manual/version.tex 2007-12-03 19:27:38 UTC (rev 6017) +++ trunk/docs/manual/version.tex 2007-12-03 20:08:21 UTC (rev 6018) @@ -1 +1 @@ -2.2.6 (10 November 2007) +2.3.6 (19 October 2007) This was sent by the SourceForge.net collaborative development platform, the world's largest Open Source development site. |
From: <ke...@us...> - 2007-12-08 20:07:57
|
Revision: 6029 http://bacula.svn.sourceforge.net/bacula/?rev=6029&view=rev Author: kerns Date: 2007-12-08 12:07:56 -0800 (Sat, 08 Dec 2007) Log Message: ----------- Update Modified Paths: -------------- trunk/docs/manual/bacula.tex trunk/docs/manual/general.tex trunk/docs/manual/install.tex trunk/docs/manual/quickstart.tex trunk/docs/manual/requirements.tex trunk/docs/manual/state.tex trunk/docs/manual/supportedoses.tex Modified: trunk/docs/manual/bacula.tex =================================================================== --- trunk/docs/manual/bacula.tex 2007-12-08 12:47:09 UTC (rev 6028) +++ trunk/docs/manual/bacula.tex 2007-12-08 20:07:56 UTC (rev 6029) @@ -74,22 +74,22 @@ \include{requirements} \include{supportedoses} \include{supporteddrives} -\include{quickstart} -\include{install} -\include{critical} +\include{quickstart} % install +\include{install} % install +\include{critical} % install \include{tutorial} -\include{configure} -\include{dirdconf} -\include{filedconf} -\include{storedconf} -\include{messagesres} -\include{consoleconf} -\include{monitorconf} -\include{console} +\include{configure} % install +\include{dirdconf} % install +\include{filedconf} % install +\include{storedconf} % install +\include{messagesres} % install +\include{consoleconf} % install +\include{monitorconf} % install +\include{console} % console \include{restore} -\include{gui} -\include{bimagemgr-chapter} -\include{catmaintenance} +\include{gui} % console +\include{bimagemgr-chapter} %utility +\include{catmaintenance} $catalog \include{recycling} \include{disk} \include{dvd} @@ -101,24 +101,24 @@ \include{spooling} \include{python} \include{ansi-labels} -\include{faq} -\include{tips} -\include{progs} -\include{tapetesting} +\include{faq} % faq +\include{tips} % faq +\include{progs} % utility +\include{tapetesting} % install \include{kaboom} \include{win32} \include{rescue} \include{tls} \include{dataencryption} -\include{security} -\include{firewalls} +\include{security} % install +\include{firewalls} % faq \include{verify} -\include{rpm-faq} +\include{rpm-faq} % utility \include{bootstrap} -\include{mysql} -\include{postgresql} -\include{sqlite} -\include{internaldb} +\include{mysql} % catalog +\include{postgresql} % catalog +\include{sqlite} % catalog +\include{internaldb} % catalog %% \include{rescuefloppy} \include{license} \include{fdl} Modified: trunk/docs/manual/general.tex =================================================================== --- trunk/docs/manual/general.tex 2007-12-08 12:47:09 UTC (rev 6028) +++ trunk/docs/manual/general.tex 2007-12-08 20:07:56 UTC (rev 6029) @@ -370,9 +370,9 @@ \item [Service] \index[fd]{Service } - This is Windows terminology for a {\bf daemon} -- see above. It is - frequently used in Unix environments as well. -% TODO: maybe do not say this is "Windows" terminology because it is common + This is a program that remains permanently in memory awaiting + instructions. In Unix environments, services are also known as + {\bf daemons}. \item [Storage Coordinates] \index[fd]{Storage Coordinates } @@ -414,21 +414,14 @@ to a Volume agrees with what is stored in the Catalog (i.e. it compares the file attributes), *or it can check the Volume contents against the original files on disk. -% TODO: fix book for asterisk above and below \item [*Archive] \index[fd]{*Archive } An Archive operation is done after a Save, and it consists of removing the -Volumes on which data is saved from active use. These Volumes are marked as -Archived, and may no longer be used to save files. All the files contained -on an Archived Volume are removed from the Catalog. NOT YET IMPLEMENTED. + Volumes on which data is saved from active use. These Volumes are marked as + Archived, and may no longer be used to save files. All the files contained + on an Archived Volume are removed from the Catalog. NOT YET IMPLEMENTED. -\item [*Update] - \index[fd]{*Update } - An Update operation causes the files on the remote system to be updated to be -the same as the host system. This is equivalent to an {\bf rdist} capability. -NOT YET IMPLEMENTED. - \item [Retention Period] \index[fd]{Retention Period } There are various kinds of retention periods that Bacula recognizes. @@ -438,14 +431,19 @@ in the Catalog database. This should not be confused with the time that the data saved to a Volume is valid. -% TODO: the following sentence is unclear to me The File Retention Period determines the time that File records are kept - in the catalog database. This period is important because the volume of - the database File records by far use the most storage space in the + in the catalog database. This period is important for two reasons: the + first is that as long as File records remain in the database, you + can "browse" the database with a console program and restore any + individual file. Once the File records are removed or pruned from the + database, the individual files of a backup job can no longer be + "browsed". The second reason for carefully choosing the File Retention + Period is because the volume of + the database File records use the most storage space in the database. As a consequence, you must ensure that regular "pruning" of - the database file records is done. (See the Console {\bf retention} + the database file records is done to keep your database from growing + too large. (See the Console {\bf prune} command for more details on this subject). -% TODO: Where? The Job Retention Period is the length of time that Job records will be kept in the database. Note, all the File records are tied to the Job Modified: trunk/docs/manual/install.tex =================================================================== --- trunk/docs/manual/install.tex 2007-12-08 12:47:09 UTC (rev 6028) +++ trunk/docs/manual/install.tex 2007-12-08 20:07:56 UTC (rev 6029) @@ -9,7 +9,8 @@ In general, you will need the Bacula source release, and if you want to run a Windows client, you will need the Bacula Windows binary release. However, Bacula needs certain third party packages (such as {\bf MySQL}, -{\bf PostgreSQL}, or {\bf SQLite} to build properly depending on the +{\bf PostgreSQL}, or {\bf SQLite} to build and run +properly depending on the options you specify. Normally, {\bf MySQL} and {\bf PostgreSQL} are packages that can be installed on your distribution. However, if you do not have them, to simplify your task, we have combined a number of these @@ -21,9 +22,9 @@ \section{Source Release Files} \index[general]{Source Files} \index[general]{Release Files} -Beginning with Bacula 1.38.0, the source code has been broken into -four separate tar files each corresponding to a different module in -the Bacula SVN. The released files are: + Beginning with Bacula 1.38.0, the source code has been broken into + four separate tar files each corresponding to a different module in + the Bacula SVN. The released files are: \begin{description} \item [bacula-2.0.3.tar.gz] Modified: trunk/docs/manual/quickstart.tex =================================================================== --- trunk/docs/manual/quickstart.tex 2007-12-08 12:47:09 UTC (rev 6028) +++ trunk/docs/manual/quickstart.tex 2007-12-08 20:07:56 UTC (rev 6029) @@ -328,20 +328,14 @@ \section{Get Rid of the /lib/tls Directory} \index[general]{Directory!Get Rid of the /lib/tls } \index[general]{Get Rid of the /lib/tls Directory } +The new pthreads library {\bf /lib/tls} installed by default on recent Red +Hat systems running Linux kernel 2.4.x is defective. You must remove it or +rename it, then reboot your system before running Bacula otherwise after a +week or so of running, Bacula will either block for long periods or +deadlock entirely. You may want to use the loader environment variable +override rather than removing /lib/tls. Please see \ilink{ Supported +Operating Systems}{SupportedOSes} for more information on this problem. -% TODO: this seems dangerous -- how do you know if they don't use -% TODO: /lib/tls for something mission critical? Reword this or point to -% TODO: appropriate documentation. - -The new pthreads library {\bf /lib/tls} installed by default on recent Red Hat -systems running Linux kernel 2.4.x is defective. You must remove it or rename it, -then reboot your system before running Bacula otherwise after a week or so of -running, Bacula will either block for long periods or deadlock entirely. -You may want to use the loader environment variable override rather -than removing /lib/tls. Please see \ilink{ Supported Operating -Systems}{SupportedOSes} for more -information on this problem. - This problem does not occur on systems running Linux 2.6.x kernels. \label{Running1} Modified: trunk/docs/manual/requirements.tex =================================================================== --- trunk/docs/manual/requirements.tex 2007-12-08 12:47:09 UTC (rev 6028) +++ trunk/docs/manual/requirements.tex 2007-12-08 20:07:56 UTC (rev 6029) @@ -20,7 +20,7 @@ depkgs1} releases. However, most current Linux and FreeBSD systems provide these as system packages. \item The minimum versions for each of the databases supported by Bacula -are: + are: \begin{itemize} \item MySQL 4.1 Modified: trunk/docs/manual/state.tex =================================================================== --- trunk/docs/manual/state.tex 2007-12-08 12:47:09 UTC (rev 6028) +++ trunk/docs/manual/state.tex 2007-12-08 20:07:56 UTC (rev 6029) @@ -22,11 +22,10 @@ (sometimes called multiplexing). \item Job sequencing using priorities. \item \ilink{Console}{UADef} interface to the Director allowing complete - control. A shell, GNOME GUI and wxWidgets GUI versions of the Console program - are available. Note, the GNOME GUI program currently offers very few - additional features over the shell program. - With version 2.2.0, a much more complete GUI interface has been - written, which is called the Bacula Admistration Tool, or bat. + control. A shell, Qt4 GUI, GNOME GUI and wxWidgets GUI versions of + the Console program are available. Note, the Qt4 GUI program called + the Bacula Administration tool or bat, offers many additional + features over the shell program. \end{itemize} \item Security @@ -178,7 +177,7 @@ commercial application, probably because that application stores its catalog information in a large number of individual files rather than an SQL database as Bacula does. -\item Aside from a GUI administrative interface, Bacula has a +\item Aside from several GUI administrative interfaces, Bacula has a comprehensive shell administrative interface, which allows the administrator to use tools such as ssh to administrate any part of Bacula from anywhere (even from home). @@ -220,7 +219,8 @@ You must explicitly update the date/time stamp on all moved files (we have a project to correct this). \item File System Modules (configurable routines for - saving/restoring special files) are not yet implemented. + saving/restoring special files) are not yet implemented. However, + this feature is easily implemented using RunScripts. \item Bacula supports doing backups and restores to multiple devices of different media type and multiple Storage daemons. However, if you have backed up a job to multiple storage Modified: trunk/docs/manual/supportedoses.tex =================================================================== --- trunk/docs/manual/supportedoses.tex 2007-12-08 12:47:09 UTC (rev 6028) +++ trunk/docs/manual/supportedoses.tex 2007-12-08 20:07:56 UTC (rev 6029) @@ -7,16 +7,15 @@ \index[general]{Supported Operating Systems } \begin{itemize} -\item Linux systems (built and tested on SuSE 10.2). -\item Most flavors of Linux (Gentoo, Red Hat, Fedora, Mandriva, Debian, Ubuntu, ...). +\item Linux systems (built and tested on CentOS 5). +\item Most flavors of Linux (Gentoo, Red Hat, Fedora, Mandriva, + Debian, OpenSuSE, Ubuntu, Kubuntu, ...). \item Solaris various versions. \item FreeBSD (tape driver supported in 1.30 -- for FreeBSD older than version 5.0, please see some {\bf important} considerations in the \ilink{ Tape Modes on FreeBSD}{FreeBSDTapes} section of the Tape Testing chapter of this manual.) -\item Windows (Win98/Me, WinNT/2K/XP) Client (File daemon) binaries. -\item Windows Vista VSS (Volume Shadow Copy) is reported not to work - with Bacula. +\item Windows (Win98/Me, WinNT/2K/XP, Vista) Client (File daemon) binaries. \item The Windows servers (Director and Storage daemon) are available in the binary Client installer. The are reported to work in many cases. However they are NOT supported. @@ -27,8 +26,10 @@ \item Tru64 \item Bacula is said to work on other systems (AIX, BSDI, HPUX, NetBSD, ...) but we do not have first hand knowledge of these systems. -\item RHat 7.2 AS2, AS3, AS4, Fedora Core 2,3,4,5, SuSE SLES 7,8,9,10,10.1 and Debian Woody and Sarge Linux on - S/390 and Linux on zSeries. +\item RHat 7.2 AS2, AS3, AS4, RHEL5, Fedora Core 2,3,4,5,6,7 SuSE SLES + 7,8,9,10,10.1,10.2,10.3 + and Debian Woody and Sarge Linux on + S/390 and Linux on zSeries. \item See the Porting chapter of the Bacula Developer's Guide for information on porting to other systems. This was sent by the SourceForge.net collaborative development platform, the world's largest Open Source development site. |