Enables replay of VuGen scripts against localhost during script development
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
www
.gitignore
README.md
buildzip.bat

README.md

VuGen Local Replay

This tool enables replay of web-based VuGen scripts against localhost during script development.

Product page: http://www.myloadtest.com/tools/vugen-local-replay/ GitHub repository: https://github.com/MyLoadTest/VuGenLocalReplay

Installation Instructions

The installation instructions assume that you are using Windows.

  1. Install Apache and PHP. The easiest way to do this is to install WampServer. To check that it is working, navigate to http://localhost/ and check that the WampServer Homepage is displayed.

  2. Sign up for a GitHub account, install the [GitHub for Windows] (http://windows.github.com/) client and clone the VuGenLocalReplay repository. You should have now have a copy of the VuGenLocalReplay repository somewhere like C:\Documents and Settings\Administrator\My Documents\GitHub\VuGenLocalReplay

  3. Reconfigure Apache by editing httpd.conf. The file is probably located at C:\wamp\bin\apache\Apache2.4.4\conf\httpd.conf

    Enable mod_rewrite by uncommenting this line:

    #LoadModule rewrite_module modules/mod_rewrite.so
    

    Change the DocumentRoot to point to the VuGenLocalReplay repository.

    # Change this...
    DocumentRoot "c:/wamp/www"
    <Directory "c:/wamp/www">
    # ...to this...
    DocumentRoot "C:\Documents and Settings\Administrator\My Documents\GitHub\VuGenLocalReplay/www"
    <Directory "C:\Documents and Settings\Administrator\My Documents\GitHub\VuGenLocalReplay/www">
    

    You will need to restart Apache for these changes to take effect. Click on the WampServer icon in the system tray, and select "Restart All Services". Confirm that your changes worked, by navigating to http://localhost/. You should see the VuGenLocalReplay homepage.

  4. Copy a recently recorded VuGen script to .\GitHub\VuGenLocalReplay\www\vugen Note that there should only be one VuGen script in this directory at a time.

  5. Open http://localhost/ for further configuration instructions. It will instruct you to modify your hosts file (C:\WINDOWS\system32\drivers\etc\hosts) and may also require you to change the listening ports in the httpd.conf file.

Potential Problems

  • Sites that use HTTPS (also, certificate errors)
  • Websites that include content from multiple host names
  • Websites that do not run on port 80, or that run on multiple ports
  • HTTP redirects
  • Recordings done through proxies (extra headers)
  • Windows integrated authentication (NTLM, Kerberos, etc)
  • Snapshot files do not get removed when the script is regenerated. e.g. A script has 100 non-resources and 200 resources. If the script was recorded in HTML mode, there will be 100 snapshot files. Regenerate the script in URL mode, and there will be 300 snapshot files. Regenerate the script in HTML mode again, and there are still 300 snapshot files.
  • Performance problems. Can probably solve this by caching the HttpRequestResponseMap on disk.
  • Local ports are already in use

Useful Websites