Novell eGuide 2.1

Readme

June 26, 2002

================================================

1.0 New Features and Enhancements in eGuide 2.1

The following items have been added to Novell® eGuide 2.1:


2.0 Known Issues

2.1 UNIX Platform Installation

XWindows support is required for installing on UNIX platforms.

2.2 Out of Memory Errors

If you experience "Out of Memory" errors, add the appropriate settings to your Novell eGuide configuration file (EGUIDE.CFG) to limit the number of concurrent sessions allowed and to redirect sessions to another eGuide server. For details, the "Settings in EGUIDE.CFG File" appendix in the Novell eGuide 2.1 Administration Guide.

2.3 No Search Results

When you search on an attribute with 'DN' syntax, you will need to have your search filter set to 'Exact' or 'Equals'. This is an LDAP matching rule.

2.4 Administration Utility Lock-Out

Certain actions, such as deleting the eGuide Administrator user, removes access to the Novell eGuide Administration Utility from the eGuide client. To regain access, use a text editor to add the following line to the \EGUIDE\WEB-INF\PROPERTIES\EGUIDE.PROPERTIES file:

eGuideAdminAtStartUp=true

Then launch the following URL:

http://<web_server>/eGuide/admin

Be sure to remove the eGuideAdminAtStartUp command from the EGUIDE.PROPERTIES file after fixing the cause of the lockout.

2.5 Modifications in the Administration Utility

You may need to log in again after making changes in the Administration Utility in order to have those changes take effect.

If you are using Internet Explorer, you also need to set the browser to load each page every time you access it.

In Internet Explorer, click Tools > Internet Options > Settings (on the General tab), and then select Every Visit to the Page under Check for Newer Versions of Stored Pages.

2.6 Org Chart Administration

Only an eGuide User Administrator can modify the ORGCHARTPARENTDN and ORCHARTISPARENT template keys when they are marked Editable. You will also be able to use Role Based Services to set up a role to manage these attributes in the final release build of iManager 1.5.

2.7 JVM Compatibility

Novell eGuide 2.1 requires JVM 1.3.1 or later.

2.8 Overlapping Page Display

Performing a second action before allowing the first to complete (such as starting a search and then accessing the Administration Utility before the search is completed) can confuse the browser and cause page display to overlap. This problem is exaggerated on slow servers.

2.9 Tomcat 3.2 Problems

When trying to run eGuide 2.1 with Tomcat 3.2, eGuide fails with SAX Parser exceptions. In order to get this to work, place the xerces.jar from the eGuide/WEB-INF/lib dir in the tomcat/lib directory and remove the jaxp.jar file from the tomcat/lib. It is recommended to upgrade to the Tomcat 3.3 version.

2.10 URL Requests Between eGuide and iManager

The eGuide task builder in iManager makes URL requests to the eGuide 2.1 servlet to query for categories and category attributes during the task creation process. The eGuide Task wizard, however, currently does not support any https URL requests. Therefore, for this release, it will be necessary to setup eGuide up to run on a non-secure web-server for this URL communication to take place between iManager and eGuide.

If eGuide has already been configured to run on a secure web server and custom categories have already been created, a workaround is to install a second copy of eGuide on a regular web-server, pointing to the same login directory and then copy all settings from the first eGuide install. These settings can be propagated by copying all ...WEB-INF\properties files from the secure eGuide install into the new eGuide WEB-INF\properties directory and re-starting the web-server of the new eGuide install. Then from the eGuide task wizard in iManager, the new eGuide URL needs to be manually entered on page two to initialize URL communication. After this new URL is entered once, the task wizard will retain this URL for future requests until/unless changed manually.

NOTE: You would only want to copy these settings to a new install if 1) You are configured and running on a secure web-server and 2) You have created any additional categories beyond the default User.

If you have not created any new categories and are running on a secure web-server, you only need to re-install on a non-secure web-server, pointing to the same login directory.

2.11 Web-Based Client Password

If you're using a non-web based client to administer passwords (such as ConsoleOne), make sure to use LDAP standards of alpha-numeric characters.

2.12 Photo Options Moved

Photo options are now handled via the UIHandlers.xml file located in the WEB-INF\plugins\eGuide directory.

2.13 Configuring the LDAP Server for Secure or Non-secure Searches

There are now two security options for eDirectory LDAP. The first option is "Allow clear text passwords", which supports eDirectory's traditional SSL. This option is not selected by default and therefore will require secure passwords for access to LDAP. The second option, new to eDirectory 8.7, is Transport Security Layer (TLS), which supports an open SSL implementation. There are two TLS settings: Require Simple Bind Passwords and Require TLS for All Operations.

Require Simple Bind Passwords is selected by default, which means that the server will need to be configured to accept TLS connections, and clients must use TLS when connecting. To access this option in Novell iManager, click the Roles and Tasks button > LDAP Management > LDAP Overview > View LDAP Group Objects > double-click an LDAP Group object > click Information.

Require TLS for All Operations is not selected by default. Selecting this option forces any operation to fail unless the connection is protected by TLS. To access this option in Novell iManager, click the Roles and Tasks button > LDAP Management > LDAP Overview > View LDAP Server Objects > double-click an LDAP Server object > click Connections. For more information, see "Understanding the Secure Sockets Layer Protocol" in the Novell eDirectory 8.7 Administration Guide.

3.0 Legal Notices

3.1 Disclaimer, Export Notice, Copyright, and Patents

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.

This product may require export authorization from the U.S. Department of Commerce prior to exporting from the U.S. or Canada.

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 © 2002 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.

U.S. and Foreign Patents Pending.

3.2 Trademarks

Novell and NetWare are registered trademarks of Novell, Inc. in the United States and other countries.

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