Configuring Iguana

The Web Interface

This article describes how to configure Iguana after it has been installed and deployed.If you are migrating Iguana to a new machine then see Moving Iguana from one Server to Another.

Accessing the Web Interface

Iguana has an intuitive web interface, which makes remote administration and monitoring easy. As long as the Iguana service is started, the web interface will be easily accessible by opening any web browser and pointing it to a specific port on your local machine.

To access the web interface:

  1. Ensure the Iguana Service is running.
  2. In your web browser’s address bar, type http://localhost:6543 (6543 is the default web server port).

    Note: You can also easily access Iguana’s web interface remotely by entering either one of the following lines in your web browser’s address bar:

    • http://host_name:6543, where host_name is the name of the host that’s running Iguana, or
    • http://ip_address:6543, where ip_address is the IP address of the machine that’s running Iguana.

    In all cases, 6543 is the default web server port. Your installation of Iguana may have specified a different web server port. See the Installation section for details.

    You can change the port on which the Iguana web server is running. For more information, see Changing Iguana’s Default Web Server Port.

  3. When you start the web interface, a screen may appear that displays the informational messages generated by the Iguana service upon startup. You can examine these messages to ensure that your server is behaving as expected.
  4. Click Continue To Login to continue to the Iguana login screen.

Change the Administrator Password [top]

Iguana ships with a single user Administrator Account enabled. The username for this account is admin, and the password is “password”.

We strongly recommend changing the Administrator Password for production servers:

  1. Login as admin.
  2. From the Dashboard, click the Settings tab.
  3. Click the Users and Roles > Edit Your Account link.
  4. Click the [Change Password] link:
    Note: Confirm you are editing the admin user.
  5. Enter the current and new password in the fields provided, then click Save Changes:

    The Settings > Users page appears, with a message confirming that your changes were saved:

Manage Users and Roles [top]

For Production Servers you will need to create Users and use Roles to give them appropriate permissions.

  1. From the Dashboard, click the Settings tab.
  2. To manage users click the User and Roles > Users link, this screen appears:
    From here you can add and remove users, and edit user rights.
  3. To manage roles click the User and Roles > Roles link, this screen appears:
    From here you can create and delete roles, and and add/remove users to/from roles.
  4. See the Users and Roles references for details.

Web Server Settings [top]

Iguana has a web interface that makes remote administration and monitoring easy. By default, Iguana’s web server is configured to run on port 6543. If another application is using that port on your machine, you must change the default port that Iguana is run on.

Note: For information on how to use ports in Iguana, see Port Management Tips.

To change Iguana’s default web server port:

  1. Open Iguana, and click the Settings tab at the top right of the Dashboard.
  2. Click the IGUANA Setup > Web Server link.
  3. In the Web Server Settings page, click Edit, then enter the Web Server Port that you want to use. In the example below, port 8085 is selected.
  4. Click Save Changes and Restart Web Server, a screen appears indicating that the web server is about to be restarted.
  5. Once the web server has restarted, the Web Server Settings page is redisplayed.
    Note: Not all changes will require a restart.

You can also change the web port by editing the Configuration XML File.

Changing the Server Name

Naming your Iguana instance gives it a label that makes it easier to manage multiple servers. This name will be displayed on Dashboard, and can be seen in the “ServerName” entry when running the http://localhost:6543/monitor_query? command.

Note: The Server Name is merely a label, it bears no relation the URL used to access your Iguana Server.

  1. From the Dashboard, click the Settings tab.
  2. Click the IGUANA Setup > Web Server link.
  3. In the Web Server Settings page, click Edit link.
    • When you enter a server name for the first time the server will “Unnamed“:
  4. Enter the name in the Server Name field, and click the Save Changes and Restart Web Server button:

    The name change will usually be accepted without requiring a restart:
    Screen Shot 2016-08-29 at 19.32.42

Changing the Web Port in the Configuration XML File

To change Iguana’s default web server port via the configuration XML file:

  1. In the Iguana installation directory (e.g. C:\Program Files\iNTERFACEWARE\Iguana), use a text editor to open IguanaConfiguration.xml.
  2. In the <web_config> section, edit the port attribute to be the port that you want to use. In the example below, port 8085 is used:
  3. Save your changes.
  4. In the directory in which you have installed Iguana, right-click the Iguana Internet shortcut and select Properties.
  5. The Iguana Properties window appears:
  6. Select the Web Document tab, and edit the URL field so that the port number after localhost: is the port that you chose above.
  7. Click OK to save your change.
  8. Stop and restart the Iguana Service.
    Note: This is required when you change the web port on which Iguana is running.

Change the Plugin Server Port [top]

By default, Iguana uses 6123 as the plugin communication server port. If another application is using this port on your system, you can change the plugin communication server port.

You can change this port using the Plugin Settings page.

Set the Config File Directory [top]

If you are running Iguana 4.0 or later, you can specify the directory in which the configuration file is located.

This allows you to:

  • Keep all of your Iguana configuration files in a single directory structure
  • Easily test upgrades to Iguana, as you can put the test configuration file in a separate directory and roll back as needed
  • Change configuration files as necessary

To specify the configuration file directory:

  1. Stop your Iguana service if it has already been started, see Starting and Stopping the Iguana Service.
  2. Using a text editor, edit the iguana_service.hdf configuration file. This file is located in the directory in which Iguana is installed.
  3. If you are running Iguana on Windows, edit the command_line field in the iguana_service.hdf file. Use the –working_dir parameter to specify the directory containing the configuration file. For example:command_line=iguana.exe --working_dir "D:\build\v3"
  4. If you are running Iguana on Unix, Linux or Mac OS X, edit the command_line_unix field in the iguana_service.hdf file. Use the –working_dir parameter to specify the directory containing the configuration file. For example:command_line_unix=./iguana --working_dir "Users/admin/build/v3"
  5. Save the edited iguana_service.hdf file and restart your Iguana service.

Note: You will need a valid Iguana license for each working directory that you use. See Registering Iguana for more information.

Leave a Reply