Novell eGuide 2.1.1 Readme

August 4, 2003
1.0 New Features in Novell eGuide 2.1.1
2.0 Known Issues
2.1 UNIX Platform Installation
2.2 Out of Memory Errors
2.3 No Search Results
2.4 Administration Utility Lock-Out
2.5 Modifications in the Administration Utility
2.6 Org Chart Administration
2.7 JVM Compatibility
2.8 Overlapping Page Display
2.9 Tomcat 3.2 Problems
2.10 URL Requests Between eGuide and iManager
2.11 Web-Based Client Password
2.12 Photo Options Moved
2.13 Configuring the LDAP Server for Secure or Non-secure Searches
2.14 Uninstalling eGuide
2.15 Creating New Self Management Roles in eGuide
2.16 Role-Bases Services Not Working with eGuide
2.17 Upgrading NetWare 6.0 to NetWare 6.5/Virtual Office
2.18 Configuring SSL on AIX
2.19 Installing eGuide on NetWare 6 SP3 with JVM 1.4.1
3.0 Legal Notices

1.0 New Features in Novell eGuide 2.1.1

The following items have been added to Novell® eGuide 2.1.1.

NOTE:  These new features were first available in 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.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.1 Administration Guide on the Novell Product Documentation Web site.


2.14 Uninstalling eGuide

To uninstall eGuide, delete the "eguide" directory created during the eGuide install. The default location of this directory relative to where you installed it is ...\webapps\eguide.


2.15 Creating New Self Management Roles in eGuide

If you create an eGuide role using the iManager Create eGuide Role wizard and you select the checkbox to create a Self Management role, the checkbox value is not being saved. The rest of the wizard pages will reflect the UI for a regular eGuide role. The role will be created as a regular eGuide role and not a Self Management role.

To work around this, you can modify the existing eGuide Self Management role included with iManager, install it as into different collections, and change the task list as desired.


2.16 Role-Bases Services Not Working with eGuide

There are two Role-Based Services issues known to exist in eGuide 2.1 caused by the rbsCoreLDAP.jar file (see bullets below). These issues should be resolved by downloading a new rbsCoreLDAP.jar file that is available on the Novell Support Web site and replacing it with the existing file located in the eGuide ...\WEB-INF\lib directory. Refer to Solution ID# NOVL82867.


2.17 Upgrading NetWare 6.0 to NetWare 6.5/Virtual Office

If you upgrade from NetWare 6 to NetWare 6.5 and install Virtual Office at the same time, existing properties files will not be migrated from the old eGuide install path. If you have made extensive customizations, you can migrate the properties files by manually moving these files.

sys:webapps/eGuide/WEB-INF/properties is the old path where the .properties files can be found.

sys:tomcat/4/webapps/eGuide/WEB-INF/properties is the new path.

NOTE:  There are keys in the new properties files for eGuide 2.1.1 that don't exist in existing installed properties files. You should compare the files before replacing the newly installed files.


2.18 Configuring SSL on AIX

Auto-configuration of SSL requires a JVM security library that is not present in AIX. Therefore, manual configuration of SSL is required on the AIX platform. For instructions on how to manually set up SSL, see the eGuide 2.1.1 Administration Guide.


2.19 Installing eGuide on NetWare 6 SP3 with JVM 1.4.1

If the JVM is upgraded to 1.4.1 on NetWare 6 SP3, the eGuide 2.1.1 standalone installation program will not edit the sys:\Apache\conf\adminserv.conf file automatically, causing the eGuide program to not run properly.

To fix this problem, add the following line to the end of the sys:\Apache\conf\adminserv.conf file:

include sys:\webapps\eGuide\WEB-INF\eGuide-apache.conf


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

Novell and NetWare 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.