1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
|
StoreHostname = @@ServerName@@
AccountNumber = 0x@@AccountNo@@
KeysFile = @@InstallDir@@/conf/@@AccountNo@@-FileEncKeys.raw
CertificateFile = @@InstallDir@@/conf/@@AccountNo@@-cert.pem
PrivateKeyFile = @@InstallDir@@/conf/@@AccountNo@@-key.pem
TrustedCAsFile = @@InstallDir@@/conf/serverCA.pem
DataDirectory = @@InstallDir@@/state
# This script is run whenever bbackupd changes state or encounters a
# problem which requires the system administrator to assist:
#
# 1) The store is full, and no more data can be uploaded.
# 2) Some files or directories were not readable.
# 3) A backup run starts or finishes.
#
# The default script emails the system administrator, except for backups
# starting and stopping, where it does nothing.
NotifyScript = @@InstallDir@@/bin/NotifySysAdmin.vbs
# The number of seconds between backup runs under normal conditions. To avoid
# cycles of load on the server, this time is randomly adjusted by a small
# percentage as the daemon runs.
UpdateStoreInterval = 3600
# The minimum age of a file, in seconds, that will be uploaded. Avoids
# repeated uploads of a file which is constantly being modified.
MinimumFileAge = 21600
# If a file is modified repeated, it won't be uploaded immediately in case
# it's modified again, due to the MinimumFileAge specified above. However, it
# should be uploaded eventually even if it is being modified repeatedly. This
# is how long we should wait, in seconds, after first noticing a change.
# (86400 seconds = 1 day)
MaxUploadWait = 86400
# If the connection is idle for some time (e.g. over 10 minutes or 600
# seconds, not sure exactly how long) then the server will give up and
# disconnect the client, resulting in Connection Protocol_Timeout errors
# on the server and TLSReadFailed or TLSWriteFailed errors on the client.
# Also, some firewalls and NAT gateways will kill idle connections after
# similar lengths of time.
#
# This can happen for example when most files are backed up already and
# don't need to be sent to the store again, while scanning a large
# directory, or while calculating diffs of a large file. To avoid this,
# KeepAliveTime specifies that special keep-alive messages should be sent
# when the connection is otherwise idle for a certain length of time,
# specified here in seconds.
#
# The default is that these messages are never sent, equivalent to setting
# this option to zero, but we recommend that all users enable this.
KeepAliveTime = 120
# Files above this size (in bytes) are tracked, and if they are renamed they will simply be
# renamed on the server, rather than being uploaded again. (64k - 1)
FileTrackingSizeThreshold = 65535
# The daemon does "changes only" uploads for files above this size (in bytes).
# Files less than it are uploaded whole without this extra processing.
DiffingUploadSizeThreshold = 8192
# The limit on how much time is spent diffing files, in seconds. Most files
# shouldn't take very long, but if you have really big files you can use this
# to limit the time spent diffing them.
#
# * Reduce if you are having problems with processor usage.
#
# * Increase if you have large files, and think the upload of changes is too
# large and you want bbackupd to spend more time searching for unchanged
# blocks.
MaximumDiffingTime = 120
# Uncomment this line to see exactly what the daemon is going when it's connected to the server.
# ExtendedLogging = yes
# This specifies a program or script script which is run just before each
# sync, and ideally the full path to the interpreter. It will be run as the
# same user bbackupd is running as, usually root.
#
# The script must output (print) either "now" or a number to STDOUT (and a
# terminating newline, no quotes).
#
# If the result was "now", then the sync will happen. If it's a number, then
# no backup will happen for that number of seconds (bbackupd will pause) and
# then the script will be run again.
#
# Use this to temporarily stop bbackupd from syncronising or connecting to the
# store. For example, you could use this on a laptop to only backup when on a
# specific network, or when it has a working Internet connection.
# SyncAllowScript = /path/to/intepreter/or/exe script-name parameters etc
# Where the command socket is created in the filesystem.
CommandSocket = @@CommandSocketNamedPipe@@
# Uncomment the StoreObjectInfoFile to enable the experimental archiving
# of the daemon's state (including client store marker and configuration)
# between backup runs. This saves time and increases efficiency when
# bbackupd is frequently stopped and started, since it removes the need
# to rescan all directories on the remote server. However, it is new and
# not yet heavily tested, so use with caution.
StoreObjectInfoFile = @@InstallDir@@/state/bbackupd.state
Server
{
PidFile = @@InstallDir@@/state/bbackupd.pid
}
# BackupLocations specifies which locations on disc should be backed up. Each
# directory is in the format
#
# name
# {
# Path = /path/of/directory
# (optional exclude directives)
# }
#
# 'name' is derived from the Path by the config script, but should merely be
# unique.
#
# The exclude directives are of the form
#
# [Exclude|AlwaysInclude][File|Dir][|sRegex] = regex or full pathname
#
# (The regex suffix is shown as 'sRegex' to make File or Dir plural)
#
# For example:
#
# ExcludeDir = /home/guest-user
# ExcludeFilesRegex = \.(mp3|MP3)\$
# AlwaysIncludeFile = /home/username/veryimportant.mp3
#
# This excludes the directory /home/guest-user from the backup along with all mp3
# files, except one MP3 file in particular.
#
# In general, Exclude excludes a file or directory, unless the directory is
# explicitly mentioned in a AlwaysInclude directive. However, Box Backup
# does NOT scan inside excluded directories and will never back up an
# AlwaysIncluded file or directory inside an excluded directory or any
# subdirectory thereof.
#
# To back up a directory inside an excluded directory, use a configuration
# like this, to ensure that each directory in the path to the important
# files is included, but none of their contents will be backed up except
# the directories further down that path to the important one.
#
# ExcludeDirsRegex = ^/home/user/bigfiles/
# ExcludeFilesRegex = ^/home/user/bigfiles/
# AlwaysIncludeDir = /home/user/bigfiles/path
# AlwaysIncludeDir = /home/user/bigfiles/path/to
# AlwaysIncludeDir = /home/user/bigfiles/path/important
# AlwaysIncludeDir = /home/user/bigfiles/path/important/files
# AlwaysIncludeDirsRegex = ^/home/user/bigfiles/path/important/files/
# AlwaysIncludeFilesRegex = ^/home/user/bigfiles/path/important/files/
#
# If a directive ends in Regex, then it is a regular expression rather than a
# explicit full pathname. See
#
# man 7 re_format
#
# for the regex syntax on your platform.
|
