| 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 ## Network simulation | 17 ## Linux-specific install steps |
| 18 For network simulation, you can use https://github.com/WPO-Foundation/tsproxy | 18 On Linux, Dummynet must be installed to simulate network conditions. |
| 19 which works on most platforms. More realistic network simulation options can be | 19 |
| 20 achieved through using tools like dummynet, but those only support limited | 20 1. For the Linux code, try downloading the [latest linux sources from Marta |
| 21 platforms. | 21 Carbone](http://info.iet.unipi.it/~marta/dummynet/). These are more up-to-date t
han what is found on the [Dummynet |
| 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 |
| 22 | 54 |
| 23 # Record | 55 # Record |
| 24 First you must record the web page or pages that you wish to replay. | 56 First you must record the web page or pages that you wish to replay. |
| 25 | 57 |
| 26 1. Open the web browser you wish to use and clear its cache so that all | 58 1. Open the web browser you wish to use and clear its cache so that all |
| 27 resources will be requested from the network. | 59 resources will be requested from the network. |
| 28 2. Switch to the Terminal application and start the program in record mode. | 60 2. Switch to the Terminal application and start the program in record mode. |
| 29 All HTTP requests performed on the machine while it is running will be | 61 All HTTP requests performed on the machine while it is running will be |
| 30 saved into the archive. | 62 saved into the archive. |
| 31 ``` | 63 ``` |
| (...skipping 96 matching lines...) Expand 10 before | Expand all | Expand 10 after Loading... |
| 128 ``` | 160 ``` |
| 129 | 161 |
| 130 # Help | 162 # Help |
| 131 | 163 |
| 132 For full usage instructions and advanced options, see the program's | 164 For full usage instructions and advanced options, see the program's |
| 133 help. | 165 help. |
| 134 | 166 |
| 135 ``` | 167 ``` |
| 136 $ ./replay.py --help | 168 $ ./replay.py --help |
| 137 ``` | 169 ``` |
| OLD | NEW |