How can I run Iguana from the command line?

Introduction

If you are diagnosing problems with Iguana, or want to check whether potential problems exist, you can run Iguana from the command line.

Tip: When running Iguana from the command line it uses the current user permissions, not the permissions for admin or localsystem (or the service/daemon user).

If any of your code needs special access you will need to logon as a user with sufficient permissions, for example: The service/daemon user.

Issue [top]

How to run Iguana from the command line.

Solution [top]

Windows:

  1. Open a command prompt with administrator rights:

    You need to use the “Run as administator” option when you open the command prompt.

  2. Run these commands:

    Substitute your own install directory for C:\Program Files\iNTERFACEWARE-Iguana

    • Change to the install directory using this command: 
      cd C:\Program Files\iNTERFACEWARE\Iguana
    • Start Iguana: 
      iguana --run

      Note: You can optionally start Iguana in safe mode to prevent channels from starting:

      iguana --run --safe_mode
  3. Use Ctrl+c to stop the server

Mac/Linux:

  1. Open a terminal window.
  2. Run these commands:

    Substitute your own install directory for /Applications/iNTERFACEWARE-Iguana/

    • Change to the install directory using this command: 
      cd /Applications/iNTERFACEWARE-Iguana/
    • Start Iguana: 
      sudo ./iguana --run

      Note: You can optionally start Iguana in safe mode to prevent channels from starting:

      sudo ./iguana --run --safe_mode
  3. Use Cmd+c to stop the server

How it Works [top]

When you use iguana --run to start Iguana, it outputs several types of information, including:

Sample Information Description
IguanaConfiguration.xml Iguana uses a channel configuration file called IguanaConfiguration.xml. If there are any issues, Iguana will output them in the Command Prompt window.
Database Information (e.g. libmysql.dll, oci.dll, etc.) Iguana tries to load the databases that are specified in your channel configuration. If certain databases are not present or supported, it provides an explanation (e.g. Oracle OCI support not present).
Server Information Iguana outputs server information, including:

  • The URL the server is current listening on;
  • Whether or not the HTTPS server is enabled;
  • Whether or not there are any port conflicts with other processes.
Channel Status Iguana outputs the status of any channels that are automatically started when Iguana is started.
Log Index Files Iguana outputs information on the status of the log index files that are rebuilt.