Debugging Iguana From The Command Line |
If you are diagnosing problems with Iguana, or want to check whether potential problems exist, you can run Iguana from the command line:
C:\Program Files\iNTERFACEWARE\Iguana>iguana --run |
When you use iguana --run from a command prompt, the Iguana server is being run as a normal console process instead of as a service. This allows you to diagnose issues such as:
- Incompatible versions of Chameleon - you should be using the version of Chameleon (or higher) that's shipped with Iguana.
- Port conflicts - you may have applications on your system that are already listening on ports that Iguana wants to use.
 | ||
When using iguana --run, note that it uses the current user permissions, not the admin or localsystem permissions for services. | ||
 |
When you use iguana --run to start Iguana, it outputs several types of information, including:
| Sample Information | Description |
|---|---|
| IguanaConfiguration.xml | Iguana uses a new channel configuration file called IguanaConfiguration.xml in versions 4.0 and later. Iguana will automatically convert any existing Iguana configuration files into the new format. 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:
|
| Channel Status (Iguana 4.0 or later only) | Iguana 4.0 and later versions outputs the status of any channels that are automatically started when Iguana is started. |
| Log Index Files (Iguana 4.0 or later only) | Iguana 4.0 and later versions outputs information on the status of the log index files that are rebuilt. |