Welcome to part 2! This post discusses installing Webpagetest.org. In order to do so, we will need:

  • A windows machine (XP or Windows 7 have been tested with this method)
  • Apache2.2 or higher
  • PHP5 or higher
  • IE of some sort (IE8 or 9 would be best)
  • ffmpeg

It is possible to split up the web server and the testing server, but I put them both on the same machine for ease of use. In addition I found installing and configuring Apache and PHP together on windows was surprisingly difficult, so I suggest installing Xampp. It's a single-install program that includes many of the tools used for serving web pages and web development, such as Apache, PHP5, MySQL, and Filezilla. Windows 7 machines have IE 8 installed by default, but upgrading is straightforward for XP machines.

Once you have your machine set up properly, it's time to install Webpagetest! You can download the source here: Webpagetest.org source.

There are also installation instructions on the webpagetest.org google site. I would recommend following these fora a complete guide, but what I have written is a shorter version and will attain the same result.


Configure Apache to point to the www directory of your source, or move the contents of the folder to the "htdocs" folder under Xampp (I found that the Virtualhost directive in Apache was having issues, so I just threw everything into the htdocs folder, where Xampp is initially configured to point to). I found that on the windows machine, giving read/write permissions to the directories needed was not an issue.

You will then have to configure everything properly. This involves basically copying and pasting everything in the settings folder to it's non-sample equivalent. I was able to do this because I wanted a basic instance, but keep in mind you may need to do more if you want more complex options.

Configuring the system to run the tests is best explained, verbatim from the private-instance setup site linked above:

  1. Configure the test system to automatically log-on to an administrator account. Running "control userpasswords2" from the start menu is one way to configure it.

  2. Disable any screen savers (the desktop needs to remain visible for the video capture to work)

  3. Disable UAC (Vista or later - slide to "never notify")

  4. Uninstall IE Enhanced-Security Mode (Windows Server)

  5. Copy the test software from the agent folder to the system (to "c:\webpagetest" for this example)

  6. Install the DUMMYNET ipfw driver

    • Pull up the properties for the Network Adapter that is used to access the Internet
    • Click "Install"
    • Select "Service" and click "Add"
    • Click "Have Disk" and navigate to c:\webpagetest\dummynet
    • Select the ipfw+dummynet service (and click through any warnings about the driver being unsigned)

  7. Create a shortcut to c:\webpagetest\dummynet\ipfw.cmd in the startup folder

  8. Create a shortcut to c:\webpagetest\urlblast.exe in the startup folder

  9. Make a copy of the settings file (urlblast.ini) based on the sample

    • Give it the path to the server (default configuration points to a server on the local machine)
    • Configure the location to match the location defined on the server in locations.ini (if modified)
    • Configure the location key to match the server in locations.ini (if modified)

  10. Reboot to make sure everything starts up correctly

Note:On windows 7, ipfw will not properly install (it will not show up under installable services). If you want to use windows 7, you must add a "Location = LAN" directive under test in settings.inc in settings:

[Test]Location = LAN

After that, your instance should be set up! Now that wasn't so bad, was it?

Next time we'll talk about installing HttpArchive!


comments powered by Disqus

About Yusuke Tsutsumi
I work at Zillow. I focus on tools and services for developer productivity, including build and testing.

My other interests include programming language design, game development, and learning languages (the non-programming ones).