OLD | NEW |
1 # Prerequisites | 1 # Prerequisites |
2 * A Mac running OS X 10.6 ("Snow Leopard") or Linux (tested with Ubuntu | 2 * A Mac running OS X 10.6 ("Snow Leopard") or Linux (tested with Ubuntu |
3 Lucid). Support for Windows is still experimental | 3 Lucid). Support for Windows is still experimental |
4 * [Python 2.6](http://www.python.org/download/releases/2.6.6/) | 4 * [Python 2.6](http://www.python.org/download/releases/2.6.6/) |
5 | 5 |
6 # Install | 6 # Install |
7 Only do this the first time. | 7 Only do this the first time. |
8 | 8 |
9 1. Open the Terminal application and download the source. | 9 1. Open the Terminal application and download the source. |
10 ``` | 10 ``` |
11 $ git clone https://github.com/chromium/web-page-replay.git | 11 $ git clone https://github.com/chromium/web-page-replay.git |
12 ``` | 12 ``` |
13 2. Move to the newly created directory. | 13 2. Move to the newly created directory. |
14 ``` | 14 ``` |
15 $ cd web-page-replay | 15 $ cd web-page-replay |
16 ``` | 16 ``` |
17 ## Linux-specific install steps | 17 ## Network simulation |
18 On Linux, Dummynet must be installed to simulate network conditions. | 18 For network simulation, you can use https://github.com/WPO-Foundation/tsproxy |
19 | 19 which works on most platforms. More realistic network simulation options can be |
20 1. For the Linux code, try downloading the [latest linux sources from Marta | 20 achieved through using tools like dummynet, but those only support limited |
21 Carbone](http://info.iet.unipi.it/~marta/dummynet/). These are more up-to-date t
han what is found on the [Dummynet | 21 platforms. |
22 homepage](http://info.iet.unipi.it/~luigi/dummynet/). | |
23 2. Build and install: | |
24 ``` | |
25 $ tar -C /tmp -xvzf ipfw3-20120119.tgz | |
26 $ cd /tmp/ipfw3-20120119 | |
27 $ make | |
28 [Ignore output like the following:] | |
29 echo " ERROR: Kernel configuration is invalid.";\ | |
30 echo " include/generated/autoconf.h or | |
31 include/config/auto.conf are missing.";\ | |
32 echo " Run 'make oldconfig && make prepare' on kernel | |
33 src to fix it.";\ | |
34 [The lines will print without "echo" if there is an actual error.] | |
35 $ sudo insmod dummynet2/ipfw_mod.ko | |
36 $ sudo cp ipfw/ipfw /usr/local/sbin | |
37 ``` | |
38 3. To remove it later | |
39 ``` | |
40 $ sudo rmmod ipfw_mod.ko | |
41 ``` | |
42 ## Windows-specific install steps | |
43 *Windows support is experimental and not well tested.* On Windows XP, the | |
44 Dummynet driver must be installed to simulate network conditions | |
45 (Drivers for Windows Vista and Windows 7 are currently unavailable). | |
46 | |
47 1. Control Panel -> Network Connections -> Right-click adapter in use -> | |
48 select Properties | |
49 2. Click Install... -> Service -> Add... -> Have Disk... | |
50 3. Browse... -> | |
51 web-page-replay-read-only\third_party\ipfw_win32\netipfw.inf | |
52 4. Click Open -> Ok -> Ok | |
53 - Accept any warnings for installing an unknown driver | |
54 | 22 |
55 # Record | 23 # Record |
56 First you must record the web page or pages that you wish to replay. | 24 First you must record the web page or pages that you wish to replay. |
57 | 25 |
58 1. Open the web browser you wish to use and clear its cache so that all | 26 1. Open the web browser you wish to use and clear its cache so that all |
59 resources will be requested from the network. | 27 resources will be requested from the network. |
60 2. Switch to the Terminal application and start the program in record mode. | 28 2. Switch to the Terminal application and start the program in record mode. |
61 All HTTP requests performed on the machine while it is running will be | 29 All HTTP requests performed on the machine while it is running will be |
62 saved into the archive. | 30 saved into the archive. |
63 ``` | 31 ``` |
(...skipping 96 matching lines...) Expand 10 before | Expand all | Expand 10 after Loading... |
160 ``` | 128 ``` |
161 | 129 |
162 # Help | 130 # Help |
163 | 131 |
164 For full usage instructions and advanced options, see the program's | 132 For full usage instructions and advanced options, see the program's |
165 help. | 133 help. |
166 | 134 |
167 ``` | 135 ``` |
168 $ ./replay.py --help | 136 $ ./replay.py --help |
169 ``` | 137 ``` |
OLD | NEW |