Middle Tier (Xtier) Log File Message Information

  • 3212540
  • 23-Aug-2007
  • 30-Apr-2012

Environment

Novell ZENworks 7 Desktop Management Support Pack 1 - ZDM7 SP1 Middle Tier

Situation

Middle Tier logs messages formated as follows:

"date time", "XTIER-SERVER","Severity","Status Code","XSrvAuthenticateUser:: Session: Session ID, user: userDN, error text"

When informational mode is enabled, the logs will include more information that may or may not be useful in understanding a particular problem. Understanding the Status Code can help identify whether or not further troubleshooting is necessary.

Resolution

Example from Middle Tier informational log:
"Mon, 20 Aug 2007 14:57:22 GMT","XTIER-SERVER","informational","0xC7FFFD63","XSrvAuthenticateUser:: Session: 1c09000101010001 user: user.org failed authenticating to: server.com"
In the status code, a leading 0xC means an error has occurred. The next 3 hex digits refer to the origin of the error, and the last 4 refer to the actual error code.

Example Status Codes:

  1. 0xC7FFFD63:0xCis error, 0x7FF is Facility, 0xFD63 corresponds to the eDirectory error code. FFFFFD63is decimal value -669 meaning ERR_FAILED_AUTHENTICATION Invalid Password.
  2. 0xC7E10005:0xCis error, 0x7E1 is Facility (NDAP module), 0x0005 is the code meaning object not found.This means that the name as entered was not found directly in the context configured, and the Middle Tier needs to do an LDAP search to look up the user name. This does not indicate a failed login attempt.
  3. 0xC7BF0014:0xCis error, 0x7BF is the facility (Middle Tier server), 0x0014 is the code meaning that the Middle Tier could not contact any of the hosts in the primary authentication domain list.

Change Log

14 December sperrin added header to internal notes so I don't have to dig it out each time.