Novell eGuide 2.1.2 Readme

January, 30 2004
1.0 New Features and Fixes in Novell eGuide 2.1.2
1.1 New Features
1.2 Fixes
2.0 Known Issues
2.1 eGuide Roles Are Not Added
2.2 Users Cannot Update Information Without Role-Based Services Rights
2.3 eGuide 2.1.2 Does Not Connect to the Server if Installed Over an Existing Version
2.4 eGuide Does Not Install After a Previous Uninstall on Novell Nterprise Linux Services (NNLS)
2.5 Cannot Access eGuide on Red Hat Advanced Server
2.6 eGuide is Unable to Send Notifications to NetMail SMTP
2.7 UNIX Platform Installation
2.8 Out of Memory Errors
2.9 No Search Results
2.10 Administration Utility Lock-Out
2.11 Modifications in the Administration Utility
2.12 Org Chart Administration
2.13 JVM Compatibility
2.14 Overlapping Page Display
2.15 Tomcat 3.2 Problems
2.16 URL Requests Between eGuide and iManager
2.17 Web-Based Client Password
2.18 Photo Options Moved
2.19 Configuring the LDAP Server for Secure or Non-secure Searches
2.20 Uninstalling eGuide
2.21 Creating New Self Management Roles in eGuide
2.22 Role-Bases Services Not Working with eGuide
2.23 Upgrading NetWare 6.0 to NetWare 6.5/Virtual Office
2.24 Configuring SSL on AIX
3.0 Documentation
4.0 Legal Notices

1.0 New Features and Fixes in Novell eGuide 2.1.2


1.1 New Features

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

NOTE:  These new features were first available in eGuide 2.1.


1.2 Fixes

The following issues have been resolved in eGuide 2.1.2:


2.0 Known Issues


2.1 eGuide Roles Are Not Added

When you attempt to add an object to eGuide roles, the object does not add when you click Add. To resolve this, you must apply a patch. For information about this patch, see TID 10089040.


2.2 Users Cannot Update Information Without Role-Based Services Rights

Role-Based Services (RBS) lets users administer their own personal information in Novell® eDirectoryTM using the Novell iManager utility. Unless users have these rights, they cannot edit their own information.


2.3 eGuide 2.1.2 Does Not Connect to the Server if Installed Over an Existing Version

If you install eGuide 2.1.2 over an existing version, you can keep the existing directory configuration or do a new installation. To clean up the configurations from a previous installation, you must unload Tomcat before you begin the installation. Otherwise, only a portion of the configuration files are removed, which breaks the eGuide configuration.

To resolve this issue, open the webapps\eguide\WEB-INF\properties directory and remove the *.properties files. Then run the eGuide configuration wizard again.


2.4 eGuide Does Not Install After a Previous Uninstall on Novell Nterprise Linux Services (NNLS)

When you uninstall eGuide on NNLS, the JVM CA store (cacerts) remains. When reinstalling eGuide, the eGuide configuration piece attempts to add the eDir certificate to the store. This fails because there is already a certificate with the same alias. To resolve this, you need to delete the certificate with that alias.

Use the following command to delete the certificate:
/opt/novell/java/bin/keytool -delete -alias vofficetreeca -keystore /opt/novell/java/jre/lib/security/cacerts


2.5 Cannot Access eGuide on Red Hat Advanced Server

Localhost is not defined in the file /etc/hosts so Apache and Tomcat are unable to communicate with each other resulting in an Apache internal server error in the web browser that is trying to access eGuide.To resolve this issue, edit the /etc/hosts file and ensure that the line 127.0.0.1 localhost appears. You can also verify that the configuration is working by pinging the localhost.After you verify that the configuration is working, reboot your server.


2.6 eGuide is Unable to Send Notifications to NetMail SMTP

In order for the sendto user option to function properly in eGuide, the SMTP service must be on a separate server from where eGuide is installed.


2.7 UNIX Platform Installation

XWindows support is required for installing on UNIX platforms.


2.8 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.9 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.10 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.11 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.12 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.13 JVM Compatibility

Novell eGuide 2.1.2 requires JVM 1.4.1 or later.


2.14 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.15 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 4 version.


2.16 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.17 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.18 Photo Options Moved

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


2.19 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 TLS for Simple Binds with 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.20 Uninstalling eGuide

To uninstall eGuide, use the Add/Remove programs on Windows*. The default location of this directory is relative to the servlet container.


2.21 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.22 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.23 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.2 that don't exist in existing installed properties files. You should compare the files before replacing the newly installed files.


2.24 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.2 Administration Guide


3.0 Documentation

For the most recent documentation on setting up and configuring eGuide, see the eGuide 2.1.2 Administration Guide .


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