1DRPMSYNC(8) System Manager's Manual DRPMSYNC(8)
2
6 drpmsync - sync a file tree with deltarpms
7
10 drpmsync [-c config] [source] dir
11 drpmsync [-s|-S] serverconfig
12 cgi-bin/drpmsync
13
16 Drpmsync keeps a local file system tree in sync with a remote one. Its
17 intended use is to work with rpm trees; the deltarpm technology can
18 only save bandwidth if rpms get transmitted. Please use the rsync pro‐
19 gram for normal file trees.
20 Drpmsync can run in two modes: as a client it connects to a server,
22 receives a file list and brings the tree up to date, as a server it
23 answers incoming requests and transmits files and rpms.
24
27 In this mode drpmsync updates the tree in dir. It opens the configura‐
28 tion file dir/drpmsync/config to get information about which server to
29 use and other settings. You can specify a different configuration file
30 with the -c option. The following settings are understood (the default
31 for the boolean settings is false):
32 source: server1 server2...
34 This is a list of servers to connect to. Drpmsync advances through this
36 list until a working server is found. If a source is specified on the
37 command line it is used instead of the one from the configuration. The
38 syntax for the server entries is "host[:port]/tree".
39 log: logfile
41 Specifies the name of a logfile. If the name does not start with a
43 slash, dir/drpmsync/ is prepended to it.
44 generate_deltas: true|false
46 Controls whether drpmsync generates a delta if it receives a new ver‐
48 sion of a rpm and the server doesn't provide a delta. This is only use‐
49 ful if the local tree is also exported to other clients via a local
50 drpmsync server.
51 generate_delta_compression: comp
53 This parameter is forwarded to the makedeltarpm program when creating
55 deltas. An example would be gzip,gzip.
56 keep_deltas: true|false
58 Tell drpmsync to save received or freshly created deltas to the
60 dir/drpmsync/delta directory. Automatically true if generate_deltas or
61 keep_uncombined is set to true.
62 keep_uncombined: true|false
64 This tells drpmsync to request uncombined deltas from the server
66 instead of a precombined single delta. This makes sense if you re-
67 export the tree and want to maximize the number of versions your
68 clients can update from.
69 always_get_rpm: true|false
71 Configures whether drpmsync should request that the full rpm is always
73 sent along with the delta. Only makes sense if you have a fast network
74 connection so that applydeltarpm takes longer than transmitting the ful
75 rpm.
76 deltarpmpath: path
78 Sets the directory where drpmsync searches for the deltarpm programs.
80 The default is to search the $PATH variable.
81
84 Drpmsync can wither work as CGI script or as a standalone server. CGI
85 script mode is automatically selected if the REQUEST_METHOD environment
86 variable is set. In this mode drpmsync expects the DRPMSYNC_CONFIG
87 environment variable to contain the path to a server config file. For
88 apache you can set this with the SetEnv directive.
89 Standalone mode is selected with the -s or -S option. In this mode the
91 server configuration must be specified as an argument to the drpmsync
92 program. The -s option makes the drpmsync program background itself and
93 exit right away, while -S keeps the server in the foreground.
94 The server configuration can contain the following settings:
96 allow: pattern1 pattern2...
98 deny: pattern1 pattern2...
99 This provides the access control for the server. pattern can either be
101 a simple glob pattern (only * is supported) or it can be a full regular
102 expression if it is written as /RE/. The regular expression is auto‐
103 matically anchored at the start and the end. Examples are 10.10.* or
104 /10\.10\..*/ If either the numerical ip address or the domain name of
105 the client matches any entry of the deny list, access is forbidden.
106 Otherwise the allow list is searched for a match. If none is found,
107 access is also denied. The default setting for both lists is empty, so
108 you have to provide an allow list to allow access for the clients.
109 log: logfile
111 Specifies the path of a logfile.
113 no_combine: true|false
115 If this setting is true the server does not combine deltarpms. This
117 increases to amount of data that has to be transferred but reduces the
118 processor load on the server.
119 tree: external_path internal_path
121 This statements exports the tree located at internal_path to the
123 clients as directory external_path. All of the above settings are
124 saved as settings of this particular tree, so different trees can use
125 different configurations. This also means that the configuration direc‐
126 tives of a tree must be above the tree statement.
127 The following settings are global and only needed for standalone mode:
130 serverlog: logfile
132 Specifies the path of a logfile used for logging server events.
134 servername: hostname[:port]
136 The name of the server. If hostname is empty, the fully qualified
138 domain name is used instead. The port defaults to port 80.
139 serveraddr: addr
141 This address is used for binding the server's socket. If not specified,
143 connections can come from any interface.
144 serveruser: user
146 servergroup: group
147 Configures the user and group the servers swicthes to after binding the
149 socket to the desired port. Examples are nobody or wwwrun.
150 maxclients: num
152 This settings limits the maximum number of concurrent connections to
154 num. The default value is 10 connections.
155 deltarpmpath: path
157 Sets the directory where drpmsync searches for the deltarpm programs.
159 The default is to search the $PATH variable.
160
163 dir/drpmsync/deltas
164 directory used to store the deltas
165 dir/drpmsync/lock
166 lock used to serialize syncrpm calls
167 dir/drpmsync/wip
168 temporary storing space for the transmitted objects
169 dir/drpmsync/cache
170 md5sum cache to speed up the calculation of the tree state
171 dir/drpmsync/timstamp
172 contains the time of the last finished sync and the last time
173 the remote tree state was requested.
174
176 makedeltarpm(8), combinedeltarpm(8), applydeltarpm(8),
177
179 Michael Schroeder <mls@suse.de>
180 Jun 2005 DRPMSYNC(8)