1
How to set up autoupgrades
2
--------------------------
4
Clients need to be on version 1.3.0 or newer to have the ability to
5
autoupgrade. Also, the server needs to be newer than 1.3.0.
7
On the client machines, you need to have fields in burp.conf that look like
10
autoupgrade_os = win32
11
autoupgrade_dir = C:/Program Files/Burp/autoupgrade
13
autoupgrade_os = some_os
14
autoupgrade_dir = /etc/burp/autoupgrade/client
16
The 'os' values match a directory component on the server.
17
The directories given need to exist.
20
On the server, you need to have a field in the burp.conf that looks like this:
21
autoupgrade_dir = /etc/burp/autoupgrade/server
23
The directory needs to exist on the server.
24
Subdirectories need to exist for the 'autoupgrade_os' values on the client,
25
with further subdirectories named after the current server version.
27
/etc/burp/autoupgrade/server/win32/1.3.1
28
/etc/burp/autoupgrade/server/some_os/1.3.1
30
The version directory needs to contain two files called "script" and "package".
31
If all your packages are going to be installed the same way for a particular
32
OS, you may also place "script" at the top level for that OS. Like this, for
34
/etc/burp/autoupgrade/server/win32/script
37
Given all the above, then when the client version is 1.3.0 or newer, and the
38
server version is greater than the client version, the next time the client
39
connects, it will download the two files, execute the "script" file, and then
42
Examples of "script" files are given in the source package, in
43
configs/server/autoupgrade.
45
The "package" file is the new package to be installed.
49
I shall explain once more, by example.
52
You have a 32 bit Windows client called 'win2k8' that is currently on 1.3.0.
53
You have a Debian server that is currently on 1.3.1.
54
You want to automatically upgrade the Windows client to 1.3.1.
55
You have a Windows burp installer called burp-win32-installer-1.3.1.exe.
57
Make sure this is in the client burp.conf file:
58
autoupgrade_os = win32
59
autoupgrade_dir = C:/Program Files/Burp/autoupgrade
61
Make sure this is in the server burp.conf file:
62
autoupgrade_dir = /etc/burp/autoupgrade/server
64
Make sure this directory exists on the server:
65
/etc/burp/autoupgrade/server/win32/1.3.1
67
Copy an appropriate script file to the OS directory (and rename it "script"):
68
cp burp/configs/autoupgrade/windows.script \
69
/etc/burp/autoupgrade/server/win32/script
70
Copy the installer to the version directory (and rename it "package"):
71
cp burp-win32-installer-1.3.1.exe \
72
/etc/burp/autoupgrade/server/win32/1.3.1/package
74
The client should now automatically upgrade to 1.3.1 when it next connects.