Novell DirXML 1.1a for NetWare

1.0 Documentation

For information about DirXML^® and the drivers, refer to the documentation located at the Novell Product Documentation site.

You can view the documentation online in HTML, or download a copy in PDF format.

The latest readme file is also available online at the same location.

2.0 Special Instructions

If you use Novell^® iManager 1.5 to administer User objects and you also use the DirXML Driver for GroupWise^® (or if you have used it in the past), you should refer to TID #NOVL82926 and download the patch for iManager. The patch is necessary for maintaining correct Group Lists, GroupWise PO memberships, and GroupWise Distribution Lists.

If you don't download the patch, you will experience errors after you view Group Memberships on a User object. If you select any other tabs from the Modify Object task after viewing Group Memberships (such as Login Script, See Also, or Postal Address), you will see a message indicating that the GroupWise Post Office DN is not a group. You cannot exit iManager until you delete the offending DN. If you delete the offending DN, the User's association with his or her post office and distribution lists will be lost.

3.0 Known Issues

• Migration events being dropped: If you experience a -734 cache error, virus protection software might be corrupting Novell cache files. These are the symptoms:
  • A cache error -734 occurs.
  • A message in the trace says that the event cache has been deleted, and events that are in the cache are dropped.
  • The driver can begin processing again and succeeds until another cache error occurs.

  To resolve the issue, make sure your virus protection software is excluding TAO files. In addition, exclude from virus protection the Novell\NDS folder and all the subfolders below it.

• Due to limitations of the Netscape* browser, you cannot administer DirXML with iManager. This will be fixed in a future release.
• If you are running DirXML 1.1a on a NetWare 5.x server, you should ensure that your JClient files match. The JClient version mismatch problem might arise if you are (1) upgrading from DirXML 1.1 to DirXML 1.1a, or (2) installing DirXML 1.1a for the first time on NetWare 5.x.

  Symptoms of JClient version problems include:

  • The DirXML installation program does not work when you run the install program. You will not be able to install DirXML until after you copy the new JCLIENT.JAR from SYS:\JAVA\LIB to SYS:\NI\UPDATE\LIB.
  • The DirXML Driver for eDirectory will not start even though the DirXML installation succeeded. You might see the following errors in the system console when you try to start the driver: "Symbol already defined: Java_novell_jclient_JClient_", "Symbol already defined: Java_novell_jclient_NWFile_", or "Error Processing Public Records." You should copy the new JCLIENT.JAR from SYS:\JAVA\LIB to SYS:\NI\UPDATE\LIB.
  • If you create passwords that contain extended foreign characters such as accented or double-byte characters, we recommend that you manage passwords from one kind of administration tool. If you are using both ConsoleOne^® and iManager, you might have problems authenticating to one client if you created your password in the other system. Each handles extended characters differently and submits different hash values to eDirectory.

    If you need to create passwords in both administration tools, you should restrict passwords to the lower 128 ASCII characters.

  • To install the DirXML plug-ins for iManager, the DirXML installation CD should be mapped or mounted locally. If you run the DirXML installation from a CD image mapped or mounted remotely, the iManager plug-ins will not install.
  • After you install the iManager DirXML plug-ins, you must stop and restart the Web server.
  • If your display resolution is set at 600x800, you might have a problem closing help screens because the help screens display in a larger dialog box than the program you are running. In this case, you can close the help screen by pressing ALT+ F4.
  • If you experience authentication problems during the installation, and if you are certain your authentication information is correct, you should ensure that the NCP packet signature level is not set to 3. If the parameter value is set to 3, you will see a -864 error in DSTrace. You should set the value to 1, reboot your computer, run the installation program, and then set the value back to 3 to maintain the same security level.

    NCP packet signatures determine the level of enhanced security support. Enhanced security includes the use of a message digest algorithm and a per connection/per request session state. The values are as follows: 0=disabled, 1=enabled but not preferred, 2=preferred, and 3=required. Setting this parameter to 2 or 3 increases security, but decreases performance.

  • When running the installation program from a non-CD source, NetWare uses an 8.3 file-naming convention. If the installation directory path contains a long name, the path gets truncated, and you might encounter the following symptoms during installation: failure to open source files, failure to extend the schema, or failure to update the ConsoleOne snap-ins.

    To resolve this, you should change the directory path name to an 8.3 file format (for example, from sys:install/dirxml_final_11a to sys:install/dirxml11)

4.0 Legal Notices

Novell, Inc. makes no representations or warranties with respect to the contents or use of this documentation, and specifically disclaims any express or implied warranties of merchantability or fitness for any particular purpose. Further, Novell, Inc. reserves the right to revise this publication and to make changes to its content, at any time, without obligation to notify any person or entity of such revisions or changes.

Further, Novell, Inc. makes no representations or warranties with respect to any software, and specifically disclaims any express or implied warranties of merchantability or fitness for any particular purpose. Further, Novell, Inc. reserves the right to make changes to any and all parts of Novell software, at any time, without any obligation to notify any person or entity of such changes.

You may not export or re-export this product in violation of any applicable laws or regulations including, without limitation, U.S. export regulations or the laws of the country in which you reside.

Copyright ^© 2003 Novell, Inc. All rights reserved. No part of this publication may be reproduced, photocopied, stored on a retrieval system, or transmitted without the express written consent of the publisher.

Patents Pending.

ConsoleOne, DirXML, GroupWise, and Novell are registered trademarks of Novell, Inc. in the United States and other countries.

eDirectory is a trademark of Novell, Inc.

All third-party trademarks are the property of their respective owners.