Troubleshooting common problems

Port conflict resolution

The HTTP server hosting the Enterprise Console Web Services Adapter is set to use default port <port>. In case the port is already used by another program in the system in which you install the Enterprise Console Web Services Adapter, you will see the following error on startup:

org.apache.coyote.http11.Http11Protocol init
SEVERE: Error initializing endpoint
java.net.BindException: Address already in use: NET_Bind:8080

If you receive the above error message, then you need to modify the port number to be used. Refer to the Port configuration section for information on how to choose different ports.

Events are not displayed at the Enterprise Console Console

There may be multiple causes to the problem, as follows:

  1. The events cannot be parsed by the Enterprise Console Server.

    This can be detected by running the wtdumprl command at the Enterprise Console Server. If the screen output shows "Parse error" messages for the events, it indicates that the events are not compatible with the rule base in use at the Enterprise Console Server. Refer to the Enterprise Console 3.9 Rule Developer's Guide document for information on how to modify the Enterprise Console Server rule base.

  2. The Enterprise Console Server is down or running slowly

    This can be detected by looking at the contents of the file temp/cache.dat. This file is used to hold events that cannot be sent to a Enterprise Console Server due to the server being down or simply running slowly. Once the Enterprise Console Server becomes available again, the events are automatically flushed to the server. refer to the Enterprise Console Forwarding configuration section for more information on how to modify some of the configuration parameters or enable debugging for the transport library.

Other problems

The above problems are the most likely problems found in the Enterprise Console Web Services Adapter. Additional problems may require assistance from IBM support, in which case you may be asked to recreate the problem with log collection turned on.

Please refer to Enabling log collection for the Enterprise Console Web Services Adapter for information on how to turn on log collection for the Enterprise Console Web Services Adapter.


Related topics
Enabling log collection
Administering the adapter

Parent topic
Troubleshooting