Iguana HL7 Interface Engine

The Iguana Hl7 Interface Engine is a third-party tool that is installed on a computer/server at the office.  This tool allows our application to interface with on-site devices that can send or receive HL7 files. This tool runs as a service on the PC and can place files into a folder, pick files up from a folder, send files over TCP/IP, and receive files via TCP/IP.  The data is sent to/from the application via web-services.

Learn More about the Iguana Interface Engine here: https://www.interfaceware.com/iguana.html 

A Channel in Iguana refers to a specific interface that is configured. In order for the interface to work, the channel must be running.  Sometimes, a channel may stop.  In this case, a user at the practice that has been provided with a login to Iguana must start the channel back up. 

Please follow the link to the Iguana Support Site. This link will provide step by step documentation on starting or stopping channels in Iguana:  https://help.interfaceware.com/v6/starting-and-stopping-channels 

The Iguana Interface Engine runs in the background on the computer as a Service.  In some scenarios, the service must be manually stopped or manually started if a major issues occurs on the PC. 

Using the Services Manager:

1. Open Windows Services:

   Using the Services Manager is the “standard” way to manage Windows services.

   1. Type “services” into Windows Search and run the Services App:

      This works on Windows 10 and Windows 7. Alternatively you can run services.msc.

      

   2. The Services window appears:
      
2. Stop the Iguana service:
   1. Choose the service to start or stop — in this case we will stop the iNTERFACEWARE Iguana service:
   2. Right click on the service name, click on Stop or Start (depending on what you are trying to do):

      The Status column changes from Running to blank or Stopped to Running.

      
      

Error Message

Error getting startup status:  0 : error - 

About this Error

This error will sometimes appear when the Iguana INTERFACE Engine is unable to start successfully. This usually happens when some of the startup files have been corrupted.

How to Fix this Error

1. Stop the Iguana Service: Starting and Stopping the Iguana Service
2. Navigate to Task Manager > Processes.  Locate 'Iguana' and click 'End Task'.  
3. Navigate to the directory where Iguana is installed (usually C:\Program Files\iNTERFACEWARE\Iguana)
   1. Open the 'Logs' directory and delete the files here (not the folders)
   2. Open the 'Meta' directory within 'Logs' and delete the files here
   3. Open the 'Index' directory within 'Logs' and delete the files here
4. Restart the Iguana Service: Starting and Stopping the Iguana Service
5. Launch Iguana and verify the error is no longer appearing on startup.