...
An unexpected and abrupt shutdown of the Iguana process or service.
Iguana services are running but unable to process channels
Iguana can process messages but unable to access dashboard (ex. port 6543)
Iguana services and dashboard are working but unable to commit changes
...
Initial Investigation and Support Preparation
[Prep as Support team will ask]
Crash Dump: [Def]
Are there crash dump files in the Iguana working directory? If so, send them to
iNTERFACEWARE Support following the documentation here: http://help.interfaceware.com/v6/how-to-report-problems#ftp
Before asking the client to send us the crash dump files, make sure they are running Iguana 6. The development team will not look at Iguana 5 crash dump files.
Some factors to consider if no crashdumps were created:
The server ran out of memory
Iguana does not have the correct permissions
Too many opened files, cannot open a new file for crashdump
mac and Linux might have it disabled more information here
Send us the ServiceErrorLog.txt file [Def]
Look for errors caused by the log files being locked by another program.
In order to aid the development team in their investigation, also ask the followingInitial Investigation Questions:
Operating system, process architecture, and Iguana version: [Explain Why]
What they were doing when the crash happened, and how many users were using Iguana at that time?
Were there any recent changes to the Iguana environment?
Is there any backup or antivirus software on their server?
Is there any scheduled server maintenance, and if so, does this involve a server restart?
Is this a production instance?
If the instance is HA
Search the company in Google Drive and understand their HA architecture diagramMemory and CPU Usage
Questions related to High Availability Iguana
Did WK1 or WK2 go down?
Did the failover execute successfully?
...
Ran out of memory
An old Iguana instance may still be running after an improper shutdown (potentially due to server maintenance), and can have a lock on the log files still
Before asking the client to send us the crash dump files, make sure they are running Iguana 6. The development team will not look at Iguana 5 crash dump files.
Some factors to consider if no crashdumps were created:
The server ran out of memory
Iguana does not have the correct permissions
Too many opened files, cannot open a new file for crashdump
mac and Linux might have it disabled more information here
...
Adapted from Paul Le’s article in Basecamp.