TROUBLESHOOTING
JAGUAR PRO ONLY
Software support is available only for JAGUAR PRO users. Most JAGUAR production
versions are very stable while the TEST versions may have issues due to a fast
development cycle. If JAGUAR crashes unattended, no problem: JAGUAR has been
developed for an unattended 24x7 use so LIFESAVER.EXE will normally wake up
JAGUAR again and no recordings will be lost.
When you report an issue to groups.io, it will be fixed asap - just help the
development team by giving a "recipe", or detailed instructions how to
reproduce the problem. We cannot fix the problem without adequate details so
please don't send bug reports just mentioning "Jaguar crashed last night" or
"xxx failed". If we cannot reproduce the issue based on your description, we
will ask for more information and/or start a detailed debugging process.
If you have any issues at JAGUAR start-up, most likely the culprit is located
in the SYSTEM.INI file. You can try TOOLBAR > SHUTDOWN > RESET which
deletes SYSTEM.INI and/or SETUP.INI and restarts JAGUAR. An alternative way is
to delete SYSTEM.INI and SETUP.INI files manually from the Jaguar folder.
JAGUAR will deploy all the default settings at the next start-up. If nothing
else seems to help, you may also try to make a fresh install from the JAGUAR
full-installation package.
Also, if you are running an old version, you should try installing the latest
version (via STAR EXPESS) before reporting any bug or issue. It is possible
that the issue has already been fixed.
Sometimes the culprit may be in the Windows operating system itself. For
example, users should enable the Windows cache flushing if external hard disks
are used, and disable all sleep states in Power Settings as dscribed in the
installation instructions.
When a severe error/crash happens, Jaguar writes a line into LIFESAVER.LOG.
This log is saved in the Jaguar folder. One common log entry is HANG. This
means that the I/O flow from Perseus to the buffer disk is interrupted, and it
cannot be recovered automatically without a JAGUAR restart. If your
LIFESAVER.LOG contains a lot of these entries, changing a USB port or the USB
cable may help. Note that in a 24x7 operation, there may be a few such HANGs
weekly also in "100% healthy" setups.
HOW TO
* CRASH / HANG / WRITE messages can contain a
reson code (#00000000-#99999999) in LIFESAVER.LOG. If you find several CRASHES
/ HANG lines with the same reason code, please provide that code as part of the
bug message. Currently known issues (no need to report these) are
WRITE #00000000 = Writing Perseus data stream to disk fails, zero bytes
written
CRASH #40000000 = Perseus input buffer reference fails
In "Zero bytes written" case we could continue operation, but Jaguar decides to
bring the services down and ask Jaguar restart from LIFESAVER.EXE, without
doing this the currently running recording(s) would be lost. After this forced
restart the current recording continues normally.
* You can test how your setup survives from unattended crashes by creating an
artificial crash during recording: type
.CRASH
(dot before CRASH) end press enter and see if Jaguar is automatically recovered
and if the recording continues normally after that (artificial)
crash.