ECMS - Enable Desktop Client Debugging
[Doc 8386 content is unavailable at this time.]
Occasionally it may be useful to create a log file of the Perceptive Content client activity. There are two ways to do this, one by editing the imagenow.ini file used by the client when it starts; and the other by using the Content Client taskbar. Both options are detailed below.
Using the Content Client to create, view, and delete log files
- Login to the Content Client
- With your keyboard and pointing device, press SHIFT and RIGHT-CLICK on the Content Client Taskbar window header (not the menu-bar area or the button area):
- A dropdown menu will appear, as the image shows with Logging as its top item. Clicking on it with your pointing device will reveal a second expanded menu.
- This second menu allows you to specify a logging level, or disable logging if previously enabled. Each selection corresponds to successively greater detail in the log file.
- Select a log level.
- Exit and Re-run the Content Client to begin logging at the logging level selected.
- This same dropdown menu provides options for Viewing the log and Deleting the log, as the image shows.
- By default the View log file option opens the log in Windows Notepad.
- Selecting Explore log folder allows you to use a different editor for viewing.
Manually editing the imagenow.ini file
- In Windows File explorer, navigate to: %AppData%\ImageNow
- In this folder find and open the file: imagenow.ini in a TEXT editor like Notepad.
- In the editor scroll down to (or Search for) [Logging]
- The line that follows should be: debug.level.file=0
- Modify the value following the = sign, e.g., debug.level.file=5
- The value can range from 0 to 5 with higher numbers indicating greater log detail
- Greater log detail will create larger log files
- For this reason it is not advised that logging be set with a high value for normal client use
- Once set, Save the change and exit the editor.
With elevated logging set, run the Perceptive Content Client. Client activity will be logged into the folder %AppData%\ImageNow\log in a file named after this pattern "imagenow_YYYYMMDD.log". Thus an actual log file would be named "imagenow_20180802.log" in the indicated folder. Imaging Team members or Hyland support personnel may be able to use the contents of this file to trouble-shoot client activity issues.
To disable logging, repeat the steps above, but set the log level to 0 in Step 5.