Use iutestupgrade to test your Webserve site

If you use an .htaccess file to set the default PHP version to 5.6, iutestupgrade will not override that setting and cannot be used to test your site against PHP 7.1 . For more about configuring PHP versions using .htaccess, see Specify PHP versions on Webserve.

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 hostname. 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 (that is, 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 Support Center Tier 2.

This is document aofw in the Knowledge Base.
Last modified on 2019-04-18 14:01:23.

Contact us

For help or to comment, email the UITS Support Center.