Automatic Install
Contents
Note: When installing Iguana as a Production Server please follow the recommendations in the the Best Practice Production Deployment for Iguana article in our Deployment Guide section.
Warning: If you are installing Iguana on a Windows Server you will need to Disable IE ESC (enhanced IE browser security), as it prevents javascript from running which prevents you from registering/running Iguana.
- Download the latest Iguana release.
- To test new features you can choose a snapshot installer
- Make sure you use an account with Administrator privileges.
- If you are upgrading:
- As a precaution you should copy the Iguana configuration files.
- vcs_repo.sqlite
- IguanaConfiguration.xml
- Note: This is a precautionary measure as the manual install does not include these files, so they will not be overwritten during the upgrade process. However it is wise to have copies in case of problems.
- If you have changed the Iguana Service Name then you will need to copy the iguana_service.hdf file.
Note: When you install multiple Iguana instances on one machine they must use different service names.Tip: If you you accidentally overwrite this file you can recover by editing it as per the instructions in the Installation FAQs “How to recover from overwriting your default Iguana install with a manual one”.
- Optionally you can copy the log files, see how to backup and restore Iguana.
Tip: The simplest way to copy the configuration (and log) files is to copy the complete Iguana install directory.
If anything goes wrong just delete the (upgraded) original directory and revert to the (non-upgraded) copy.
- As a precaution you should copy the Iguana configuration files.
- Run the installer and follow the instructions.
- Here is a detailed install guide with screenshots if you need it.
- If the install.log file cannot be found just create an identically named empty text file and re-run the installer.
- Run Iguana using the default url http://localhost:6543 (or the port you specified)
- Login using the defaults, user = admin and password = password
- Note: For a production server you should change the password for security
- Register Iguana.
- If you upgraded Iguana you should refresh the browser cache, usually F5 is enough.
- New User: Click the “Activate Free Trial“ button
- Existing Customer: Click “Log In and Activate” This Instance
Upgrading Iguana
- How to manage upgrades has detailed instructions, particularly important for mission critical systems.
Requirements
- Check your system meets the basic requirements.
- Do not use SMB file shares for Iguana’s log files. This includes Samba and Windows Network shares.
Troubleshooting
- The automatic installer does not recognize a valid license
- Log into your user account and activate a temporary license to regain access to the software.
- Then contact support at support@interfaceware.com with your Iguana ID and request an updated license code with a more recent date.
Notes
- The automatic install includes Chameleon (useful to edit VMD files).
- The automatic install only allows you to run a single instance of Iguana (use a manual install for multiple instances).