The Iguana installer makes it easy to upgrade your current Iguana installation. This section helps to make the upgrade process as seamless as possible by showing you how to safely upgrade your Iguana and Chameleon installations in Windows. Before upgrading your system in your production environment, iNTERFACEWARE strongly recommends performing the upgrade on a test machine first.

	Prior to Upgrading Attempting to upgrade without a valid maintenance agreement will cause your license to stop working. To avoid any interruptions, make sure you do the following prior to upgrading: If necessary, get your maintenance/support agreement up-to-date. For more information, see Checking the Maintenance Expiry Date. If you need to renew your maintenance agreement, please contact a support representative by sending an email to support@interfaceware.com. Apply the updated registration code in Iguana. This updates your maintenance expiry date.

To upgrade Iguana in Windows:

• Stop all running Iguana channels, and change each channels's configuration so that they do not start automatically.

• If you are using Iguana 4.0 or later, back up your existing IguanaConfiguration.xml file from the Iguana installation directory. If you are using an older version of Iguana, back up your existing ChannelConfiguration.xml file from the Iguana installation directory. Ideally, this should be done periodically as a routine backup anyway. Other files you may want to back up include VMD files currently in use and the IguanaLicense file.

• Save a copy of the prior release in a temporary directory, just in case you want to revert back to it after performing the upgrade. You can obtain a copy of the latest release from: http://dl.interfaceware.com/iguana/.

• Check the log key numbers in the Logs page for each channel, and note the last key number, date and time after you stopped the channel. This should be done before you perform an upgrade so you can verify that everything is running properly after the upgrade.

• Click Start > Settings > Control Panel > Administrative Tools > Services. The Services window appears.

Services Window

• In the Services window, right-click iNTERFACEWARE Iguana and choose Properties. The iNTERFACEWARE Iguana Properties window appears.

• Click the Log On tab, and note if it is a Local System account or a password-enabled user account. If it is not a local system account, Iguana will automatically reset this option and you will need to set the password again after you perform the upgrade.

iNTERFACEWARE Iguana Properties Window

• If you have installed only one copy of Iguana, or you are upgrading your primary copy of Iguana, you can use Iguana's automatic installer to upgrade your Iguana server. (The primary copy of Iguana is the one you installed using the Iguana installer.) To do this, download and install the latest Iguana version from the iNTERFACEWARE website. The installer automatically uninstalls and reinstalls both Iguana and Chameleon. Please note that this process saves your current configuration and key registration information. It also stops the services and restarts them when it finishes the installation.

	For details on how to use the automatic installer to install the latest version of Iguana, see Installing Iguana On Windows Using The Automatic Installer.

• If you have installed more than one copy of Iguana, and you want to upgrade a copy of Iguana other than your primary copy, you can upgrade your Iguana copy manually. To do this, follow the steps described in Upgrading Iguana in Windows Manually.

	If you want to revert back to the last installed version, just perform the last step with the previous installation.

The next step is to verify that the installation functions as expected.

• Start Iguana, and manually start your channels one at a time to ensure that they are running normally. If a channel is not running normally, you will have to copy the backup files that you created into the iNTERFACEWARE directory. For more information, see Copying Your Backup Files into the iNTERFACEWARE Directory.
• If any of your channels are supposed to start automatically, stop each channel in question and change its configuration accordingly.
• Verify that each channel that you changed functions as expected.

Congratulations, you have successfully upgraded both Iguana and Chameleon. Note that you do not have to register Iguana and Chameleon again.