Starting the Listener on Image Services servers

Most products that support the Dashboard, such as IBM FileNet Content Manager, IBM Content Manager, Image Services, Image Services Resource Adapter, IBM® Enterprise Records , and other products, make the Listener active by default. However, you must activate the Listener explicitly on an Image Services server (all versions).

The perf_mon.script file is read from two locations. The released version of the file is in /fnsw/lib/perf. Any customizations to the file are copied to /fnsw/local/sd, so the files are not overwritten when the next release is installed. When you start the Image Services or Process Engine system, the Listener first looks for /fnsw/local/sd/perf_mon.script on UNIX systems or drive:\fnsw_loc\sd\perf_mon.script on Windows systems. If the script does not exist, the Listener looks in the /fnsw/lib/perf directory on UNIX systems or the drive:\fnsw\lib\perf folder on Windows systems. To turn on the Listener automatically whenever Image Services or Process Engine (before release 5.0) is started, complete the following steps:

1. For UNIX, go to the: /fnsw/local/sd directory, for Windows to: drive:\fnsw_loc\sd to determine whether a perf_mon.script file exists.
   • If a perf_mon.script exists, skip to Step 2.
   • If a perf_mon.script does not exist, create one by copying it from /fnsw/lib/perf/ for UNIX or drive:\fnsw\lib\perf for Windows. cp /fnsw/lib/perf/perf_mon.script /fnsw/local/sd/perf_mon.script (Copy the perf_mon.script file to drive:\fnsw_loc\sd on a Windows server.)
2. From the /fnsw/local/sd directory for UNIX or drive:\fnsw_loc\sd for Window), use your preferred editor to update the perf_mon.script file. Add the line set ’listener true’ before the poll line. Your edited file looks similar to this example:

   # stamp
   #
   schedule 0 0:00:00 2:00:00
   schedule 0 6:00:00 0:15:00
   schedule 0 19:00:00 2:00:00
   schedule 1 0:00:00 2:00:00
   link 0 1
   link 1 0
   link 2 0
   link 3 0
   link 4 0
   link 5 0
   link 6 1
   set listener true
   poll /fnsw/local/sd/1/perflog
   echo done
   # stamp d;lkfjpojr;wohf  

3. Save and Exit the file.
4. Restart the Image Services software. The Listener starts automatically.