Windows Install

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:
  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 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]

Tagged: