Using iutestupgrade to test your Webserve site

Webserve administrators periodically upgrade the Webserve environment to offer additional features or to patch services and improve security. To give Webserve users a chance to test their sites against upcoming changes, the administrators have created a special server inside the Webserve environment that users can access using the iutestupgrade switch.

The iutestupgrade switch not only forces your web browser to use the special server with the administrator's planned upgrades, but also turns on PHP logging and reporting for your browser session so you can more easily see site errors. This error reporting may change the formatting of your site while on, but will provide invaluable troubleshooting information when testing your website against any server changes.

To enable iutestupgrade:

  1. Type the base URL for your site in your browser, and add the string iutestupgrade to this base URL. For example:

    In the above examples, you would replace ~account with the name of your account. If you also have a virtual host for your site, you would add iutestupgrade to the base virtual host name. For example:

  2. You will then be directed to a page that describes a cookie that was set in your browser. (Make sure your browser is set to accept cookies.)
  3. After this cookie is set, when you view pages on your site, all requests will be delivered by the server the upgrades, if any. Logging will also be visible on the page, displaying PHP or other errors.
  4. If the page on your site has an html <title> </title> tag, the title displayed in the browser will be prefixed with the string Testing -, as a confirmation that you are viewing your site on the alternate server. (Note that the Testing - string is added dynamically by the server; no changes are made to your actual files.)

    If you do not see this, you may be viewing a cached version of the web page instead of the page as it appears on Webserve. To correct this, hold down the Shift key while clicking the reload/refresh button in your browser.
  5. The cookie set in this manner persists until you close all browser windows. To revert to normal browsing of your site, close your browser.

Important details

  • You may test multiple sites simultaneously by appending iutestupgrade to multiple URLS (submitting one at a time). This results in a unique cookie being set for each URL.
  • You may need to submit multiple URLs if your site contains an assortment of full URL links (rather than relative URLs). For example, you have a virtual host named, but there is also a alias. If you have full URL links to both and, both would have to be submitted with iutestupgrade appended to ensure all requests go to the older server.
  • There is no way to separate testing of non-SSL and SSL URLs (i.e., http and https). Any URL submitted with iutestupgrade appended will apply to both http and https.
  • Very important for application driven sites: If your application connects to a MySQL database, remember that when testing your site, you will be connecting to your production database unless you make configuration changes for testing.


If you find any bugs or have general feedback about the upgrades, contact Web Services Support.

This is document aofw in the Knowledge Base.
Last modified on 2017-05-16 11:44:05.

  • Fill out this form to submit your issue to the UITS Support Center.
  • Please note that you must be affiliated with Indiana University to receive support.
  • All fields are required.

Please provide your IU email address. If you currently have a problem receiving email at your IU account, enter an alternate email address.

  • Fill out this form to submit your comment to the IU Knowledge Base.
  • If you are affiliated with Indiana University and need help with a computing problem, please use the I need help with a computing problem section above, or contact your campus Support Center.

Please provide your IU email address. If you currently have a problem receiving email at your IU account, enter an alternate email address.