• Quick Install
• Multiple Instances
• Manual Install
• Tips
• Troubleshooting
• More Information

Quick Install

Application: Development or Testing using a single Iguana instance.

This assumes that Iguana is not yet installed on your machine. Creates a single instance of Iguana in the default install directory.

1. Use an account with Local Administrator privileges.
2. Download the latest Iguana release.
3. Run the installer and accept the defaults.
4. Run Iguana by using a web browser to connect to http://localhost:6543/.
5. Login to Iguana using the defaults, user = admin and password = password.
6. Register Iguana.

Multiple Instances [top]

Application: Development or Testing using multiple Iguana instances.

This assumes that Iguana is not installed in the chosen directory. Create multiple instances of Iguana in different directories, using different ports.

Note: For upgrades use the Windows Upgrade procedure.

1. Use an account with Local Administrator privileges.
2. Download the latest Iguana release.
3. Run the installer and follow the instructions:
   • Choose an unused install directory
     Iguana can run from any directory with write permission.
   • Choose an unused port number for the Web Server Port
     Each instance of Iguana must use a different port number.
4. Run Iguana by using a web browser to connect to http://localhost:6543/ (or the the port you chose above).
5. Login to Iguana using the defaults, user = admin and password = password.
6. Register Iguana.

Manual Install [top]

Application: Production, Development or Testing particularly when you need multiple Iguana instances.

This assumes that Iguana is not installed in the chosen directory. Create multiple instances of Iguana in different directories, using different ports.

Note: For upgrades use the Windows Upgrade procedure, for production servers we recommend reviewing our Deployment section.

1. Use an account with Local Administrator privileges.
2. Download the manual install (zip) file for the latest Iguana release.
3. Choose an install directory
   Iguana can run from any directory with write permission.
4. Unpack the zip file into the install directory.
5. Set the Iguana Web Server Port:
   By default Iguana listens on port 6543, if this port is already in use Iguana will not start.
   • You can change your existing Iguana instance to use another port (than 6543) in Settings > IGUANA Setup > Web Server.
   • Or you can edit the port setting for the new Iguana instance in the configuration file, see: How to change settings by editing the IguanaConfiguration.xml file.

     Note: You must run Iguana once to create the configuration file as it is not included in the install.

     During installation it can be useful to run Iguana for the first time as an executable to create configuration file.

6. Install Iguana as a service:
   • Edit iguana_service.hdf to change the service_name=<new name> and (optionally) other parameters, see: How to change Iguana Service details in the iguana_service.hdf file.

     Warning! any Iguana service with same name will be overwritten. To recover from this see: How to recover from overwriting your default Iguana Service during a manual install.

   • Open a Windows Command Prompt window (run cmd.exe)
   • Browse to the Iguana install directory cd <install directory>
   • Run iguana_service --install
   • Start the service from Services administration or using net start <service name>
7. Run Iguana by using a web browser to connect to http://localhost:6543/ (or the the port you chose above).
8. Login to Iguana using the defaults, user = admin and password = password.
9. Register Iguana.

Tips [top]

• For security reasons we recommend changing the admin password on production systems
• We recommend changing the Web Server Port from the default of 6543, this will prevent port conflicts if you install multiple instances of Iguana:
  • You can change the port number in Settings > IGUANA Setup > Web Server.
• When you use the Iguana Automatic Installer it also installs Chameleon, which allows you to edit VMD files.

Troubleshooting [top]

• The automatic installer fails with an error like “Iguana installation failed: Could not find <Iguana install directory>install.log”.
  Solution: Create an empty text file named install.log in the Iguana install directory and run the installer again.
• Web Server Port conflicts: If Iguana fails to start it indicates that the Web Server Port (often the 6453 default) is being used by another application (probably another Iguana instance).
  Solution: Change the port for the new Iguana instance (usually easiest) or the other application:
  • You can change an existing Iguana instance to use another port (than 6543) in Settings > IGUANA Setup > Web Server.
  • Or you can edit the port setting for the new Iguana instance in the configuration file, see: How to change settings by editing the IguanaConfiguration.xml file.
• You cannot run or register Iguana on a Windows Server. Iguana uses javascript, if javascript is disabled in your browser then you will not be able to register or run Iguana. This issue usually occurs when using IE (Internet Explorer) on Windows Servers, because by default they enable enhanced security (IE ESC). This prevents javascript from running on untrusted sites.
  Solution: Add Iguana to the IE trusted sites, see Enabling javascript for IE on Windows Servers. The same solution should work with other browsers, like Chrome and Firefox.

More Information [top]

• Upgrades: How to upgrade Iguana
• Deployment: Best practices for deploying Iguana in a production environment
• Download other Install files: Useful if you need to use an older version, or to try out new (unreleased) features