Error Messages

The following table contains errors that can be seen in the Status Log or DSTrace screen. The Error Condition column contains the error text returned to Identity Manager. The Level column specifies the status level. The Description column describes situations that might cause the condition and possible actions you can take to fix the problem. The message text and status level are recorded in the Driver DirXML log.

Error Condition Level Description

A SIF Agent Name must be provided.

Fatal

A SIF Agent Name must be specified in the driver parameters.

A Zone URL must be provided.

Fatal

A Zone URL must be specified in the driver parameters.

Authentication level must be 0-3.

Fatal

An authentication level of 0, 1, 2, or 3 must be specified in the driver parameters.

Connection to ZIS not yet established

Retry

The DirXML® engine sent a command to the driver Subscriber channel. The driver cannot handle the command at this time because it does not have a connection to the ZIS. The engine retries the operation every 30 seconds.

Encryption level must be 0-4.

Fatal

An encryption level of 0, 1, 2, 3, or 4 must be specified in the driver parameters.

Error connecting to Zone = java.io.FileNotFoundException: http://ZISserver/zone1

Error

The specified ZIS server cannot be located. Use the IP address of the ZIS Server instead of a DNS name.

Error connecting to Zone = java.net.MalformedURLException: no protocol: ...

Error

The URL must begin with http:// or https://. Correct the URL and retry.

Error connecting to Zone = java.net.SocketException: Connection refused: Connection refused

Error

The ZIS server is up but the ZIS is not running. Start the ZIS.

Error connecting to Zone = javax.net.ssl.SSLException: Received fatal alert: handshake_failure (no cipher suites in common)

Error

 

Error processing sifobjects.conf, code = xxx

Fatal

The sifobjects.conf file is required. Either the file could not be accessed or the file contains errors and cannot be processed. The DirXML trace contains additional information.

Error processing sifschema.xml

Fatal

The sifschema.xml file is required. Either the file could not be accessed or the file contains errors and cannot be processed. The DirXML trace contains additional information.

java.io.IOException: HTTPS hostname wrong: should be <x.x.x.x.x>, but cert says <y.y.y.y>

Error

The specified communications protocol is secure HTTP (HTTPS). The ZIS has sent its public key certificate to the driver for authentication. The certificate cannot be authenticated. The keystore file jssecacerts contain the server's CA trusted root certificate but the certificate contains the wrong hostname (cn=).

java.net.SocketException: Connection reset by peer: JVM_recv in socket input stream read

Error

The specified communications protocol is HTTP. The specified URL is a ZIS expecting a secure HTTP (HTTPS) connection. The ZIS URL is specified in Driver object > Properties > Driver Parameters.

javax.net.SocketException: Connection timed out: Connection timed out

Error

The specified ZIS server cannot be reached. Verify the ZIS address. If the ZIS server is on the other side of a firewall, verify that the firewall allows the connection.

java.net.SocketException: Network is unreachable

Error

TCP/IP is not configured properly. Verify that the gateway and subnet mask are correct.

java.net.SocketException: Software caused connection abort:

Error

TCP/IP is not configured properly. Verify that the gateway and subnet mask are correct.

javax.net.ssl.SSLException: Received fatal alert: bad_certificate

Error

The specified communications protocol is secure HTTP (HTTPS) with client authentication.

  • An incorrect or no driver keystore file is specified,

    or

  • An incorrect or no driver certificate password is specified.

The agent keystore file and password are specified in the Driver object > Properties > Driver Parameters.

javax.net.ssl.SSLException: Received fatal alert: certificate_unknown

Error

The specified communications protocol is secure HTTP (HTTPS) with client authentication. The server could not authenticate the client's key. Either

  • The client key in the agent keystore file is incorrect.

    or

  • The client's CA trusted root certificate is not contained in the server's (ZIS) trusted keystore.

javax.net.ssl.SSLException: Unrecognized SSL handshake.

Error

The specified communications protocol is secure HTTP (HTTPS). The specified ZIS URL is not correct. The contacted server is not expecting a secure connection. The ZIS URL is specified in Driver object > Properties > Driver Parameters. Try using the IP address of the ZIS Server instead of a DNS name.

javax.net.ssl.SSLException: untrusted server cert chain

 

The specified communications protocol is secure HTTP (HTTPS). The ZIS has sent its public key certificate to the driver for authentication. The certificate cannot be authenticated. The keystore file jssecacerts does not contain the server's CA trusted root certificate.

Manage existing users must be 'yes' or 'no'.

Fatal

Manage existing users must be set to Yes or No in the driver parameters.

Migrate not supported when Match Existing Users is set to no.

Warning

The Driver will not process a Migrate into eDirectory command when Manage Existing eDirectory Users is set to No.

No initialization parameters

No publisher initialization parameters

No subscriber initialization parameters

Publisher filter missing.

Fatal

On driver initialization, the DirXML engine provided no parameters. Verify that the DirXML engine is properly installed and configured.

No Publisher Option Parameters

Fatal

On Publisher channel initialization, the DirXML engine provided no Publisher options. Verify that Driver Object > Properties > Driver Parameters are properly configured.

Poll rate is not defined.

Poll rate must be an integer value

Fatal

A valid poll rate must be specified in the Driver Parameters. The poll rate is an integer greater than 5.

SAXException = Missing whitespace before SYSTEM literal URI. null response received

Error

The specified URL is not correct. The contacted server is not a ZIS. The ZIS URL is specified in Driver object > Properties > Driver Parameters.

SIF Category = xxx, SIF Code = xxx, SIF Description = xxx, yyy;

Error

An error has been returned from the ZIS. This error is reported to Identity Manager. Additional information about the category, code, and description can be found in the SIF Implementation Specification.

SIF does not support the Move operation.

Warning

The SIF Implementation Specification does not contain the notion of containers. Therefore it does not provide for moving objects.

SIF does not support the Rename operation

Warning

The SIF Implementation Specification does not provide for renaming objects.

SIF objects to process not provided.

Fatal

The SIF objects to process are not specified in the Driver Parameters. The values are student, staff, or the names of defined SIF objects.

SIF Schema not available, error processing sifobjects.conf, code = xxx

Fatal

The sifschema.xml file is required. Either the file could not be accessed or the file contains errors and cannot be processed. The DirXML trace contains additional information.

The Incomplete container must be specified.

Incomplete Container does not reference an Organizational Unit.

Fatal

The Incomplete container in the Driver Parameters must contain the DN of an organizational unit (container).

Unable to add home directory: novell.jclient.JCException: licenseConnection -1 DSERR_INSUFFICIENT_SPACE

Error

The NetWare® system must have sufficient user licenses installed. An available license does not exist that can be used for creating the user home directory.

Unsupported Subscriber Channel operation =

Error

The DirXML engine has passed the driver a command that it cannot convert to a SIF operation.

xmlDoc is null.

Error

The DirXML engine passed a null document to the Subscriber channel. Verify that the DirXML engine is properly installed and configured.

ZIS connection operational. (This is not an error.)

Informational

When the driver has established an operational connection with the ZIS this message is logged. If the connection is lost an error is logged. When the connection is reestablished this message is logged. Because only error messages are logged, this message shows in the log file as an error.

Zone is not responding = java.net.ConnectException: Connection refused: connect

Error

The ZIS is not up or is not accepting connections. Verify the ZIS address and port number.

Zone is not responding = java.net.ConnectException: Operation timed out: connect

Error

The specified ZIS server cannot be reached. Verify the ZIS address.

novell.jclient.JCException: modifyEntry -672 ERR_NO_ACCESS

Error

Driver Security Equals is not defined or does not have sufficient rights to perform operation.

provideUsers is not defined.

modifyUsers is not defined.

addUsers is not defined.

Driver parameter <schools> malformed.

Driver parameter <schools> parameter not available.

Fatal

The driver Subscriber channel configuration is not set up correctly. Remove the current driver object and add the driver again.

School Information zone n does not reference an enabled zone

Fatal

The Zone number specified in the SUBSCRIBER CHANNEL section of the Global Configuration Values does not reference an enabled Zone.

At least one School Information must be configured when providing users.

Fatal

When "Be the SIF Default Provider for Students and Staff" is set to Yes, one or more School information sets must be configured in the SUBSCRIBER CHANNEL section of Global Config Values.

Connection to ZIS not yet established

Retry

The driver has not yet established a connection the Zone when an event is received from the DirXML engine. The driver responds with a retry status.

A Search Container must be provided

Fatal

A search container must be specified in the Global Config Values.

Zone n - Enabled zone must have a URL

Zone n - Malformed Zone URL =

Zone n - URL not http or https =

Fatal

In the Global Config Values a Zone is enabled but a URL is not specified or is not correctly formed.

Zone n - Incomplete container must be configured for enabled zone.

Fatal

In the Global Config Values, a Zone is enabled but an Incomplete container is not specified.

Zone n - Staff container must be configured for enabled zone.

Fatal

In the Global Config Values, a Zone is enabled but a Staff container is not specified.

At least one zone must be enabled.

Fatal

In the Global Config Values, at least one Zone must be enabled.

Stopping driver because configured objects were not found in eDirectory.

Fatal

One of the DNs specified in the Global Config Values does not reference a valid object in eDirectory.

Stopping driver because nothing is on sendDocToEngine.

Stopping driver because doc = null.

Stopping driver because something is on sendDocToEngine.

Fatal

Internal Driver error.

SIF objects to process not provided.

SIF objects must include StudentPersonal and/or StaffPersonal.

Driver parameter <zone> malformed.

<zone> parameter not available.

Driver parameter <student> malformed.

<student> parameter not available.

Fatal

The driver Publisher channel configuration is not set up correctly. Remove the current driver object and add the driver again.

No object name provided.

 

Disregard this error message. It does not indicate a problem.