diff --git a/documentation/areaDetectorViewers.html b/documentation/areaDetectorViewers.html
index 85ab053..d21b0f6 100755
--- a/documentation/areaDetectorViewers.html
+++ b/documentation/areaDetectorViewers.html
@@ -22,6 +22,7 @@
Overview
ImageJ Viewer
IDL Viewer
+ Troubleshooting
Overview
@@ -79,8 +80,9 @@
Files\ImageJ\jre\lib. On Linux it will be wherever the jre/lib directory for Java
is located. Note that it should be necessary to create such a configuration file
on almost all areaDetector clients because the CAJ default value of max_array_bytes
- is 16384, which will be too small for almost any detector. However, it appears that
- the CAJ library actually ignores the value of max_array_bytes, so it is not actually
+ is 16384, which will be too small for almost any detector. However, the
+ the CAJ library dynamically changes the maximum array size if the server array
+ is larger than max_array_bytes, so it is not actually
necessary to set its value for the EPICS_AD_Viewer plugin.
Start ImageJ and go to the Plugins/EPICS_areaDetector/EPICS_AD_Viewer to run the
plugin
@@ -249,5 +251,32 @@
to display the data from this areaDetector plugin, and will be provided in a future
release of areaDetector.
+
+ Troubleshooting
+ If the ImageJ or IDL viewer is not displaying new images as the detector collects them check the following:
+
+ - If other EPICS channel access clients (e.g. medm, caget) running on the same machine as the viewer
+ cannot connect to the IOC then check the following:
+
+ - There may be a firewall blocking EPICS channel access either on the server (IOC) machine or the client
+ (viewer) machine.
+ - The environment variable EPICS_CA_ADDR_LIST may need to be set to allow the client to find the IOC
+ if the IOC is not on the same subnet as the viewer or if other EPICS channel access settings do not
+ have their default values.
+
+
+ - If other EPICS channel access clients (e.g. medm, caget) running on the same machine as the viewer
+ can connect to the IOC then check the following:
+
+ - The detector is actually collecting images, and the ArrayCallbacks PV is set to Enable.
+ - The image plugin (NDStdArrays) has the EnableCallbacks PV set to Yes, and that the
+ MinCallbackTime PV is not set too large.
+ - The environment variable EPICS_CA_MAX_ARRAY_BYTES is set to a value at least as large as the
+ size of the arrays to be sent to the viewer. This environment variable must be set on the machine
+ that the IOC is running on before the IOC is started. It must also be set on the machine that the IDL
+ client is running on before IDL is started. It is not used by the ImageJ client, as discussed above.
+
+
+