Chromium Code Reviews
chromiumcodereview-hr@appspot.gserviceaccount.com (chromiumcodereview-hr) | Please choose your nickname with Settings | Help | Chromium Project | Gerrit Changes | Sign out
(261)

Side by Side Diff: documentation/GettingStarted.md

Issue 2835923003: Update WPR documentation (Closed)
Patch Set: Created 3 years, 8 months ago
Use n/p to move between diff chunks; N/P to move between comments. Draft comments are only viewable by you.
Jump to:
View unified diff | Download patch
« no previous file with comments | « README.md ('k') | no next file » | no next file with comments »
Toggle Intra-line Diffs ('i') | Expand Comments ('e') | Collapse Comments ('c') | Show Comments Hide Comments ('s')
OLDNEW
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
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 ```
OLDNEW
« no previous file with comments | « README.md ('k') | no next file » | no next file with comments »

Powered by Google App Engine
This is Rietveld 408576698