Novell Documentation: eGuide 2.0 - Installing and Starting eGuide

Installing and Starting eGuide

System Requirements

The following are the minimum system requirements for running Novell eGuide software:

System Component	Requirement
Operating System	NetWare^® 5.1 with Support Pack 2 or later NetWare 6 Windows* NT* 4.0 Windows 2000 Red Hat Linux* 7.0 Solaris* 8
Web Server	Apache 1.3.20 (tested and recommended on all platforms) Internet Information Server (IIS) (tested on Windows platforms) HINT: If you need help installing Apache, see Installing the Apache Web Server.
Web Application Server	Tomcat 3.2.3 (tested and recommended) or any that supports the 2.2 Java Servlet Specification HINT: If you need help installing Tomcat, see Installing the Tomcat Web Application Server/Servlet Engine.
Java* Virtual Machine (JVM)	Version 1.2.2 or later for NetWare 5.1 Version 1.3 or later (1.3.1 recommended) for all other platforms
LDAP Directory	Supports LDAP 3 Administrator has access rights Uses clear text passwords for clear text connections NOTE: The clear text requirement is necessary for installation only. You can configure the directory to use SSL after eGuide installation. IMPORTANT: If you plan to use eGuide with eDirectory, version 8 or later is the minimum requirement; version 8.5 or later is required to support password security.
Browser for eGuide Administration Utility	Netscape* 6.0 or later Internet Explorer 5.0 or later
Browser for eGuide Client	Netscape 4.78 or later Internet Explorer 5.0 or later

Tested Environments

Novell tested and supports the following environments:

Operating System	Web Server	Web Application Server
NetWare 5.1 with Support Pack 2a or later and JVM 1.2.2	Apache 1.3.20	Tomcat 3.2.3
NetWare 6	Apache (version included with NetWare 6)	Tomcat (version included with NetWare 6)
Windows NT 4.0 with Support Pack 6a or later	IIS 4.0 Apache 1.3.20	Tomcat 3.2.3
Windows 2000 with Support Pack 1 or later and JVM 1.3.1	IIS 4.0 Apache 1.3.20	Tomcat 3.2.3
Red Hat Linux 7.0	Apache 1.3.20	Tomcat 3.2.3
Solaris 8 with appropriate patches	Apache 1.3.20	Tomcat 3.2.3

Running the Install Program

The way you run the Install program depends on the platform of the server you are installing Novell eGuide on.

NOTE: The following instructions assume you have already downloaded the eGuide product and extracted the eGuide files from the .ZIP or .TAR file.

NetWare Instructions

Copy the following file to the SYS: volume of the NetWare server:

\INSTALL\NETWARE\INSTALL.ZIP

This path is relative to the directory where you extracted the eGuide files.

At the NetWare server console, enter the following command:

java -cp [full_path]/install.zip install

Replace [full_path] with the path to the directory where you downloaded the INSTALL.ZIP file.

Follow the prompts.

Windows Instructions

Using Windows Explorer or Run, run the following file:

\INSTALL\WIN\INSTALL.EXE

This path is relative to the directory where you extracted the eGuide files.

Follow the prompts.

Solaris/Linux Instructions

Open a shell and change to the /install/unix directory.

This path is relative to the directory where you extracted the eGuide files.

IMPORTANT: For the Install program to run, your PATH environment variable must point to the location of a Java* virtual machine (for example, /usr/java/bin).

Enter the following command:

sh ./install.bin

Follow the prompts

Running the eGuide Quick Setup Wizard

You must run the Quick Setup Wizard after installing the Novell eGuide files before you can start using eGuide.

Enter the following URL in your browser:

http://[web_server]/eGuide/admin

Replace [web_server] with the host name or IP address of the Web server where you installed eGuide.

IMPORTANT: The "eGuide" portion of the URL shown above is case sensitive. You must type it exactly as shown (with a capital "G" and all other letters in lowercase). Also, depending on how your Web server and Web application server are configured, you might need to include a port number with the Web server name/IP address (in the format [web_server]:[port_number]). The port number depends on your Web server configuration.

NOTE: If the Quick Setup Wizard fails to start, you might need to modify the configuration of your Web server and/or servlet engine in order to make the eGuide application accessible. The configuration requirements vary depending on the specific Web server. Consult your Web server documentation for details. Be aware that you may need to restart your Web server and servlet engine after reconfiguring them.

Follow the prompts to set up the first LDAP directory you want to search with eGuide.

The Quick Setup Wizard automatically launches the eGuide Administration Utility when it is finished. You can use the Administration Utility to further configure and customize eGuide. For details, see Configuring eGuide.

Though further configuration is usually not necessary in order to begin using eGuide, it may be necessary under the following circumstances:

If the LDAP directory you configure in the wizard does not contain the same schema classes that eGuide uses by default

By default, eGuide creates a User search category and attempts to add the following schema classes to that category: InetOrgPerson, OrganizationalPerson, and Person. If one or more of these classes do not exist in the LDAP directory you configure in the Quick Setup Wizard, you might need to add one or more schema classes to the User search category so eGuide can access all the needed information in the LDAP directory. For details on adding a schema class to a search category, see Adding and Removing Schema Classes from a Search Category.

If you do not want the authentication credentials you entered in the wizard used as the default proxy credentials in Guide
For details on setting proxy credentials in eGuide, see Editing LDAP Settings.