Re: SMB Windows share not backing up - NT_STATUS_ACCESS_DENIED listing \System Volume Information\SRM\*
Marc Gilliatt <[email protected]> Tue, 9 Jan 2018 15:31:27 +0000
| Newsgroups | gmane.comp.sysutils.backup.backuppc.devel |
|---|---|
| Message-ID | <HE1P194MB01394AFD7F6C52FC11BDE884BB100@HE1P194MB0139.EURP194.PROD.OUTLOOK.COM> |
--===============7631554306948322726== Content-Language: en-GB Content-Type: multipart/alternative; boundary="_000_HE1P194MB01394AFD7F6C52FC11BDE884BB100HE1P194MB0139EURP_" --_000_HE1P194MB01394AFD7F6C52FC11BDE884BB100HE1P194MB0139EURP_ Content-Type: text/plain; charset="us-ascii" Content-Transfer-Encoding: quoted-printable Ive posted to the correct mailing list. Here are the contents to my config.pl #=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D -*-perl-*- # # Configuration file for BackupPC. # # DESCRIPTION # # This is the main configuration file for BackupPC. # # This file must be valid perl source, so make sure the punctuation, # quotes, and other syntax are valid. # # This file is read by BackupPC at startup, when a HUP (-1) signal # is sent to BackupPC and also at each wakeup time whenever the # modification time of this file changes. # # The configuration parameters are divided into four general groups. # The first group (general server configuration) provides general # configuration for BackupPC. The next two groups describe what # to backup, when to do it, and how long to keep it. The fourth # group are settings for the CGI http interface. # # Configuration settings can also be specified on a per-PC basis. # Simply put the relevant settings in a config.pl file in the # PC's backup directory (ie: in __TOPDIR__/pc/hostName). # All configuration settings in the second, third and fourth # groups can be overridden by the per-PC config.pl file. # # AUTHOR # Craig Barratt <[email protected]> # # COPYRIGHT # Copyright (C) 2001-2015 Craig Barratt # # See http://backuppc.sourceforge.net. # #=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D ########################################################################### # General server configuration ########################################################################### # # Host name on which the BackupPC server is running. # $ENV{'PATH'} =3D '/bin:/usr/bin'; delete @ENV{'IFS', 'CDPATH', 'ENV', 'BASH_ENV'}; $Conf{ServerHost} =3D 'backuppc01'; chomp($Conf{ServerHost}); # # TCP port number on which the BackupPC server listens for and accepts # connections. Normally this should be disabled (set to -1). The TCP # port is only needed if apache runs on a different machine from BackupPC. # In that case, set this to any spare port number over 1024 (eg: 2359). # If you enable the TCP port, make sure you set $Conf{ServerMesgSecret} # too! # $Conf{ServerPort} =3D -1; # # Shared secret to make the TCP port secure. Set this to a hard to guess # string if you enable the TCP port (ie: $Conf{ServerPort} > 0). # # To avoid possible attacks via the TCP socket interface, every client # message is protected by an MD5 digest. The MD5 digest includes four # items: # - a seed that is sent to the client when the connection opens # - a sequence number that increments for each message # - a shared secret that is stored in $Conf{ServerMesgSecret} # - the message itself. # # The message is sent in plain text preceded by the MD5 digest. A # snooper can see the plain-text seed sent by BackupPC and plain-text # message from the client, but cannot construct a valid MD5 digest since # the secret $Conf{ServerMesgSecret} is unknown. A replay attack is # not possible since the seed changes on a per-connection and # per-message basis. # $Conf{ServerMesgSecret} =3D ''; # # PATH setting for BackupPC. An explicit value is necessary # for taint mode. Value shouldn't matter too much since # all execs use explicit paths. However, taint mode in perl # will complain if this directory is world writable. # $Conf{MyPath} =3D '/bin'; # # Permission mask for directories and files created by BackupPC. # Default value prevents any access from group other, and prevents # group write. # $Conf{UmaskMode} =3D 23; # # Times at which we wake up, check all the PCs, and schedule necessary # backups. Times are measured in hours since midnight. Can be # fractional if necessary (eg: 4.25 means 4:15am). # # If the hosts you are backing up are always connected to the network # you might have only one or two wakeups each night. This will keep # the backup activity after hours. On the other hand, if you are backing # up laptops that are only intermittently connected to the network you # will want to have frequent wakeups (eg: hourly) to maximize the chance # that each laptop is backed up. # # Examples: # $Conf{WakeupSchedule} =3D [22.5]; # once per day at 10:30 pm. # $Conf{WakeupSchedule} =3D [2,4,6,8,10,12,14,16,18,20,22]; # every 2 = hours # # The default value is every hour except midnight. # # The first entry of $Conf{WakeupSchedule} is when BackupPC_nightly is run. # You might want to re-arrange the entries in $Conf{WakeupSchedule} # (they don't have to be ascending) so that the first entry is when # you want BackupPC_nightly to run (eg: when you don't expect a lot # of regular backups to run). # $Conf{WakeupSchedule} =3D [ 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20, 21, 22, 23 ]; # # Maximum number of simultaneous backups to run. If there # are no user backup requests then this is the maximum number # of simultaneous backups. # $Conf{MaxBackups} =3D 5; # # Additional number of simultaneous backups that users can run. # As many as $Conf{MaxBackups} + $Conf{MaxUserBackups} requests can # run at the same time. # $Conf{MaxUserBackups} =3D 5; # # Maximum number of pending link commands. New backups will only be # started if there are no more than $Conf{MaxPendingCmds} plus # $Conf{MaxBackups} number of pending link commands, plus running jobs. # This limit is to make sure BackupPC doesn't fall too far behind in # running BackupPC_link commands. # $Conf{MaxPendingCmds} =3D 15; # # Nice level at which CmdQueue commands (eg: BackupPC_link and # BackupPC_nightly) are run at. # $Conf{CmdQueueNice} =3D 10; # # How many BackupPC_nightly processes to run in parallel. # # Each night, at the first wakeup listed in $Conf{WakeupSchedule}, # BackupPC_nightly is run. Its job is to remove unneeded files # in the pool, ie: files that only have one link. To avoid race # conditions, BackupPC_nightly and BackupPC_link cannot run at # the same time. Starting in v3.0.0, BackupPC_nightly can run # concurrently with backups (BackupPC_dump). # # So to reduce the elapsed time, you might want to increase this # setting to run several BackupPC_nightly processes in parallel # (eg: 4, or even 8). # $Conf{MaxBackupPCNightlyJobs} =3D 5; # # How many days (runs) it takes BackupPC_nightly to traverse the # entire pool. Normally this is 1, which means every night it runs, # it does traverse the entire pool removing unused pool files. # # Other valid values are 2, 4, 8, 16. This causes BackupPC_nightly to # traverse 1/2, 1/4, 1/8 or 1/16th of the pool each night, meaning it # takes 2, 4, 8 or 16 days to completely traverse the pool. The # advantage is that each night the running time of BackupPC_nightly # is reduced roughly in proportion, since the total job is split # over multiple days. The disadvantage is that unused pool files # take longer to get deleted, which will slightly increase disk # usage. # # Note that even when $Conf{BackupPCNightlyPeriod} > 1, BackupPC_nightly # still runs every night. It just does less work each time it runs. # # Examples: # # $Conf{BackupPCNightlyPeriod} =3D 1; # entire pool is checked every n= ight # # $Conf{BackupPCNightlyPeriod} =3D 2; # two days to complete pool chec= k # # (different half each night) # # $Conf{BackupPCNightlyPeriod} =3D 4; # four days to complete pool che= ck # # (different quarter each night) # $Conf{BackupPCNightlyPeriod} =3D 1; # # Maximum number of log files we keep around in log directory. # These files are aged nightly. A setting of 14 means the log # directory will contain about 2 weeks of old log files, in # particular at most the files LOG, LOG.0, LOG.1, ... LOG.13 # (except today's LOG, these files will have a .z extension if # compression is on). # # If you decrease this number after BackupPC has been running for a # while you will have to manually remove the older log files. # $Conf{MaxOldLogFiles} =3D 14; # # Full path to the df command. Security caution: normal users # should not allowed to write to this file or directory. # $Conf{DfPath} =3D '/bin/df'; # # Command to run df. The following variables are substituted at run-time: # # $dfPath path to df ($Conf{DfPath}) # $topDir top-level BackupPC data directory # # Note: all Cmds are executed directly without a shell, so the prog name # needs to be a full path and you can't include shell syntax like # redirection and pipes; put that in a script if you need it. # $Conf{DfCmd} =3D '$dfPath $topDir'; # # Full path to various commands for archiving # $Conf{SplitPath} =3D '/usr/bin/split'; $Conf{ParPath} =3D undef; $Conf{CatPath} =3D '/bin/cat'; $Conf{GzipPath} =3D '/bin/gzip'; $Conf{Bzip2Path} =3D '/bin/bzip2'; # # Maximum threshold for disk utilization on the __TOPDIR__ filesystem. # If the output from $Conf{DfPath} reports a percentage larger than # this number then no new regularly scheduled backups will be run. # However, user requested backups (which are usually incremental and # tend to be small) are still performed, independent of disk usage. # Also, currently running backups will not be terminated when the disk # usage exceeds this number. # $Conf{DfMaxUsagePct} =3D 95; # # How long BackupPC_trashClean sleeps in seconds between each check # of the trash directory. Once every 5 minutes should be reasonable. # $Conf{TrashCleanSleepSec} =3D 300; # # List of DHCP address ranges we search looking for PCs to backup. # This is an array of hashes for each class C address range. # This is only needed if hosts in the conf/hosts file have the # dhcp flag set. # # Examples: # # to specify 192.10.10.20 to 192.10.10.250 as the DHCP address pool # $Conf{DHCPAddressRanges} =3D [ # { # ipAddrBase =3D> '192.10.10', # first =3D> 20, # last =3D> 250, # }, # ]; # # to specify two pools (192.10.10.20-250 and 192.10.11.10-50) # $Conf{DHCPAddressRanges} =3D [ # { # ipAddrBase =3D> '192.10.10', # first =3D> 20, # last =3D> 250, # }, # { # ipAddrBase =3D> '192.10.11', # first =3D> 10, # last =3D> 50, # }, # ]; # $Conf{DHCPAddressRanges} =3D []; # # The BackupPC user. # $Conf{BackupPCUser} =3D 'backuppc'; # # Important installation directories: # # TopDir - where all the backup data is stored # ConfDir - where the main config and hosts files resides # LogDir - where log files and other transient information # InstallDir - where the bin, lib and doc installation dirs reside. # Note: you cannot change this value since all the # perl scripts include this path. You must reinstall # with configure.pl to change InstallDir. # CgiDir - Apache CGI directory for BackupPC_Admin # # Note: it is STRONGLY recommended that you don't change the # values here. These are set at installation time and are here # for reference and are used during upgrades. # # Instead of changing TopDir here it is recommended that you use # a symbolic link to the new location, or mount the new BackupPC # store at the existing $Conf{TopDir} setting. # $Conf{TopDir} =3D '/var/lib/backuppc'; $Conf{ConfDir} =3D '/etc/backuppc'; $Conf{LogDir} =3D '/var/lib/backuppc/log'; $Conf{InstallDir} =3D '/usr/share/backuppc'; $Conf{CgiDir} =3D '/usr/share/backuppc/cgi-bin'; # # Whether BackupPC and the CGI script BackupPC_Admin verify that they # are really running as user $Conf{BackupPCUser}. If this flag is set # and the effective user id (euid) differs from $Conf{BackupPCUser} # then both scripts exit with an error. This catches cases where # BackupPC might be accidently started as root or the wrong user, # or if the CGI script is not installed correctly. # $Conf{BackupPCUserVerify} =3D '1'; # # Maximum number of hardlinks supported by the $TopDir file system # that BackupPC uses. Most linux or unix file systems should support # at least 32000 hardlinks per file, or 64000 in other cases. If a pool # file already has this number of hardlinks, a new pool file is created # so that new hardlinks can be accommodated. This limit will only # be hit if an identical file appears at least this number of times # across all the backups. # $Conf{HardLinkMax} =3D 31999; # # Advanced option for asking BackupPC to load additional perl modules. # Can be a list (array ref) of module names to load at startup. # $Conf{PerlModuleLoad} =3D undef; # # Path to init.d script and command to use that script to start the # server from the CGI interface. The following variables are substituted # at run-time: # # $sshPath path to ssh ($Conf{SshPath}) # $serverHost same as $Conf{ServerHost} # $serverInitdPath path to init.d script ($Conf{ServerInitdPath}) # # Example: # # $Conf{ServerInitdPath} =3D '/etc/init.d/backuppc'; # $Conf{ServerInitdStartCmd} =3D '$sshPath -q -x -l root $serverHost' # . ' $serverInitdPath start' # . ' < /dev/null >& /dev/null'; # # Note: all Cmds are executed directly without a shell, so the prog name # needs to be a full path and you can't include shell syntax like # redirection and pipes; put that in a script if you need it. # $Conf{ServerInitdPath} =3D undef; $Conf{ServerInitdStartCmd} =3D ''; ########################################################################### # What to backup and when to do it # (can be overridden in the per-PC config.pl) ########################################################################### # # Minimum period in days between full backups. A full dump will only be # done if at least this much time has elapsed since the last full dump, # and at least $Conf{IncrPeriod} days has elapsed since the last # successful dump. # # Typically this is set slightly less than an integer number of days. The # time taken for the backup, plus the granularity of $Conf{WakeupSchedule} # will make the actual backup interval a bit longer. # $Conf{FullPeriod} =3D '6.9'; # # Minimum period in days between incremental backups (a user requested # incremental backup will be done anytime on demand). # # Typically this is set slightly less than an integer number of days. The # time taken for the backup, plus the granularity of $Conf{WakeupSchedule} # will make the actual backup interval a bit longer. # $Conf{IncrPeriod} =3D '0.9'; # # Number of full backups to keep. Must be >=3D 1. # # In the steady state, each time a full backup completes successfully # the oldest one is removed. If this number is decreased, the # extra old backups will be removed. # # If filling of incremental dumps is off the oldest backup always # has to be a full (ie: filled) dump. This might mean one or two # extra full dumps are kept until the oldest incremental backups expire. # # Exponential backup expiry is also supported. This allows you to specify: # # - num fulls to keep at intervals of 1 * $Conf{FullPeriod}, followed by # - num fulls to keep at intervals of 2 * $Conf{FullPeriod}, # - num fulls to keep at intervals of 4 * $Conf{FullPeriod}, # - num fulls to keep at intervals of 8 * $Conf{FullPeriod}, # - num fulls to keep at intervals of 16 * $Conf{FullPeriod}, # # and so on. This works by deleting every other full as each expiry # boundary is crossed. # # Exponential expiry is specified using an array for $Conf{FullKeepCnt}: # # $Conf{FullKeepCnt} =3D [4, 2, 3]; # # Entry #n specifies how many fulls to keep at an interval of # 2^n * $Conf{FullPeriod} (ie: 1, 2, 4, 8, 16, 32, ...). # # The example above specifies keeping 4 of the most recent full backups # (1 week interval) two full backups at 2 week intervals, and 3 full # backups at 4 week intervals, eg: # # full 0 19 weeks old \ # full 1 15 weeks old >--- 3 backups at 4 * $Conf{FullPeriod} # full 2 11 weeks old / # full 3 7 weeks old \____ 2 backups at 2 * $Conf{FullPeriod} # full 4 5 weeks old / # full 5 3 weeks old \ # full 6 2 weeks old \___ 4 backups at 1 * $Conf{FullPeriod} # full 7 1 week old / # full 8 current / # # On a given week the spacing might be less than shown as each backup # ages through each expiry period. For example, one week later, a # new full is completed and the oldest is deleted, giving: # # full 0 16 weeks old \ # full 1 12 weeks old >--- 3 backups at 4 * $Conf{FullPeriod} # full 2 8 weeks old / # full 3 6 weeks old \____ 2 backups at 2 * $Conf{FullPeriod} # full 4 4 weeks old / # full 5 3 weeks old \ # full 6 2 weeks old \___ 4 backups at 1 * $Conf{FullPeriod} # full 7 1 week old / # full 8 current / # # You can specify 0 as a count (except in the first entry), and the # array can be as long as you wish. For example: # # $Conf{FullKeepCnt} =3D [4, 0, 4, 0, 0, 2]; # # This will keep 10 full dumps, 4 most recent at 1 * $Conf{FullPeriod}, # followed by 4 at an interval of 4 * $Conf{FullPeriod} (approx 1 month # apart), and then 2 at an interval of 32 * $Conf{FullPeriod} (approx # 7-8 months apart). # # Example: these two settings are equivalent and both keep just # the four most recent full dumps: # # $Conf{FullKeepCnt} =3D 4; # $Conf{FullKeepCnt} =3D [4]; # $Conf{FullKeepCnt} =3D [ 1 ]; # # Very old full backups are removed after $Conf{FullAgeMax} days. However, # we keep at least $Conf{FullKeepCntMin} full backups no matter how old # they are. # # Note that $Conf{FullAgeMax} will be increased to $Conf{FullKeepCnt} # times $Conf{FullPeriod} if $Conf{FullKeepCnt} specifies enough # full backups to exceed $Conf{FullAgeMax}. # $Conf{FullKeepCntMin} =3D 1; $Conf{FullAgeMax} =3D 90; # # Number of incremental backups to keep. Must be >=3D 1. # # In the steady state, each time an incr backup completes successfully # the oldest one is removed. If this number is decreased, the # extra old backups will be removed. # $Conf{IncrKeepCnt} =3D 6; # # Very old incremental backups are removed after $Conf{IncrAgeMax} days. # However, we keep at least $Conf{IncrKeepCntMin} incremental backups no # matter how old they are. # $Conf{IncrKeepCntMin} =3D 1; $Conf{IncrAgeMax} =3D 30; # # Level of each incremental. "Level" follows the terminology # of dump(1). A full backup has level 0. A new incremental # of level N will backup all files that have changed since # the most recent backup of a lower level. # # The entries of $Conf{IncrLevels} apply in order to each # incremental after each full backup. It wraps around until # the next full backup. For example, these two settings # have the same effect: # # $Conf{IncrLevels} =3D [1, 2, 3]; # $Conf{IncrLevels} =3D [1, 2, 3, 1, 2, 3]; # # This means the 1st and 4th incrementals (level 1) go all # the way back to the full. The 2nd and 3rd (and 5th and # 6th) backups just go back to the immediate preceeding # incremental. # # Specifying a sequence of multi-level incrementals will # usually mean more than $Conf{IncrKeepCnt} incrementals will # need to be kept, since lower level incrementals are needed # to merge a complete view of a backup. For example, with # # $Conf{FullPeriod} =3D 7; # $Conf{IncrPeriod} =3D 1; # $Conf{IncrKeepCnt} =3D 6; # $Conf{IncrLevels} =3D [1, 2, 3, 4, 5, 6]; # # there will be up to 11 incrementals in this case: # # backup #0 (full, level 0, oldest) # backup #1 (incr, level 1) # backup #2 (incr, level 2) # backup #3 (incr, level 3) # backup #4 (incr, level 4) # backup #5 (incr, level 5) # backup #6 (incr, level 6) # backup #7 (full, level 0) # backup #8 (incr, level 1) # backup #9 (incr, level 2) # backup #10 (incr, level 3) # backup #11 (incr, level 4) # backup #12 (incr, level 5, newest) # # Backup #1 (the oldest level 1 incremental) can't be deleted # since backups 2..6 depend on it. Those 6 incrementals can't # all be deleted since that would only leave 5 (#8..12). # When the next incremental happens (level 6), the complete # set of 6 older incrementals (#1..6) will be deleted, since # that maintains the required number ($Conf{IncrKeepCnt}) # of incrementals. This situation is reduced if you set # shorter chains of multi-level incrementals, eg: # # $Conf{IncrLevels} =3D [1, 2, 3]; # # would only have up to 2 extra incremenals before all 3 # are deleted. # # BackupPC as usual merges the full and the sequence # of incrementals together so each incremental can be # browsed and restored as though it is a complete backup. # If you specify a long chain of incrementals then more # backups need to be merged when browsing, restoring, # or getting the starting point for rsync backups. # In the example above (levels 1..6), browing backup # #6 requires 7 different backups (#0..6) to be merged. # # Because of this merging and the additional incrementals # that need to be kept, it is recommended that some # level 1 incrementals be included in $Conf{IncrLevels}. # # Prior to version 3.0 incrementals were always level 1, # meaning each incremental backed up all the files that # changed since the last full. # $Conf{IncrLevels} =3D [ 1 ]; # # Disable all full and incremental backups. These settings are # useful for a client that is no longer being backed up # (eg: a retired machine), but you wish to keep the last # backups available for browsing or restoring to other machines. # # There are three values for $Conf{BackupsDisable}: # # 0 Backups are enabled. # # 1 Don't do any regular backups on this client. Manually # requested backups (via the CGI interface) will still occur. # # 2 Don't do any backups on this client. Manually requested # backups (via the CGI interface) will be ignored. # # In versions prior to 3.0 Backups were disabled by setting # $Conf{FullPeriod} to -1 or -2. # $Conf{BackupsDisable} =3D 0; # # A failed full backup is saved as a partial backup. The rsync # XferMethod can take advantage of the partial full when the next # backup is run. This parameter sets the age of the partial full # in days: if the partial backup is older than this number of # days, then rsync will ignore (not use) the partial full when # the next backup is run. If you set this to a negative value # then no partials will be saved. If you set this to 0, partials # will be saved, but will not be used by the next backup. # # The default setting of 3 days means that a partial older than # 3 days is ignored when the next full backup is done. # $Conf{PartialAgeMax} =3D 3; # # Whether incremental backups are filled. "Filling" means that the # most recent full (or filled) dump is merged into the new incremental # dump using hardlinks. This makes an incremental dump look like a # full dump. Prior to v1.03 all incremental backups were filled. # In v1.4.0 and later the default is off. # # BackupPC, and the cgi interface in particular, do the right thing on # un-filled incremental backups. It will correctly display the merged # incremental backup with the most recent filled backup, giving the # un-filled incremental backups a filled appearance. That means it # invisible to the user whether incremental dumps are filled or not. # # Filling backups takes a little extra disk space, and it does cost # some extra disk activity for filling, and later removal. Filling # is no longer useful, since file mangling and compression doesn't # make a filled backup very useful. It's likely the filling option # will be removed from future versions: filling will be delegated to # the display and extraction of backup data. # # If filling is off, BackupPC makes sure that the oldest backup is # a full, otherwise the following incremental backups will be # incomplete. This might mean an extra full backup has to be # kept until the following incremental backups expire. # # The default is off. You can turn this on or off at any # time without affecting existing backups. # $Conf{IncrFill} =3D '0'; # # Number of restore logs to keep. BackupPC remembers information about # each restore request. This number per client will be kept around before # the oldest ones are pruned. # # Note: files/dirs delivered via Zip or Tar downloads don't count as # restores. Only the first restore option (where the files and dirs # are written to the host) count as restores that are logged. # $Conf{RestoreInfoKeepCnt} =3D 10; # # Number of archive logs to keep. BackupPC remembers information # about each archive request. This number per archive client will # be kept around before the oldest ones are pruned. # $Conf{ArchiveInfoKeepCnt} =3D 10; # # List of directories or files to backup. If this is defined, only these # directories or files will be backed up. # # When editing from the web interface, you should add a valid ShareName # (based on $Conf{XferMethod}), and then enter the directories specific # to that ShareName. A special ShareName "*" matches any ShareName that # doesn't have an explicit entry. # # For Smb, only one of $Conf{BackupFilesExclude} and $Conf{BackupFilesOnly} # can be specified per share. If both are set for a particular share, then # $Conf{BackupFilesOnly} takes precedence and $Conf{BackupFilesExclude} # is ignored. # # This can be set to a string, an array of strings, or, in the case # of multiple shares, a hash of strings or arrays. A hash is used # to give a list of directories or files to backup for each share # (the share name is the key). If this is set to just a string or # array, and $Conf{SmbShareName} contains multiple share names, then # the setting is assumed to apply all shares. # # If a hash is used, a special key "*" means it applies to all # shares that don't have a specific entry. # # Examples: # $Conf{BackupFilesOnly} =3D '/myFiles'; # $Conf{BackupFilesOnly} =3D ['/myFiles']; # same as first example # $Conf{BackupFilesOnly} =3D ['/myFiles', '/important']; # $Conf{BackupFilesOnly} =3D { # 'c' =3D> ['/myFiles', '/important'], # these are for 'c' share # 'd' =3D> ['/moreFiles', '/archive'], # these are for 'd' share # }; # $Conf{BackupFilesOnly} =3D { # 'c' =3D> ['/myFiles', '/important'], # these are for 'c' share # '*' =3D> ['/myFiles', '/important'], # these are other shares # }; # $Conf{BackupFilesOnly} =3D {}; # # List of directories or files to exclude from the backup. For Smb, # only one of $Conf{BackupFilesExclude} and $Conf{BackupFilesOnly} # can be specified per share. If both are set for a particular share, # then $Conf{BackupFilesOnly} takes precedence and # $Conf{BackupFilesExclude} is ignored. # # When editing from the web interface, you should add a valid ShareName # (based on $Conf{XferMethod}), and then enter the directories or files # specific to that ShareName. A special ShareName "*" matches any # ShareName that doesn't have an explicit entry. # # This can be set to a string, an array of strings, or, in the case # of multiple shares, a hash of strings or arrays. A hash is used # to give a list of directories or files to exclude for each share # (the share name is the key). If this is set to just a string or # array, and $Conf{SmbShareName} contains multiple share names, then # the setting is assumed to apply to all shares. # # The exact behavior is determined by the underlying transport program, # smbclient or tar. For smbclient the exlclude file list is passed into # the X option. Simple shell wild-cards using "*" or "?" are allowed. # # For tar, if the exclude file contains a "/" it is assumed to be anchored # at the start of the string. Since all the tar paths start with "./", # BackupPC prepends a "." if the exclude file starts with a "/". Note # that GNU tar version >=3D 1.13.7 is required for the exclude option to # work correctly. For linux or unix machines you should add # "/proc" to $Conf{BackupFilesExclude} unless you have specified # --one-file-system in $Conf{TarClientCmd} or --one-file-system in # $Conf{RsyncArgs}. Also, for tar, do not use a trailing "/" in # the directory name: a trailing "/" causes the name to not match # and the directory will not be excluded. # # Users report that for smbclient you should specify a directory # followed by "/*", eg: "/proc/*", instead of just "/proc". # # FTP servers are traversed recursively so excluding directories will # also exclude its contents. You can use the wildcard characters "*" # and "?" to define files for inclusion and exclusion. Both # attributes $Conf{BackupFilesOnly} and $Conf{BackupFilesExclude} can # be defined for the same share. # # If a hash is used, a special key "*" means it applies to all # shares that don't have a specific entry. # # Examples: # $Conf{BackupFilesExclude} =3D '/temp'; # $Conf{BackupFilesExclude} =3D ['/temp']; # same as first example # $Conf{BackupFilesExclude} =3D ['/temp', '/winnt/tmp']; # $Conf{BackupFilesExclude} =3D { # 'c' =3D> ['/temp', '/winnt/tmp'], # these are for 'c' share # 'd' =3D> ['/junk', '/dont_back_this_up'], # these are for 'd' share # }; # $Conf{BackupFilesExclude} =3D { # 'c' =3D> ['/temp', '/winnt/tmp'], # these are for 'c' share # '*' =3D> ['/junk', '/dont_back_this_up'], # these are for other sha= res # }; # $Conf{BackupFilesExclude} =3D {}; # # PCs that are always or often on the network can be backed up after # hours, to reduce PC, network and server load during working hours. For # each PC a count of consecutive good pings is maintained. Once a PC has # at least $Conf{BlackoutGoodCnt} consecutive good pings it is subject # to "blackout" and not backed up during hours and days specified by # $Conf{BlackoutPeriods}. # # To allow for periodic rebooting of a PC or other brief periods when a # PC is not on the network, a number of consecutive bad pings is allowed # before the good ping count is reset. This parameter is # $Conf{BlackoutBadPingLimit}. # # Note that bad and good pings don't occur with the same interval. If a # machine is always on the network, it will only be pinged roughly once # every $Conf{IncrPeriod} (eg: once per day). So a setting for # $Conf{BlackoutGoodCnt} of 7 means it will take around 7 days for a # machine to be subject to blackout. On the other hand, if a ping is # failed, it will be retried roughly every time BackupPC wakes up, eg, # every one or two hours. So a setting for $Conf{BlackoutBadPingLimit} of # 3 means that the PC will lose its blackout status after 3-6 hours of # unavailability. # # To disable the blackout feature set $Conf{BlackoutGoodCnt} to a negative # value. A value of 0 will make all machines subject to blackout. But # if you don't want to do any backups during the day it would be easier # to just set $Conf{WakeupSchedule} to a restricted schedule. # $Conf{BlackoutBadPingLimit} =3D 3; $Conf{BlackoutGoodCnt} =3D 1; # # One or more blackout periods can be specified. If a client is # subject to blackout then no regular (non-manual) backups will # be started during any of these periods. hourBegin and hourEnd # specify hours fro midnight and weekDays is a list of days of # the week where 0 is Sunday, 1 is Monday etc. # # For example: # # $Conf{BlackoutPeriods} =3D [ # { # hourBegin =3D> 7.0, # hourEnd =3D> 19.5, # weekDays =3D> [1, 2, 3, 4, 5], # }, # ]; # # specifies one blackout period from 7:00am to 7:30pm local time # on Mon-Fri. # # The blackout period can also span midnight by setting # hourBegin > hourEnd, eg: # # $Conf{BlackoutPeriods} =3D [ # { # hourBegin =3D> 7.0, # hourEnd =3D> 19.5, # weekDays =3D> [1, 2, 3, 4, 5], # }, # { # hourBegin =3D> 23, # hourEnd =3D> 5, # weekDays =3D> [5, 6], # }, # ]; # # This specifies one blackout period from 7:00am to 7:30pm local time # on Mon-Fri, and a second period from 11pm to 5am on Friday and # Saturday night. # $Conf{BlackoutPeriods} =3D [ { 'hourEnd' =3D> 20, 'weekDays' =3D> [ 0, 1, 2, 3, 4, 5, 6 ], 'hourBegin' =3D> 7 } ]; # # A backup of a share that has zero files is considered fatal. This is # used to catch miscellaneous Xfer errors that result in no files being # backed up. If you have shares that might be empty (and therefore an # empty backup is valid) you should set this flag to 0. # $Conf{BackupZeroFilesIsFatal} =3D '1'; ########################################################################### # How to backup a client # (can be overridden in the per-PC config.pl) ########################################################################### # # What transport method to use to backup each host. If you have # a mixed set of WinXX and linux/unix hosts you will need to override # this in the per-PC config.pl. # # The valid values are: # # - 'smb': backup and restore via smbclient and the SMB protocol. # Easiest choice for WinXX. # # - 'rsync': backup and restore via rsync (via rsh or ssh). # Best choice for linux/unix. Good choice also for WinXX. # # - 'rsyncd': backup and restore via rsync daemon on the client. # Best choice for linux/unix if you have rsyncd running on # the client. Good choice also for WinXX. # # - 'tar': backup and restore via tar, tar over ssh, rsh or nfs. # Good choice for linux/unix. # # - 'archive': host is a special archive host. Backups are not done. # An archive host is used to archive other host's backups # to permanent media, such as tape, CDR or DVD. # # $Conf{XferMethod} =3D 'rsync'; # # Level of verbosity in Xfer log files. 0 means be quiet, 1 will give # will give one line per file, 2 will also show skipped files on # incrementals, higher values give more output. # $Conf{XferLogLevel} =3D 1; # # Filename charset encoding on the client. BackupPC uses utf8 # on the server for filename encoding. If this is empty, then # utf8 is assumed and client filenames will not be modified. # If set to a different encoding then filenames will converted # to/from utf8 automatically during backup and restore. # # If the file names displayed in the browser (eg: accents or special # characters) don't look right then it is likely you haven't set # $Conf{ClientCharset} correctly. # # If you are using smbclient on a WinXX machine, smbclient will convert # to the "unix charset" setting in smb.conf. The default is utf8, # in which case leave $Conf{ClientCharset} empty since smbclient does # the right conversion. # # If you are using rsync on a WinXX machine then it does no conversion. # A typical WinXX encoding for latin1/western europe is 'cp1252', # so in this case set $Conf{ClientCharset} to 'cp1252'. # # On a linux or unix client, run "locale charmap" to see the client's # charset. Set $Conf{ClientCharset} to this value. A typical value # for english/US is 'ISO-8859-1'. # # Do "perldoc Encode::Supported" to see the list of possible charset # values. The FAQ at http://www.cl.cam.ac.uk/~mgk25/unicode.html # is excellent, and http://czyborra.com/charsets/iso8859.html # provides more information on the iso-8859 charsets. # $Conf{ClientCharset} =3D ''; # # Prior to 3.x no charset conversion was done by BackupPC. Backups were # stored in what ever charset the XferMethod provided - typically utf8 # for smbclient and the client's locale settings for rsync and tar (eg: # cp1252 for rsync on WinXX and perhaps iso-8859-1 with rsync on linux). # This setting tells BackupPC the charset that was used to store file # names in old backups taken with BackupPC 2.x, so that non-ascii file # names in old backups can be viewed and restored. # $Conf{ClientCharsetLegacy} =3D 'iso-8859-1'; ########################################################################### # Samba Configuration # (can be overwritten in the per-PC log file) ########################################################################### # # Name of the host share that is backed up when using SMB. This can be a # string or an array of strings if there are multiple shares per host. # Examples: # # $Conf{SmbShareName} =3D 'c'; # backup 'c' share # $Conf{SmbShareName} =3D ['c', 'd']; # backup 'c' and 'd' shares # # This setting only matters if $Conf{XferMethod} =3D 'smb'. # $Conf{SmbShareName} =3D [ 'C$' ]; # # Smbclient share user name. This is passed to smbclient's -U argument. # # This setting only matters if $Conf{XferMethod} =3D 'smb'. # $Conf{SmbShareUserName} =3D ''; # # Smbclient share password. This is passed to smbclient via its PASSWD # environment variable. There are several ways you can tell BackupPC # the smb share password. In each case you should be very careful about # security. If you put the password here, make sure that this file is # not readable by regular users! See the "Setting up config.pl" section # in the documentation for more information. # # This setting only matters if $Conf{XferMethod} =3D 'smb'. # $Conf{SmbSharePasswd} =3D ''; # # Full path for smbclient. Security caution: normal users should not # allowed to write to this file or directory. # # smbclient is from the Samba distribution. smbclient is used to # actually extract the incremental or full dump of the share filesystem # from the PC. # # This setting only matters if $Conf{XferMethod} =3D 'smb'. # $Conf{SmbClientPath} =3D '/usr/bin/smbclient'; # # Command to run smbclient for a full dump. # This setting only matters if $Conf{XferMethod} =3D 'smb'. # # The following variables are substituted at run-time: # # $smbClientPath same as $Conf{SmbClientPath} # $host host to backup/restore # $hostIP host IP address # $shareName share name # $userName user name # $fileList list of files to backup (based on exclude/include) # $I_option optional -I option to smbclient # $X_option exclude option (if $fileList is an exclude list) # $timeStampFile start time for incremental dump # # Note: all Cmds are executed directly without a shell, so the prog name # needs to be a full path and you can't include shell syntax like # redirection and pipes; put that in a script if you need it. # $Conf{SmbClientFullCmd} =3D '$smbClientPath \\\\$host\\$shareName $I_option= -U $userName -E -d 1 -c tarmode\\ full -Tc$X_option - $fileList'; # # Command to run smbclient for an incremental dump. # This setting only matters if $Conf{XferMethod} =3D 'smb'. # # Same variable substitutions are applied as $Conf{SmbClientFullCmd}. # # Note: all Cmds are executed directly without a shell, so the prog name # needs to be a full path and you can't include shell syntax like # redirection and pipes; put that in a script if you need it. # $Conf{SmbClientIncrCmd} =3D '$smbClientPath \\\\$host\\$shareName $I_option= -U $userName -E -d 1 -c tarmode\\ full -TcN$X_option $timeStampFile - $fil= eList'; # # Command to run smbclient for a restore. # This setting only matters if $Conf{XferMethod} =3D 'smb'. # # Same variable substitutions are applied as $Conf{SmbClientFullCmd}. # # If your smb share is read-only then direct restores will fail. # You should set $Conf{SmbClientRestoreCmd} to undef and the # corresponding CGI restore option will be removed. # # Note: all Cmds are executed directly without a shell, so the prog name # needs to be a full path and you can't include shell syntax like # redirection and pipes; put that in a script if you need it. # $Conf{SmbClientRestoreCmd} =3D '$smbClientPath \\\\$host\\$shareName $I_opt= ion -U $userName -E -d 1 -c tarmode\\ full -Tx -'; ########################################################################### # Tar Configuration # (can be overwritten in the per-PC log file) ########################################################################### # # Which host directories to backup when using tar transport. This can be a # string or an array of strings if there are multiple directories to # backup per host. Examples: # # $Conf{TarShareName} =3D '/'; # backup= everything # $Conf{TarShareName} =3D '/home'; # only backup /h= ome # $Conf{TarShareName} =3D ['/home', '/src']; # backup /home and /= src # # The fact this parameter is called 'TarShareName' is for historical # consistency with the Smb transport options. You can use any valid # directory on the client: there is no need for it to correspond to # any Smb share or device mount point. # # Note also that you can also use $Conf{BackupFilesOnly} to specify # a specific list of directories to backup. It's more efficient to # use this option instead of $Conf{TarShareName} since a new tar is # run for each entry in $Conf{TarShareName}. # # On the other hand, if you add --one-file-system to $Conf{TarClientCmd} # you can backup each file system separately, which makes restoring one # bad file system easier. In this case you would list all of the mount # points here, since you can't get the same result with # $Conf{BackupFilesOnly}: # # $Conf{TarShareName} =3D ['/', '/var', '/data', '/boot']; # # This setting only matters if $Conf{XferMethod} =3D 'tar'. # $Conf{TarShareName} =3D [ '/' ]; # # Command to run tar on the client. GNU tar is required. You will # need to fill in the correct paths for ssh2 on the local host (server) # and GNU tar on the client. Security caution: normal users should not # allowed to write to these executable files or directories. # # $Conf{TarClientCmd} is appended with with either $Conf{TarFullArgs} or # $Conf{TarIncrArgs} to create the final command that is run. # # See the documentation for more information about setting up ssh2 keys. # # If you plan to use NFS then tar just runs locally and ssh2 is not needed. # For example, assuming the client filesystem is mounted below /mnt/hostNam= e, # you could use something like: # # $Conf{TarClientCmd} =3D '$tarPath -c -v -f - -C /mnt/$host/$shareName' # . ' --totals'; # # In the case of NFS or rsh you need to make sure BackupPC's privileges # are sufficient to read all the files you want to backup. Also, you # will probably want to add "/proc" to $Conf{BackupFilesExclude}. # # The following variables are substituted at run-time: # # $host host name # $hostIP host's IP address # $incrDate newer-than date for incremental backups # $shareName share name to backup (ie: top-level directory path) # $fileList specific files to backup or exclude # $tarPath same as $Conf{TarClientPath} # $sshPath same as $Conf{SshPath} # # If a variable is followed by a "+" it is shell escaped. This is # necessary for the command part of ssh or rsh, since it ends up # getting passed through the shell. # # This setting only matters if $Conf{XferMethod} =3D 'tar'. # # Note: all Cmds are executed directly without a shell, so the prog name # needs to be a full path and you can't include shell syntax like # redirection and pipes; put that in a script if you need it. # $Conf{TarClientCmd} =3D '$sshPath -q -x -n -l root $host env LC_ALL=3DC $ta= rPath -c -v -f - -C $shareName+ --totals'; # # Extra tar arguments for full backups. Several variables are substituted = at # run-time. See $Conf{TarClientCmd} for the list of variable substitutions= . # # If you are running tar locally (ie: without rsh or ssh) then remove the # "+" so that the argument is no longer shell escaped. # # This setting only matters if $Conf{XferMethod} =3D 'tar'. # $Conf{TarFullArgs} =3D '$fileList+'; # # Extra tar arguments for incr backups. Several variables are substituted = at # run-time. See $Conf{TarClientCmd} for the list of variable substitutions= . # # Note that GNU tar has several methods for specifying incremental backups, # including: # # --newer-mtime $incrDate+ # This causes a file to be included if the modification time is # later than $incrDate (meaning its contents might have changed). # But changes in the ownership or modes will not qualify the # file to be included in an incremental. # # --newer=3D$incrDate+ # This causes the file to be included if any attribute of the # file is later than $incrDate, meaning either attributes or # the modification time. This is the default method. Do # not use --atime-preserve in $Conf{TarClientCmd} above, # otherwise resetting the atime (access time) counts as an # attribute change, meaning the file will always be included # in each new incremental dump. # # If you are running tar locally (ie: without rsh or ssh) then remove the # "+" so that the argument is no longer shell escaped. # # This setting only matters if $Conf{XferMethod} =3D 'tar'. # $Conf{TarIncrArgs} =3D '--newer=3D$incrDate+ $fileList+'; # # Full command to run tar for restore on the client. GNU tar is required. # This can be the same as $Conf{TarClientCmd}, with tar's -c replaced by -x # and ssh's -n removed. # # See $Conf{TarClientCmd} for full details. # # This setting only matters if $Conf{XferMethod} =3D "tar". # # If you want to disable direct restores using tar, you should set # $Conf{TarClientRestoreCmd} to undef and the corresponding CGI # restore option will be removed. # # Note: all Cmds are executed directly without a shell, so the prog name # needs to be a full path and you can't include shell syntax like # redirection and pipes; put that in a script if you need it. # $Conf{TarClientRestoreCmd} =3D '$sshPath -q -x -l root $host env LC_ALL=3DC= $tarPath -x -p --numeric-owner --same-owner -v -f - -C $shareName+'; # # Full path for tar on the client. Security caution: normal users should no= t # allowed to write to this file or directory. # # This setting only matters if $Conf{XferMethod} =3D 'tar'. # $Conf{TarClientPath} =3D '/bin/tar'; ########################################################################### # Rsync/Rsyncd Configuration # (can be overwritten in the per-PC log file) ########################################################################### # # Path to rsync executable on the client # $Conf{RsyncClientPath} =3D '/usr/bin/rsync'; # # Full command to run rsync on the client machine. The following variables # are substituted at run-time: # # $host host name being backed up # $hostIP host's IP address # $shareName share name to backup (ie: top-level directory path= ) # $rsyncPath same as $Conf{RsyncClientPath} # $sshPath same as $Conf{SshPath} # $argList argument list, built from $Conf{RsyncArgs}, # $shareName, $Conf{BackupFilesExclude} and # $Conf{BackupFilesOnly} # # This setting only matters if $Conf{XferMethod} =3D 'rsync'. # $Conf{RsyncClientCmd} =3D '$sshPath -q -x -l root $host $rsyncPath $argList= +'; # # Full command to run rsync for restore on the client. The following # variables are substituted at run-time: # # $host host name being backed up # $hostIP host's IP address # $shareName share name to backup (ie: top-level directory path= ) # $rsyncPath same as $Conf{RsyncClientPath} # $sshPath same as $Conf{SshPath} # $argList argument list, built from $Conf{RsyncArgs}, # $shareName, $Conf{BackupFilesExclude} and # $Conf{BackupFilesOnly} # # This setting only matters if $Conf{XferMethod} =3D 'rsync'. # # Note: all Cmds are executed directly without a shell, so the prog name # needs to be a full path and you can't include shell syntax like # redirection and pipes; put that in a script if you need it. # $Conf{RsyncClientRestoreCmd} =3D '$sshPath -q -x -l root $host $rsyncPath $= argList+'; # # Share name to backup. For $Conf{XferMethod} =3D "rsync" this should # be a file system path, eg '/' or '/home'. # # For $Conf{XferMethod} =3D "rsyncd" this should be the name of the module # to backup (ie: the name from /etc/rsynd.conf). # # This can also be a list of multiple file system paths or modules. # For example, by adding --one-file-system to $Conf{RsyncArgs} you # can backup each file system separately, which makes restoring one # bad file system easier. In this case you would list all of the mount # points: # # $Conf{RsyncShareName} =3D ['/', '/var', '/data', '/boot']; # $Conf{RsyncShareName} =3D [ '/' ]; # # Rsync daemon port on the client, for $Conf{XferMethod} =3D "rsyncd". # $Conf{RsyncdClientPort} =3D 873; # # Rsync daemon user name on client, for $Conf{XferMethod} =3D "rsyncd". # The user name and password are stored on the client in whatever file # the "secrets file" parameter in rsyncd.conf points to # (eg: /etc/rsyncd.secrets). # $Conf{RsyncdUserName} =3D ''; # # Rsync daemon user name on client, for $Conf{XferMethod} =3D "rsyncd". # The user name and password are stored on the client in whatever file # the "secrets file" parameter in rsyncd.conf points to # (eg: /etc/rsyncd.secrets). # $Conf{RsyncdPasswd} =3D ''; # # Whether authentication is mandatory when connecting to the client's # rsyncd. By default this is on, ensuring that BackupPC will refuse to # connect to an rsyncd on the client that is not password protected. # Turn off at your own risk. # $Conf{RsyncdAuthRequired} =3D '1'; # # When rsync checksum caching is enabled (by adding the # --checksum-seed=3D32761 option to $Conf{RsyncArgs}), the cached # checksums can be occasionally verified to make sure the file # contents matches the cached checksums. This is to avoid the # risk that disk problems might cause the pool file contents to # get corrupted, but the cached checksums would make BackupPC # think that the file still matches the client. # # This setting is the probability (0 means never and 1 means always) # that a file will be rechecked. Setting it to 0 means the checksums # will not be rechecked (unless there is a phase 0 failure). Setting # it to 1 (ie: 100%) means all files will be checked, but that is # not a desirable setting since you are better off simply turning # caching off (ie: remove the --checksum-seed option). # # The default of 0.01 means 1% (on average) of the files during a full # backup will have their cached checksum re-checked. # # This setting has no effect unless checksum caching is turned on. # $Conf{RsyncCsumCacheVerifyProb} =3D '0.01'; # # Arguments to rsync for backup. Do not edit the first set unless you # have a thorough understanding of how File::RsyncP works. # $Conf{RsyncArgs} =3D [ '--numeric-ids', '--perms', '--owner', '--group', '-D', '--links', '--hard-links', '--times', '--block-size=3D2048', '--recursive' ]; # # Additional arguments added to RsyncArgs. This can be used in # conbination with $Conf{RsyncArgs} to allow customization of # the rsync arguments on a part-client basis. The standard # arguments go in $Conf{RsyncArgs} and $Conf{RsyncArgsExtra} # can be set on a per-client basis. # # Examples of additional arguments that should work are --exclude/--include= , # eg: # # $Conf{RsyncArgsExtra} =3D [ # '--exclude', '/proc', # '--exclude', '*.tmp', # ]; # # Both $Conf{RsyncArgs} and $Conf{RsyncArgsExtra} are subject # to the following variable substitutions: # # $client client name being backed up # $host host name (could be different from client name if # $Conf{ClientNameAlias} is set) # $hostIP IP address of host # $confDir configuration directory path # # This allows settings of the form: # # $Conf{RsyncArgsExtra} =3D [ # '--exclude-from=3D$confDir/pc/$host.exclude', # ]; # $Conf{RsyncArgsExtra} =3D [ '--one-file-system', '' ]; # # Arguments to rsync for restore. Do not edit the first set unless you # have a thorough understanding of how File::RsyncP works. # # If you want to disable direct restores using rsync (eg: is the module # is read-only), you should set $Conf{RsyncRestoreArgs} to undef and # the corresponding CGI restore option will be removed. # # $Conf{RsyncRestoreArgs} is subject to the following variable # substitutions: # # $client client name being backed up # $host host name (could be different from client name if # $Conf{ClientNameAlias} is set) # $hostIP IP address of host # $confDir configuration directory path # # Note: $Conf{RsyncArgsExtra} doesn't apply to $Conf{RsyncRestoreArgs}. # $Conf{RsyncRestoreArgs} =3D [ '--numeric-ids', '--perms', '--owner', '--group', '-D', '--links', '--hard-links', '--times', '--block-size=3D2048', '--relative', '--ignore-times', '--recursive' ]; ########################################################################### # FTP Configuration # (can be overwritten in the per-PC log file) ########################################################################## # # Which host directories to backup when using FTP. This can be a # string or an array of strings if there are multiple shares per host. # # This value must be specified in one of two ways: either as a # subdirectory of the 'share root' on the server, or as the absolute # path of the directory. # # In the following example, if the directory /home/username is the # root share of the ftp server with the given username, the following # two values will back up the same directory: # # $Conf{FtpShareName} =3D 'www'; # www directory # $Conf{FtpShareName} =3D '/home/username/www'; # same directory # # Path resolution is not supported; i.e.; you may not have an ftp # share path defined as '../otheruser' or '~/games'. # # Multiple shares may also be specified, as with other protocols: # # $Conf{FtpShareName} =3D [ 'www', # 'bin', # 'config' ]; # # Note also that you can also use $Conf{BackupFilesOnly} to specify # a specific list of directories to backup. It's more efficient to # use this option instead of $Conf{FtpShareName} since a new tar is # run for each entry in $Conf{FtpShareName}. # # This setting only matters if $Conf{XferMethod} =3D 'ftp'. # $Conf{FtpShareName} =3D [ '' ]; # # FTP user name. This is used to log into the server. # # This setting is used only if $Conf{XferMethod} =3D 'ftp'. # $Conf{FtpUserName} =3D ''; # # FTP user password. This is used to log into the server. # # This setting is used only if $Conf{XferMethod} =3D 'ftp'. # $Conf{FtpPasswd} =3D ''; # # Whether passive mode is used. The correct setting depends upon # whether local or remote ports are accessible from the other machine, # which is affected by any firewall or routers between the FTP server # on the client and the BackupPC server. # # This setting is used only if $Conf{XferMethod} =3D 'ftp'. # $Conf{FtpPassive} =3D '1'; # # Transfer block size. This sets the size of the amounts of data in # each frame. While undefined, this value takes the default value. # # This setting is used only if $Conf{XferMethod} =3D 'ftp'. # $Conf{FtpBlockSize} =3D 10240; # # The port of the ftp server. If undefined, 21 is used. # # This setting is used only if $Conf{XferMethod} =3D 'ftp'. # $Conf{FtpPort} =3D 21; # # Connection timeout for FTP. When undefined, the default is 120 seconds. # # This setting is used only if $Conf{XferMethod} =3D 'ftp'. # #$Conf{FtpTimeout} =3D 120; $Conf{FtpTimeout} =3D 240; # # Behaviour when BackupPC encounters symlinks on the FTP share. # # Symlinks cannot be restored via FTP, so the desired behaviour will # be different depending on the setup of the share. The default for # this behavor is 1. Directory shares with more complicated directory # structures should consider other protocols. # $Conf{FtpFollowSymlinks} =3D '0'; ########################################################################### # Archive Configuration # (can be overwritten in the per-PC log file) ########################################################################### # # Archive Destination # # The Destination of the archive # e.g. /tmp for file archive or /dev/nst0 for device archive # $Conf{ArchiveDest} =3D '/tmp'; # # Archive Compression type # # The valid values are: # # - 'none': No Compression # # - 'gzip': Medium Compression. Recommended. # # - 'bzip2': High Compression but takes longer. # $Conf{ArchiveComp} =3D 'gzip'; # # Archive Parity Files # # The amount of Parity data to generate, as a percentage # of the archive size. # Uses the commandline par2 (par2cmdline) available from # http://parchive.sourceforge.net # # Only useful for file dumps. # # Set to 0 to disable this feature. # $Conf{ArchivePar} =3D '0'; # # Archive Size Split # # Only for file archives. Splits the output into # the specified size * 1,000,000. # e.g. to split into 650,000,000 bytes, specify 650 below. # # If the value is 0, or if $Conf{ArchiveDest} is an existing file or # device (e.g. a streaming tape drive), this feature is disabled. # $Conf{ArchiveSplit} =3D 0; # # Archive Command # # This is the command that is called to actually run the archive process # for each host. The following variables are substituted at run-time: # # $Installdir The installation directory of BackupPC # $tarCreatePath The path to BackupPC_tarCreate # $splitpath The path to the split program # $parpath The path to the par2 program # $host The host to archive # $backupnumber The backup number of the host to archive # $compression The path to the compression program # $compext The extension assigned to the compression type # $splitsize The number of bytes to split archives into # $archiveloc The location to put the archive # $parfile The amount of parity data to create (percentage) # # Note: all Cmds are executed directly without a shell, so the prog name # needs to be a full path and you can't include shell syntax like # redirection and pipes; put that in a script if you need it. # $Conf{ArchiveClientCmd} =3D '$Installdir/bin/BackupPC_archiveHost $tarCreat= ePath $splitpath $parpath $host $backupnumber $compression $compext $splits= ize $archiveloc $parfile *'; # # Full path for ssh. Security caution: normal users should not # allowed to write to this file or directory. # $Conf{SshPath} =3D '/usr/bin/ssh'; # # Full path for nmblookup. Security caution: normal users should not # allowed to write to this file or directory. # # nmblookup is from the Samba distribution. nmblookup is used to get the # netbios name, necessary for DHCP hosts. # $Conf{NmbLookupPath} =3D '/usr/bin/nmblookup'; # # NmbLookup command. Given an IP address, does an nmblookup on that # IP address. The following variables are substituted at run-time: # # $nmbLookupPath path to nmblookup ($Conf{NmbLookupPath}) # $host IP address # # This command is only used for DHCP hosts: given an IP address, this # command should try to find its NetBios name. # # Note: all Cmds are executed directly without a shell, so the prog name # needs to be a full path and you can't include shell syntax like # redirection and pipes; put that in a script if you need it. # $Conf{NmbLookupCmd} =3D '$nmbLookupPath -A $host'; # # NmbLookup command. Given a netbios name, finds that host by doing # a NetBios lookup. Several variables are substituted at run-time: # # $nmbLookupPath path to nmblookup ($Conf{NmbLookupPath}) # $host NetBios name # # In some cases you might need to change the broadcast address, for # example if nmblookup uses 192.168.255.255 by default and you find # that doesn't work, try 192.168.1.255 (or your equivalent class C # address) using the -B option: # # $Conf{NmbLookupFindHostCmd} =3D '$nmbLookupPath -B 192.168.1.255 $host= '; # # If you use a WINS server and your machines don't respond to # multicast NetBios requests you can use this (replace 1.2.3.4 # with the IP address of your WINS server): # # $Conf{NmbLookupFindHostCmd} =3D '$nmbLookupPath -R -U 1.2.3.4 $host'; # # This is preferred over multicast since it minimizes network traffic. # # Experiment manually for your site to see what form of nmblookup command # works. # # Note: all Cmds are executed directly without a shell, so the prog name # needs to be a full path and you can't include shell syntax like # redirection and pipes; put that in a script if you need it. # $Conf{NmbLookupFindHostCmd} =3D '$nmbLookupPath $host'; # # For fixed IP address hosts, BackupPC_dump can also verify the netbios # name to ensure it matches the host name. An error is generated if # they do not match. Typically this flag is off. But if you are going # to transition a bunch of machines from fixed host addresses to DHCP, # setting this flag is a great way to verify that the machines have # their netbios name set correctly before turning on DCHP. # $Conf{FixedIPNetBiosNameCheck} =3D '0'; # # Full path to the ping command. Security caution: normal users # should not be allowed to write to this file or directory. # # If you want to disable ping checking, set this to some program # that exits with 0 status, eg: # # $Conf{PingPath} =3D '/bin/echo'; # $Conf{PingPath} =3D '/bin/ping'; $Conf{Ping6Path} =3D undef; # # Ping command. The following variables are substituted at run-time: # # $pingPath path to ping ($Conf{PingPath}) # $host host name # # Wade Brown reports that on solaris 2.6 and 2.7 ping -s returns the wrong # exit status (0 even on failure). Replace with "ping $host 1", which # gets the correct exit status but we don't get the round-trip time. # # Note: all Cmds are executed directly without a shell, so the prog name # needs to be a full path and you can't include shell syntax like # redirection and pipes; put that in a script if you need it. # $Conf{PingCmd} =3D '$pingPath -c 1 $host'; # # Maximum round-trip ping time in milliseconds. This threshold is set # to avoid backing up PCs that are remotely connected through WAN or # dialup connections. The output from ping -s (assuming it is supported # on your system) is used to check the round-trip packet time. On your # local LAN round-trip times should be much less than 20msec. On most # WAN or dialup connections the round-trip time will be typically more # than 20msec. Tune if necessary. # $Conf{PingMaxMsec} =3D 20; # # Compression level to use on files. 0 means no compression. Compression # levels can be from 1 (least cpu time, slightly worse compression) to # 9 (most cpu time, slightly better compression). The recommended value # is 3. Changing to 5, for example, will take maybe 20% more cpu time # and will get another 2-3% additional compression. See the zlib # documentation for more information about compression levels. # # Changing compression on or off after backups have already been done # will require both compressed and uncompressed pool files to be stored. # This will increase the pool storage requirements, at least until all # the old backups expire and are deleted. # # It is ok to change the compression value (from one non-zero value to # another non-zero value) after dumps are already done. Since BackupPC # matches pool files by comparing the uncompressed versions, it will still # correctly match new incoming files against existing pool files. The # new compression level will take effect only for new files that are # newly compressed and added to the pool. # # If compression was off and you are enabling compression for the first # time you can use the BackupPC_compressPool utility to compress the # pool. This avoids having the pool grow to accommodate both compressed # and uncompressed backups. See the documentation for more information. # # Note: compression needs the Compress::Zlib perl library. If the # Compress::Zlib library can't be found then $Conf{CompressLevel} is # forced to 0 (compression off). # $Conf{CompressLevel} =3D 3; # # Timeout in seconds when listening for the transport program's # (smbclient, tar etc) stdout. If no output is received during this # time, then it is assumed that something has wedged during a backup, # and the backup is terminated. # # Note that stdout buffering combined with huge files being backed up # could cause longish delays in the output from smbclient that # BackupPC_dump sees, so in rare cases you might want to increase # this value. # # Despite the name, this parameter sets the timeout for all transport # methods (tar, smb etc). # #$Conf{ClientTimeout} =3D 72000; $Conf{ClientTimeout} =3D 1209600; # # Maximum number of log files we keep around in each PC's directory # (ie: pc/$host). These files are aged monthly. A setting of 12 # means there will be at most the files LOG, LOG.0, LOG.1, ... LOG.11 # in the pc/$host directory (ie: about a years worth). (Except this # month's LOG, these files will have a .z extension if compression # is on). # # If you decrease this number after BackupPC has been running for a # while you will have to manually remove the older log files. # $Conf{MaxOldPerPCLogFiles} =3D 12; # # Optional commands to run before and after dumps and restores, # and also before and after each share of a dump. # # Stdout from these commands will be written to the Xfer (or Restore) # log file. One example of using these commands would be to # shut down and restart a database server, dump a database # to files for backup, or doing a snapshot of a share prior # to a backup. Example: # # $Conf{DumpPreUserCmd} =3D '$sshPath -q -x -l root $host /usr/bin/dumpM= ysql'; # # The following variable substitutions are made at run time for # $Conf{DumpPreUserCmd}, $Conf{DumpPostUserCmd}, $Conf{DumpPreShareCmd} # and $Conf{DumpPostShareCmd}: # # $type type of dump (incr or full) # $xferOK 1 if the dump succeeded, 0 if it didn't # $client client name being backed up # $host host name (could be different from client name if # $Conf{ClientNameAlias} is set) # $hostIP IP address of host # $user user name from the hosts file # $moreUsers list of additional users from the hosts file # $share the first share name (or current share for # $Conf{DumpPreShareCmd} and $Conf{DumpPostShareCmd}= ) # $shares list of all the share names # $XferMethod value of $Conf{XferMethod} (eg: tar, rsync, smb) # $sshPath value of $Conf{SshPath}, # $cmdType set to DumpPreUserCmd or DumpPostUserCmd # # The following variable substitutions are made at run time for # $Conf{RestorePreUserCmd} and $Conf{RestorePostUserCmd}: # # $client client name being backed up # $xferOK 1 if the restore succeeded, 0 if it didn't # $host host name (could be different from client name if # $Conf{ClientNameAlias} is set) # $hostIP IP address of host # $user user name from the hosts file # $moreUsers list of additional users from the hosts file # $share the first share name # $XferMethod value of $Conf{XferMethod} (eg: tar, rsync, smb) # $sshPath value of $Conf{SshPath}, # $type set to "restore" # $bkupSrcHost host name of the restore source # $bkupSrcShare share name of the restore source # $bkupSrcNum backup number of the restore source # $pathHdrSrc common starting path of restore source # $pathHdrDest common starting path of destination # $fileList list of files being restored # $cmdType set to RestorePreUserCmd or RestorePostUserCmd # # The following variable substitutions are made at run time for # $Conf{ArchivePreUserCmd} and $Conf{ArchivePostUserCmd}: # # $client client name being backed up # $xferOK 1 if the archive succeeded, 0 if it didn't # $host Name of the archive host # $user user name from the hosts file # $share the first share name # $XferMethod value of $Conf{XferMethod} (eg: tar, rsync, smb) # $HostList list of hosts being archived # $BackupList list of backup numbers for the hosts being archived # $archiveloc location where the archive is sent to # $parfile amount of parity data being generated (percentage) # $compression compression program being used (eg: cat, gzip, bzip2= ) # $compext extension used for compression type (eg: raw, gz, bz= 2) # $splitsize size of the files that the archive creates # $sshPath value of $Conf{SshPath}, # $type set to "archive" # $cmdType set to ArchivePreUserCmd or ArchivePostUserCmd # # Note: all Cmds are executed directly without a shell, so the prog name # needs to be a full path and you can't include shell syntax like # redirection and pipes; put that in a script if you need it. # $Conf{DumpPreUserCmd} =3D undef; $Conf{DumpPostUserCmd} =3D '/var/lib/backuppc/backuppc_notification.sh $xfe= rOK $host $type $client $hostIP $share $XferMethod $sshPath $cmdType'; $Conf{DumpPreShareCmd} =3D undef; $Conf{DumpPostShareCmd} =3D undef; $Conf{RestorePreUserCmd} =3D undef; $Conf{RestorePostUserCmd} =3D undef; $Conf{ArchivePreUserCmd} =3D undef; $Conf{ArchivePostUserCmd} =3D undef; # # Whether the exit status of each PreUserCmd and # PostUserCmd is checked. # # If set and the Dump/Restore/Archive Pre/Post UserCmd # returns a non-zero exit status then the dump/restore/archive # is aborted. To maintain backward compatibility (where # the exit status in early versions was always ignored), # this flag defaults to 0. # # If this flag is set and the Dump/Restore/Archive PreUserCmd # fails then the matching Dump/Restore/Archive PostUserCmd is # not executed. If DumpPreShareCmd returns a non-exit status, # then DumpPostShareCmd is not executed, but the DumpPostUserCmd # is still run (since DumpPreUserCmd must have previously # succeeded). # # An example of a DumpPreUserCmd that might fail is a script # that snapshots or dumps a database which fails because # of some database error. # $Conf{UserCmdCheckStatus} =3D '0'; # # Override the client's host name. This allows multiple clients # to all refer to the same physical host. This should only be # set in the per-PC config file and is only used by BackupPC at # the last moment prior to generating the command used to backup # that machine (ie: the value of $Conf{ClientNameAlias} is invisible # everywhere else in BackupPC). The setting can be a host name or # IP address, eg: # # $Conf{ClientNameAlias} =3D 'realHostName'; # $Conf{ClientNameAlias} =3D '192.1.1.15'; # # will cause the relevant smb/tar/rsync backup/restore commands to be # directed to realHostName, not the client name. # # Note: this setting doesn't work for hosts with DHCP set to 1. # $Conf{ClientNameAlias} =3D undef; ########################################################################### # Email reminders, status and messages # (can be overridden in the per-PC config.pl) ########################################################################### # # Full path to the sendmail command. Security caution: normal users # should not allowed to write to this file or directory. # $Conf{SendmailPath} =3D '/usr/sbin/sendmail'; # # Minimum period between consecutive emails to a single user. # This tries to keep annoying email to users to a reasonable # level. Email checks are done nightly, so this number is effectively # rounded up (ie: 2.5 means a user will never receive email more # than once every 3 days). # $Conf{EMailNotifyMinDays} =3D 1; # # Name to use as the "from" name for email. Depending upon your mail # handler this is either a plain name (eg: "admin") or a fully-qualified # name (eg: "[email protected]"). # $Conf{EMailFromUserName} =3D 'backuppc01'; # # Destination address to an administrative user who will receive a # nightly email with warnings and errors. If there are no warnings # or errors then no email will be sent. Depending upon your mail # handler this is either a plain name (eg: "admin") or a fully-qualified # name (eg: "[email protected]"). # $Conf{EMailAdminUserName} =3D ''; # # Destination domain name for email sent to users. By default # this is empty, meaning email is sent to plain, unqualified # addresses. Otherwise, set it to the destintation domain, eg: # # $Cong{EMailUserDestDomain} =3D '@mydomain.com'; # # With this setting user email will be set to '[email protected]'. # $Conf{EMailUserDestDomain} =3D '[email protected]'; # # This subject and message is sent to a user if their PC has never been # backed up. # # These values are language-dependent. The default versions can be # found in the language file (eg: lib/BackupPC/Lang/en.pm). If you # need to change the message, copy it here and edit it, eg: # # $Conf{EMailNoBackupEverMesg} =3D <<'EOF'; # To: $user$domain # cc: # Subject: $subj # # Dear $userName, # # This is a site-specific email message. # EOF # $Conf{EMailNoBackupEverSubj} =3D undef; $Conf{EMailNoBackupEverMesg} =3D undef; # # How old the most recent backup has to be before notifying user. # When there have been no backups in this number of days the user # is sent an email. # $Conf{EMailNotifyOldBackupDays} =3D 0; # # This subject and message is sent to a user if their PC has not recently # been backed up (ie: more than $Conf{EMailNotifyOldBackupDays} days ago). # # These values are language-dependent. The default versions can be # found in the language file (eg: lib/BackupPC/Lang/en.pm). If you # need to change the message, copy it here and edit it, eg: # # $Conf{EMailNoBackupRecentMesg} =3D <<'EOF'; # To: $user$domain # cc: # Subject: $subj # # Dear $userName, # # This is a site-specific email message. # EOF # $Conf{EMailNoBackupRecentSubj} =3D undef; $Conf{EMailNoBackupRecentMesg} =3D undef; # # How old the most recent backup of Outlook files has to be before # notifying user. # $Conf{EMailNotifyOldOutlookDays} =3D 0; # # This subject and message is sent to a user if their Outlook files have # not recently been backed up (ie: more than $Conf{EMailNotifyOldOutlookDay= s} # days ago). # # These values are language-dependent. The default versions can be # found in the language file (eg: lib/BackupPC/Lang/en.pm). If you # need to change the message, copy it here and edit it, eg: # # $Conf{EMailOutlookBackupMesg} =3D <<'EOF'; # To: $user$domain # cc: # Subject: $subj # # Dear $userName, # # This is a site-specific email message. # EOF # $Conf{EMailOutlookBackupSubj} =3D undef; $Conf{EMailOutlookBackupMesg} =3D undef; # # Additional email headers. This sets to charset to # utf8. # $Conf{EMailHeaders} =3D 'MIME-Version: 1.0 Content-Type: text/plain; charset=3D"utf-8" '; ########################################################################### # CGI user interface configuration settings # (can be overridden in the per-PC config.pl) ########################################################################### # # Normal users can only access information specific to their host. # They can start/stop/browse/restore backups. # # Administrative users have full access to all hosts, plus overall # status and log information. # # The administrative users are the union of the unix/linux group # $Conf{CgiAdminUserGroup} and the manual list of users, separated # by spaces, in $Conf{CgiAdminUsers}. If you don't want a group or # manual list of users set the corresponding configuration setting # to undef or an empty string. # # If you want every user to have admin privileges (careful!), set # $Conf{CgiAdminUsers} =3D '*'. # # Examples: # $Conf{CgiAdminUserGroup} =3D 'admin'; # $Conf{CgiAdminUsers} =3D 'craig celia'; # --> administrative users are the union of group admin, plus # craig and celia. # # $Conf{CgiAdminUserGroup} =3D ''; # $Conf{CgiAdminUsers} =3D 'craig celia'; # --> administrative users are only craig and celia'. # $Conf{CgiAdminUserGroup} =3D 'backuppc'; $Conf{CgiAdminUsers} =3D 'backuppc'; # # URL of the BackupPC_Admin CGI script. Used for email messages. # $Conf{CgiURL} =3D 'http://backuppc01/backuppc/index.cgi'; # # Language to use. See lib/BackupPC/Lang for the list of supported # languages, which include English (en), French (fr), Spanish (es), # German (de), Italian (it), Dutch (nl), Polish (pl), Portuguese # Brazillian (pt_br) and Chinese (zh_CH). # # Currently the Language setting applies to the CGI interface and email # messages sent to users. Log files and other text are still in English. # $Conf{Language} =3D 'en'; # # User names that are rendered by the CGI interface can be turned # into links into their home page or other information about the # user. To set this up you need to create two sprintf() strings, # that each contain a single '%s' that will be replaced by the user # name. The default is a mailto: link. # # $Conf{CgiUserHomePageCheck} should be an absolute file path that # is used to check (via "-f") that the user has a valid home page. # Set this to undef or an empty string to turn off this check. # # $Conf{CgiUserUrlCreate} should be a full URL that points to the # user's home page. Set this to undef or an empty string to turn # off generation of URLs for user names. # # Example: # $Conf{CgiUserHomePageCheck} =3D '/var/www/html/users/%s.html'; # $Conf{CgiUserUrlCreate} =3D 'http://myhost/users/%s.html'; # --> if /var/www/html/users/craig.html exists, then 'craig' will # be rendered as a link to http://myhost/users/craig.html. # $Conf{CgiUserHomePageCheck} =3D ''; $Conf{CgiUserUrlCreate} =3D 'mailto:%s'; # # Date display format for CGI interface. A value of 1 uses US-style # dates (MM/DD), a value of 2 uses full YYYY-MM-DD format, and zero # for international dates (DD/MM). # $Conf{CgiDateFormatMMDD} =3D 1; # # If set, the complete list of hosts appears in the left navigation # bar pull-down for administrators. Otherwise, just the hosts for which # the user is listed in the host file (as either the user or in moreUsers) # are displayed. # $Conf{CgiNavBarAdminAllHosts} =3D '1'; # # Enable/disable the search box in the navigation bar. # $Conf{CgiSearchBoxEnable} =3D '1'; # # Additional navigation bar links. These appear for both regular users # and administrators. This is a list of hashes giving the link (URL) # and the text (name) for the link. Specifying lname instead of name # uses the language specific string (ie: $Lang->{lname}) instead of # just literally displaying name. # $Conf{CgiNavBarLinks} =3D [ { 'lname' =3D> 'Documentation', 'name' =3D> undef, 'link' =3D> '?action=3Dview&type=3Ddocs' }, { 'lname' =3D> undef, 'name' =3D> 'Wiki', 'link' =3D> 'http://backuppc.wiki.sourceforge.net' }, { 'link' =3D> 'http://backuppc.sourceforge.net', 'name' =3D> 'SourceForge', 'lname' =3D> undef } ]; # # Hilight colors based on status that are used in the PC summary page. # $Conf{CgiStatusHilightColor} =3D { 'Disabled_AllBackupsDisabled' =3D> '#d1d1d1', 'Reason_backup_canceled_by_user' =3D> '#ff9900', 'Status_backup_in_progress' =3D> '#66cc99', 'Reason_no_ping' =3D> '#ffff99', 'Reason_backup_failed' =3D> '#ffcccc', 'Reason_backup_done' =3D> '#ccffcc', 'Disabled_OnlyManualBackups' =3D> '#d1d1d1' }; # # Additional CGI header text. # $Conf{CgiHeaders} =3D '<meta http-equiv=3D"pragma" content=3D"no-cache">'; # # Directory where images are stored. This directory should be below # Apache's DocumentRoot. This value isn't used by BackupPC but is # used by configure.pl when you upgrade BackupPC. # # Example: # $Conf{CgiImageDir} =3D '/var/www/htdocs/BackupPC'; # $Conf{CgiImageDir} =3D '/usr/share/backuppc/image'; # # Additional mappings of file name extenions to Content-Type for # individual file restore. See $Ext2ContentType in BackupPC_Admin # for the default setting. You can add additional settings here, # or override any default settings. Example: # # $Conf{CgiExt2ContentType} =3D { # 'pl' =3D> 'text/plain', # }; # $Conf{CgiExt2ContentType} =3D {}; # # URL (without the leading http://host) for BackupPC's image directory. # The CGI script uses this value to serve up image files. # # Example: # $Conf{CgiImageDirURL} =3D '/BackupPC'; # $Conf{CgiImageDirURL} =3D '/backuppc/image'; # # CSS stylesheet "skin" for the CGI interface. It is stored # in the $Conf{CgiImageDir} directory and accessed via the # $Conf{CgiImageDirURL} URL. # # For BackupPC v3.x several color, layout and font changes were made. # The previous v2.x version is available as BackupPC_stnd_orig.css, so # if you prefer the old skin, change this to BackupPC_stnd_orig.css. # $Conf{CgiCSSFile} =3D 'BackupPC_stnd.css'; # # Whether the user is allowed to edit their per-PC config. # $Conf{CgiUserConfigEditEnable} =3D '1'; # # Which per-host config variables a non-admin user is allowed # to edit. Admin users can edit all per-host config variables, # even if disabled in this list. # # SECURITY WARNING: Do not let users edit any of the Cmd # config variables! That's because a user could set a # Cmd to a shell script of their choice and it will be # run as the BackupPC user. That script could do all # sorts of bad things. # $Conf{CgiUserConfigEdit} =3D { 'EMailFromUserName' =3D> '1', 'ArchiveInfoKeepCnt' =3D> '1', 'FtpTimeout' =3D> '1', 'TarClientCmd' =3D> '0', 'SmbSharePasswd' =3D> '1', 'FtpShareName' =3D> '1', 'FtpPort' =3D> '1', 'RestorePreUserCmd' =3D> '0', 'EMailNoBackupEverSubj' =3D> '1', 'FullPeriod' =3D> '1', 'FixedIPNetBiosNameCheck' =3D> '1', 'TarClientPath' =3D> '0', 'EMailOutlookBackupMesg' =3D> '1', 'SmbShareName' =3D> '1', 'ClientNameAlias' =3D> '1', 'DumpPreShareCmd' =3D> '0', 'ArchivePar' =3D> '1', 'BlackoutGoodCnt' =3D> '1', 'TarClientRestoreCmd' =3D> '0', 'EMailNoBackupRecentMesg' =3D> '1', 'FullAgeMax' =3D> '1', 'ArchivePostUserCmd' =3D> '0', 'ClientCharset' =3D> '1', 'ArchiveSplit' =3D> '1', 'BlackoutBadPingLimit' =3D> '1', 'FtpBlockSize' =3D> '1', 'UserCmdCheckStatus' =3D> '0', 'RsyncArgs' =3D> '1', 'SmbClientFullCmd' =3D> '0', 'ClientCharsetLegacy' =3D> '1', 'EMailNoBackupRecentSubj' =3D> '1', 'NmbLookupFindHostCmd' =3D> '0', 'ArchiveComp' =3D> '1', 'TarShareName' =3D> '1', 'RsyncdAuthRequired' =3D> '1', 'RsyncCsumCacheVerifyProb' =3D> '1', 'FtpRestoreEnabled' =3D> '1', 'TarIncrArgs' =3D> '1', 'RsyncdUserName' =3D> '1', 'SmbClientRestoreCmd' =3D> '0', 'ArchivePreUserCmd' =3D> '0', 'RsyncClientPath' =3D> '0', 'FtpFollowSymlinks' =3D> '1', 'EMailHeaders' =3D> '1', 'BackupFilesExclude' =3D> '1', 'RsyncdClientPort' =3D> '1', 'ArchiveDest' =3D> '1', 'PartialAgeMax' =3D> '1', 'IncrKeepCntMin' =3D> '1', 'IncrAgeMax' =3D> '1', 'IncrPeriod' =3D> '1', 'DumpPreUserCmd' =3D> '0', 'RsyncdPasswd' =3D> '1', 'EMailNotifyMinDays' =3D> '1', 'XferMethod' =3D> '1', 'BackupFilesOnly' =3D> '1', 'FullKeepCntMin' =3D> '1', 'BackupZeroFilesIsFatal' =3D> '1', 'RsyncArgsExtra' =3D> '1', 'IncrKeepCnt' =3D> '1', 'RsyncShareName' =3D> '1', 'FtpUserName' =3D> '1', 'XferLogLevel' =3D> '1', 'SmbShareUserName' =3D> '1', 'PingMaxMsec' =3D> '1', 'TarFullArgs' =3D> '1', 'IncrLevels' =3D> '1', 'RestorePostUserCmd' =3D> '0', 'MaxOldPerPCLogFiles' =3D> '1', 'NmbLookupCmd' =3D> '0', 'RestoreInfoKeepCnt' =3D> '1', 'SmbClientIncrCmd' =3D> '0', 'RsyncClientRestoreCmd' =3D> '0', 'DumpPostUserCmd' =3D> '0', 'EMailNoBackupEverMesg' =3D> '1', 'CompressLevel' =3D> '1', 'IncrFill' =3D> '1', 'EMailAdminUserName' =3D> '1', 'DumpPostShareCmd' =3D> '0', 'PingCmd' =3D> '0', 'EMailOutlookBackupSubj' =3D> '1', 'BlackoutPeriods' =3D> '1', 'EMailNotifyOldBackupDays' =3D> '1', 'FullKeepCnt' =3D> '1', 'EMailNotifyOldOutlookDays' =3D> '1', 'ArchiveClientCmd' =3D> '0', 'EMailUserDestDomain' =3D> '1', 'ClientTimeout' =3D> '1', 'RsyncRestoreArgs' =3D> '1', 'BackupsDisable' =3D> '1', 'RsyncClientCmd' =3D> '0', 'FtpPasswd' =3D> '1' }; ________________________________ From: Holger Parplies <[email protected]> Sent: 09 January 2018 13:01 To: Marc Gilliatt Cc: [email protected] Subject: Re: [BackupPC-devel] SMB Windows share not backing up - NT_STATUS_= ACCESS_DENIED listing \System Volume Information\SRM\* Hi, Marc Gilliatt wrote on 2018-01-09 12:00:55 +0000 [[BackupPC-devel] SMB Wind= ows share not backing up - NT_STATUS_ACCESS_DENIED listing \System Volume I= nformation\SRM\*]: > [...] > Any suggestions/ideas would be truly appreciative. try reading the responses you already got. It's all in there. Repeating it likely won't help. If you don't understand something in the responses, ask specifically. I can't talk for others, but I don't feel like explaining something in yet a different way if I don't know if it's the specific thing you didn't understand or not, and when I don't know what the problem in understanding it was. I'll try just the same: * This is the wrong mailing list. [email protected] is the correct one. * You *cannot* use includes and excludes with smb at the same time. Your excludes will simply be ignored. * We need your configuration settings if you want us to tell you what is wrong with them, not some vague descriptions of about what they might be like. Saying what you're *intending* to do won't reveal the syntax error. Hope that helps. Regards, Holger --_000_HE1P194MB01394AFD7F6C52FC11BDE884BB100HE1P194MB0139EURP_ Content-Type: text/html; charset="us-ascii" Content-Transfer-Encoding: quoted-printable <html> <head> <meta http-equiv=3D"Content-Type" content=3D"text/html; charset=3Dus-ascii"= > <style type=3D"text/css" style=3D"display:none;"> P {margin-top:0;margin-bo= ttom:0;} </style> </head> <body dir=3D"ltr"> <div style=3D"font-family: Calibri, Helvetica, sans-serif; font-size: 12pt;= color: rgb(0, 0, 0); background-color: rgba(0, 0, 0, 0);"> Ive posted to the correct mailing list.</div> <div style=3D"font-family: Calibri, Helvetica, sans-serif; font-size: 12pt;= color: rgb(0, 0, 0); background-color: rgba(0, 0, 0, 0);"> <br> </div> <div style=3D"font-family: Calibri, Helvetica, sans-serif; font-size: 12pt;= color: rgb(0, 0, 0); background-color: rgba(0, 0, 0, 0);"> Here are the contents to my config.pl</div> <div style=3D"font-family: Calibri, Helvetica, sans-serif; font-size: 12pt;= color: rgb(0, 0, 0); background-color: rgba(0, 0, 0, 0);"> <br> </div> <div style=3D"font-family: Calibri, Helvetica, sans-serif; font-size: 12pt;= color: rgb(0, 0, 0); background-color: rgba(0, 0, 0, 0);"> <p class=3D"MsoNormal">#=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D -*-perl-*-<o:p></= o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal"># Configuration file for BackupPC.<o:p></o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal"># DESCRIPTION<o:p></o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal"># This is the main configuration file fo= r BackupPC.<o:p></o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal"># This file must be valid perl source, s= o make sure the punctuation,<o:p></o:p></p> <p class=3D"MsoNormal"># quotes, and other syntax are valid.<o:= p></o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal"># This file is read by BackupPC at start= up, when a HUP (-1) signal<o:p></o:p></p> <p class=3D"MsoNormal"># is sent to BackupPC and also at each w= akeup time whenever the<o:p></o:p></p> <p class=3D"MsoNormal"># modification time of this file changes= .<o:p></o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal"># The configuration parameters are divid= ed into four general groups.<o:p></o:p></p> <p class=3D"MsoNormal"># The first group (general server config= uration) provides general<o:p></o:p></p> <p class=3D"MsoNormal"># configuration for BackupPC. The = next two groups describe what<o:p></o:p></p> <p class=3D"MsoNormal"># to backup, when to do it, and how long= to keep it. The fourth<o:p></o:p></p> <p class=3D"MsoNormal"># group are settings for the CGI http in= terface.<o:p></o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal"># Configuration settings can also be spe= cified on a per-PC basis.<o:p></o:p></p> <p class=3D"MsoNormal"># Simply put the relevant settings in a = config.pl file in the<o:p></o:p></p> <p class=3D"MsoNormal"># PC's backup directory (ie: in __TOPDIR= __/pc/hostName).<o:p></o:p></p> <p class=3D"MsoNormal"># All configuration settings in the seco= nd, third and fourth<o:p></o:p></p> <p class=3D"MsoNormal"># groups can be overridden by the per-PC= config.pl file.<o:p></o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal"># AUTHOR<o:p></o:p></p> <p class=3D"MsoNormal"># Craig Barratt <cbarratt@users= .sourceforge.net><o:p></o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal"># COPYRIGHT<o:p></o:p></p> <p class=3D"MsoNormal"># Copyright (C) 2001-2015 Craig Ba= rratt<o:p></o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal"># See http://backuppc.sourceforge.net.<o= :p></o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal">#=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D<o:p></o:p></p> <p class=3D"MsoNormal"><o:p> </o:p></p> <p class=3D"MsoNormal">####################################################= #######################<o:p></o:p></p> <p class=3D"MsoNormal"># General server configuration<o:p></o:p></p> <p class=3D"MsoNormal">####################################################= #######################<o:p></o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal"># Host name on which the BackupPC server is running.= <o:p></o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal">$ENV{'PATH'} =3D '/bin:/usr/bin';<o:p></o:p></p> <p class=3D"MsoNormal">delete @ENV{'IFS', 'CDPATH', 'ENV', 'BASH_ENV'};<o:p= ></o:p></p> <p class=3D"MsoNormal">$Conf{ServerHost} =3D 'backuppc01';<o:p></o:p></p> <p class=3D"MsoNormal">chomp($Conf{ServerHost});<o:p></o:p></p> <p class=3D"MsoNormal"><o:p> </o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal"># TCP port number on which the BackupPC server liste= ns for and accepts<o:p></o:p></p> <p class=3D"MsoNormal"># connections. Normally this should be disable= d (set to -1). The TCP<o:p></o:p></p> <p class=3D"MsoNormal"># port is only needed if apache runs on a different = machine from BackupPC.<o:p></o:p></p> <p class=3D"MsoNormal"># In that case, set this to any spare port number ov= er 1024 (eg: 2359).<o:p></o:p></p> <p class=3D"MsoNormal"># If you enable the TCP port, make sure you set $Con= f{ServerMesgSecret}<o:p></o:p></p> <p class=3D"MsoNormal"># too!<o:p></o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal">$Conf{ServerPort} =3D -1;<o:p></o:p></p> <p class=3D"MsoNormal"><o:p> </o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal"># Shared secret to make the TCP port secure. S= et this to a hard to guess<o:p></o:p></p> <p class=3D"MsoNormal"># string if you enable the TCP port (ie: $Conf{Serve= rPort} > 0).<o:p></o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal"># To avoid possible attacks via the TCP socket inter= face, every client<o:p></o:p></p> <p class=3D"MsoNormal"># message is protected by an MD5 digest. The MD5 dig= est includes four<o:p></o:p></p> <p class=3D"MsoNormal"># items:<o:p></o:p></p> <p class=3D"MsoNormal"># - a seed that is sent to the client wh= en the connection opens<o:p></o:p></p> <p class=3D"MsoNormal"># - a sequence number that increments fo= r each message<o:p></o:p></p> <p class=3D"MsoNormal"># - a shared secret that is stored in $C= onf{ServerMesgSecret}<o:p></o:p></p> <p class=3D"MsoNormal"># - the message itself.<o:p></o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal"># The message is sent in plain text preceded by the = MD5 digest. A<o:p></o:p></p> <p class=3D"MsoNormal"># snooper can see the plain-text seed sent by Backup= PC and plain-text<o:p></o:p></p> <p class=3D"MsoNormal"># message from the client, but cannot construct a va= lid MD5 digest since<o:p></o:p></p> <p class=3D"MsoNormal"># the secret $Conf{ServerMesgSecret} is unknown.&nbs= p; A replay attack is<o:p></o:p></p> <p class=3D"MsoNormal"># not possible since the seed changes on a per-conne= ction and<o:p></o:p></p> <p class=3D"MsoNormal"># per-message basis.<o:p></o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal">$Conf{ServerMesgSecret} =3D '';<o:p></o:p></p> <p class=3D"MsoNormal"><o:p> </o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal"># PATH setting for BackupPC. An explicit value= is necessary<o:p></o:p></p> <p class=3D"MsoNormal"># for taint mode. Value shouldn't matter too m= uch since<o:p></o:p></p> <p class=3D"MsoNormal"># all execs use explicit paths. However, taint= mode in perl<o:p></o:p></p> <p class=3D"MsoNormal"># will complain if this directory is world writable.= <o:p></o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal">$Conf{MyPath} =3D '/bin';<o:p></o:p></p> <p class=3D"MsoNormal"><o:p> </o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal"># Permission mask for directories and files created = by BackupPC.<o:p></o:p></p> <p class=3D"MsoNormal"># Default value prevents any access from group other= , and prevents<o:p></o:p></p> <p class=3D"MsoNormal"># group write.<o:p></o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal">$Conf{UmaskMode} =3D 23;<o:p></o:p></p> <p class=3D"MsoNormal"><o:p> </o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal"># Times at which we wake up, check all the PCs, and = schedule necessary<o:p></o:p></p> <p class=3D"MsoNormal"># backups. Times are measured in hours since m= idnight. Can be<o:p></o:p></p> <p class=3D"MsoNormal"># fractional if necessary (eg: 4.25 means 4:15am).<o= :p></o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal"># If the hosts you are backing up are always connect= ed to the network<o:p></o:p></p> <p class=3D"MsoNormal"># you might have only one or two wakeups each night.= This will keep<o:p></o:p></p> <p class=3D"MsoNormal"># the backup activity after hours. On the othe= r hand, if you are backing<o:p></o:p></p> <p class=3D"MsoNormal"># up laptops that are only intermittently connected = to the network you<o:p></o:p></p> <p class=3D"MsoNormal"># will want to have frequent wakeups (eg: hourly) to= maximize the chance<o:p></o:p></p> <p class=3D"MsoNormal"># that each laptop is backed up.<o:p></o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal"># Examples:<o:p></o:p></p> <p class=3D"MsoNormal"># $Conf{WakeupSchedule} =3D = [22.5]; # once per day at 1= 0:30 pm.<o:p></o:p></p> <p class=3D"MsoNormal"># $Conf{WakeupSchedule} =3D = [2,4,6,8,10,12,14,16,18,20,22]; # every 2 hours<o:p></o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal"># The default value is every hour except midnight.<o= :p></o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal"># The first entry of $Conf{WakeupSchedule} is when B= ackupPC_nightly is run.<o:p></o:p></p> <p class=3D"MsoNormal"># You might want to re-arrange the entries in $Conf{= WakeupSchedule}<o:p></o:p></p> <p class=3D"MsoNormal"># (they don't have to be ascending) so that the firs= t entry is when<o:p></o:p></p> <p class=3D"MsoNormal"># you want BackupPC_nightly to run (eg: when you don= 't expect a lot<o:p></o:p></p> <p class=3D"MsoNormal"># of regular backups to run).<o:p></o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal">$Conf{WakeupSchedule} =3D [<o:p></o:p></p> <p class=3D"MsoNormal"> 1,<o:p></o:p></p> <p class=3D"MsoNormal"> 2,<o:p></o:p></p> <p class=3D"MsoNormal"> 3,<o:p></o:p></p> <p class=3D"MsoNormal"> 4,<o:p></o:p></p> <p class=3D"MsoNormal"> 5,<o:p></o:p></p> <p class=3D"MsoNormal"> 6,<o:p></o:p></p> <p class=3D"MsoNormal"> 7,<o:p></o:p></p> <p class=3D"MsoNormal"> 8,<o:p></o:p></p> <p class=3D"MsoNormal"> 9,<o:p></o:p></p> <p class=3D"MsoNormal"> 10,<o:p></o:p></p> <p class=3D"MsoNormal"> 11,<o:p></o:p></p> <p class=3D"MsoNormal"> 12,<o:p></o:p></p> <p class=3D"MsoNormal"> 13,<o:p></o:p></p> <p class=3D"MsoNormal"> 14,<o:p></o:p></p> <p class=3D"MsoNormal"> 15,<o:p></o:p></p> <p class=3D"MsoNormal"> 16,<o:p></o:p></p> <p class=3D"MsoNormal"> 17,<o:p></o:p></p> <p class=3D"MsoNormal"> 18,<o:p></o:p></p> <p class=3D"MsoNormal"> 19,<o:p></o:p></p> <p class=3D"MsoNormal"> 20,<o:p></o:p></p> <p class=3D"MsoNormal"> 21,<o:p></o:p></p> <p class=3D"MsoNormal"> 22,<o:p></o:p></p> <p class=3D"MsoNormal"> 23<o:p></o:p></p> <p class=3D"MsoNormal">];<o:p></o:p></p> <p class=3D"MsoNormal"><o:p> </o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal"># Maximum number of simultaneous backups to run.&nbs= p; If there<o:p></o:p></p> <p class=3D"MsoNormal"># are no user backup requests then this is the maxim= um number<o:p></o:p></p> <p class=3D"MsoNormal"># of simultaneous backups.<o:p></o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal">$Conf{MaxBackups} =3D 5;<o:p></o:p></p> <p class=3D"MsoNormal"><o:p> </o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal"># Additional number of simultaneous backups that use= rs can run.<o:p></o:p></p> <p class=3D"MsoNormal"># As many as $Conf{MaxBackups} + $Conf{MaxUserBa= ckups} requests can<o:p></o:p></p> <p class=3D"MsoNormal"># run at the same time.<o:p></o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal">$Conf{MaxUserBackups} =3D 5;<o:p></o:p></p> <p class=3D"MsoNormal"><o:p> </o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal"># Maximum number of pending link commands. New backu= ps will only be<o:p></o:p></p> <p class=3D"MsoNormal"># started if there are no more than $Conf{MaxPending= Cmds} plus<o:p></o:p></p> <p class=3D"MsoNormal"># $Conf{MaxBackups} number of pending link commands,= plus running jobs.<o:p></o:p></p> <p class=3D"MsoNormal"># This limit is to make sure BackupPC doesn't fall t= oo far behind in<o:p></o:p></p> <p class=3D"MsoNormal"># running BackupPC_link commands.<o:p></o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal">$Conf{MaxPendingCmds} =3D 15;<o:p></o:p></p> <p class=3D"MsoNormal"><o:p> </o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal"># Nice level at which CmdQueue commands (eg: BackupP= C_link and<o:p></o:p></p> <p class=3D"MsoNormal"># BackupPC_nightly) are run at.<o:p></o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal">$Conf{CmdQueueNice} =3D 10;<o:p></o:p></p> <p class=3D"MsoNormal"><o:p> </o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal"># How many BackupPC_nightly processes to run in para= llel.<o:p></o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal"># Each night, at the first wakeup listed in $Conf{Wa= keupSchedule},<o:p></o:p></p> <p class=3D"MsoNormal"># BackupPC_nightly is run. Its job is to remov= e unneeded files<o:p></o:p></p> <p class=3D"MsoNormal"># in the pool, ie: files that only have one link.&nb= sp; To avoid race<o:p></o:p></p> <p class=3D"MsoNormal"># conditions, BackupPC_nightly and BackupPC_link can= not run at<o:p></o:p></p> <p class=3D"MsoNormal"># the same time. Starting in v3.0.0, BackupPC_= nightly can run<o:p></o:p></p> <p class=3D"MsoNormal"># concurrently with backups (BackupPC_dump).<o:p></o= :p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal"># So to reduce the elapsed time, you might want to i= ncrease this<o:p></o:p></p> <p class=3D"MsoNormal"># setting to run several BackupPC_nightly processes = in parallel<o:p></o:p></p> <p class=3D"MsoNormal"># (eg: 4, or even 8).<o:p></o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal">$Conf{MaxBackupPCNightlyJobs} =3D 5;<o:p></o:p></p> <p class=3D"MsoNormal"><o:p> </o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal"># How many days (runs) it takes BackupPC_nightly to = traverse the<o:p></o:p></p> <p class=3D"MsoNormal"># entire pool. Normally this is 1, which means= every night it runs,<o:p></o:p></p> <p class=3D"MsoNormal"># it does traverse the entire pool removing unused p= ool files.<o:p></o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal"># Other valid values are 2, 4, 8, 16. This cau= ses BackupPC_nightly to<o:p></o:p></p> <p class=3D"MsoNormal"># traverse 1/2, 1/4, 1/8 or 1/16th of the pool each = night, meaning it<o:p></o:p></p> <p class=3D"MsoNormal"># takes 2, 4, 8 or 16 days to completely traverse th= e pool. The<o:p></o:p></p> <p class=3D"MsoNormal"># advantage is that each night the running time of B= ackupPC_nightly<o:p></o:p></p> <p class=3D"MsoNormal"># is reduced roughly in proportion, since the total = job is split<o:p></o:p></p> <p class=3D"MsoNormal"># over multiple days. The disadvantage is that= unused pool files<o:p></o:p></p> <p class=3D"MsoNormal"># take longer to get deleted, which will slightly in= crease disk<o:p></o:p></p> <p class=3D"MsoNormal"># usage.<o:p></o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal"># Note that even when $Conf{BackupPCNightlyPeriod} &= gt; 1, BackupPC_nightly<o:p></o:p></p> <p class=3D"MsoNormal"># still runs every night. It just does less wo= rk each time it runs.<o:p></o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal"># Examples:<o:p></o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal"># $Conf{BackupPCNightlyPeriod} =3D= 1; # entire pool is checked every night<o:p></o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal"># $Conf{BackupPCNightlyPeriod} =3D= 2; # two days to complete pool check<o:p></o:p></p> <p class=3D"MsoNormal"># &nb= sp; = &nb= sp; # (different half each night)<o:p></o:p><= /p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal"># $Conf{BackupPCNightlyPeriod} =3D= 4; # four days to complete pool check<o:p></o:p></p> <p class=3D"MsoNormal"># &nb= sp; = &n= bsp; # (different quarter each night)<o:p></o:= p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal">$Conf{BackupPCNightlyPeriod} =3D 1;<o:p></o:p></p> <p class=3D"MsoNormal"><o:p> </o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal"># Maximum number of log files we keep around in log = directory.<o:p></o:p></p> <p class=3D"MsoNormal"># These files are aged nightly. A setting of 1= 4 means the log<o:p></o:p></p> <p class=3D"MsoNormal"># directory will contain about 2 weeks of old log fi= les, in<o:p></o:p></p> <p class=3D"MsoNormal"># particular at most the files LOG, LOG.0, LOG.1, ..= . LOG.13<o:p></o:p></p> <p class=3D"MsoNormal"># (except today's LOG, these files will have a .z ex= tension if<o:p></o:p></p> <p class=3D"MsoNormal"># compression is on).<o:p></o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal"># If you decrease this number after BackupPC has bee= n running for a<o:p></o:p></p> <p class=3D"MsoNormal"># while you will have to manually remove the older l= og files.<o:p></o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal">$Conf{MaxOldLogFiles} =3D 14;<o:p></o:p></p> <p class=3D"MsoNormal"><o:p> </o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal"># Full path to the df command. Security cautio= n: normal users<o:p></o:p></p> <p class=3D"MsoNormal"># should not allowed to write to this file or direct= ory.<o:p></o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal">$Conf{DfPath} =3D '/bin/df';<o:p></o:p></p> <p class=3D"MsoNormal"><o:p> </o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal"># Command to run df. The following variables a= re substituted at run-time:<o:p></o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal"># $dfPath = path to df ($Conf{DfPath})<o:p></o:p></p> <p class=3D"MsoNormal"># $topDir = top-level BackupPC data directory<o:p></o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal"># Note: all Cmds are executed directly without a she= ll, so the prog name<o:p></o:p></p> <p class=3D"MsoNormal"># needs to be a full path and you can't include shel= l syntax like<o:p></o:p></p> <p class=3D"MsoNormal"># redirection and pipes; put that in a script if you= need it.<o:p></o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal">$Conf{DfCmd} =3D '$dfPath $topDir';<o:p></o:p></p> <p class=3D"MsoNormal"><o:p> </o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal"># Full path to various commands for archiving<o:p></= o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal">$Conf{SplitPath} =3D '/usr/bin/split';<o:p></o:p></p= > <p class=3D"MsoNormal">$Conf{ParPath} =3D undef;<o:p></o:p></p> <p class=3D"MsoNormal">$Conf{CatPath} =3D '/bin/cat';<o:p></o:p></p> <p class=3D"MsoNormal">$Conf{GzipPath} =3D '/bin/gzip';<o:p></o:p></p> <p class=3D"MsoNormal">$Conf{Bzip2Path} =3D '/bin/bzip2';<o:p></o:p></p> <p class=3D"MsoNormal"><o:p> </o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal"># Maximum threshold for disk utilization on the __TO= PDIR__ filesystem.<o:p></o:p></p> <p class=3D"MsoNormal"># If the output from $Conf{DfPath} reports a percent= age larger than<o:p></o:p></p> <p class=3D"MsoNormal"># this number then no new regularly scheduled backup= s will be run.<o:p></o:p></p> <p class=3D"MsoNormal"># However, user requested backups (which are usually= incremental and<o:p></o:p></p> <p class=3D"MsoNormal"># tend to be small) are still performed, independent= of disk usage.<o:p></o:p></p> <p class=3D"MsoNormal"># Also, currently running backups will not be termin= ated when the disk<o:p></o:p></p> <p class=3D"MsoNormal"># usage exceeds this number.<o:p></o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal">$Conf{DfMaxUsagePct} =3D 95;<o:p></o:p></p> <p class=3D"MsoNormal"><o:p> </o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal"># How long BackupPC_trashClean sleeps in seconds bet= ween each check<o:p></o:p></p> <p class=3D"MsoNormal"># of the trash directory. Once every 5 minutes= should be reasonable.<o:p></o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal">$Conf{TrashCleanSleepSec} =3D 300;<o:p></o:p></p> <p class=3D"MsoNormal"><o:p> </o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal"># List of DHCP address ranges we search looking for = PCs to backup.<o:p></o:p></p> <p class=3D"MsoNormal"># This is an array of hashes for each class C addres= s range.<o:p></o:p></p> <p class=3D"MsoNormal"># This is only needed if hosts in the conf/hosts fil= e have the<o:p></o:p></p> <p class=3D"MsoNormal"># dhcp flag set.<o:p></o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal"># Examples:<o:p></o:p></p> <p class=3D"MsoNormal"># # to specify 192.10.10.20 to 192= .10.10.250 as the DHCP address pool<o:p></o:p></p> <p class=3D"MsoNormal"># $Conf{DHCPAddressRanges} =3D [<o= :p></o:p></p> <p class=3D"MsoNormal"># {<o:p></= o:p></p> <p class=3D"MsoNormal"># &nb= sp; ipAddrBase =3D> '192.10.10',<o:p></o:p></p> <p class=3D"MsoNormal"># &nb= sp; first =3D> 20,<o:p></o:p></p> <p class=3D"MsoNormal"># &nb= sp; last =3D> 250,<o:p></o:p></p> <p class=3D"MsoNormal"># },<o:p><= /o:p></p> <p class=3D"MsoNormal"># ];<o:p></o:p></p> <p class=3D"MsoNormal"># # to specify two pools (192.10.1= 0.20-250 and 192.10.11.10-50)<o:p></o:p></p> <p class=3D"MsoNormal"># $Conf{DHCPAddressRanges} =3D [<o= :p></o:p></p> <p class=3D"MsoNormal"># {<o:p></= o:p></p> <p class=3D"MsoNormal"># &nb= sp; ipAddrBase =3D> '192.10.10',<o:p></o:p></p> <p class=3D"MsoNormal"># &nb= sp; first =3D> 20,<o:p></o:p></p> <p class=3D"MsoNormal"># &nb= sp; last =3D> 250,<o:p></o:p></p> <p class=3D"MsoNormal"># },<o:p><= /o:p></p> <p class=3D"MsoNormal"># {<o:p></= o:p></p> <p class=3D"MsoNormal"># &nb= sp; ipAddrBase =3D> '192.10.11',<o:p></o:p></p> <p class=3D"MsoNormal"># &nb= sp; first =3D> 10,<o:p></o:p></p> <p class=3D"MsoNormal"># &nb= sp; last =3D> 50,<o:p></o:p></p> <p class=3D"MsoNormal"># },<o:p><= /o:p></p> <p class=3D"MsoNormal"># ];<o:p></o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal">$Conf{DHCPAddressRanges} =3D [];<o:p></o:p></p> <p class=3D"MsoNormal"><o:p> </o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal"># The BackupPC user.<o:p></o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal">$Conf{BackupPCUser} =3D 'backuppc';<o:p></o:p></p> <p class=3D"MsoNormal"><o:p> </o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal"># Important installation directories:<o:p></o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal"># TopDir - where= all the backup data is stored<o:p></o:p></p> <p class=3D"MsoNormal"># ConfDir - where the = main config and hosts files resides<o:p></o:p></p> <p class=3D"MsoNormal"># LogDir - where= log files and other transient information<o:p></o:p></p> <p class=3D"MsoNormal"># InstallDir - where the bin, lib and do= c installation dirs reside.<o:p></o:p></p> <p class=3D"MsoNormal"># &nb= sp; Note: you cannot change this value = since all the<o:p></o:p></p> <p class=3D"MsoNormal"># &nb= sp; perl scripts include this path.&nbs= p; You must reinstall<o:p></o:p></p> <p class=3D"MsoNormal"># &nb= sp; with configure.pl to change Install= Dir.<o:p></o:p></p> <p class=3D"MsoNormal"># CgiDir - Apach= e CGI directory for BackupPC_Admin<o:p></o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal"># Note: it is STRONGLY recommended that you don't ch= ange the<o:p></o:p></p> <p class=3D"MsoNormal"># values here. These are set at installation t= ime and are here<o:p></o:p></p> <p class=3D"MsoNormal"># for reference and are used during upgrades.<o:p></= o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal"># Instead of changing TopDir here it is recommended = that you use<o:p></o:p></p> <p class=3D"MsoNormal"># a symbolic link to the new location, or mount the = new BackupPC<o:p></o:p></p> <p class=3D"MsoNormal"># store at the existing $Conf{TopDir} setting.<o:p><= /o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal">$Conf{TopDir} =3D '/var/lib/backuppc';<o:p></o:p></p= > <p class=3D"MsoNormal">$Conf{ConfDir} =3D '/etc/backuppc';<o:p></o:p></p> <p class=3D"MsoNormal">$Conf{LogDir} =3D '/var/lib/backuppc/log';<o:p></o:p= ></p> <p class=3D"MsoNormal">$Conf{InstallDir} =3D '/usr/share/backuppc';<o:p></o= :p></p> <p class=3D"MsoNormal">$Conf{CgiDir} =3D '/usr/share/backuppc/cgi-bin';<o:p= ></o:p></p> <p class=3D"MsoNormal"><o:p> </o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal"># Whether BackupPC and the CGI script BackupPC_Admin= verify that they<o:p></o:p></p> <p class=3D"MsoNormal"># are really running as user $Conf{BackupPCUser}.&nb= sp; If this flag is set<o:p></o:p></p> <p class=3D"MsoNormal"># and the effective user id (euid) differs from $Con= f{BackupPCUser}<o:p></o:p></p> <p class=3D"MsoNormal"># then both scripts exit with an error. This c= atches cases where<o:p></o:p></p> <p class=3D"MsoNormal"># BackupPC might be accidently started as root or th= e wrong user,<o:p></o:p></p> <p class=3D"MsoNormal"># or if the CGI script is not installed correctly.<o= :p></o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal">$Conf{BackupPCUserVerify} =3D '1';<o:p></o:p></p> <p class=3D"MsoNormal"><o:p> </o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal"># Maximum number of hardlinks supported by the $TopD= ir file system<o:p></o:p></p> <p class=3D"MsoNormal"># that BackupPC uses. Most linux or unix file = systems should support<o:p></o:p></p> <p class=3D"MsoNormal"># at least 32000 hardlinks per file, or 64000 in oth= er cases. If a pool<o:p></o:p></p> <p class=3D"MsoNormal"># file already has this number of hardlinks, a new p= ool file is created<o:p></o:p></p> <p class=3D"MsoNormal"># so that new hardlinks can be accommodated. T= his limit will only<o:p></o:p></p> <p class=3D"MsoNormal"># be hit if an identical file appears at least this = number of times<o:p></o:p></p> <p class=3D"MsoNormal"># across all the backups.<o:p></o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal">$Conf{HardLinkMax} =3D 31999;<o:p></o:p></p> <p class=3D"MsoNormal"><o:p> </o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal"># Advanced option for asking BackupPC to load additi= onal perl modules.<o:p></o:p></p> <p class=3D"MsoNormal"># Can be a list (array ref) of module names to load = at startup.<o:p></o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal">$Conf{PerlModuleLoad} =3D undef;<o:p></o:p></p> <p class=3D"MsoNormal"><o:p> </o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal"># Path to init.d script and command to use that scri= pt to start the<o:p></o:p></p> <p class=3D"MsoNormal"># server from the CGI interface. The following= variables are substituted<o:p></o:p></p> <p class=3D"MsoNormal"># at run-time:<o:p></o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal"># $sshPath = path to ssh ($Conf{SshPath})<o:p></o:p></p> <p class=3D"MsoNormal"># $serverHost &nb= sp; same as $Conf{ServerHost}<o:p></o:p></p> <p class=3D"MsoNormal"># $serverInitdPath path to i= nit.d script ($Conf{ServerInitdPath})<o:p></o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal"># Example:<o:p></o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal"># $Conf{ServerInitdPath} =3D= '/etc/init.d/backuppc';<o:p></o:p></p> <p class=3D"MsoNormal"># $Conf{ServerInitdStartCmd} =3D '$sshPath -q -x -l = root $serverHost'<o:p></o:p></p> <p class=3D"MsoNormal"># &nb= sp; = . ' $serverInitdPath start'<o:p></o:p>= </p> <p class=3D"MsoNormal"># &nb= sp; = . ' < /dev/null >& /dev/null= ';<o:p></o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal"># Note: all Cmds are executed directly without a she= ll, so the prog name<o:p></o:p></p> <p class=3D"MsoNormal"># needs to be a full path and you can't include shel= l syntax like<o:p></o:p></p> <p class=3D"MsoNormal"># redirection and pipes; put that in a script if you= need it.<o:p></o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal">$Conf{ServerInitdPath} =3D undef;<o:p></o:p></p> <p class=3D"MsoNormal">$Conf{ServerInitdStartCmd} =3D '';<o:p></o:p></p> <p class=3D"MsoNormal"><o:p> </o:p></p> <p class=3D"MsoNormal"><o:p> </o:p></p> <p class=3D"MsoNormal">####################################################= #######################<o:p></o:p></p> <p class=3D"MsoNormal"># What to backup and when to do it<o:p></o:p></p> <p class=3D"MsoNormal"># (can be overridden in the per-PC config.pl)<o:p></= o:p></p> <p class=3D"MsoNormal">####################################################= #######################<o:p></o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal"># Minimum period in days between full backups. A ful= l dump will only be<o:p></o:p></p> <p class=3D"MsoNormal"># done if at least this much time has elapsed since = the last full dump,<o:p></o:p></p> <p class=3D"MsoNormal"># and at least $Conf{IncrPeriod} days has elapsed si= nce the last<o:p></o:p></p> <p class=3D"MsoNormal"># successful dump.<o:p></o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal"># Typically this is set slightly less than an intege= r number of days. The<o:p></o:p></p> <p class=3D"MsoNormal"># time taken for the backup, plus the granularity of= $Conf{WakeupSchedule}<o:p></o:p></p> <p class=3D"MsoNormal"># will make the actual backup interval a bit longer.= <o:p></o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal">$Conf{FullPeriod} =3D '6.9';<o:p></o:p></p> <p class=3D"MsoNormal"><o:p> </o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal"># Minimum period in days between incremental backups= (a user requested<o:p></o:p></p> <p class=3D"MsoNormal"># incremental backup will be done anytime on demand)= .<o:p></o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal"># Typically this is set slightly less than an intege= r number of days. The<o:p></o:p></p> <p class=3D"MsoNormal"># time taken for the backup, plus the granularity of= $Conf{WakeupSchedule}<o:p></o:p></p> <p class=3D"MsoNormal"># will make the actual backup interval a bit longer.= <o:p></o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal">$Conf{IncrPeriod} =3D '0.9';<o:p></o:p></p> <p class=3D"MsoNormal"><o:p> </o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal"># Number of full backups to keep. Must be >= =3D 1.<o:p></o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal"># In the steady state, each time a full backup compl= etes successfully<o:p></o:p></p> <p class=3D"MsoNormal"># the oldest one is removed. If this number is= decreased, the<o:p></o:p></p> <p class=3D"MsoNormal"># extra old backups will be removed.<o:p></o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal"># If filling of incremental dumps is off the oldest = backup always<o:p></o:p></p> <p class=3D"MsoNormal"># has to be a full (ie: filled) dump. This mig= ht mean one or two<o:p></o:p></p> <p class=3D"MsoNormal"># extra full dumps are kept until the oldest increme= ntal backups expire.<o:p></o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal"># Exponential backup expiry is also supported. = This allows you to specify:<o:p></o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal"># - num fulls to keep at intervals of 1 = * $Conf{FullPeriod}, followed by<o:p></o:p></p> <p class=3D"MsoNormal"># - num fulls to keep at intervals of 2 = * $Conf{FullPeriod},<o:p></o:p></p> <p class=3D"MsoNormal"># - num fulls to keep at intervals of 4 = * $Conf{FullPeriod},<o:p></o:p></p> <p class=3D"MsoNormal"># - num fulls to keep at intervals of 8 = * $Conf{FullPeriod},<o:p></o:p></p> <p class=3D"MsoNormal"># - num fulls to keep at intervals of 16= * $Conf{FullPeriod},<o:p></o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal"># and so on. This works by deleting every othe= r full as each expiry<o:p></o:p></p> <p class=3D"MsoNormal"># boundary is crossed.<o:p></o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal"># Exponential expiry is specified using an array for= $Conf{FullKeepCnt}:<o:p></o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal"># $Conf{FullKeepCnt} =3D [4, 2, 3];<o:p>= </o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal"># Entry #n specifies how many fulls to keep at an in= terval of<o:p></o:p></p> <p class=3D"MsoNormal"># 2^n * $Conf{FullPeriod} (ie: 1, 2, 4, 8, 16, 32, .= ..).<o:p></o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal"># The example above specifies keeping 4 of the most = recent full backups<o:p></o:p></p> <p class=3D"MsoNormal"># (1 week interval) two full backups at 2 week inter= vals, and 3 full<o:p></o:p></p> <p class=3D"MsoNormal"># backups at 4 week intervals, eg:<o:p></o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal"># full 0 19 weeks old = \<o:p></o:p></p> <p class=3D"MsoNormal"># full 1 15 weeks old &= nbsp; >--- 3 backups at 4 * $Conf{FullPeriod}<o:p></o:p></p> <p class=3D"MsoNormal"># full 2 11 weeks old = / <o:p></o:p></p> <p class=3D"MsoNormal"># full 3 7 weeks old &n= bsp; \____ 2 backups at 2 * $Conf{FullPeriod}<o:p></o:p></p> <p class=3D"MsoNormal"># full 4 5 weeks old &n= bsp; /<o:p></o:p></p> <p class=3D"MsoNormal"># full 5 3 weeks old &n= bsp; \<o:p></o:p></p> <p class=3D"MsoNormal"># full 6 2 weeks old &n= bsp; \___ 4 backups at 1 * $Conf{FullPeriod}<o:p></o:p></p> <p class=3D"MsoNormal"># full 7 1 week old &nb= sp; /<o:p></o:p></p> <p class=3D"MsoNormal"># full 8 current = /<o:p></o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal"># On a given week the spacing might be less than sho= wn as each backup<o:p></o:p></p> <p class=3D"MsoNormal"># ages through each expiry period. For example= , one week later, a<o:p></o:p></p> <p class=3D"MsoNormal"># new full is completed and the oldest is deleted, g= iving:<o:p></o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal"># full 0 16 weeks old = \<o:p></o:p></p> <p class=3D"MsoNormal"># full 1 12 weeks old &= nbsp; >--- 3 backups at 4 * $Conf{FullPeriod}<o:p></o:p></p> <p class=3D"MsoNormal"># full 2 8 weeks old &n= bsp; / <o:p></o:p></p> <p class=3D"MsoNormal"># full 3 6 weeks old &n= bsp; \____ 2 backups at 2 * $Conf{FullPeriod}<o:p></o:p></p> <p class=3D"MsoNormal"># full 4 4 weeks old &n= bsp; /<o:p></o:p></p> <p class=3D"MsoNormal"># full 5 3 weeks old &n= bsp; \<o:p></o:p></p> <p class=3D"MsoNormal"># full 6 2 weeks old &n= bsp; \___ 4 backups at 1 * $Conf{FullPeriod}<o:p></o:p></p> <p class=3D"MsoNormal"># full 7 1 week old &nb= sp; /<o:p></o:p></p> <p class=3D"MsoNormal"># full 8 current = /<o:p></o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal"># You can specify 0 as a count (except in the first = entry), and the<o:p></o:p></p> <p class=3D"MsoNormal"># array can be as long as you wish. For exampl= e:<o:p></o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal"># $Conf{FullKeepCnt} =3D [4, 0, 4, 0, 0,= 2];<o:p></o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal"># This will keep 10 full dumps, 4 most recent at 1 *= $Conf{FullPeriod},<o:p></o:p></p> <p class=3D"MsoNormal"># followed by 4 at an interval of 4 * $Conf{FullPeri= od} (approx 1 month<o:p></o:p></p> <p class=3D"MsoNormal"># apart), and then 2 at an interval of 32 * $Conf{Fu= llPeriod} (approx<o:p></o:p></p> <p class=3D"MsoNormal"># 7-8 months apart).<o:p></o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal"># Example: these two settings are equivalent and bot= h keep just<o:p></o:p></p> <p class=3D"MsoNormal"># the four most recent full dumps:<o:p></o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal"># $Conf{FullKeepCnt} =3D 4;<o:p></= o:p></p> <p class=3D"MsoNormal"># $Conf{FullKeepCnt} =3D [4];<o:p>= </o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal">$Conf{FullKeepCnt} =3D [<o:p></o:p></p> <p class=3D"MsoNormal"> 1<o:p></o:p></p> <p class=3D"MsoNormal">];<o:p></o:p></p> <p class=3D"MsoNormal"><o:p> </o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal"># Very old full backups are removed after $Conf{Full= AgeMax} days. However,<o:p></o:p></p> <p class=3D"MsoNormal"># we keep at least $Conf{FullKeepCntMin} full backup= s no matter how old<o:p></o:p></p> <p class=3D"MsoNormal"># they are.<o:p></o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal"># Note that $Conf{FullAgeMax} will be increased to $= Conf{FullKeepCnt}<o:p></o:p></p> <p class=3D"MsoNormal"># times $Conf{FullPeriod} if $Conf{FullKeepCnt} spec= ifies enough<o:p></o:p></p> <p class=3D"MsoNormal"># full backups to exceed $Conf{FullAgeMax}.<o:p></o:= p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal">$Conf{FullKeepCntMin} =3D 1;<o:p></o:p></p> <p class=3D"MsoNormal">$Conf{FullAgeMax} =3D 90;<o:p></o:p></p> <p class=3D"MsoNormal"><o:p> </o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal"># Number of incremental backups to keep. Must = be >=3D 1.<o:p></o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal"># In the steady state, each time an incr backup comp= letes successfully<o:p></o:p></p> <p class=3D"MsoNormal"># the oldest one is removed. If this number is= decreased, the<o:p></o:p></p> <p class=3D"MsoNormal"># extra old backups will be removed.<o:p></o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal">$Conf{IncrKeepCnt} =3D 6;<o:p></o:p></p> <p class=3D"MsoNormal"><o:p> </o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal"># Very old incremental backups are removed after $Co= nf{IncrAgeMax} days.<o:p></o:p></p> <p class=3D"MsoNormal"># However, we keep at least $Conf{IncrKeepCntMin} in= cremental backups no<o:p></o:p></p> <p class=3D"MsoNormal"># matter how old they are.<o:p></o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal">$Conf{IncrKeepCntMin} =3D 1;<o:p></o:p></p> <p class=3D"MsoNormal">$Conf{IncrAgeMax} =3D 30;<o:p></o:p></p> <p class=3D"MsoNormal"><o:p> </o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal"># Level of each incremental. "Level"= follows the terminology<o:p></o:p></p> <p class=3D"MsoNormal"># of dump(1). A full backup has level 0. = A new incremental<o:p></o:p></p> <p class=3D"MsoNormal"># of level N will backup all files that have changed= since<o:p></o:p></p> <p class=3D"MsoNormal"># the most recent backup of a lower level.<o:p></o:p= ></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal"># The entries of $Conf{IncrLevels} apply in order to= each<o:p></o:p></p> <p class=3D"MsoNormal"># incremental after each full backup. It wraps= around until<o:p></o:p></p> <p class=3D"MsoNormal"># the next full backup. For example, these two= settings<o:p></o:p></p> <p class=3D"MsoNormal"># have the same effect:<o:p></o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal"># $Conf{IncrLeve= ls} =3D [1, 2, 3];<o:p></o:p></p> <p class=3D"MsoNormal"># $Conf{IncrLeve= ls} =3D [1, 2, 3, 1, 2, 3];<o:p></o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal"># This means the 1st and 4th incrementals (level 1) = go all<o:p></o:p></p> <p class=3D"MsoNormal"># the way back to the full. The 2nd and 3rd (a= nd 5th and<o:p></o:p></p> <p class=3D"MsoNormal"># 6th) backups just go back to the immediate preceed= ing<o:p></o:p></p> <p class=3D"MsoNormal"># incremental.<o:p></o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal"># Specifying a sequence of multi-level incrementals = will<o:p></o:p></p> <p class=3D"MsoNormal"># usually mean more than $Conf{IncrKeepCnt} incremen= tals will<o:p></o:p></p> <p class=3D"MsoNormal"># need to be kept, since lower level incrementals ar= e needed<o:p></o:p></p> <p class=3D"MsoNormal"># to merge a complete view of a backup. For ex= ample, with<o:p></o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal"># $Conf{FullPeri= od} =3D 7;<o:p></o:p></p> <p class=3D"MsoNormal"># $Conf{IncrPeri= od} =3D 1;<o:p></o:p></p> <p class=3D"MsoNormal"># $Conf{IncrKeep= Cnt} =3D 6;<o:p></o:p></p> <p class=3D"MsoNormal"># $Conf{IncrLeve= ls} =3D [1, 2, 3, 4, 5, 6];<o:p></o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal"># there will be up to 11 incrementals in this case: = <o:p></o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal"># backup #0 = ; (full, level 0, oldest)<o:p></o:p></p> <p class=3D"MsoNormal"># backup #1 = ; (incr, level 1)<o:p></o:p></p> <p class=3D"MsoNormal"># backup #2 = ; (incr, level 2)<o:p></o:p></p> <p class=3D"MsoNormal"># backup #3 = ; (incr, level 3)<o:p></o:p></p> <p class=3D"MsoNormal"># backup #4 = ; (incr, level 4)<o:p></o:p></p> <p class=3D"MsoNormal"># backup #5 = ; (incr, level 5)<o:p></o:p></p> <p class=3D"MsoNormal"># backup #6 = ; (incr, level 6)<o:p></o:p></p> <p class=3D"MsoNormal"># backup #7 = ; (full, level 0)<o:p></o:p></p> <p class=3D"MsoNormal"># backup #8 = ; (incr, level 1)<o:p></o:p></p> <p class=3D"MsoNormal"># backup #9 = ; (incr, level 2)<o:p></o:p></p> <p class=3D"MsoNormal"># backup #10 (in= cr, level 3)<o:p></o:p></p> <p class=3D"MsoNormal"># backup #11 (in= cr, level 4)<o:p></o:p></p> <p class=3D"MsoNormal"># backup #12 (in= cr, level 5, newest)<o:p></o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal"># Backup #1 (the oldest level 1 incremental) can't b= e deleted<o:p></o:p></p> <p class=3D"MsoNormal"># since backups 2..6 depend on it. Those 6 inc= rementals can't<o:p></o:p></p> <p class=3D"MsoNormal"># all be deleted since that would only leave 5 (#8..= 12).<o:p></o:p></p> <p class=3D"MsoNormal"># When the next incremental happens (level 6), the c= omplete<o:p></o:p></p> <p class=3D"MsoNormal"># set of 6 older incrementals (#1..6) will be delete= d, since<o:p></o:p></p> <p class=3D"MsoNormal"># that maintains the required number ($Conf{IncrKeep= Cnt})<o:p></o:p></p> <p class=3D"MsoNormal"># of incrementals. This situation is reduced i= f you set<o:p></o:p></p> <p class=3D"MsoNormal"># shorter chains of multi-level incrementals, eg:<o:= p></o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal"># $Conf{IncrLeve= ls} =3D [1, 2, 3];<o:p></o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal"># would only have up to 2 extra incremenals before a= ll 3<o:p></o:p></p> <p class=3D"MsoNormal"># are deleted.<o:p></o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal"># BackupPC as usual merges the full and the sequence= <o:p></o:p></p> <p class=3D"MsoNormal"># of incrementals together so each incremental can b= e<o:p></o:p></p> <p class=3D"MsoNormal"># browsed and restored as though it is a complete ba= ckup.<o:p></o:p></p> <p class=3D"MsoNormal"># If you specify a long chain of incrementals then m= ore<o:p></o:p></p> <p class=3D"MsoNormal"># backups need to be merged when browsing, restoring= ,<o:p></o:p></p> <p class=3D"MsoNormal"># or getting the starting point for rsync backups.<o= :p></o:p></p> <p class=3D"MsoNormal"># In the example above (levels 1..6), browing backup= <o:p></o:p></p> <p class=3D"MsoNormal"># #6 requires 7 different backups (#0..6) to be merg= ed.<o:p></o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal"># Because of this merging and the additional increme= ntals<o:p></o:p></p> <p class=3D"MsoNormal"># that need to be kept, it is recommended that some<= o:p></o:p></p> <p class=3D"MsoNormal"># level 1 incrementals be included in $Conf{IncrLeve= ls}.<o:p></o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal"># Prior to version 3.0 incrementals were always leve= l 1,<o:p></o:p></p> <p class=3D"MsoNormal"># meaning each incremental backed up all the files t= hat<o:p></o:p></p> <p class=3D"MsoNormal"># changed since the last full.<o:p></o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal">$Conf{IncrLevels} =3D [<o:p></o:p></p> <p class=3D"MsoNormal"> 1<o:p></o:p></p> <p class=3D"MsoNormal">];<o:p></o:p></p> <p class=3D"MsoNormal"><o:p> </o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal"># Disable all full and incremental backups. Th= ese settings are<o:p></o:p></p> <p class=3D"MsoNormal"># useful for a client that is no longer being backed= up<o:p></o:p></p> <p class=3D"MsoNormal"># (eg: a retired machine), but you wish to keep the = last<o:p></o:p></p> <p class=3D"MsoNormal"># backups available for browsing or restoring to oth= er machines.<o:p></o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal"># There are three values for $Conf{BackupsDisable}:<= o:p></o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal"># 0 Backups are enable= d.<o:p></o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal"># 1 Don't do any regul= ar backups on this client. Manually<o:p></o:p></p> <p class=3D"MsoNormal"># requeste= d backups (via the CGI interface) will still occur.<o:p></o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal"># 2 Don't do any backu= ps on this client. Manually requested<o:p></o:p></p> <p class=3D"MsoNormal"># backups = (via the CGI interface) will be ignored.<o:p></o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal"># In versions prior to 3.0 Backups were disabled by = setting<o:p></o:p></p> <p class=3D"MsoNormal"># $Conf{FullPeriod} to -1 or -2.<o:p></o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal">$Conf{BackupsDisable} =3D 0;<o:p></o:p></p> <p class=3D"MsoNormal"><o:p> </o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal"># A failed full backup is saved as a partial backup.= The rsync<o:p></o:p></p> <p class=3D"MsoNormal"># XferMethod can take advantage of the partial full = when the next<o:p></o:p></p> <p class=3D"MsoNormal"># backup is run. This parameter sets the age of the = partial full<o:p></o:p></p> <p class=3D"MsoNormal"># in days: if the partial backup is older than this = number of<o:p></o:p></p> <p class=3D"MsoNormal"># days, then rsync will ignore (not use) the partial= full when<o:p></o:p></p> <p class=3D"MsoNormal"># the next backup is run. If you set this to a= negative value<o:p></o:p></p> <p class=3D"MsoNormal"># then no partials will be saved. If you set t= his to 0, partials<o:p></o:p></p> <p class=3D"MsoNormal"># will be saved, but will not be used by the next ba= ckup.<o:p></o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal"># The default setting of 3 days means that a partial= older than<o:p></o:p></p> <p class=3D"MsoNormal"># 3 days is ignored when the next full backup is don= e.<o:p></o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal">$Conf{PartialAgeMax} =3D 3;<o:p></o:p></p> <p class=3D"MsoNormal"><o:p> </o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal"># Whether incremental backups are filled. &quo= t;Filling" means that the<o:p></o:p></p> <p class=3D"MsoNormal"># most recent full (or filled) dump is merged into t= he new incremental<o:p></o:p></p> <p class=3D"MsoNormal"># dump using hardlinks. This makes an incremen= tal dump look like a<o:p></o:p></p> <p class=3D"MsoNormal"># full dump. Prior to v1.03 all incremental ba= ckups were filled.<o:p></o:p></p> <p class=3D"MsoNormal"># In v1.4.0 and later the default is off.<o:p></o:p>= </p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal"># BackupPC, and the cgi interface in particular, do = the right thing on<o:p></o:p></p> <p class=3D"MsoNormal"># un-filled incremental backups. It will corre= ctly display the merged<o:p></o:p></p> <p class=3D"MsoNormal"># incremental backup with the most recent filled bac= kup, giving the<o:p></o:p></p> <p class=3D"MsoNormal"># un-filled incremental backups a filled appearance.= That means it<o:p></o:p></p> <p class=3D"MsoNormal"># invisible to the user whether incremental dumps ar= e filled or not.<o:p></o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal"># Filling backups takes a little extra disk space, a= nd it does cost<o:p></o:p></p> <p class=3D"MsoNormal"># some extra disk activity for filling, and later re= moval. Filling<o:p></o:p></p> <p class=3D"MsoNormal"># is no longer useful, since file mangling and compr= ession doesn't<o:p></o:p></p> <p class=3D"MsoNormal"># make a filled backup very useful. It's likely the = filling option<o:p></o:p></p> <p class=3D"MsoNormal"># will be removed from future versions: filling will= be delegated to<o:p></o:p></p> <p class=3D"MsoNormal"># the display and extraction of backup data.<o:p></o= :p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal"># If filling is off, BackupPC makes sure that the ol= dest backup is<o:p></o:p></p> <p class=3D"MsoNormal"># a full, otherwise the following incremental backup= s will be<o:p></o:p></p> <p class=3D"MsoNormal"># incomplete. This might mean an extra full ba= ckup has to be<o:p></o:p></p> <p class=3D"MsoNormal"># kept until the following incremental backups expir= e.<o:p></o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal"># The default is off. You can turn this on or = off at any<o:p></o:p></p> <p class=3D"MsoNormal"># time without affecting existing backups.<o:p></o:p= ></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal">$Conf{IncrFill} =3D '0';<o:p></o:p></p> <p class=3D"MsoNormal"><o:p> </o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal"># Number of restore logs to keep. BackupPC rem= embers information about<o:p></o:p></p> <p class=3D"MsoNormal"># each restore request. This number per client= will be kept around before<o:p></o:p></p> <p class=3D"MsoNormal"># the oldest ones are pruned.<o:p></o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal"># Note: files/dirs delivered via Zip or Tar download= s don't count as<o:p></o:p></p> <p class=3D"MsoNormal"># restores. Only the first restore option (whe= re the files and dirs<o:p></o:p></p> <p class=3D"MsoNormal"># are written to the host) count as restores that ar= e logged.<o:p></o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal">$Conf{RestoreInfoKeepCnt} =3D 10;<o:p></o:p></p> <p class=3D"MsoNormal"><o:p> </o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal"># Number of archive logs to keep. BackupPC rem= embers information<o:p></o:p></p> <p class=3D"MsoNormal"># about each archive request. This number per = archive client will<o:p></o:p></p> <p class=3D"MsoNormal"># be kept around before the oldest ones are pruned.<= o:p></o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal">$Conf{ArchiveInfoKeepCnt} =3D 10;<o:p></o:p></p> <p class=3D"MsoNormal"><o:p> </o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal"># List of directories or files to backup. If t= his is defined, only these<o:p></o:p></p> <p class=3D"MsoNormal"># directories or files will be backed up.<o:p></o:p>= </p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal"># When editing from the web interface, you should ad= d a valid ShareName<o:p></o:p></p> <p class=3D"MsoNormal"># (based on $Conf{XferMethod}), and then enter the d= irectories specific<o:p></o:p></p> <p class=3D"MsoNormal"># to that ShareName. A special ShareName "= ;*" matches any ShareName that<o:p></o:p></p> <p class=3D"MsoNormal"># doesn't have an explicit entry.<o:p></o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal"># For Smb, only one of $Conf{BackupFilesExclude} and= $Conf{BackupFilesOnly}<o:p></o:p></p> <p class=3D"MsoNormal"># can be specified per share. If both are set for a = particular share, then<o:p></o:p></p> <p class=3D"MsoNormal"># $Conf{BackupFilesOnly} takes precedence and $Conf{= BackupFilesExclude}<o:p></o:p></p> <p class=3D"MsoNormal"># is ignored.<o:p></o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal"># This can be set to a string, an array of strings, = or, in the case<o:p></o:p></p> <p class=3D"MsoNormal"># of multiple shares, a hash of strings or arrays.&n= bsp; A hash is used<o:p></o:p></p> <p class=3D"MsoNormal"># to give a list of directories or files to backup f= or each share<o:p></o:p></p> <p class=3D"MsoNormal"># (the share name is the key). If this is set = to just a string or<o:p></o:p></p> <p class=3D"MsoNormal"># array, and $Conf{SmbShareName} contains multiple s= hare names, then<o:p></o:p></p> <p class=3D"MsoNormal"># the setting is assumed to apply all shares.<o:p></= o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal"># If a hash is used, a special key "*" mea= ns it applies to all<o:p></o:p></p> <p class=3D"MsoNormal"># shares that don't have a specific entry.<o:p></o:p= ></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal"># Examples:<o:p></o:p></p> <p class=3D"MsoNormal"># $Conf{BackupFilesOnly} =3D '/myF= iles';<o:p></o:p></p> <p class=3D"MsoNormal"># $Conf{BackupFilesOnly} =3D ['/my= Files']; # same as first example<o:p></o:p></p> <p class=3D"MsoNormal"># $Conf{BackupFilesOnly} =3D ['/my= Files', '/important'];<o:p></o:p></p> <p class=3D"MsoNormal"># $Conf{BackupFilesOnly} =3D {<o:p= ></o:p></p> <p class=3D"MsoNormal"># 'c' =3D> ['= /myFiles', '/important'], # these are for 'c'= share<o:p></o:p></p> <p class=3D"MsoNormal"># 'd' =3D> ['= /moreFiles', '/archive'], # these are for 'd'= share<o:p></o:p></p> <p class=3D"MsoNormal"># };<o:p></o:p></p> <p class=3D"MsoNormal"># $Conf{BackupFilesOnly} =3D {<o:p= ></o:p></p> <p class=3D"MsoNormal"># 'c' =3D> ['= /myFiles', '/important'], # these are for 'c'= share<o:p></o:p></p> <p class=3D"MsoNormal"># '*' =3D> ['= /myFiles', '/important'], # these are other s= hares<o:p></o:p></p> <p class=3D"MsoNormal"># };<o:p></o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal">$Conf{BackupFilesOnly} =3D {};<o:p></o:p></p> <p class=3D"MsoNormal"><o:p> </o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal"># List of directories or files to exclude from the b= ackup. For Smb,<o:p></o:p></p> <p class=3D"MsoNormal"># only one of $Conf{BackupFilesExclude} and $Conf{Ba= ckupFilesOnly}<o:p></o:p></p> <p class=3D"MsoNormal"># can be specified per share. If both are set = for a particular share,<o:p></o:p></p> <p class=3D"MsoNormal"># then $Conf{BackupFilesOnly} takes precedence and<o= :p></o:p></p> <p class=3D"MsoNormal"># $Conf{BackupFilesExclude} is ignored.<o:p></o:p></= p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal"># When editing from the web interface, you should ad= d a valid ShareName<o:p></o:p></p> <p class=3D"MsoNormal"># (based on $Conf{XferMethod}), and then enter the d= irectories or files<o:p></o:p></p> <p class=3D"MsoNormal"># specific to that ShareName. A special ShareN= ame "*" matches any<o:p></o:p></p> <p class=3D"MsoNormal"># ShareName that doesn't have an explicit entry.<o:p= ></o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal"># This can be set to a string, an array of strings, = or, in the case<o:p></o:p></p> <p class=3D"MsoNormal"># of multiple shares, a hash of strings or arrays.&n= bsp; A hash is used<o:p></o:p></p> <p class=3D"MsoNormal"># to give a list of directories or files to exclude = for each share<o:p></o:p></p> <p class=3D"MsoNormal"># (the share name is the key). If this is set = to just a string or<o:p></o:p></p> <p class=3D"MsoNormal"># array, and $Conf{SmbShareName} contains multiple s= hare names, then<o:p></o:p></p> <p class=3D"MsoNormal"># the setting is assumed to apply to all shares.<o:p= ></o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal"># The exact behavior is determined by the underlying= transport program,<o:p></o:p></p> <p class=3D"MsoNormal"># smbclient or tar. For smbclient the exlclude= file list is passed into<o:p></o:p></p> <p class=3D"MsoNormal"># the X option. Simple shell wild-cards using = "*" or "?" are allowed.<o:p></o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal"># For tar, if the exclude file contains a "/&qu= ot; it is assumed to be anchored<o:p></o:p></p> <p class=3D"MsoNormal"># at the start of the string. Since all the ta= r paths start with "./",<o:p></o:p></p> <p class=3D"MsoNormal"># BackupPC prepends a "." if the exclude f= ile starts with a "/". Note<o:p></o:p></p> <p class=3D"MsoNormal"># that GNU tar version >=3D 1.13.7 is required fo= r the exclude option to<o:p></o:p></p> <p class=3D"MsoNormal"># work correctly. For linux or unix machines y= ou should add<o:p></o:p></p> <p class=3D"MsoNormal"># "/proc" to $Conf{BackupFilesExclude} unl= ess you have specified<o:p></o:p></p> <p class=3D"MsoNormal"># --one-file-system in $Conf{TarClientCmd} or --one-= file-system in<o:p></o:p></p> <p class=3D"MsoNormal"># $Conf{RsyncArgs}. Also, for tar, do not use = a trailing "/" in<o:p></o:p></p> <p class=3D"MsoNormal"># the directory name: a trailing "/" cause= s the name to not match<o:p></o:p></p> <p class=3D"MsoNormal"># and the directory will not be excluded.<o:p></o:p>= </p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal"># Users report that for smbclient you should specify= a directory<o:p></o:p></p> <p class=3D"MsoNormal"># followed by "/*", eg: "/proc/*"= ;, instead of just "/proc".<o:p></o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal"># FTP servers are traversed recursively so excluding= directories will<o:p></o:p></p> <p class=3D"MsoNormal"># also exclude its contents. You can use the w= ildcard characters "*"<o:p></o:p></p> <p class=3D"MsoNormal"># and "?" to define files for inclusion an= d exclusion. Both<o:p></o:p></p> <p class=3D"MsoNormal"># attributes $Conf{BackupFilesOnly} and $Conf{Backup= FilesExclude} can<o:p></o:p></p> <p class=3D"MsoNormal"># be defined for the same share.<o:p></o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal"># If a hash is used, a special key "*" mea= ns it applies to all<o:p></o:p></p> <p class=3D"MsoNormal"># shares that don't have a specific entry.<o:p></o:p= ></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal"># Examples:<o:p></o:p></p> <p class=3D"MsoNormal"># $Conf{BackupFilesExclude} =3D '/= temp';<o:p></o:p></p> <p class=3D"MsoNormal"># $Conf{BackupFilesExclude} =3D ['= /temp']; # same as first example<o:p></o:p></p> <p class=3D"MsoNormal"># $Conf{BackupFilesExclude} =3D ['= /temp', '/winnt/tmp'];<o:p></o:p></p> <p class=3D"MsoNormal"># $Conf{BackupFilesExclude} =3D {<= o:p></o:p></p> <p class=3D"MsoNormal"># 'c' =3D> ['= /temp', '/winnt/tmp'], # th= ese are for 'c' share<o:p></o:p></p> <p class=3D"MsoNormal"># 'd' =3D> ['= /junk', '/dont_back_this_up'], # these are for 'd' share<o:p></o:p></p> <p class=3D"MsoNormal"># };<o:p></o:p></p> <p class=3D"MsoNormal"># $Conf{BackupFilesExclude} =3D {<= o:p></o:p></p> <p class=3D"MsoNormal"># 'c' =3D> ['= /temp', '/winnt/tmp'], # th= ese are for 'c' share<o:p></o:p></p> <p class=3D"MsoNormal"># '*' =3D> ['= /junk', '/dont_back_this_up'], # these are for other shares<o:p></o:p></p> <p class=3D"MsoNormal"># };<o:p></o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal">$Conf{BackupFilesExclude} =3D {};<o:p></o:p></p> <p class=3D"MsoNormal"><o:p> </o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal"># PCs that are always or often on the network can be= backed up after<o:p></o:p></p> <p class=3D"MsoNormal"># hours, to reduce PC, network and server load durin= g working hours. For<o:p></o:p></p> <p class=3D"MsoNormal"># each PC a count of consecutive good pings is maint= ained. Once a PC has<o:p></o:p></p> <p class=3D"MsoNormal"># at least $Conf{BlackoutGoodCnt} consecutive good p= ings it is subject<o:p></o:p></p> <p class=3D"MsoNormal"># to "blackout" and not backed up during h= ours and days specified by<o:p></o:p></p> <p class=3D"MsoNormal"># $Conf{BlackoutPeriods}.<o:p></o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal"># To allow for periodic rebooting of a PC or other b= rief periods when a<o:p></o:p></p> <p class=3D"MsoNormal"># PC is not on the network, a number of consecutive = bad pings is allowed<o:p></o:p></p> <p class=3D"MsoNormal"># before the good ping count is reset. This paramete= r is<o:p></o:p></p> <p class=3D"MsoNormal"># $Conf{BlackoutBadPingLimit}.<o:p></o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal"># Note that bad and good pings don't occur with the = same interval. If a<o:p></o:p></p> <p class=3D"MsoNormal"># machine is always on the network, it will only be = pinged roughly once<o:p></o:p></p> <p class=3D"MsoNormal"># every $Conf{IncrPeriod} (eg: once per day). So a s= etting for<o:p></o:p></p> <p class=3D"MsoNormal"># $Conf{BlackoutGoodCnt} of 7 means it will take aro= und 7 days for a<o:p></o:p></p> <p class=3D"MsoNormal"># machine to be subject to blackout. On the other ha= nd, if a ping is<o:p></o:p></p> <p class=3D"MsoNormal"># failed, it will be retried roughly every time Back= upPC wakes up, eg,<o:p></o:p></p> <p class=3D"MsoNormal"># every one or two hours. So a setting for $Conf{Bla= ckoutBadPingLimit} of<o:p></o:p></p> <p class=3D"MsoNormal"># 3 means that the PC will lose its blackout status = after 3-6 hours of<o:p></o:p></p> <p class=3D"MsoNormal"># unavailability.<o:p></o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal"># To disable the blackout feature set $Conf{Blackout= GoodCnt} to a negative<o:p></o:p></p> <p class=3D"MsoNormal"># value. A value of 0 will make all machines s= ubject to blackout. But<o:p></o:p></p> <p class=3D"MsoNormal"># if you don't want to do any backups during the day= it would be easier<o:p></o:p></p> <p class=3D"MsoNormal"># to just set $Conf{WakeupSchedule} to a restricted = schedule.<o:p></o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal">$Conf{BlackoutBadPingLimit} =3D 3;<o:p></o:p></p> <p class=3D"MsoNormal">$Conf{BlackoutGoodCnt} =3D 1;<o:p></o:p></p> <p class=3D"MsoNormal"><o:p> </o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal"># One or more blackout periods can be specified.&nbs= p; If a client is<o:p></o:p></p> <p class=3D"MsoNormal"># subject to blackout then no regular (non-manual) b= ackups will<o:p></o:p></p> <p class=3D"MsoNormal"># be started during any of these periods. hour= Begin and hourEnd<o:p></o:p></p> <p class=3D"MsoNormal"># specify hours fro midnight and weekDays is a list = of days of<o:p></o:p></p> <p class=3D"MsoNormal"># the week where 0 is Sunday, 1 is Monday etc.<o:p><= /o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal"># For example:<o:p></o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal"># $Conf{BlackoutPeriods} =3D [<o:p= ></o:p></p> <p class=3D"MsoNormal"># &nb= sp; {<o:p></o:p></p> <p class=3D"MsoNormal"># &nb= sp; hourBegin =3D> 7.0,<o:p><= /o:p></p> <p class=3D"MsoNormal"># &nb= sp; hourEnd =3D> 19.5,<= o:p></o:p></p> <p class=3D"MsoNormal"># &nb= sp; weekDays =3D> [1, 2, 3, 4= , 5],<o:p></o:p></p> <p class=3D"MsoNormal"># &nb= sp; },<o:p></o:p></p> <p class=3D"MsoNormal"># ];<o:p></o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal"># specifies one blackout period from 7:00am to 7:30p= m local time<o:p></o:p></p> <p class=3D"MsoNormal"># on Mon-Fri.<o:p></o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal"># The blackout period can also span midnight by sett= ing<o:p></o:p></p> <p class=3D"MsoNormal"># hourBegin > hourEnd, eg:<o:p></o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal"># $Conf{BlackoutPeriods} =3D [<o:p= ></o:p></p> <p class=3D"MsoNormal"># &nb= sp; {<o:p></o:p></p> <p class=3D"MsoNormal"># &nb= sp; hourBegin =3D> 7.0,<o:p><= /o:p></p> <p class=3D"MsoNormal"># &nb= sp; hourEnd =3D> 19.5,<= o:p></o:p></p> <p class=3D"MsoNormal"># &nb= sp; weekDays =3D> [1, 2, 3, 4= , 5],<o:p></o:p></p> <p class=3D"MsoNormal"># &nb= sp; },<o:p></o:p></p> <p class=3D"MsoNormal"># &nb= sp; {<o:p></o:p></p> <p class=3D"MsoNormal"># &nb= sp; hourBegin =3D> 23,<o:p></o:p></= p> <p class=3D"MsoNormal"># &nb= sp; hourEnd =3D> = 5,<o:p></o:p></p> <p class=3D"MsoNormal"># &nb= sp; weekDays =3D> [5, 6],<o:p= ></o:p></p> <p class=3D"MsoNormal"># &nb= sp; },<o:p></o:p></p> <p class=3D"MsoNormal"># ];<o:p></o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal"># This specifies one blackout period from 7:00am to = 7:30pm local time<o:p></o:p></p> <p class=3D"MsoNormal"># on Mon-Fri, and a second period from 11pm to 5am o= n Friday and<o:p></o:p></p> <p class=3D"MsoNormal"># Saturday night.<o:p></o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal">$Conf{BlackoutPeriods} =3D [<o:p></o:p></p> <p class=3D"MsoNormal"> {<o:p></o:p></p> <p class=3D"MsoNormal"> 'hourEnd' =3D> 20,<o:p></o:p><= /p> <p class=3D"MsoNormal"> 'weekDays' =3D> [<o:p></o:p></= p> <p class=3D"MsoNormal"> 0,<o:p></o:p></p> <p class=3D"MsoNormal"> 1,<o:p></o:p></p> <p class=3D"MsoNormal"> 2,<o:p></o:p></p> <p class=3D"MsoNormal"> 3,<o:p></o:p></p> <p class=3D"MsoNormal"> 4,<o:p></o:p></p> <p class=3D"MsoNormal"> 5,<o:p></o:p></p> <p class=3D"MsoNormal"> 6<o:p></o:p></p> <p class=3D"MsoNormal"> ],<o:p></o:p></p> <p class=3D"MsoNormal"> 'hourBegin' =3D> 7<o:p></o:p><= /p> <p class=3D"MsoNormal"> }<o:p></o:p></p> <p class=3D"MsoNormal">];<o:p></o:p></p> <p class=3D"MsoNormal"><o:p> </o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal"># A backup of a share that has zero files is conside= red fatal. This is<o:p></o:p></p> <p class=3D"MsoNormal"># used to catch miscellaneous Xfer errors that resul= t in no files being<o:p></o:p></p> <p class=3D"MsoNormal"># backed up. If you have shares that might be = empty (and therefore an<o:p></o:p></p> <p class=3D"MsoNormal"># empty backup is valid) you should set this flag to= 0.<o:p></o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal">$Conf{BackupZeroFilesIsFatal} =3D '1';<o:p></o:p></p= > <p class=3D"MsoNormal"><o:p> </o:p></p> <p class=3D"MsoNormal">####################################################= #######################<o:p></o:p></p> <p class=3D"MsoNormal"># How to backup a client<o:p></o:p></p> <p class=3D"MsoNormal"># (can be overridden in the per-PC config.pl)<o:p></= o:p></p> <p class=3D"MsoNormal">####################################################= #######################<o:p></o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal"># What transport method to use to backup each host.&= nbsp; If you have<o:p></o:p></p> <p class=3D"MsoNormal"># a mixed set of WinXX and linux/unix hosts you will= need to override<o:p></o:p></p> <p class=3D"MsoNormal"># this in the per-PC config.pl.<o:p></o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal"># The valid values are:<o:p></o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal"># - 'smb': backu= p and restore via smbclient and the SMB protocol.<o:p></o:p></p> <p class=3D"MsoNormal"># &nb= sp; Easiest choice for WinXX.<o:p></o:p= ></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal"># - 'rsync': backup and rest= ore via rsync (via rsh or ssh).<o:p></o:p></p> <p class=3D"MsoNormal"># &nb= sp; Best choice for linux/unix. G= ood choice also for WinXX.<o:p></o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal"># - 'rsyncd': backup and restore v= ia rsync daemon on the client.<o:p></o:p></p> <p class=3D"MsoNormal"># &nb= sp; Best choice for linux/unix if you h= ave rsyncd running on<o:p></o:p></p> <p class=3D"MsoNormal"># &nb= sp; the client. Good choice also = for WinXX.<o:p></o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal"># - 'tar': backup and = restore via tar, tar over ssh, rsh or nfs.<o:p></o:p></p> <p class=3D"MsoNormal"># &nb= sp; Good choice for linux/unix.<o:p></o:p></p= > <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal"># - 'archive': host is a special archive= host. Backups are not done.<o:p></o:p></p> <p class=3D"MsoNormal"># &nb= sp; An archive host is used to archive = other host's backups<o:p></o:p></p> <p class=3D"MsoNormal"># &nb= sp; to permanent media, such as tape, C= DR or DVD.<o:p></o:p></p> <p class=3D"MsoNormal"># &nb= sp; <o:p></o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal">$Conf{XferMethod} =3D 'rsync';<o:p></o:p></p> <p class=3D"MsoNormal"><o:p> </o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal"># Level of verbosity in Xfer log files. 0 mean= s be quiet, 1 will give<o:p></o:p></p> <p class=3D"MsoNormal"># will give one line per file, 2 will also show skip= ped files on<o:p></o:p></p> <p class=3D"MsoNormal"># incrementals, higher values give more output.<o:p>= </o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal">$Conf{XferLogLevel} =3D 1;<o:p></o:p></p> <p class=3D"MsoNormal"><o:p> </o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal"># Filename charset encoding on the client. Bac= kupPC uses utf8<o:p></o:p></p> <p class=3D"MsoNormal"># on the server for filename encoding. If this= is empty, then<o:p></o:p></p> <p class=3D"MsoNormal"># utf8 is assumed and client filenames will not be m= odified.<o:p></o:p></p> <p class=3D"MsoNormal"># If set to a different encoding then filenames will= converted<o:p></o:p></p> <p class=3D"MsoNormal"># to/from utf8 automatically during backup and resto= re.<o:p></o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal"># If the file names displayed in the browser (eg: ac= cents or special<o:p></o:p></p> <p class=3D"MsoNormal"># characters) don't look right then it is likely you= haven't set<o:p></o:p></p> <p class=3D"MsoNormal"># $Conf{ClientCharset} correctly.<o:p></o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal"># If you are using smbclient on a WinXX machine, smb= client will convert<o:p></o:p></p> <p class=3D"MsoNormal"># to the "unix charset" setting in smb.con= f. The default is utf8,<o:p></o:p></p> <p class=3D"MsoNormal"># in which case leave $Conf{ClientCharset} empty sin= ce smbclient does<o:p></o:p></p> <p class=3D"MsoNormal"># the right conversion.<o:p></o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal"># If you are using rsync on a WinXX machine then it = does no conversion.<o:p></o:p></p> <p class=3D"MsoNormal"># A typical WinXX encoding for latin1/western europe= is 'cp1252',<o:p></o:p></p> <p class=3D"MsoNormal"># so in this case set $Conf{ClientCharset} to 'cp125= 2'.<o:p></o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal"># On a linux or unix client, run "locale charma= p" to see the client's<o:p></o:p></p> <p class=3D"MsoNormal"># charset. Set $Conf{ClientCharset} to this va= lue. A typical value<o:p></o:p></p> <p class=3D"MsoNormal"># for english/US is 'ISO-8859-1'.<o:p></o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal"># Do "perldoc Encode::Supported" to see th= e list of possible charset<o:p></o:p></p> <p class=3D"MsoNormal"># values. The FAQ at http://www.cl.cam.ac.uk/~= mgk25/unicode.html<o:p></o:p></p> <p class=3D"MsoNormal"># is excellent, and http://czyborra.com/charsets/iso= 8859.html<o:p></o:p></p> <p class=3D"MsoNormal"># provides more information on the iso-8859 charsets= .<o:p></o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal">$Conf{ClientCharset} =3D '';<o:p></o:p></p> <p class=3D"MsoNormal"><o:p> </o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal"># Prior to 3.x no charset conversion was done by Bac= kupPC. Backups were<o:p></o:p></p> <p class=3D"MsoNormal"># stored in what ever charset the XferMethod provide= d - typically utf8<o:p></o:p></p> <p class=3D"MsoNormal"># for smbclient and the client's locale settings for= rsync and tar (eg:<o:p></o:p></p> <p class=3D"MsoNormal"># cp1252 for rsync on WinXX and perhaps iso-8859-1 w= ith rsync on linux).<o:p></o:p></p> <p class=3D"MsoNormal"># This setting tells BackupPC the charset that was u= sed to store file<o:p></o:p></p> <p class=3D"MsoNormal"># names in old backups taken with BackupPC 2.x, so t= hat non-ascii file<o:p></o:p></p> <p class=3D"MsoNormal"># names in old backups can be viewed and restored.<o= :p></o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal">$Conf{ClientCharsetLegacy} =3D 'iso-8859-1';<o:p></o= :p></p> <p class=3D"MsoNormal"><o:p> </o:p></p> <p class=3D"MsoNormal">####################################################= #######################<o:p></o:p></p> <p class=3D"MsoNormal"># Samba Configuration<o:p></o:p></p> <p class=3D"MsoNormal"># (can be overwritten in the per-PC log file)<o:p></= o:p></p> <p class=3D"MsoNormal">####################################################= #######################<o:p></o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal"># Name of the host share that is backed up when usin= g SMB. This can be a<o:p></o:p></p> <p class=3D"MsoNormal"># string or an array of strings if there are multipl= e shares per host.<o:p></o:p></p> <p class=3D"MsoNormal"># Examples:<o:p></o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal"># $Conf{SmbShareName} =3D 'c'; &nbs= p; # backup 'c' share<o:p></o:p><= /p> <p class=3D"MsoNormal"># $Conf{SmbShareName} =3D ['c', 'd'];&nb= sp; # backup 'c' and 'd' shares<o:p></o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal"># This setting only matters if $Conf{XferMethod} =3D= 'smb'.<o:p></o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal">$Conf{SmbShareName} =3D [<o:p></o:p></p> <p class=3D"MsoNormal"> 'C$'<o:p></o:p></p> <p class=3D"MsoNormal">];<o:p></o:p></p> <p class=3D"MsoNormal"><o:p> </o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal"># Smbclient share user name. This is passed to= smbclient's -U argument.<o:p></o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal"># This setting only matters if $Conf{XferMethod} =3D= 'smb'.<o:p></o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal">$Conf{SmbShareUserName} =3D '';<o:p></o:p></p> <p class=3D"MsoNormal"><o:p> </o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal"># Smbclient share password. This is passed to = smbclient via its PASSWD<o:p></o:p></p> <p class=3D"MsoNormal"># environment variable. There are several ways= you can tell BackupPC<o:p></o:p></p> <p class=3D"MsoNormal"># the smb share password. In each case you sho= uld be very careful about<o:p></o:p></p> <p class=3D"MsoNormal"># security. If you put the password here, make= sure that this file is<o:p></o:p></p> <p class=3D"MsoNormal"># not readable by regular users! See the "= ;Setting up config.pl" section<o:p></o:p></p> <p class=3D"MsoNormal"># in the documentation for more information.<o:p></o= :p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal"># This setting only matters if $Conf{XferMethod} =3D= 'smb'.<o:p></o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal">$Conf{SmbSharePasswd} =3D '';<o:p></o:p></p> <p class=3D"MsoNormal"><o:p> </o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal"># Full path for smbclient. Security caution: normal = users should not<o:p></o:p></p> <p class=3D"MsoNormal"># allowed to write to this file or directory.<o:p></= o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal"># smbclient is from the Samba distribution. smbclien= t is used to<o:p></o:p></p> <p class=3D"MsoNormal"># actually extract the incremental or full dump of t= he share filesystem<o:p></o:p></p> <p class=3D"MsoNormal"># from the PC.<o:p></o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal"># This setting only matters if $Conf{XferMethod} =3D= 'smb'.<o:p></o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal">$Conf{SmbClientPath} =3D '/usr/bin/smbclient';<o:p><= /o:p></p> <p class=3D"MsoNormal"><o:p> </o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal"># Command to run smbclient for a full dump.<o:p></o:= p></p> <p class=3D"MsoNormal"># This setting only matters if $Conf{XferMethod} =3D= 'smb'.<o:p></o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal"># The following variables are substituted at run-tim= e:<o:p></o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal"># $smbClientPath same = as $Conf{SmbClientPath}<o:p></o:p></p> <p class=3D"MsoNormal"># $host &nb= sp; host to backup/restore<o:p></o:p></= p> <p class=3D"MsoNormal"># $hostIP &= nbsp; host IP address<o:p></o:p></p> <p class=3D"MsoNormal"># $shareName &nbs= p; share name<o:p></o:p></p> <p class=3D"MsoNormal"># $userName  = ; user name<o:p></o:p></p> <p class=3D"MsoNormal"># $fileList  = ; list of files to backup (based on exclude/include)<o:p>= </o:p></p> <p class=3D"MsoNormal"># $I_option  = ; optional -I option to smbclient<o:p></o:p></p> <p class=3D"MsoNormal"># $X_option  = ; exclude option (if $fileList is an exclude list)<o:p></= o:p></p> <p class=3D"MsoNormal"># $timeStampFile start= time for incremental dump<o:p></o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal"># Note: all Cmds are executed directly without a she= ll, so the prog name<o:p></o:p></p> <p class=3D"MsoNormal"># needs to be a full path and you can't include shel= l syntax like<o:p></o:p></p> <p class=3D"MsoNormal"># redirection and pipes; put that in a script if you= need it.<o:p></o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal">$Conf{SmbClientFullCmd} =3D '$smbClientPath \\\\$hos= t\\$shareName $I_option -U $userName -E -d 1 -c tarmode\\ full -Tc$X_option= - $fileList';<o:p></o:p></p> <p class=3D"MsoNormal"><o:p> </o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal"># Command to run smbclient for an incremental dump.<= o:p></o:p></p> <p class=3D"MsoNormal"># This setting only matters if $Conf{XferMethod} =3D= 'smb'.<o:p></o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal"># Same variable substitutions are applied as $Conf{S= mbClientFullCmd}.<o:p></o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal"># Note: all Cmds are executed directly without a she= ll, so the prog name<o:p></o:p></p> <p class=3D"MsoNormal"># needs to be a full path and you can't include shel= l syntax like<o:p></o:p></p> <p class=3D"MsoNormal"># redirection and pipes; put that in a script if you= need it.<o:p></o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal">$Conf{SmbClientIncrCmd} =3D '$smbClientPath \\\\$hos= t\\$shareName $I_option -U $userName -E -d 1 -c tarmode\\ full -TcN$X_optio= n $timeStampFile - $fileList';<o:p></o:p></p> <p class=3D"MsoNormal"><o:p> </o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal"># Command to run smbclient for a restore.<o:p></o:p>= </p> <p class=3D"MsoNormal"># This setting only matters if $Conf{XferMethod} =3D= 'smb'.<o:p></o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal"># Same variable substitutions are applied as $Conf{S= mbClientFullCmd}.<o:p></o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal"># If your smb share is read-only then direct restore= s will fail.<o:p></o:p></p> <p class=3D"MsoNormal"># You should set $Conf{SmbClientRestoreCmd} to undef= and the<o:p></o:p></p> <p class=3D"MsoNormal"># corresponding CGI restore option will be removed.<= o:p></o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal"># Note: all Cmds are executed directly without a she= ll, so the prog name<o:p></o:p></p> <p class=3D"MsoNormal"># needs to be a full path and you can't include shel= l syntax like<o:p></o:p></p> <p class=3D"MsoNormal"># redirection and pipes; put that in a script if you= need it.<o:p></o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal">$Conf{SmbClientRestoreCmd} =3D '$smbClientPath \\\\$= host\\$shareName $I_option -U $userName -E -d 1 -c tarmode\\ full -Tx -';<o= :p></o:p></p> <p class=3D"MsoNormal"><o:p> </o:p></p> <p class=3D"MsoNormal">####################################################= #######################<o:p></o:p></p> <p class=3D"MsoNormal"># Tar Configuration<o:p></o:p></p> <p class=3D"MsoNormal"># (can be overwritten in the per-PC log file)<o:p></= o:p></p> <p class=3D"MsoNormal">####################################################= #######################<o:p></o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal"># Which host directories to backup when using tar tr= ansport. This can be a<o:p></o:p></p> <p class=3D"MsoNormal"># string or an array of strings if there are multipl= e directories to<o:p></o:p></p> <p class=3D"MsoNormal"># backup per host. Examples:<o:p></o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal"># $Conf{TarShareName} =3D '/'; &nbs= p; &= nbsp; &nbs= p; # backup everything<o:p></o:p>= </p> <p class=3D"MsoNormal"># $Conf{TarShareName} =3D '/home'; = &nb= sp; # only backup /home<o:p= ></o:p></p> <p class=3D"MsoNormal"># $Conf{TarShareName} =3D ['/home', '/sr= c']; # backup /home and /sr= c<o:p></o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal"># The fact this parameter is called 'TarShareName' i= s for historical<o:p></o:p></p> <p class=3D"MsoNormal"># consistency with the Smb transport options. = You can use any valid<o:p></o:p></p> <p class=3D"MsoNormal"># directory on the client: there is no need for it t= o correspond to<o:p></o:p></p> <p class=3D"MsoNormal"># any Smb share or device mount point.<o:p></o:p></p= > <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal"># Note also that you can also use $Conf{BackupFilesO= nly} to specify<o:p></o:p></p> <p class=3D"MsoNormal"># a specific list of directories to backup. It= 's more efficient to<o:p></o:p></p> <p class=3D"MsoNormal"># use this option instead of $Conf{TarShareName} sin= ce a new tar is<o:p></o:p></p> <p class=3D"MsoNormal"># run for each entry in $Conf{TarShareName}.<o:p></o= :p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal"># On the other hand, if you add --one-file-system to= $Conf{TarClientCmd}<o:p></o:p></p> <p class=3D"MsoNormal"># you can backup each file system separately, which = makes restoring one<o:p></o:p></p> <p class=3D"MsoNormal"># bad file system easier. In this case you wou= ld list all of the mount<o:p></o:p></p> <p class=3D"MsoNormal"># points here, since you can't get the same result w= ith<o:p></o:p></p> <p class=3D"MsoNormal"># $Conf{BackupFilesOnly}:<o:p></o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal"># $Conf{TarShareName} =3D ['= /', '/var', '/data', '/boot'];<o:p></o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal"># This setting only matters if $Conf{XferMethod} =3D= 'tar'.<o:p></o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal">$Conf{TarShareName} =3D [<o:p></o:p></p> <p class=3D"MsoNormal"> '/'<o:p></o:p></p> <p class=3D"MsoNormal">];<o:p></o:p></p> <p class=3D"MsoNormal"><o:p> </o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal"># Command to run tar on the client. GNU tar is= required. You will<o:p></o:p></p> <p class=3D"MsoNormal"># need to fill in the correct paths for ssh2 on the = local host (server)<o:p></o:p></p> <p class=3D"MsoNormal"># and GNU tar on the client. Security caution:= normal users should not<o:p></o:p></p> <p class=3D"MsoNormal"># allowed to write to these executable files or dire= ctories.<o:p></o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal"># $Conf{TarClientCmd} is appended with with either $= Conf{TarFullArgs} or<o:p></o:p></p> <p class=3D"MsoNormal"># $Conf{TarIncrArgs} to create the final command tha= t is run.<o:p></o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal"># See the documentation for more information about s= etting up ssh2 keys.<o:p></o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal"># If you plan to use NFS then tar just runs locally = and ssh2 is not needed.<o:p></o:p></p> <p class=3D"MsoNormal"># For example, assuming the client filesystem is mou= nted below /mnt/hostName,<o:p></o:p></p> <p class=3D"MsoNormal"># you could use something like:<o:p></o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal"># $Conf{TarClientCmd} =3D '$tarPat= h -c -v -f - -C /mnt/$host/$shareName'<o:p></o:p></p> <p class=3D"MsoNormal"># &nb= sp; = . ' --totals';<o:p></o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal"># In the case of NFS or rsh you need to make sure Ba= ckupPC's privileges<o:p></o:p></p> <p class=3D"MsoNormal"># are sufficient to read all the files you want to b= ackup. Also, you<o:p></o:p></p> <p class=3D"MsoNormal"># will probably want to add "/proc" to $Co= nf{BackupFilesExclude}.<o:p></o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal"># The following variables are substituted at run-tim= e:<o:p></o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal"># $host &nb= sp; host name<o:p></o:p></p> <p class=3D"MsoNormal"># $hostIP = host's IP address<o:p></o:p></p> <p class=3D"MsoNormal"># $incrDate newer-than= date for incremental backups<o:p></o:p></p> <p class=3D"MsoNormal"># $shareName share name to b= ackup (ie: top-level directory path)<o:p></o:p></p> <p class=3D"MsoNormal"># $fileList specific f= iles to backup or exclude<o:p></o:p></p> <p class=3D"MsoNormal"># $tarPath same = as $Conf{TarClientPath}<o:p></o:p></p> <p class=3D"MsoNormal"># $sshPath same = as $Conf{SshPath}<o:p></o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal"># If a variable is followed by a "+" i= t is shell escaped. This is<o:p></o:p></p> <p class=3D"MsoNormal"># necessary for the command part of ssh or rsh, sinc= e it ends up<o:p></o:p></p> <p class=3D"MsoNormal"># getting passed through the shell.<o:p></o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal"># This setting only matters if $Conf{XferMethod} =3D= 'tar'.<o:p></o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal"># Note: all Cmds are executed directly without a she= ll, so the prog name<o:p></o:p></p> <p class=3D"MsoNormal"># needs to be a full path and you can't include shel= l syntax like<o:p></o:p></p> <p class=3D"MsoNormal"># redirection and pipes; put that in a script if you= need it.<o:p></o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal">$Conf{TarClientCmd} =3D '$sshPath -q -x -n -l root $= host env LC_ALL=3DC $tarPath -c -v -f - -C $shareName+ --totals';<o:p><= /o:p></p> <p class=3D"MsoNormal"><o:p> </o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal"># Extra tar arguments for full backups. Severa= l variables are substituted at<o:p></o:p></p> <p class=3D"MsoNormal"># run-time. See $Conf{TarClientCmd} for the li= st of variable substitutions.<o:p></o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal"># If you are running tar locally (ie: without rsh or= ssh) then remove the<o:p></o:p></p> <p class=3D"MsoNormal"># "+" so that the argument is no longe= r shell escaped.<o:p></o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal"># This setting only matters if $Conf{XferMethod} =3D= 'tar'.<o:p></o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal">$Conf{TarFullArgs} =3D '$fileList+';<o:p></o:p><= /p> <p class=3D"MsoNormal"><o:p> </o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal"># Extra tar arguments for incr backups. Severa= l variables are substituted at<o:p></o:p></p> <p class=3D"MsoNormal"># run-time. See $Conf{TarClientCmd} for the li= st of variable substitutions.<o:p></o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal"># Note that GNU tar has several methods for specifyi= ng incremental backups,<o:p></o:p></p> <p class=3D"MsoNormal"># including:<o:p></o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal"># --newer-mtime $incrDate+<o:p></o:p= ></p> <p class=3D"MsoNormal"># &nb= sp; This causes a file to be included if the modification time is<o:p></o:p= ></p> <p class=3D"MsoNormal"># &nb= sp; later than $incrDate (meaning its contents might have changed).<o:p></o= :p></p> <p class=3D"MsoNormal"># &nb= sp; But changes in the ownership or modes will not qualify the<o:p></o:p></= p> <p class=3D"MsoNormal"># &nb= sp; file to be included in an incremental.<o:p></o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal"># --newer=3D$incrDate+<o:p></o:p></p= > <p class=3D"MsoNormal"># &nb= sp; This causes the file to be included if any attribute of the<o:p></o:p><= /p> <p class=3D"MsoNormal"># &nb= sp; file is later than $incrDate, meaning either attributes or<o:p></o:p></= p> <p class=3D"MsoNormal"># &nb= sp; the modification time. This is the default method. Do<o:p><= /o:p></p> <p class=3D"MsoNormal"># &nb= sp; not use --atime-preserve in $Conf{TarClientCmd} above,<o:p></o:p></p> <p class=3D"MsoNormal"># &nb= sp; otherwise resetting the atime (access time) counts as an<o:p></o:p></p> <p class=3D"MsoNormal"># &nb= sp; attribute change, meaning the file will always be included<o:p></o:p></= p> <p class=3D"MsoNormal"># &nb= sp; in each new incremental dump.<o:p></o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal"># If you are running tar locally (ie: without rsh or= ssh) then remove the<o:p></o:p></p> <p class=3D"MsoNormal"># "+" so that the argument is no longe= r shell escaped.<o:p></o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal"># This setting only matters if $Conf{XferMethod} =3D= 'tar'.<o:p></o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal">$Conf{TarIncrArgs} =3D '--newer=3D$incrDate+ $fi= leList+';<o:p></o:p></p> <p class=3D"MsoNormal"><o:p> </o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal"># Full command to run tar for restore on the client.= GNU tar is required.<o:p></o:p></p> <p class=3D"MsoNormal"># This can be the same as $Conf{TarClientCmd}, with = tar's -c replaced by -x<o:p></o:p></p> <p class=3D"MsoNormal"># and ssh's -n removed.<o:p></o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal"># See $Conf{TarClientCmd} for full details.<o:p></o:= p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal"># This setting only matters if $Conf{XferMethod} =3D= "tar".<o:p></o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal"># If you want to disable direct restores using tar, = you should set<o:p></o:p></p> <p class=3D"MsoNormal"># $Conf{TarClientRestoreCmd} to undef and the corres= ponding CGI<o:p></o:p></p> <p class=3D"MsoNormal"># restore option will be removed.<o:p></o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal"># Note: all Cmds are executed directly without a she= ll, so the prog name<o:p></o:p></p> <p class=3D"MsoNormal"># needs to be a full path and you can't include shel= l syntax like<o:p></o:p></p> <p class=3D"MsoNormal"># redirection and pipes; put that in a script if you= need it.<o:p></o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal">$Conf{TarClientRestoreCmd} =3D '$sshPath -q -x -l ro= ot $host env LC_ALL=3DC $tarPath -x -p --numeric-owner --same-owner -v -f -= -C $shareName+';<o:p></o:p></p> <p class=3D"MsoNormal"><o:p> </o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal"># Full path for tar on the client. Security caution:= normal users should not<o:p></o:p></p> <p class=3D"MsoNormal"># allowed to write to this file or directory.<o:p></= o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal"># This setting only matters if $Conf{XferMethod} =3D= 'tar'.<o:p></o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal">$Conf{TarClientPath} =3D '/bin/tar';<o:p></o:p></p> <p class=3D"MsoNormal"><o:p> </o:p></p> <p class=3D"MsoNormal">####################################################= #######################<o:p></o:p></p> <p class=3D"MsoNormal"># Rsync/Rsyncd Configuration<o:p></o:p></p> <p class=3D"MsoNormal"># (can be overwritten in the per-PC log file)<o:p></= o:p></p> <p class=3D"MsoNormal">####################################################= #######################<o:p></o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal"># Path to rsync executable on the client<o:p></o:p><= /p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal">$Conf{RsyncClientPath} =3D '/usr/bin/rsync';<o:p></o= :p></p> <p class=3D"MsoNormal"><o:p> </o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal"># Full command to run rsync on the client machine.&n= bsp; The following variables<o:p></o:p></p> <p class=3D"MsoNormal"># are substituted at run-time:<o:p></o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal"># $host&nb= sp; host name being b= acked up<o:p></o:p></p> <p class=3D"MsoNormal"># $hostIP&= nbsp; host's IP address<o:p></o:p= ></p> <p class=3D"MsoNormal"># $shareNa= me share name to backup (ie: top-level direct= ory path)<o:p></o:p></p> <p class=3D"MsoNormal"># $rsyncPa= th same as $Conf{RsyncClientPath}<o:p></o:p><= /p> <p class=3D"MsoNormal"># $sshPath= same as $Conf{SshPath}<o:p></o:p= ></p> <p class=3D"MsoNormal"># $argList= argument list, built from $Conf{= RsyncArgs},<o:p></o:p></p> <p class=3D"MsoNormal"># &nb= sp; = $shareName, $Conf{BackupFilesExclude} and<o:p></o:p></p> <p class=3D"MsoNormal"># &nb= sp; = $Conf{BackupFilesOnly}<o:p></o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal"># This setting only matters if $Conf{XferMethod} =3D= 'rsync'.<o:p></o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal">$Conf{RsyncClientCmd} =3D '$sshPath -q -x -l root $h= ost $rsyncPath $argList+';<o:p></o:p></p> <p class=3D"MsoNormal"><o:p> </o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal"># Full command to run rsync for restore on the clien= t. The following<o:p></o:p></p> <p class=3D"MsoNormal"># variables are substituted at run-time:<o:p></o:p><= /p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal"># $host&nb= sp; host name being b= acked up<o:p></o:p></p> <p class=3D"MsoNormal"># $hostIP&= nbsp; host's IP address<o:p></o:p= ></p> <p class=3D"MsoNormal"># $shareNa= me share name to backup (ie: top-level direct= ory path)<o:p></o:p></p> <p class=3D"MsoNormal"># $rsyncPa= th same as $Conf{RsyncClientPath}<o:p></o:p><= /p> <p class=3D"MsoNormal"># $sshPath= same as $Conf{SshPath}<o:p></o:p= ></p> <p class=3D"MsoNormal"># $argList= argument list, built from $Conf{= RsyncArgs},<o:p></o:p></p> <p class=3D"MsoNormal"># &nb= sp; = $shareName, $Conf{BackupFilesExclude} and<o:p></o:p></p> <p class=3D"MsoNormal"># &nb= sp; = $Conf{BackupFilesOnly}<o:p></o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal"># This setting only matters if $Conf{XferMethod} =3D= 'rsync'.<o:p></o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal"># Note: all Cmds are executed directly without a she= ll, so the prog name<o:p></o:p></p> <p class=3D"MsoNormal"># needs to be a full path and you can't include shel= l syntax like<o:p></o:p></p> <p class=3D"MsoNormal"># redirection and pipes; put that in a script if you= need it.<o:p></o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal">$Conf{RsyncClientRestoreCmd} =3D '$sshPath -q -x -l = root $host $rsyncPath $argList+';<o:p></o:p></p> <p class=3D"MsoNormal"><o:p> </o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal"># Share name to backup. For $Conf{XferMethod} = =3D "rsync" this should<o:p></o:p></p> <p class=3D"MsoNormal"># be a file system path, eg '/' or '/home'.<o:p></o:= p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal"># For $Conf{XferMethod} =3D "rsyncd" this = should be the name of the module<o:p></o:p></p> <p class=3D"MsoNormal"># to backup (ie: the name from /etc/rsynd.conf).<o:p= ></o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal"># This can also be a list of multiple file system pa= ths or modules.<o:p></o:p></p> <p class=3D"MsoNormal"># For example, by adding --one-file-system to $Conf{= RsyncArgs} you<o:p></o:p></p> <p class=3D"MsoNormal"># can backup each file system separately, which make= s restoring one<o:p></o:p></p> <p class=3D"MsoNormal"># bad file system easier. In this case you wou= ld list all of the mount<o:p></o:p></p> <p class=3D"MsoNormal"># points:<o:p></o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal"># $Conf{RsyncShareName} =3D = ['/', '/var', '/data', '/boot'];<o:p></o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal">$Conf{RsyncShareName} =3D [<o:p></o:p></p> <p class=3D"MsoNormal"> '/'<o:p></o:p></p> <p class=3D"MsoNormal">];<o:p></o:p></p> <p class=3D"MsoNormal"><o:p> </o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal"># Rsync daemon port on the client, for $Conf{XferMet= hod} =3D "rsyncd".<o:p></o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal">$Conf{RsyncdClientPort} =3D 873;<o:p></o:p></p> <p class=3D"MsoNormal"><o:p> </o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal"># Rsync daemon user name on client, for $Conf{XferMe= thod} =3D "rsyncd".<o:p></o:p></p> <p class=3D"MsoNormal"># The user name and password are stored on the clien= t in whatever file<o:p></o:p></p> <p class=3D"MsoNormal"># the "secrets file" parameter in rsyncd.c= onf points to<o:p></o:p></p> <p class=3D"MsoNormal"># (eg: /etc/rsyncd.secrets).<o:p></o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal">$Conf{RsyncdUserName} =3D '';<o:p></o:p></p> <p class=3D"MsoNormal"><o:p> </o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal"># Rsync daemon user name on client, for $Conf{XferMe= thod} =3D "rsyncd".<o:p></o:p></p> <p class=3D"MsoNormal"># The user name and password are stored on the clien= t in whatever file<o:p></o:p></p> <p class=3D"MsoNormal"># the "secrets file" parameter in rsyncd.c= onf points to<o:p></o:p></p> <p class=3D"MsoNormal"># (eg: /etc/rsyncd.secrets).<o:p></o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal">$Conf{RsyncdPasswd} =3D '';<o:p></o:p></p> <p class=3D"MsoNormal"><o:p> </o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal"># Whether authentication is mandatory when connectin= g to the client's<o:p></o:p></p> <p class=3D"MsoNormal"># rsyncd. By default this is on, ensuring that= BackupPC will refuse to<o:p></o:p></p> <p class=3D"MsoNormal"># connect to an rsyncd on the client that is not pas= sword protected.<o:p></o:p></p> <p class=3D"MsoNormal"># Turn off at your own risk.<o:p></o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal">$Conf{RsyncdAuthRequired} =3D '1';<o:p></o:p></p> <p class=3D"MsoNormal"><o:p> </o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal"># When rsync checksum caching is enabled (by adding = the<o:p></o:p></p> <p class=3D"MsoNormal"># --checksum-seed=3D32761 option to $Conf{RsyncArgs}= ), the cached<o:p></o:p></p> <p class=3D"MsoNormal"># checksums can be occasionally verified to make sur= e the file<o:p></o:p></p> <p class=3D"MsoNormal"># contents matches the cached checksums. This = is to avoid the<o:p></o:p></p> <p class=3D"MsoNormal"># risk that disk problems might cause the pool file = contents to<o:p></o:p></p> <p class=3D"MsoNormal"># get corrupted, but the cached checksums would make= BackupPC<o:p></o:p></p> <p class=3D"MsoNormal"># think that the file still matches the client.<o:p>= </o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal"># This setting is the probability (0 means never and= 1 means always)<o:p></o:p></p> <p class=3D"MsoNormal"># that a file will be rechecked. Setting it to= 0 means the checksums<o:p></o:p></p> <p class=3D"MsoNormal"># will not be rechecked (unless there is a phase 0 f= ailure). Setting<o:p></o:p></p> <p class=3D"MsoNormal"># it to 1 (ie: 100%) means all files will be checked= , but that is<o:p></o:p></p> <p class=3D"MsoNormal"># not a desirable setting since you are better off s= imply turning<o:p></o:p></p> <p class=3D"MsoNormal"># caching off (ie: remove the --checksum-seed option= ).<o:p></o:p></p> <p class=3D"MsoNormal"># <o:p></o:p></p> <p class=3D"MsoNormal"># The default of 0.01 means 1% (on average) of the f= iles during a full<o:p></o:p></p> <p class=3D"MsoNormal"># backup will have their cached checksum re-checked.= <o:p></o:p></p> <p class=3D"MsoNormal"># <o:p></o:p></p> <p class=3D"MsoNormal"># This setting has no effect unless checksum caching= is turned on.<o:p></o:p></p> <p class=3D"MsoNormal"># <o:p></o:p></p> <p class=3D"MsoNormal">$Conf{RsyncCsumCacheVerifyProb} =3D '0.01';<o:p></o:= p></p> <p class=3D"MsoNormal"><o:p> </o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal"># Arguments to rsync for backup. Do not edit t= he first set unless you<o:p></o:p></p> <p class=3D"MsoNormal"># have a thorough understanding of how File::RsyncP = works.<o:p></o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal">$Conf{RsyncArgs} =3D [<o:p></o:p></p> <p class=3D"MsoNormal"> '--numeric-ids',<o:p></o:p></p> <p class=3D"MsoNormal"> '--perms',<o:p></o:p></p> <p class=3D"MsoNormal"> '--owner',<o:p></o:p></p> <p class=3D"MsoNormal"> '--group',<o:p></o:p></p> <p class=3D"MsoNormal"> '-D',<o:p></o:p></p> <p class=3D"MsoNormal"> '--links',<o:p></o:p></p> <p class=3D"MsoNormal"> '--hard-links',<o:p></o:p></p> <p class=3D"MsoNormal"> '--times',<o:p></o:p></p> <p class=3D"MsoNormal"> '--block-size=3D2048',<o:p></o:p></p> <p class=3D"MsoNormal"> '--recursive'<o:p></o:p></p> <p class=3D"MsoNormal">];<o:p></o:p></p> <p class=3D"MsoNormal"><o:p> </o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal"># Additional arguments added to RsyncArgs. Thi= s can be used in<o:p></o:p></p> <p class=3D"MsoNormal"># conbination with $Conf{RsyncArgs} to allow customi= zation of<o:p></o:p></p> <p class=3D"MsoNormal"># the rsync arguments on a part-client basis. = The standard<o:p></o:p></p> <p class=3D"MsoNormal"># arguments go in $Conf{RsyncArgs} and $Conf{RsyncAr= gsExtra}<o:p></o:p></p> <p class=3D"MsoNormal"># can be set on a per-client basis.<o:p></o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal"># Examples of additional arguments that should work = are --exclude/--include,<o:p></o:p></p> <p class=3D"MsoNormal"># eg:<o:p></o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal"># $Conf{RsyncArgsExtra} =3D = [<o:p></o:p></p> <p class=3D"MsoNormal"># &nb= sp; '--exclude', '/proc',<o:p></o:p></p> <p class=3D"MsoNormal"># &nb= sp; '--exclude', '*.tmp',<o:p></o:p></p> <p class=3D"MsoNormal"># ];<o:p></o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal"># Both $Conf{RsyncArgs} and $Conf{RsyncArgsExtra} ar= e subject<o:p></o:p></p> <p class=3D"MsoNormal"># to the following variable substitutions:<o:p></o:p= ></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal"># $client&= nbsp; client name being backed up<o:p></o:p><= /p> <p class=3D"MsoNormal"># $host&nb= sp; host name (could be different= from client name if<o:p></o:p></p> <p class=3D"MsoNormal"># &nb= sp; = $Conf{Cl= ientNameAlias} is set)<o:p></o:p></p> <p class=3D"MsoNormal"># $hostIP&= nbsp; IP address of host<o:p></o:p></p> <p class=3D"MsoNormal"># $confDir= configuration directory path<o:p></o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal"># This allows settings of the form:<o:p></o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal"># $Conf{RsyncArgsExtra} =3D = [<o:p></o:p></p> <p class=3D"MsoNormal"># &nb= sp; '--exclude-from=3D$confDir/pc/$host.exclude',<o:p></o= :p></p> <p class=3D"MsoNormal"># ];<o:p></o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal">$Conf{RsyncArgsExtra} =3D [<o:p></o:p></p> <p class=3D"MsoNormal"> '--one-file-system',<o:p></o:p></p> <p class=3D"MsoNormal"> ''<o:p></o:p></p> <p class=3D"MsoNormal">];<o:p></o:p></p> <p class=3D"MsoNormal"><o:p> </o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal"># Arguments to rsync for restore. Do not edit = the first set unless you<o:p></o:p></p> <p class=3D"MsoNormal"># have a thorough understanding of how File::RsyncP = works.<o:p></o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal"># If you want to disable direct restores using rsync= (eg: is the module<o:p></o:p></p> <p class=3D"MsoNormal"># is read-only), you should set $Conf{RsyncRestoreAr= gs} to undef and<o:p></o:p></p> <p class=3D"MsoNormal"># the corresponding CGI restore option will be remov= ed.<o:p></o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal"># $Conf{RsyncRestoreArgs} is subject to the followin= g variable<o:p></o:p></p> <p class=3D"MsoNormal"># substitutions:<o:p></o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal"># $client&= nbsp; client name being backed up<o:p></o:p><= /p> <p class=3D"MsoNormal"># $host&nb= sp; host name (could be different= from client name if<o:p></o:p></p> <p class=3D"MsoNormal"># &nb= sp; = $Conf{Cl= ientNameAlias} is set)<o:p></o:p></p> <p class=3D"MsoNormal"># $hostIP&= nbsp; IP address of host<o:p></o:p></p> <p class=3D"MsoNormal"># $confDir= configuration directory path<o:p></o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal"># Note: $Conf{RsyncArgsExtra} doesn't apply to $Conf= {RsyncRestoreArgs}.<o:p></o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal">$Conf{RsyncRestoreArgs} =3D [<o:p></o:p></p> <p class=3D"MsoNormal"> '--numeric-ids',<o:p></o:p></p> <p class=3D"MsoNormal"> '--perms',<o:p></o:p></p> <p class=3D"MsoNormal"> '--owner',<o:p></o:p></p> <p class=3D"MsoNormal"> '--group',<o:p></o:p></p> <p class=3D"MsoNormal"> '-D',<o:p></o:p></p> <p class=3D"MsoNormal"> '--links',<o:p></o:p></p> <p class=3D"MsoNormal"> '--hard-links',<o:p></o:p></p> <p class=3D"MsoNormal"> '--times',<o:p></o:p></p> <p class=3D"MsoNormal"> '--block-size=3D2048',<o:p></o:p></p> <p class=3D"MsoNormal"> '--relative',<o:p></o:p></p> <p class=3D"MsoNormal"> '--ignore-times',<o:p></o:p></p> <p class=3D"MsoNormal"> '--recursive'<o:p></o:p></p> <p class=3D"MsoNormal">];<o:p></o:p></p> <p class=3D"MsoNormal"><o:p> </o:p></p> <p class=3D"MsoNormal">####################################################= #######################<o:p></o:p></p> <p class=3D"MsoNormal"># FTP Configuration<o:p></o:p></p> <p class=3D"MsoNormal"># (can be overwritten in the per-PC log file)<o:p></= o:p></p> <p class=3D"MsoNormal">####################################################= ######################<o:p></o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal"># Which host directories to backup when using FTP.&n= bsp; This can be a<o:p></o:p></p> <p class=3D"MsoNormal"># string or an array of strings if there are multipl= e shares per host.<o:p></o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal"># This value must be specified in one of two ways: e= ither as a<o:p></o:p></p> <p class=3D"MsoNormal"># subdirectory of the 'share root' on the server, or= as the absolute<o:p></o:p></p> <p class=3D"MsoNormal"># path of the directory.<o:p></o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal"># In the following example, if the directory /home/u= sername is the<o:p></o:p></p> <p class=3D"MsoNormal"># root share of the ftp server with the given userna= me, the following<o:p></o:p></p> <p class=3D"MsoNormal"># two values will back up the same directory:<o:p></= o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal"># $Conf{FtpShareName} =3D 'www';&n= bsp;  = ; # www directory<o:p></o:p></p> <p class=3D"MsoNormal"># $Conf{FtpShareName} =3D '/home/u= sername/www'; # same directory<o:p></o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal"># Path resolution is not supported; i.e.; you may no= t have an ftp<o:p></o:p></p> <p class=3D"MsoNormal"># share path defined as '../otheruser' or '~/games'.= <o:p></o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal"># Multiple shares may also be specified, as wi= th other protocols:<o:p></o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal"># $Conf{FtpShareName} =3D [ 'www',= <o:p></o:p></p> <p class=3D"MsoNormal"># &nb= sp; = 'bin',<o:p></o:p></p> <p class=3D"MsoNormal"># &nb= sp; = 'config' ];<o:p></o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal"># Note also that you can also use $Conf{BackupFilesO= nly} to specify<o:p></o:p></p> <p class=3D"MsoNormal"># a specific list of directories to backup. It= 's more efficient to<o:p></o:p></p> <p class=3D"MsoNormal"># use this option instead of $Conf{FtpShareName} sin= ce a new tar is<o:p></o:p></p> <p class=3D"MsoNormal"># run for each entry in $Conf{FtpShareName}.<o:p></o= :p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal"># This setting only matters if $Conf{XferMethod} =3D= 'ftp'.<o:p></o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal">$Conf{FtpShareName} =3D [<o:p></o:p></p> <p class=3D"MsoNormal"> ''<o:p></o:p></p> <p class=3D"MsoNormal">];<o:p></o:p></p> <p class=3D"MsoNormal"><o:p> </o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal"># FTP user name. This is used to log into the = server.<o:p></o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal"># This setting is used only if $Conf{XferMethod} =3D= 'ftp'.<o:p></o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal">$Conf{FtpUserName} =3D '';<o:p></o:p></p> <p class=3D"MsoNormal"><o:p> </o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal"># FTP user password. This is used to log into = the server.<o:p></o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal"># This setting is used only if $Conf{XferMethod} =3D= 'ftp'.<o:p></o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal">$Conf{FtpPasswd} =3D '';<o:p></o:p></p> <p class=3D"MsoNormal"><o:p> </o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal"># Whether passive mode is used. The correct se= tting depends upon<o:p></o:p></p> <p class=3D"MsoNormal"># whether local or remote ports are accessible from = the other machine,<o:p></o:p></p> <p class=3D"MsoNormal"># which is affected by any firewall or routers betwe= en the FTP server<o:p></o:p></p> <p class=3D"MsoNormal"># on the client and the BackupPC server.<o:p></o:p><= /p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal"># This setting is used only if $Conf{XferMethod} =3D= 'ftp'.<o:p></o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal">$Conf{FtpPassive} =3D '1';<o:p></o:p></p> <p class=3D"MsoNormal"><o:p> </o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal"># Transfer block size. This sets the size of the amo= unts of data in<o:p></o:p></p> <p class=3D"MsoNormal"># each frame. While undefined, this value takes the = default value.<o:p></o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal"># This setting is used only if $Conf{XferMethod} =3D= 'ftp'.<o:p></o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal">$Conf{FtpBlockSize} =3D 10240;<o:p></o:p></p> <p class=3D"MsoNormal"><o:p> </o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal"># The port of the ftp server. If undefined, 21= is used.<o:p></o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal"># This setting is used only if $Conf{XferMethod} =3D= 'ftp'.<o:p></o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal">$Conf{FtpPort} =3D 21;<o:p></o:p></p> <p class=3D"MsoNormal"><o:p> </o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal"># Connection timeout for FTP. When undefined, = the default is 120 seconds.<o:p></o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal"># This setting is used only if $Conf{XferMethod} =3D= 'ftp'.<o:p></o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal">#$Conf{FtpTimeout} =3D 120;<o:p></o:p></p> <p class=3D"MsoNormal">$Conf{FtpTimeout} =3D 240;<o:p></o:p></p> <p class=3D"MsoNormal"><o:p> </o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal"># Behaviour when BackupPC encounters symlinks on the= FTP share.<o:p></o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal"># Symlinks cannot be restored via FTP, so the desire= d behaviour will<o:p></o:p></p> <p class=3D"MsoNormal"># be different depending on the setup of the share. = The default for<o:p></o:p></p> <p class=3D"MsoNormal"># this behavor is 1. Directory shares with mor= e complicated directory<o:p></o:p></p> <p class=3D"MsoNormal"># structures should consider other protocols.<o:p></= o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal">$Conf{FtpFollowSymlinks} =3D '0';<o:p></o:p></p> <p class=3D"MsoNormal"><o:p> </o:p></p> <p class=3D"MsoNormal">####################################################= #######################<o:p></o:p></p> <p class=3D"MsoNormal"># Archive Configuration<o:p></o:p></p> <p class=3D"MsoNormal"># (can be overwritten in the per-PC log file)<o:p></= o:p></p> <p class=3D"MsoNormal">####################################################= #######################<o:p></o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal"># Archive Destination<o:p></o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal"># The Destination of the archive<o:p></o:p></p> <p class=3D"MsoNormal"># e.g. /tmp for file archive or /dev/nst0 for device= archive<o:p></o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal">$Conf{ArchiveDest} =3D '/tmp';<o:p></o:p></p> <p class=3D"MsoNormal"><o:p> </o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal"># Archive Compression type<o:p></o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal"># The valid values are:<o:p></o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal"># - 'none': No Compression<o:p></o= :p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal"># - 'gzip': Medium Compression. Re= commended.<o:p></o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal"># - 'bzip2': High Compression but takes = longer.<o:p></o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal">$Conf{ArchiveComp} =3D 'gzip';<o:p></o:p></p> <p class=3D"MsoNormal"><o:p> </o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal"># Archive Parity Files<o:p></o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal"># The amount of Parity data to generate, as a percen= tage<o:p></o:p></p> <p class=3D"MsoNormal"># of the archive size.<o:p></o:p></p> <p class=3D"MsoNormal"># Uses the commandline par2 (par2cmdline) available = from<o:p></o:p></p> <p class=3D"MsoNormal"># http://parchive.sourceforge.net<o:p></o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal"># Only useful for file dumps.<o:p></o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal"># Set to 0 to disable this feature.<o:p></o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal">$Conf{ArchivePar} =3D '0';<o:p></o:p></p> <p class=3D"MsoNormal"><o:p> </o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal"># Archive Size Split<o:p></o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal"># Only for file archives. Splits the output into <o:= p></o:p></p> <p class=3D"MsoNormal"># the specified size * 1,000,000.<o:p></o:p></p> <p class=3D"MsoNormal"># e.g. to split into 650,000,000 bytes, specify 650 = below.<o:p></o:p></p> <p class=3D"MsoNormal"># <o:p></o:p></p> <p class=3D"MsoNormal"># If the value is 0, or if $Conf{ArchiveDest} is an = existing file or<o:p></o:p></p> <p class=3D"MsoNormal"># device (e.g. a streaming tape drive), this feature= is disabled.<o:p></o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal">$Conf{ArchiveSplit} =3D 0;<o:p></o:p></p> <p class=3D"MsoNormal"><o:p> </o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal"># Archive Command<o:p></o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal"># This is the command that is called to actually run= the archive process<o:p></o:p></p> <p class=3D"MsoNormal"># for each host. The following variables are s= ubstituted at run-time:<o:p></o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal"># $Installdir The inst= allation directory of BackupPC<o:p></o:p></p> <p class=3D"MsoNormal"># $tarCreatePath The path to BackupPC_ta= rCreate<o:p></o:p></p> <p class=3D"MsoNormal"># $splitpath The= path to the split program<o:p></o:p></p> <p class=3D"MsoNormal"># $parpath = The path to the par2 program<o:p></o:p></p> <p class=3D"MsoNormal"># $host &nb= sp; The host to archive<o:p></o:p></p> <p class=3D"MsoNormal"># $backupnumber The backup number = of the host to archive<o:p></o:p></p> <p class=3D"MsoNormal"># $compression The path to t= he compression program<o:p></o:p></p> <p class=3D"MsoNormal"># $compext = The extension assigned to the compression type<o:p></o:p></p> <p class=3D"MsoNormal"># $splitsize The= number of bytes to split archives into<o:p></o:p></p> <p class=3D"MsoNormal"># $archiveloc The loca= tion to put the archive<o:p></o:p></p> <p class=3D"MsoNormal"># $parfile = The amount of parity data to create (percentage)<o:p></o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal"># Note: all Cmds are executed directly without a she= ll, so the prog name<o:p></o:p></p> <p class=3D"MsoNormal"># needs to be a full path and you can't include shel= l syntax like<o:p></o:p></p> <p class=3D"MsoNormal"># redirection and pipes; put that in a script if you= need it.<o:p></o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal">$Conf{ArchiveClientCmd} =3D '$Installdir/bin/BackupP= C_archiveHost $tarCreatePath $splitpath $parpath $host $backupnumber $compr= ession $compext $splitsize $archiveloc $parfile *';<o:p></o:p></p> <p class=3D"MsoNormal"><o:p> </o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal"># Full path for ssh. Security caution: normal users = should not<o:p></o:p></p> <p class=3D"MsoNormal"># allowed to write to this file or directory.<o:p></= o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal">$Conf{SshPath} =3D '/usr/bin/ssh';<o:p></o:p></p> <p class=3D"MsoNormal"><o:p> </o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal"># Full path for nmblookup. Security caution: normal = users should not<o:p></o:p></p> <p class=3D"MsoNormal"># allowed to write to this file or directory.<o:p></= o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal"># nmblookup is from the Samba distribution. nmblooku= p is used to get the<o:p></o:p></p> <p class=3D"MsoNormal"># netbios name, necessary for DHCP hosts.<o:p></o:p>= </p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal">$Conf{NmbLookupPath} =3D '/usr/bin/nmblookup';<o:p><= /o:p></p> <p class=3D"MsoNormal"><o:p> </o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal"># NmbLookup command. Given an IP address, does= an nmblookup on that<o:p></o:p></p> <p class=3D"MsoNormal"># IP address. The following variables are subs= tituted at run-time:<o:p></o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal"># $nmbLookupPath = path to nmblookup ($Conf{NmbLookupPath})<o:p></o:p></p> <p class=3D"MsoNormal"># $host &nb= sp; IP address<o:p></o:p></= p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal"># This command is only used for DHCP hosts: given an= IP address, this<o:p></o:p></p> <p class=3D"MsoNormal"># command should try to find its NetBios name.<o:p><= /o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal"># Note: all Cmds are executed directly without a she= ll, so the prog name<o:p></o:p></p> <p class=3D"MsoNormal"># needs to be a full path and you can't include shel= l syntax like<o:p></o:p></p> <p class=3D"MsoNormal"># redirection and pipes; put that in a script if you= need it.<o:p></o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal">$Conf{NmbLookupCmd} =3D '$nmbLookupPath -A $host';<o= :p></o:p></p> <p class=3D"MsoNormal"><o:p> </o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal"># NmbLookup command. Given a netbios name, fin= ds that host by doing<o:p></o:p></p> <p class=3D"MsoNormal"># a NetBios lookup. Several variables are subs= tituted at run-time:<o:p></o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal"># $nmbLookupPath = path to nmblookup ($Conf{NmbLookupPath})<o:p></o:p></p> <p class=3D"MsoNormal"># $host &nb= sp; NetBios name<o:p></o:p>= </p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal"># In some cases you might need to change the broadca= st address, for<o:p></o:p></p> <p class=3D"MsoNormal"># example if nmblookup uses 192.168.255.255 by defau= lt and you find<o:p></o:p></p> <p class=3D"MsoNormal"># that doesn't work, try 192.168.1.255 (or your equi= valent class C<o:p></o:p></p> <p class=3D"MsoNormal"># address) using the -B option:<o:p></o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal"># $Conf{NmbLookupFindHostCmd} =3D = '$nmbLookupPath -B 192.168.1.255 $host';<o:p></o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal"># If you use a WINS server and your machines don't r= espond to<o:p></o:p></p> <p class=3D"MsoNormal"># multicast NetBios requests you can use this (repla= ce 1.2.3.4<o:p></o:p></p> <p class=3D"MsoNormal"># with the IP address of your WINS server):<o:p></o:= p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal"># $Conf{NmbLookupFindHostCmd} =3D = '$nmbLookupPath -R -U 1.2.3.4 $host';<o:p></o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal"># This is preferred over multicast since it minimize= s network traffic.<o:p></o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal"># Experiment manually for your site to see what form= of nmblookup command<o:p></o:p></p> <p class=3D"MsoNormal"># works.<o:p></o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal"># Note: all Cmds are executed directly without a she= ll, so the prog name<o:p></o:p></p> <p class=3D"MsoNormal"># needs to be a full path and you can't include shel= l syntax like<o:p></o:p></p> <p class=3D"MsoNormal"># redirection and pipes; put that in a script if you= need it.<o:p></o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal">$Conf{NmbLookupFindHostCmd} =3D '$nmbLookupPath $hos= t';<o:p></o:p></p> <p class=3D"MsoNormal"><o:p> </o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal"># For fixed IP address hosts, BackupPC_dump can also= verify the netbios<o:p></o:p></p> <p class=3D"MsoNormal"># name to ensure it matches the host name. An = error is generated if<o:p></o:p></p> <p class=3D"MsoNormal"># they do not match. Typically this flag is of= f. But if you are going<o:p></o:p></p> <p class=3D"MsoNormal"># to transition a bunch of machines from fixed host = addresses to DHCP,<o:p></o:p></p> <p class=3D"MsoNormal"># setting this flag is a great way to verify that th= e machines have<o:p></o:p></p> <p class=3D"MsoNormal"># their netbios name set correctly before turning on= DCHP.<o:p></o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal">$Conf{FixedIPNetBiosNameCheck} =3D '0';<o:p></o:p></= p> <p class=3D"MsoNormal"><o:p> </o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal"># Full path to the ping command. Security caut= ion: normal users<o:p></o:p></p> <p class=3D"MsoNormal"># should not be allowed to write to this file or dir= ectory.<o:p></o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal"># If you want to disable ping checking, set this to = some program<o:p></o:p></p> <p class=3D"MsoNormal"># that exits with 0 status, eg:<o:p></o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal"># $Conf{PingPath} =3D '/bin/= echo';<o:p></o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal">$Conf{PingPath} =3D '/bin/ping';<o:p></o:p></p> <p class=3D"MsoNormal">$Conf{Ping6Path} =3D undef;<o:p></o:p></p> <p class=3D"MsoNormal"><o:p> </o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal"># Ping command. The following variables are su= bstituted at run-time:<o:p></o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal"># $pingPath  = ; path to ping ($Conf{PingPath})<o:p></o:p></p> <p class=3D"MsoNormal"># $host &nb= sp; host name<o:p></o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal"># Wade Brown reports that on solaris 2.6 and 2.7 pin= g -s returns the wrong<o:p></o:p></p> <p class=3D"MsoNormal"># exit status (0 even on failure). Replace wit= h "ping $host 1", which<o:p></o:p></p> <p class=3D"MsoNormal"># gets the correct exit status but we don't get the = round-trip time.<o:p></o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal"># Note: all Cmds are executed directly without a she= ll, so the prog name<o:p></o:p></p> <p class=3D"MsoNormal"># needs to be a full path and you can't include shel= l syntax like<o:p></o:p></p> <p class=3D"MsoNormal"># redirection and pipes; put that in a script if you= need it.<o:p></o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal">$Conf{PingCmd} =3D '$pingPath -c 1 $host';<o:p></o:p= ></p> <p class=3D"MsoNormal"><o:p> </o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal"># Maximum round-trip ping time in milliseconds. = ; This threshold is set<o:p></o:p></p> <p class=3D"MsoNormal"># to avoid backing up PCs that are remotely connecte= d through WAN or<o:p></o:p></p> <p class=3D"MsoNormal"># dialup connections. The output from ping -s = (assuming it is supported<o:p></o:p></p> <p class=3D"MsoNormal"># on your system) is used to check the round-trip pa= cket time. On your<o:p></o:p></p> <p class=3D"MsoNormal"># local LAN round-trip times should be much less tha= n 20msec. On most<o:p></o:p></p> <p class=3D"MsoNormal"># WAN or dialup connections the round-trip time will= be typically more<o:p></o:p></p> <p class=3D"MsoNormal"># than 20msec. Tune if necessary.<o:p></o:p></= p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal">$Conf{PingMaxMsec} =3D 20;<o:p></o:p></p> <p class=3D"MsoNormal"><o:p> </o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal"># Compression level to use on files. 0 means n= o compression. Compression<o:p></o:p></p> <p class=3D"MsoNormal"># levels can be from 1 (least cpu time, slightly wor= se compression) to<o:p></o:p></p> <p class=3D"MsoNormal"># 9 (most cpu time, slightly better compression).&nb= sp; The recommended value<o:p></o:p></p> <p class=3D"MsoNormal"># is 3. Changing to 5, for example, will take = maybe 20% more cpu time<o:p></o:p></p> <p class=3D"MsoNormal"># and will get another 2-3% additional compression. = See the zlib<o:p></o:p></p> <p class=3D"MsoNormal"># documentation for more information about compressi= on levels.<o:p></o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal"># Changing compression on or off after backups have = already been done<o:p></o:p></p> <p class=3D"MsoNormal"># will require both compressed and uncompressed pool= files to be stored.<o:p></o:p></p> <p class=3D"MsoNormal"># This will increase the pool storage requirements, = at least until all<o:p></o:p></p> <p class=3D"MsoNormal"># the old backups expire and are deleted.<o:p></o:p>= </p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal"># It is ok to change the compression value (from one= non-zero value to<o:p></o:p></p> <p class=3D"MsoNormal"># another non-zero value) after dumps are already do= ne. Since BackupPC<o:p></o:p></p> <p class=3D"MsoNormal"># matches pool files by comparing the uncompressed v= ersions, it will still<o:p></o:p></p> <p class=3D"MsoNormal"># correctly match new incoming files against existin= g pool files. The<o:p></o:p></p> <p class=3D"MsoNormal"># new compression level will take effect only for ne= w files that are<o:p></o:p></p> <p class=3D"MsoNormal"># newly compressed and added to the pool.<o:p></o:p>= </p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal"># If compression was off and you are enabling compre= ssion for the first<o:p></o:p></p> <p class=3D"MsoNormal"># time you can use the BackupPC_compressPool utility= to compress the<o:p></o:p></p> <p class=3D"MsoNormal"># pool. This avoids having the pool grow to ac= commodate both compressed<o:p></o:p></p> <p class=3D"MsoNormal"># and uncompressed backups. See the documentat= ion for more information.<o:p></o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal"># Note: compression needs the Compress::Zlib perl li= brary. If the<o:p></o:p></p> <p class=3D"MsoNormal"># Compress::Zlib library can't be found then $Conf{C= ompressLevel} is<o:p></o:p></p> <p class=3D"MsoNormal"># forced to 0 (compression off).<o:p></o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal">$Conf{CompressLevel} =3D 3;<o:p></o:p></p> <p class=3D"MsoNormal"><o:p> </o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal"># Timeout in seconds when listening for the transpor= t program's<o:p></o:p></p> <p class=3D"MsoNormal"># (smbclient, tar etc) stdout. If no output is recei= ved during this<o:p></o:p></p> <p class=3D"MsoNormal"># time, then it is assumed that something has wedged= during a backup,<o:p></o:p></p> <p class=3D"MsoNormal"># and the backup is terminated.<o:p></o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal"># Note that stdout buffering combined with huge file= s being backed up<o:p></o:p></p> <p class=3D"MsoNormal"># could cause longish delays in the output from smbc= lient that<o:p></o:p></p> <p class=3D"MsoNormal"># BackupPC_dump sees, so in rare cases you might wan= t to increase<o:p></o:p></p> <p class=3D"MsoNormal"># this value.<o:p></o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal"># Despite the name, this parameter sets the timeout = for all transport<o:p></o:p></p> <p class=3D"MsoNormal"># methods (tar, smb etc).<o:p></o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal">#$Conf{ClientTimeout} =3D 72000;<o:p></o:p></p> <p class=3D"MsoNormal">$Conf{ClientTimeout} =3D 1209600;<o:p></o:p></p> <p class=3D"MsoNormal"><o:p> </o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal"># Maximum number of log files we keep around in each= PC's directory<o:p></o:p></p> <p class=3D"MsoNormal"># (ie: pc/$host). These files are aged monthly= . A setting of 12<o:p></o:p></p> <p class=3D"MsoNormal"># means there will be at most the files LOG, LOG.0, = LOG.1, ... LOG.11<o:p></o:p></p> <p class=3D"MsoNormal"># in the pc/$host directory (ie: about a years worth= ). (Except this<o:p></o:p></p> <p class=3D"MsoNormal"># month's LOG, these files will have a .z extension = if compression<o:p></o:p></p> <p class=3D"MsoNormal"># is on).<o:p></o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal"># If you decrease this number after BackupPC has bee= n running for a<o:p></o:p></p> <p class=3D"MsoNormal"># while you will have to manually remove the older l= og files.<o:p></o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal">$Conf{MaxOldPerPCLogFiles} =3D 12;<o:p></o:p></p> <p class=3D"MsoNormal"><o:p> </o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal"># Optional commands to run before and after dumps an= d restores,<o:p></o:p></p> <p class=3D"MsoNormal"># and also before and after each share of a dump.<o:= p></o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal"># Stdout from these commands will be written to the = Xfer (or Restore)<o:p></o:p></p> <p class=3D"MsoNormal"># log file. One example of using these command= s would be to<o:p></o:p></p> <p class=3D"MsoNormal"># shut down and restart a database server, dump a da= tabase<o:p></o:p></p> <p class=3D"MsoNormal"># to files for backup, or doing a snapshot of a shar= e prior<o:p></o:p></p> <p class=3D"MsoNormal"># to a backup. Example:<o:p></o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal"># $Conf{DumpPreUserCmd} =3D '$sshP= ath -q -x -l root $host /usr/bin/dumpMysql';<o:p></o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal"># The following variable substitutions are made at r= un time for<o:p></o:p></p> <p class=3D"MsoNormal"># $Conf{DumpPreUserCmd}, $Conf{DumpPostUserCmd}, $Co= nf{DumpPreShareCmd}<o:p></o:p></p> <p class=3D"MsoNormal"># and $Conf{DumpPostShareCmd}:<o:p></o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal"># $type&nb= sp; type of dump (incr or full)<o= :p></o:p></p> <p class=3D"MsoNormal"># $xferOK&= nbsp; 1 if the dump succeeded, 0 if it didn't= <o:p></o:p></p> <p class=3D"MsoNormal"># $client&= nbsp; client name being backed up<o:p></o:p><= /p> <p class=3D"MsoNormal"># $host&nb= sp; host name (could be different= from client name if<o:p></o:p></p> <p class=3D"MsoNormal"># &nb= sp; = $Conf{Cl= ientNameAlias} is set)<o:p></o:p></p> <p class=3D"MsoNormal"># $hostIP&= nbsp; IP address of host<o:p></o:p></p> <p class=3D"MsoNormal"># $user&nb= sp; user name from the hosts file= <o:p></o:p></p> <p class=3D"MsoNormal"># $moreUse= rs list of additional users from the hosts file<o:p></o:p= ></p> <p class=3D"MsoNormal"># $share&n= bsp; the first share name (or current s= hare for<o:p></o:p></p> <p class=3D"MsoNormal"># &nb= sp; = $Conf{DumpPreShareCmd} and $Conf{DumpPostShareCmd})<o:p></o:p>= </p> <p class=3D"MsoNormal"># $shares&= nbsp; list of all the share names<o:p></o:p><= /p> <p class=3D"MsoNormal"># $XferMet= hod value of $Conf{XferMethod} (eg: tar, rsync, smb)<o:p></o:p>= </p> <p class=3D"MsoNormal"># $sshPath= value of $Conf{SshPath},<o:p></o:p></p> <p class=3D"MsoNormal"># $cmdType= set to DumpPreUserCmd or DumpPostUserCmd<o:p= ></o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal"># The following variable substitutions are made at r= un time for<o:p></o:p></p> <p class=3D"MsoNormal"># $Conf{RestorePreUserCmd} and $Conf{RestorePostUser= Cmd}:<o:p></o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal"># $client&= nbsp; client name being backed up<o:p></o:p><= /p> <p class=3D"MsoNormal"># $xferOK&= nbsp; 1 if the restore succeeded, 0 if it did= n't<o:p></o:p></p> <p class=3D"MsoNormal"># $host&nb= sp; host name (could be different= from client name if<o:p></o:p></p> <p class=3D"MsoNormal"># &nb= sp; = $Conf{Cl= ientNameAlias} is set)<o:p></o:p></p> <p class=3D"MsoNormal"># $hostIP&= nbsp; IP address of host<o:p></o:p></p> <p class=3D"MsoNormal"># $user&nb= sp; user name from the hosts file= <o:p></o:p></p> <p class=3D"MsoNormal"># $moreUse= rs list of additional users from the hosts file<o:p></o:p= ></p> <p class=3D"MsoNormal"># $share&n= bsp; the first share name<o:p></o:p></p= > <p class=3D"MsoNormal"># $XferMet= hod value of $Conf{XferMethod} (eg: tar, rsync, smb)<o:p></o:p>= </p> <p class=3D"MsoNormal"># $sshPath= value of $Conf{SshPath},<o:p></o:p></p> <p class=3D"MsoNormal"># $type&nb= sp; set to "restore"<o:= p></o:p></p> <p class=3D"MsoNormal"># $bkupSrc= Host host name of the restore source<o:p></o:p></p> <p class=3D"MsoNormal"># $bkupSrc= Share share name of the restore source<o:p></o:p></p> <p class=3D"MsoNormal"># $bkupSrc= Num backup number of the restore source<o:p></o:p></p> <p class=3D"MsoNormal"># $pathHdr= Src common starting path of restore source<o:p></o:p></p> <p class=3D"MsoNormal"># $pathHdr= Dest common starting path of destination<o:p></o:p></p> <p class=3D"MsoNormal"># $fileLis= t list of files being restored<o:p></o:p></p> <p class=3D"MsoNormal"># $cmdType= set to RestorePreUserCmd or RestorePostUserC= md<o:p></o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal"># The following variable substitutions are made at r= un time for<o:p></o:p></p> <p class=3D"MsoNormal"># $Conf{ArchivePreUserCmd} and $Conf{ArchivePostUser= Cmd}:<o:p></o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal"># $client&= nbsp; client name being backed up<o:p></o:p><= /p> <p class=3D"MsoNormal"># $xferOK&= nbsp; 1 if the archive succeeded, 0 if it did= n't<o:p></o:p></p> <p class=3D"MsoNormal"># $host&nb= sp; Name of the archive host<o:p>= </o:p></p> <p class=3D"MsoNormal"># $user&nb= sp; user name from the hosts file= <o:p></o:p></p> <p class=3D"MsoNormal"># $share&n= bsp; the first share name<o:p></o:p></p= > <p class=3D"MsoNormal"># $XferMet= hod value of $Conf{XferMethod} (eg: tar, rsync, smb)<o:p></o:p>= </p> <p class=3D"MsoNormal"># $HostLis= t list of hosts being archived<o:p></o:p></p> <p class=3D"MsoNormal"># $BackupL= ist list of backup numbers for the hosts being archived<o:p></o= :p></p> <p class=3D"MsoNormal"># $archive= loc location where the archive is sent to<o:p></o:p></p> <p class=3D"MsoNormal"># $parfile= amount of parity data being generated (perce= ntage)<o:p></o:p></p> <p class=3D"MsoNormal"># $compres= sion compression program being used (eg: cat, gzip, bzip2)<o:p></o:p>= </p> <p class=3D"MsoNormal"># $compext= extension used for compression type (eg: raw= , gz, bz2)<o:p></o:p></p> <p class=3D"MsoNormal"># $splitsi= ze size of the files that the archive creates<o:p></o:p><= /p> <p class=3D"MsoNormal"># $sshPath= value of $Conf{SshPath},<o:p></o:p></p> <p class=3D"MsoNormal"># $type&nb= sp; set to "archive"<o:= p></o:p></p> <p class=3D"MsoNormal"># $cmdType= set to ArchivePreUserCmd or ArchivePostUserC= md<o:p></o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal"># Note: all Cmds are executed directly without a she= ll, so the prog name<o:p></o:p></p> <p class=3D"MsoNormal"># needs to be a full path and you can't include shel= l syntax like<o:p></o:p></p> <p class=3D"MsoNormal"># redirection and pipes; put that in a script if you= need it.<o:p></o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal">$Conf{DumpPreUserCmd} =3D undef;<o:p></o:p></p> <p class=3D"MsoNormal">$Conf{DumpPostUserCmd} =3D '/var/lib/backuppc/backup= pc_notification.sh $xferOK $host $type $client $hostIP $share $XferMethod $= sshPath $cmdType';<o:p></o:p></p> <p class=3D"MsoNormal">$Conf{DumpPreShareCmd} =3D undef;<o:p></o:p></p> <p class=3D"MsoNormal">$Conf{DumpPostShareCmd} =3D undef;<o:p></o:p></p> <p class=3D"MsoNormal">$Conf{RestorePreUserCmd} =3D undef;<o:p></o:p></p> <p class=3D"MsoNormal">$Conf{RestorePostUserCmd} =3D undef;<o:p></o:p></p> <p class=3D"MsoNormal">$Conf{ArchivePreUserCmd} =3D undef;<o:p></o:p></p> <p class=3D"MsoNormal">$Conf{ArchivePostUserCmd} =3D undef;<o:p></o:p></p> <p class=3D"MsoNormal"><o:p> </o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal"># Whether the exit status of each PreUserCmd and<o:p= ></o:p></p> <p class=3D"MsoNormal"># PostUserCmd is checked.<o:p></o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal"># If set and the Dump/Restore/Archive Pre/Post UserC= md<o:p></o:p></p> <p class=3D"MsoNormal"># returns a non-zero exit status then the dump/resto= re/archive<o:p></o:p></p> <p class=3D"MsoNormal"># is aborted. To maintain backward compatibili= ty (where<o:p></o:p></p> <p class=3D"MsoNormal"># the exit status in early versions was always ignor= ed),<o:p></o:p></p> <p class=3D"MsoNormal"># this flag defaults to 0.<o:p></o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal"># If this flag is set and the Dump/Restore/Archive P= reUserCmd<o:p></o:p></p> <p class=3D"MsoNormal"># fails then the matching Dump/Restore/Archive PostU= serCmd is<o:p></o:p></p> <p class=3D"MsoNormal"># not executed. If DumpPreShareCmd returns a n= on-exit status,<o:p></o:p></p> <p class=3D"MsoNormal"># then DumpPostShareCmd is not executed, but the Dum= pPostUserCmd<o:p></o:p></p> <p class=3D"MsoNormal"># is still run (since DumpPreUserCmd must have previ= ously<o:p></o:p></p> <p class=3D"MsoNormal"># succeeded).<o:p></o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal"># An example of a DumpPreUserCmd that might fail is = a script<o:p></o:p></p> <p class=3D"MsoNormal"># that snapshots or dumps a database which fails bec= ause<o:p></o:p></p> <p class=3D"MsoNormal"># of some database error.<o:p></o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal">$Conf{UserCmdCheckStatus} =3D '0';<o:p></o:p></p> <p class=3D"MsoNormal"><o:p> </o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal"># Override the client's host name. This allows= multiple clients<o:p></o:p></p> <p class=3D"MsoNormal"># to all refer to the same physical host. This= should only be<o:p></o:p></p> <p class=3D"MsoNormal"># set in the per-PC config file and is only used by = BackupPC at<o:p></o:p></p> <p class=3D"MsoNormal"># the last moment prior to generating the command us= ed to backup<o:p></o:p></p> <p class=3D"MsoNormal"># that machine (ie: the value of $Conf{ClientNameAli= as} is invisible<o:p></o:p></p> <p class=3D"MsoNormal"># everywhere else in BackupPC). The setting ca= n be a host name or<o:p></o:p></p> <p class=3D"MsoNormal"># IP address, eg:<o:p></o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal"># $C= onf{ClientNameAlias} =3D 'realHostName';<o:p></o:p></p> <p class=3D"MsoNormal"># $C= onf{ClientNameAlias} =3D '192.1.1.15';<o:p></o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal"># will cause the relevant smb/tar/rsync backup/resto= re commands to be<o:p></o:p></p> <p class=3D"MsoNormal"># directed to realHostName, not the client name.<o:p= ></o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal"># Note: this setting doesn't work for hosts with DHC= P set to 1.<o:p></o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal">$Conf{ClientNameAlias} =3D undef;<o:p></o:p></p> <p class=3D"MsoNormal"><o:p> </o:p></p> <p class=3D"MsoNormal">####################################################= #######################<o:p></o:p></p> <p class=3D"MsoNormal"># Email reminders, status and messages<o:p></o:p></p= > <p class=3D"MsoNormal"># (can be overridden in the per-PC config.pl)<o:p></= o:p></p> <p class=3D"MsoNormal">####################################################= #######################<o:p></o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal"># Full path to the sendmail command. Security = caution: normal users<o:p></o:p></p> <p class=3D"MsoNormal"># should not allowed to write to this file or direct= ory.<o:p></o:p></p> <p class=3D"MsoNormal"><o:p> </o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal">$Conf{SendmailPath} =3D '/usr/sbin/sendmail';<o:p></= o:p></p> <p class=3D"MsoNormal"><o:p> </o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal"># Minimum period between consecutive emails to a sin= gle user.<o:p></o:p></p> <p class=3D"MsoNormal"># This tries to keep annoying email to users to a re= asonable<o:p></o:p></p> <p class=3D"MsoNormal"># level. Email checks are done nightly, so thi= s number is effectively<o:p></o:p></p> <p class=3D"MsoNormal"># rounded up (ie: 2.5 means a user will never receiv= e email more<o:p></o:p></p> <p class=3D"MsoNormal"># than once every 3 days).<o:p></o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal">$Conf{EMailNotifyMinDays} =3D 1;<o:p></o:p></p> <p class=3D"MsoNormal"><o:p> </o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal"># Name to use as the "from" name for email= . Depending upon your mail<o:p></o:p></p> <p class=3D"MsoNormal"># handler this is either a plain name (eg: "adm= in") or a fully-qualified<o:p></o:p></p> <p class=3D"MsoNormal"># name (eg: "[email protected]").<o:p></o= :p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal">$Conf{EMailFromUserName} =3D 'backuppc01';<o:p></o:p= ></p> <p class=3D"MsoNormal"><o:p> </o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal"># Destination address to an administrative user who = will receive a<o:p></o:p></p> <p class=3D"MsoNormal"># nightly email with warnings and errors. If t= here are no warnings<o:p></o:p></p> <p class=3D"MsoNormal"># or errors then no email will be sent. Depend= ing upon your mail<o:p></o:p></p> <p class=3D"MsoNormal"># handler this is either a plain name (eg: "adm= in") or a fully-qualified<o:p></o:p></p> <p class=3D"MsoNormal"># name (eg: "[email protected]").<o:p></o= :p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal">$Conf{EMailAdminUserName} =3D '';<o:p></o:p></p> <p class=3D"MsoNormal"><o:p> </o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal"># Destination domain name for email sent to users.&n= bsp; By default<o:p></o:p></p> <p class=3D"MsoNormal"># this is empty, meaning email is sent to plain, unq= ualified<o:p></o:p></p> <p class=3D"MsoNormal"># addresses. Otherwise, set it to the destinta= tion domain, eg:<o:p></o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal"># $Cong{EMailUserDestDomain} =3D '= @mydomain.com';<o:p></o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal"># With this setting user email will be set to 'user@= mydomain.com'.<o:p></o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal">$Conf{EMailUserDestDomain} =3D 'linux-mon@dsdambuste= r.com';<o:p></o:p></p> <p class=3D"MsoNormal"><o:p> </o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal"># This subject and message is sent to a user if thei= r PC has never been<o:p></o:p></p> <p class=3D"MsoNormal"># backed up.<o:p></o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal"># These values are language-dependent. The def= ault versions can be<o:p></o:p></p> <p class=3D"MsoNormal"># found in the language file (eg: lib/BackupPC/Lang/= en.pm). If you<o:p></o:p></p> <p class=3D"MsoNormal"># need to change the message, copy it here and edit = it, eg:<o:p></o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal"># $Conf{EMailNoBackupEverMesg} =3D <&= lt;'EOF';<o:p></o:p></p> <p class=3D"MsoNormal"># To: $user$domain<o:p></o:p></p> <p class=3D"MsoNormal"># cc:<o:p></o:p></p> <p class=3D"MsoNormal"># Subject: $subj<o:p></o:p></p> <p class=3D"MsoNormal"># <o:p></o:p></p> <p class=3D"MsoNormal"># Dear $userName,<o:p></o:p></p> <p class=3D"MsoNormal"># <o:p></o:p></p> <p class=3D"MsoNormal"># This is a site-specific email message.= <o:p></o:p></p> <p class=3D"MsoNormal"># EOF<o:p></o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal">$Conf{EMailNoBackupEverSubj} =3D undef;<o:p></o:p></= p> <p class=3D"MsoNormal">$Conf{EMailNoBackupEverMesg} =3D undef;<o:p></o:p></= p> <p class=3D"MsoNormal"><o:p> </o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal"># How old the most recent backup has to be before no= tifying user.<o:p></o:p></p> <p class=3D"MsoNormal"># When there have been no backups in this number of = days the user<o:p></o:p></p> <p class=3D"MsoNormal"># is sent an email.<o:p></o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal">$Conf{EMailNotifyOldBackupDays} =3D 0;<o:p></o:p></p= > <p class=3D"MsoNormal"><o:p> </o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal"># This subject and message is sent to a user if thei= r PC has not recently<o:p></o:p></p> <p class=3D"MsoNormal"># been backed up (ie: more than $Conf{EMailNotifyOld= BackupDays} days ago).<o:p></o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal"># These values are language-dependent. The def= ault versions can be<o:p></o:p></p> <p class=3D"MsoNormal"># found in the language file (eg: lib/BackupPC/Lang/= en.pm). If you<o:p></o:p></p> <p class=3D"MsoNormal"># need to change the message, copy it here and edit = it, eg:<o:p></o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal"># $Conf{EMailNoBackupRecentMesg} =3D <= ;<'EOF';<o:p></o:p></p> <p class=3D"MsoNormal"># To: $user$domain<o:p></o:p></p> <p class=3D"MsoNormal"># cc:<o:p></o:p></p> <p class=3D"MsoNormal"># Subject: $subj<o:p></o:p></p> <p class=3D"MsoNormal"># <o:p></o:p></p> <p class=3D"MsoNormal"># Dear $userName,<o:p></o:p></p> <p class=3D"MsoNormal"># <o:p></o:p></p> <p class=3D"MsoNormal"># This is a site-specific email message.= <o:p></o:p></p> <p class=3D"MsoNormal"># EOF<o:p></o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal">$Conf{EMailNoBackupRecentSubj} =3D undef;<o:p></o:p>= </p> <p class=3D"MsoNormal">$Conf{EMailNoBackupRecentMesg} =3D undef;<o:p></o:p>= </p> <p class=3D"MsoNormal"><o:p> </o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal"># How old the most recent backup of Outlook files ha= s to be before<o:p></o:p></p> <p class=3D"MsoNormal"># notifying user.<o:p></o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal">$Conf{EMailNotifyOldOutlookDays} =3D 0;<o:p></o:p></= p> <p class=3D"MsoNormal"><o:p> </o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal"># This subject and message is sent to a user if thei= r Outlook files have<o:p></o:p></p> <p class=3D"MsoNormal"># not recently been backed up (ie: more than $Conf{E= MailNotifyOldOutlookDays}<o:p></o:p></p> <p class=3D"MsoNormal"># days ago).<o:p></o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal"># These values are language-dependent. The def= ault versions can be<o:p></o:p></p> <p class=3D"MsoNormal"># found in the language file (eg: lib/BackupPC/Lang/= en.pm). If you<o:p></o:p></p> <p class=3D"MsoNormal"># need to change the message, copy it here and edit = it, eg:<o:p></o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal"># $Conf{EMailOutlookBackupMesg} =3D <= <'EOF';<o:p></o:p></p> <p class=3D"MsoNormal"># To: $user$domain<o:p></o:p></p> <p class=3D"MsoNormal"># cc:<o:p></o:p></p> <p class=3D"MsoNormal"># Subject: $subj<o:p></o:p></p> <p class=3D"MsoNormal"># <o:p></o:p></p> <p class=3D"MsoNormal"># Dear $userName,<o:p></o:p></p> <p class=3D"MsoNormal"># <o:p></o:p></p> <p class=3D"MsoNormal"># This is a site-specific email message.= <o:p></o:p></p> <p class=3D"MsoNormal"># EOF<o:p></o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal">$Conf{EMailOutlookBackupSubj} =3D undef;<o:p></o:p><= /p> <p class=3D"MsoNormal">$Conf{EMailOutlookBackupMesg} =3D undef;<o:p></o:p><= /p> <p class=3D"MsoNormal"><o:p> </o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal"># Additional email headers. This sets to chars= et to<o:p></o:p></p> <p class=3D"MsoNormal"># utf8.<o:p></o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal">$Conf{EMailHeaders} =3D 'MIME-Version: 1.0<o:p></o:p= ></p> <p class=3D"MsoNormal">Content-Type: text/plain; charset=3D"utf-8"= ;<o:p></o:p></p> <p class=3D"MsoNormal">';<o:p></o:p></p> <p class=3D"MsoNormal"><o:p> </o:p></p> <p class=3D"MsoNormal">####################################################= #######################<o:p></o:p></p> <p class=3D"MsoNormal"># CGI user interface configuration settings<o:p></o:= p></p> <p class=3D"MsoNormal"># (can be overridden in the per-PC config.pl)<o:p></= o:p></p> <p class=3D"MsoNormal">####################################################= #######################<o:p></o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal"># Normal users can only access information specific = to their host.<o:p></o:p></p> <p class=3D"MsoNormal"># They can start/stop/browse/restore backups.<o:p></= o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal"># Administrative users have full access to all hosts= , plus overall<o:p></o:p></p> <p class=3D"MsoNormal"># status and log information.<o:p></o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal"># The administrative users are the union of the unix= /linux group<o:p></o:p></p> <p class=3D"MsoNormal"># $Conf{CgiAdminUserGroup} and the manual list of us= ers, separated<o:p></o:p></p> <p class=3D"MsoNormal"># by spaces, in $Conf{CgiAdminUsers}. If you don't w= ant a group or<o:p></o:p></p> <p class=3D"MsoNormal"># manual list of users set the corresponding configu= ration setting<o:p></o:p></p> <p class=3D"MsoNormal"># to undef or an empty string.<o:p></o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal"># If you want every user to have admin privileges (c= areful!), set<o:p></o:p></p> <p class=3D"MsoNormal"># $Conf{CgiAdminUsers} =3D '*'.<o:p></o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal"># Examples:<o:p></o:p></p> <p class=3D"MsoNormal"># $Conf{CgiAdminUserGroup} =3D 'ad= min';<o:p></o:p></p> <p class=3D"MsoNormal"># $Conf{CgiAdminUsers} = =3D 'craig celia';<o:p></o:p></p> <p class=3D"MsoNormal"># --> administrative users are = the union of group admin, plus<o:p></o:p></p> <p class=3D"MsoNormal"># craig and celia.<o:p= ></o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal"># $Conf{CgiAdminUserGroup} =3D '';= <o:p></o:p></p> <p class=3D"MsoNormal"># $Conf{CgiAdminUsers} = =3D 'craig celia';<o:p></o:p></p> <p class=3D"MsoNormal"># --> administrative users are = only craig and celia'.<o:p></o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal">$Conf{CgiAdminUserGroup} =3D 'backuppc';<o:p></o:p><= /p> <p class=3D"MsoNormal">$Conf{CgiAdminUsers} =3D 'backuppc';<o:p></o:p></p> <p class=3D"MsoNormal"><o:p> </o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal"># URL of the BackupPC_Admin CGI script. Used f= or email messages.<o:p></o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal">$Conf{CgiURL} =3D 'http://backuppc01/backuppc/index.= cgi';<o:p></o:p></p> <p class=3D"MsoNormal"><o:p> </o:p></p> <p class=3D"MsoNormal"># <o:p></o:p></p> <p class=3D"MsoNormal"># Language to use. See lib/BackupPC/Lang for t= he list of supported<o:p></o:p></p> <p class=3D"MsoNormal"># languages, which include English (en), French (fr)= , Spanish (es),<o:p></o:p></p> <p class=3D"MsoNormal"># German (de), Italian (it), Dutch (nl), Polish (pl)= , Portuguese<o:p></o:p></p> <p class=3D"MsoNormal"># Brazillian (pt_br) and Chinese (zh_CH).<o:p></o:p>= </p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal"># Currently the Language setting applies to the CGI = interface and email<o:p></o:p></p> <p class=3D"MsoNormal"># messages sent to users. Log files and other = text are still in English.<o:p></o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal">$Conf{Language} =3D 'en';<o:p></o:p></p> <p class=3D"MsoNormal"><o:p> </o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal"># User names that are rendered by the CGI interface = can be turned<o:p></o:p></p> <p class=3D"MsoNormal"># into links into their home page or other informati= on about the<o:p></o:p></p> <p class=3D"MsoNormal"># user. To set this up you need to create two = sprintf() strings,<o:p></o:p></p> <p class=3D"MsoNormal"># that each contain a single '%s' that will be repla= ced by the user<o:p></o:p></p> <p class=3D"MsoNormal"># name. The default is a mailto: link.<o:p></o= :p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal"># $Conf{CgiUserHomePageCheck} should be an absolute = file path that<o:p></o:p></p> <p class=3D"MsoNormal"># is used to check (via "-f") that the use= r has a valid home page.<o:p></o:p></p> <p class=3D"MsoNormal"># Set this to undef or an empty string to turn off t= his check.<o:p></o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal"># $Conf{CgiUserUrlCreate} should be a full URL that = points to the<o:p></o:p></p> <p class=3D"MsoNormal"># user's home page. Set this to undef or an em= pty string to turn<o:p></o:p></p> <p class=3D"MsoNormal"># off generation of URLs for user names.<o:p></o:p><= /p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal"># Example:<o:p></o:p></p> <p class=3D"MsoNormal"># $Conf{CgiUserHomePageCheck} =3D = '/var/www/html/users/%s.html';<o:p></o:p></p> <p class=3D"MsoNormal"># $Conf{CgiUserUrlCreate} &nb= sp; =3D 'http://myhost/users/%s.html';<o:p></o:p></p> <p class=3D"MsoNormal"># --> if /var/www/html/users/cr= aig.html exists, then 'craig' will<o:p></o:p></p> <p class=3D"MsoNormal"># be rendered as a lin= k to http://myhost/users/craig.html.<o:p></o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal">$Conf{CgiUserHomePageCheck} =3D '';<o:p></o:p></p> <p class=3D"MsoNormal">$Conf{CgiUserUrlCreate} =3D 'mailto:%s';<o:p></o:p><= /p> <p class=3D"MsoNormal"><o:p> </o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal"># Date display format for CGI interface. A val= ue of 1 uses US-style<o:p></o:p></p> <p class=3D"MsoNormal"># dates (MM/DD), a value of 2 uses full YYYY-MM-DD f= ormat, and zero<o:p></o:p></p> <p class=3D"MsoNormal"># for international dates (DD/MM).<o:p></o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal">$Conf{CgiDateFormatMMDD} =3D 1;<o:p></o:p></p> <p class=3D"MsoNormal"><o:p> </o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal"># If set, the complete list of hosts appears in the = left navigation<o:p></o:p></p> <p class=3D"MsoNormal"># bar pull-down for administrators. Otherwise,= just the hosts for which<o:p></o:p></p> <p class=3D"MsoNormal"># the user is listed in the host file (as either the= user or in moreUsers)<o:p></o:p></p> <p class=3D"MsoNormal"># are displayed.<o:p></o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal">$Conf{CgiNavBarAdminAllHosts} =3D '1';<o:p></o:p></p= > <p class=3D"MsoNormal"><o:p> </o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal"># Enable/disable the search box in the navigation ba= r.<o:p></o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal">$Conf{CgiSearchBoxEnable} =3D '1';<o:p></o:p></p> <p class=3D"MsoNormal"><o:p> </o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal"># Additional navigation bar links. These appea= r for both regular users<o:p></o:p></p> <p class=3D"MsoNormal"># and administrators. This is a list of hashes= giving the link (URL)<o:p></o:p></p> <p class=3D"MsoNormal"># and the text (name) for the link. Specifying= lname instead of name<o:p></o:p></p> <p class=3D"MsoNormal"># uses the language specific string (ie: $Lang->{= lname}) instead of<o:p></o:p></p> <p class=3D"MsoNormal"># just literally displaying name.<o:p></o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal">$Conf{CgiNavBarLinks} =3D [<o:p></o:p></p> <p class=3D"MsoNormal"> {<o:p></o:p></p> <p class=3D"MsoNormal"> 'lname' =3D> 'Documentation',<= o:p></o:p></p> <p class=3D"MsoNormal"> 'name' =3D> undef,<o:p></o:p><= /p> <p class=3D"MsoNormal"> 'link' =3D> '?action=3Dview&am= p;type=3Ddocs'<o:p></o:p></p> <p class=3D"MsoNormal"> },<o:p></o:p></p> <p class=3D"MsoNormal"> {<o:p></o:p></p> <p class=3D"MsoNormal"> 'lname' =3D> undef,<o:p></o:p>= </p> <p class=3D"MsoNormal"> 'name' =3D> 'Wiki',<o:p></o:p>= </p> <p class=3D"MsoNormal"> 'link' =3D> 'http://backuppc.w= iki.sourceforge.net'<o:p></o:p></p> <p class=3D"MsoNormal"> },<o:p></o:p></p> <p class=3D"MsoNormal"> {<o:p></o:p></p> <p class=3D"MsoNormal"> 'link' =3D> 'http://backuppc.s= ourceforge.net',<o:p></o:p></p> <p class=3D"MsoNormal"> 'name' =3D> 'SourceForge',<o:p= ></o:p></p> <p class=3D"MsoNormal"> 'lname' =3D> undef<o:p></o:p><= /p> <p class=3D"MsoNormal"> }<o:p></o:p></p> <p class=3D"MsoNormal">];<o:p></o:p></p> <p class=3D"MsoNormal"><o:p> </o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal"># Hilight colors based on status that are used in th= e PC summary page.<o:p></o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal">$Conf{CgiStatusHilightColor} =3D {<o:p></o:p></p> <p class=3D"MsoNormal"> 'Disabled_AllBackupsDisabled' =3D> '#d1d1d= 1',<o:p></o:p></p> <p class=3D"MsoNormal"> 'Reason_backup_canceled_by_user' =3D> '#ff= 9900',<o:p></o:p></p> <p class=3D"MsoNormal"> 'Status_backup_in_progress' =3D> '#66cc99'= ,<o:p></o:p></p> <p class=3D"MsoNormal"> 'Reason_no_ping' =3D> '#ffff99',<o:p></o:p= ></p> <p class=3D"MsoNormal"> 'Reason_backup_failed' =3D> '#ffcccc',<o:p= ></o:p></p> <p class=3D"MsoNormal"> 'Reason_backup_done' =3D> '#ccffcc',<o:p><= /o:p></p> <p class=3D"MsoNormal"> 'Disabled_OnlyManualBackups' =3D> '#d1d1d1= '<o:p></o:p></p> <p class=3D"MsoNormal">};<o:p></o:p></p> <p class=3D"MsoNormal"><o:p> </o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal"># Additional CGI header text.<o:p></o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal">$Conf{CgiHeaders} =3D '<meta http-equiv=3D"p= ragma" content=3D"no-cache">';<o:p></o:p></p> <p class=3D"MsoNormal"><o:p> </o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal"># Directory where images are stored. This dire= ctory should be below<o:p></o:p></p> <p class=3D"MsoNormal"># Apache's DocumentRoot. This value isn't used= by BackupPC but is<o:p></o:p></p> <p class=3D"MsoNormal"># used by configure.pl when you upgrade BackupPC.<o:= p></o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal"># Example:<o:p></o:p></p> <p class=3D"MsoNormal"># $Conf{CgiImageDir} =3D '/v= ar/www/htdocs/BackupPC';<o:p></o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal">$Conf{CgiImageDir} =3D '/usr/share/backuppc/image';<= o:p></o:p></p> <p class=3D"MsoNormal"><o:p> </o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal"># Additional mappings of file name extenions to Cont= ent-Type for<o:p></o:p></p> <p class=3D"MsoNormal"># individual file restore. See $Ext2ContentTyp= e in BackupPC_Admin<o:p></o:p></p> <p class=3D"MsoNormal"># for the default setting. You can add additio= nal settings here,<o:p></o:p></p> <p class=3D"MsoNormal"># or override any default settings. Example:<o= :p></o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal"># $Conf{CgiExt2ContentType} = =3D {<o:p></o:p></p> <p class=3D"MsoNormal"># &nb= sp; 'pl' =3D> 'text/plai= n',<o:p></o:p></p> <p class=3D"MsoNormal"># &nb= sp; };<o:p></o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal">$Conf{CgiExt2ContentType} =3D {};<o:p></o:p></p> <p class=3D"MsoNormal"><o:p> </o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal"># URL (without the leading http://host) for BackupPC= 's image directory.<o:p></o:p></p> <p class=3D"MsoNormal"># The CGI script uses this value to serve up image f= iles.<o:p></o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal"># Example:<o:p></o:p></p> <p class=3D"MsoNormal"># $Conf{CgiImageDirURL} =3D = '/BackupPC';<o:p></o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal">$Conf{CgiImageDirURL} =3D '/backuppc/image';<o:p></o= :p></p> <p class=3D"MsoNormal"><o:p> </o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal"># CSS stylesheet "skin" for the CGI interf= ace. It is stored<o:p></o:p></p> <p class=3D"MsoNormal"># in the $Conf{CgiImageDir} directory and accessed v= ia the<o:p></o:p></p> <p class=3D"MsoNormal"># $Conf{CgiImageDirURL} URL.<o:p></o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal"># For BackupPC v3.x several color, layout and font c= hanges were made.<o:p></o:p></p> <p class=3D"MsoNormal"># The previous v2.x version is available as BackupPC= _stnd_orig.css, so<o:p></o:p></p> <p class=3D"MsoNormal"># if you prefer the old skin, change this to BackupP= C_stnd_orig.css.<o:p></o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal">$Conf{CgiCSSFile} =3D 'BackupPC_stnd.css';<o:p></o:p= ></p> <p class=3D"MsoNormal"><o:p> </o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal"># Whether the user is allowed to edit their per-PC c= onfig.<o:p></o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal">$Conf{CgiUserConfigEditEnable} =3D '1';<o:p></o:p></= p> <p class=3D"MsoNormal"><o:p> </o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal"># Which per-host config variables a non-admin user i= s allowed<o:p></o:p></p> <p class=3D"MsoNormal"># to edit. Admin users can edit all per-host c= onfig variables,<o:p></o:p></p> <p class=3D"MsoNormal"># even if disabled in this list.<o:p></o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal"># SECURITY WARNING: Do not let users edit any of the= Cmd<o:p></o:p></p> <p class=3D"MsoNormal"># config variables! That's because a user coul= d set a<o:p></o:p></p> <p class=3D"MsoNormal"># Cmd to a shell script of their choice and it will = be<o:p></o:p></p> <p class=3D"MsoNormal"># run as the BackupPC user. That script could = do all<o:p></o:p></p> <p class=3D"MsoNormal"># sorts of bad things.<o:p></o:p></p> <p class=3D"MsoNormal">#<o:p></o:p></p> <p class=3D"MsoNormal">$Conf{CgiUserConfigEdit} =3D {<o:p></o:p></p> <p class=3D"MsoNormal"> 'EMailFromUserName' =3D> '1',<o:p></o:p></= p> <p class=3D"MsoNormal"> 'ArchiveInfoKeepCnt' =3D> '1',<o:p></o:p><= /p> <p class=3D"MsoNormal"> 'FtpTimeout' =3D> '1',<o:p></o:p></p> <p class=3D"MsoNormal"> 'TarClientCmd' =3D> '0',<o:p></o:p></p> <p class=3D"MsoNormal"> 'SmbSharePasswd' =3D> '1',<o:p></o:p></p> <p class=3D"MsoNormal"> 'FtpShareName' =3D> '1',<o:p></o:p></p> <p class=3D"MsoNormal"> 'FtpPort' =3D> '1',<o:p></o:p></p> <p class=3D"MsoNormal"> 'RestorePreUserCmd' =3D> '0',<o:p></o:p></= p> <p class=3D"MsoNormal"> 'EMailNoBackupEverSubj' =3D> '1',<o:p></o:= p></p> <p class=3D"MsoNormal"> 'FullPeriod' =3D> '1',<o:p></o:p></p> <p class=3D"MsoNormal"> 'FixedIPNetBiosNameCheck' =3D> '1',<o:p></= o:p></p> <p class=3D"MsoNormal"> 'TarClientPath' =3D> '0',<o:p></o:p></p> <p class=3D"MsoNormal"> 'EMailOutlookBackupMesg' =3D> '1',<o:p></o= :p></p> <p class=3D"MsoNormal"> 'SmbShareName' =3D> '1',<o:p></o:p></p> <p class=3D"MsoNormal"> 'ClientNameAlias' =3D> '1',<o:p></o:p></p> <p class=3D"MsoNormal"> 'DumpPreShareCmd' =3D> '0',<o:p></o:p></p> <p class=3D"MsoNormal"> 'ArchivePar' =3D> '1',<o:p></o:p></p> <p class=3D"MsoNormal"> 'BlackoutGoodCnt' =3D> '1',<o:p></o:p></p> <p class=3D"MsoNormal"> 'TarClientRestoreCmd' =3D> '0',<o:p></o:p>= </p> <p class=3D"MsoNormal"> 'EMailNoBackupRecentMesg' =3D> '1',<o:p></= o:p></p> <p class=3D"MsoNormal"> 'FullAgeMax' =3D> '1',<o:p></o:p></p> <p class=3D"MsoNormal"> 'ArchivePostUserCmd' =3D> '0',<o:p></o:p><= /p> <p class=3D"MsoNormal"> 'ClientCharset' =3D> '1',<o:p></o:p></p> <p class=3D"MsoNormal"> 'ArchiveSplit' =3D> '1',<o:p></o:p></p> <p class=3D"MsoNormal"> 'BlackoutBadPingLimit' =3D> '1',<o:p></o:p= ></p> <p class=3D"MsoNormal"> 'FtpBlockSize' =3D> '1',<o:p></o:p></p> <p class=3D"MsoNormal"> 'UserCmdCheckStatus' =3D> '0',<o:p></o:p><= /p> <p class=3D"MsoNormal"> 'RsyncArgs' =3D> '1',<o:p></o:p></p> <p class=3D"MsoNormal"> 'SmbClientFullCmd' =3D> '0',<o:p></o:p></p= > <p class=3D"MsoNormal"> 'ClientCharsetLegacy' =3D> '1',<o:p></o:p>= </p> <p class=3D"MsoNormal"> 'EMailNoBackupRecentSubj' =3D> '1',<o:p></= o:p></p> <p class=3D"MsoNormal"> 'NmbLookupFindHostCmd' =3D> '0',<o:p></o:p= ></p> <p class=3D"MsoNormal"> 'ArchiveComp' =3D> '1',<o:p></o:p></p> <p class=3D"MsoNormal"> 'TarShareName' =3D> '1',<o:p></o:p></p> <p class=3D"MsoNormal"> 'RsyncdAuthRequired' =3D> '1',<o:p></o:p><= /p> <p class=3D"MsoNormal"> 'RsyncCsumCacheVerifyProb' =3D> '1',<o:p><= /o:p></p> <p class=3D"MsoNormal"> 'FtpRestoreEnabled' =3D> '1',<o:p></o:p></= p> <p class=3D"MsoNormal"> 'TarIncrArgs' =3D> '1',<o:p></o:p></p> <p class=3D"MsoNormal"> 'RsyncdUserName' =3D> '1',<o:p></o:p></p> <p class=3D"MsoNormal"> 'SmbClientRestoreCmd' =3D> '0',<o:p></o:p>= </p> <p class=3D"MsoNormal"> 'ArchivePreUserCmd' =3D> '0',<o:p></o:p></= p> <p class=3D"MsoNormal"> 'RsyncClientPath' =3D> '0',<o:p></o:p></p> <p class=3D"MsoNormal"> 'FtpFollowSymlinks' =3D> '1',<o:p></o:p></= p> <p class=3D"MsoNormal"> 'EMailHeaders' =3D> '1',<o:p></o:p></p> <p class=3D"MsoNormal"> 'BackupFilesExclude' =3D> '1',<o:p></o:p><= /p> <p class=3D"MsoNormal"> 'RsyncdClientPort' =3D> '1',<o:p></o:p></p= > <p class=3D"MsoNormal"> 'ArchiveDest' =3D> '1',<o:p></o:p></p> <p class=3D"MsoNormal"> 'PartialAgeMax' =3D> '1',<o:p></o:p></p> <p class=3D"MsoNormal"> 'IncrKeepCntMin' =3D> '1',<o:p></o:p></p> <p class=3D"MsoNormal"> 'IncrAgeMax' =3D> '1',<o:p></o:p></p> <p class=3D"MsoNormal"> 'IncrPeriod' =3D> '1',<o:p></o:p></p> <p class=3D"MsoNormal"> 'DumpPreUserCmd' =3D> '0',<o:p></o:p></p> <p class=3D"MsoNormal"> 'RsyncdPasswd' =3D> '1',<o:p></o:p></p> <p class=3D"MsoNormal"> 'EMailNotifyMinDays' =3D> '1',<o:p></o:p><= /p> <p class=3D"MsoNormal"> 'XferMethod' =3D> '1',<o:p></o:p></p> <p class=3D"MsoNormal"> 'BackupFilesOnly' =3D> '1',<o:p></o:p></p> <p class=3D"MsoNormal"> 'FullKeepCntMin' =3D> '1',<o:p></o:p></p> <p class=3D"MsoNormal"> 'BackupZeroFilesIsFatal' =3D> '1',<o:p></o= :p></p> <p class=3D"MsoNormal"> 'RsyncArgsExtra' =3D> '1',<o:p></o:p></p> <p class=3D"MsoNormal"> 'IncrKeepCnt' =3D> '1',<o:p></o:p></p> <p class=3D"MsoNormal"> 'RsyncShareName' =3D> '1',<o:p></o:p></p> <p class=3D"MsoNormal"> 'FtpUserName' =3D> '1',<o:p></o:p></p> <p class=3D"MsoNormal"> 'XferLogLevel' =3D> '1',<o:p></o:p></p> <p class=3D"MsoNormal"> 'SmbShareUserName' =3D> '1',<o:p></o:p></p= > <p class=3D"MsoNormal"> 'PingMaxMsec' =3D> '1',<o:p></o:p></p> <p class=3D"MsoNormal"> 'TarFullArgs' =3D> '1',<o:p></o:p></p> <p class=3D"MsoNormal"> 'IncrLevels' =3D> '1',<o:p></o:p></p> <p class=3D"MsoNormal"> 'RestorePostUserCmd' =3D> '0',<o:p></o:p><= /p> <p class=3D"MsoNormal"> 'MaxOldPerPCLogFiles' =3D> '1',<o:p></o:p>= </p> <p class=3D"MsoNormal"> 'NmbLookupCmd' =3D> '0',<o:p></o:p></p> <p class=3D"MsoNormal"> 'RestoreInfoKeepCnt' =3D> '1',<o:p></o:p><= /p> <p class=3D"MsoNormal"> 'SmbClientIncrCmd' =3D> '0',<o:p></o:p></p= > <p class=3D"MsoNormal"> 'RsyncClientRestoreCmd' =3D> '0',<o:p></o:= p></p> <p class=3D"MsoNormal"> 'DumpPostUserCmd' =3D> '0',<o:p></o:p></p> <p class=3D"MsoNormal"> 'EMailNoBackupEverMesg' =3D> '1',<o:p></o:= p></p> <p class=3D"MsoNormal"> 'CompressLevel' =3D> '1',<o:p></o:p></p> <p class=3D"MsoNormal"> 'IncrFill' =3D> '1',<o:p></o:p></p> <p class=3D"MsoNormal"> 'EMailAdminUserName' =3D> '1',<o:p></o:p><= /p> <p class=3D"MsoNormal"> 'DumpPostShareCmd' =3D> '0',<o:p></o:p></p= > <p class=3D"MsoNormal"> 'PingCmd' =3D> '0',<o:p></o:p></p> <p class=3D"MsoNormal"> 'EMailOutlookBackupSubj' =3D> '1',<o:p></o= :p></p> <p class=3D"MsoNormal"> 'BlackoutPeriods' =3D> '1',<o:p></o:p></p> <p class=3D"MsoNormal"> 'EMailNotifyOldBackupDays' =3D> '1',<o:p><= /o:p></p> <p class=3D"MsoNormal"> 'FullKeepCnt' =3D> '1',<o:p></o:p></p> <p class=3D"MsoNormal"> 'EMailNotifyOldOutlookDays' =3D> '1',<o:p>= </o:p></p> <p class=3D"MsoNormal"> 'ArchiveClientCmd' =3D> '0',<o:p></o:p></p= > <p class=3D"MsoNormal"> 'EMailUserDestDomain' =3D> '1',<o:p></o:p>= </p> <p class=3D"MsoNormal"> 'ClientTimeout' =3D> '1',<o:p></o:p></p> <p class=3D"MsoNormal"> 'RsyncRestoreArgs' =3D> '1',<o:p></o:p></p= > <p class=3D"MsoNormal"> 'BackupsDisable' =3D> '1',<o:p></o:p></p> <p class=3D"MsoNormal"> 'RsyncClientCmd' =3D> '0',<o:p></o:p></p> <p class=3D"MsoNormal"> 'FtpPasswd' =3D> '1'<o:p></o:p></p> <p class=3D"MsoNormal">};<o:p></o:p></p> <br> </div> <hr style=3D"display:inline-block;width:98%" tabindex=3D"-1"> <div id=3D"divRplyFwdMsg" dir=3D"ltr"><font face=3D"Calibri, sans-serif" st= yle=3D"font-size:11pt" color=3D"#000000"><b>From:</b> Holger Parplies <w= [email protected]><br> <b>Sent:</b> 09 January 2018 13:01<br> <b>To:</b> Marc Gilliatt<br> <b>Cc:</b> [email protected]<br> <b>Subject:</b> Re: [BackupPC-devel] SMB Windows share not backing up - NT_= STATUS_ACCESS_DENIED listing \System Volume Information\SRM\*</font> <div> </div> </div> <div class=3D"BodyFragment"><font size=3D"2"><span style=3D"font-size:11pt;= "> <div class=3D"PlainText">Hi,<br> <br> Marc Gilliatt wrote on 2018-01-09 12:00:55 +0000 [[BackupPC-devel] SMB = Windows share not backing up - NT_STATUS_ACCESS_DENIED listing \System Volu= me Information\SRM\*]:<br> > [...]<br> > Any suggestions/ideas would be truly appreciative.<br> <br> try reading the responses you already got. It's all in there. Repeating it<= br> likely won't help. If you don't understand something in the responses, ask<= br> specifically. I can't talk for others, but I don't feel like explaining<br> something in yet a different way if I don't know if it's the specific thing= <br> you didn't understand or not, and when I don't know what the problem in<br> understanding it was.<br> <br> I'll try just the same:<br> <br> * This is the wrong mailing list. [email protected] is<b= r> the correct one.<br> * You *cannot* use includes and excludes with smb at the same time. Your<br= > excludes will simply be ignored.<br> * We need your configuration settings if you want us to tell you what is<br= > wrong with them, not some vague descriptions of about what they migh= t be<br> like. Saying what you're *intending* to do won't reveal the syntax e= rror.<br> <br> Hope that helps.<br> <br> Regards,<br> Holger<br> </div> </span></font></div> </body> </html> --_000_HE1P194MB01394AFD7F6C52FC11BDE884BB100HE1P194MB0139EURP_-- --===============7631554306948322726== Content-Type: text/plain; charset="us-ascii" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit Content-Disposition: inline ------------------------------------------------------------------------------ Check out the vibrant tech community on one of the world's most engaging tech sites, Slashdot.org! http://sdm.link/slashdot --===============7631554306948322726== Content-Type: text/plain; charset="us-ascii" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit Content-Disposition: inline _______________________________________________ BackupPC-devel mailing list [email protected] List: https://lists.sourceforge.net/lists/listinfo/backuppc-devel Wiki: http://backuppc.wiki.sourceforge.net Project: http://backuppc.sourceforge.net/ --===============7631554306948322726==--