<< Contents< PreviousNext >Index >> Lutris Technologies, Inc.


 

Chapter 3
Installation

 

 

This chapter explains how to install Enhydra. You can install Enhydra on any system with a standard Java virtual machine. In particular, Enhydra supports:

For more detailed system requirements, see the top-level index.html file on the Enhydra CD.

Procedure

Follow these steps to install and configure Enhydra:

  1. If you do not already have the Java Development Kit (JDK) 1.2.2, install Java2, as described in "Downloading and Installing Java 2."

  2. Insert the Enhydra CD, and load the index.html file in the top level of the CD into your web browser. This file contains general information, including system requirements and registration information. Under the heading "Install Enhydra," click on the Enhydra link. This displays a page with installation instructions.

  3. If you are using Windows, follow the instructions in "Installing on Windows." If you are using Linux or a UNIX system, follow the instruction in "Installing on UNIX."

  4. Configure Enhydra, following the instructions in "Configuring Enhydra."

  5. Use your web browser to view the online documentation, as described in "Viewing Online Documentation."

  6. If you want to run the sample applications, follow the instructions in "Running the Sample Applications."

Downloading and Installing Java 2

Enhydra 3.0 requires the Java Development Kit (JDK) version 1.2.2, which is part of JavaTM 2, from Sun Microsystems. If you have already installed the JDK 1.2.2 on your system, you can skip this section.

Enhydra is certified for use with JDKs other than the Sun JDK. For more information, see the release notes.

You can download Java 2 for Windows from http://java.sun.com/products/jdk/1.2. Select your platform, and follow the download and installation instructions. Reboot your system when the installation is complete.

Note: JBuilder contains its own version of the JDK, so if you are going to use JBuilder, you can use its JDK instead of installing Java2 separately. See "Installing JBuilder."

Installing Enhydra 3.0

When you install Enhydra, you will select an installation directory. The installation process will create an lutris-enhydra3.0 sub-directory that contains the Enhydra executables and libraries. This book will refer to this lutris-enhydra3.0 directory as the Enhydra root directory, or <enhydra_root>.

Installing on Windows

On Windows systems, Enhydra 3.0 includes an InstallShieldTM program that automates the installation process. It is strongly recommended that you use the InstallShield program to ensure that Enhydra is installed and configured properly. Advanced users may choose to install Enhydra manually on Windows, but Lutris will not support such an installation.

Cygnus Tools

Enhydra requires a UNIX shell environment and command emulator on Windows systems. The InstallShield program will install Cygnus Tools from Cygnus Solutions, containing Cygwin®, a UNIX shell environment for Windows.

Although it is possible to use a UNIX shell environment other than CygWin, Lutris strongly recommends using CygWin.

Procedure

Follow these steps:

  1. If you are using Windows NT, log on as a user with Administrator privileges.

  2. If you are upgrading from a previous version of Enhydra, delete the old files.

  3. Exit all Windows programs.

  4. Double-click on the file LutrisEnhydra3.0.exe in the Enhydra/install/cuts directory on the CD. This will launch the InstallShield program directly from the CD.

    On some systems, you may encounter problems executing the InstallShield program directly from the CD. If so, copy the file Enhydra/install/cuts /LutrisEnhydra3.0.exe from the CD to a temporary location on your hard drive. Then double-click on this copy of LutrisEnhydra3.0.exe to launch InstallShield.

  1. Follow the InstallShield Wizard's instructions to install Enhydra on your system.

    Important: InstallShield will prompt you to enter an installation directory. The Cygnus Tools require that you install Enhydra on your C: drive

Installing on UNIX

Following the instructions in the web pages on the CD, click on the link "Get Enhydra Installation Files." Then right-click on the link of your choice:

Choose "Save Link as...," then select a directory to save the archive on your hard drive.

If you are upgrading from a previous version of Enhydra, now delete the old version.

Red Hat Linux

To use the Red Hat Package Manager (RPM) file for Enhydra, log on as root, and enter the following command:

This installs Enhydra in the /usr/local/lutris-enhydra3.0 directory. To install Enhydra in a different location, enter the following command, replacing dir with the name of the desired directory:

After the installation completes, check the rpm_config.status file to see if RPM was able to find the JDK and configure Enhydra properly.

Solaris and Other UNIX Systems

The Enhydra distribution is packaged as a zip archive. Use unzip to extract the files from the archive, as follow:

Note: Using anything other than unzip (for example Solaris tar) to extract the files may not set the file permissions properly. Using unzip is strongly recommended. If you do use tar, you must use GNU tar, available at ftp.gnu.org.

Configuring Enhydra

After installing Enhydra, you must configure it as follows:

  1. On Windows, open a Cygwin shell window; enter the commands below in this window. On UNIX, you may use any shell window.

  2. Change to the Enhydra root directory, for example:

      cd /usr/local/lutris-enhydra3.0

  3. Enter the following command, where JDK_LOC represents the directory where the JDK 1.2 is installed:

      ./configure JDK_LOC

    For example, if the JDK is installed in /jdk1.2.2, use the command:

      ./configure /jdk1.2.2
      

Windows: In a Cygwin shell window, you must convert Windows paths to UNIX-style paths. If the JDK is installed on your C drive, simply omit the drive in the path (for example, for C:\jdk1.2.2, use /jdk1.2.2). If installed on any other drive, you must include the drive letter preceded by two slashes, for example, if the JDK is installed in E:\JDK1.2.2, then use //E/JDK1.2.2.

Setting the PATH Environment Variable

To enable running the Enhydra tools from the command line, you must add <enhydra_root>/bin. to your PATH environment variable.

On UNIX systems, simply set the PATH environment variable as you normally would, for example:

On Windows systems, to change the path used by applications run from the Cygwin shell, edit the file .bashrc in the enhydra directory.

This will enable you to run XMLC, DODS, and the Multiserver Administration Console from the command line.

Viewing Online Documentation

In addition to the documentation on the Enhydra.org web site, the Enhydra installation includes HTML documentation. View the file <enhydra_root>/doc/index.html in your web browser. This file includes links to the release notes, the Frequently Asked Questions list, and other informative documents.

The doc directory includes the following documentation:

Running the Sample Applications

Enhydra 3.0 includes some sample applications ("demos") that illustrate using Enhydra. The Windows InstallShield program installs the sample applications by default. In addition, the DiscRack application described in Chapter 5, "The DiscRack Example Application," is installed to <enhydra_root>/examples/DiscRack.

On UNIX systems, you must install them manually as follows:

  1. On the CD, go to the directory Enhydra/install/cuts/demos.

  2. Decompress the lutris-enhydra-demos3.0.tar.gz or lutris-enhydra-demos3.0.zip file to a directory of you choice, for example, /usr/local/lutris-enhydra-demos3.0.

Follow these steps to run them:

  1. Change to the directory containing the sample applications (lutris-enhydra-demos3.0) and run the start script:
      cd /usr/local/lutris-enhydra-demos3.0

      ./start

  2. To access the sample applications, enter the following URL into your browser: http://localhost:xxx, where xxxx represents the port you specified for the samples during installation. For example, if you specified port 9050, enter http://localhost:9050.

  3. You will see a page with links to several sample applications:

    Sample Description
    DemoApp1 A very simple demonstration application.
    Calculator1 Simulates a pocket calculator.
    Chat Room1 Uses a special algorithm to achieve the effects of push technology using HTTP. Messages that users enter appear immediately to other users.
    Golf Shop An example of a classic Web shopping cart application used to support an on-line Golf Store. The user name is enhydra and the password is lutris or you may create your own account.
    1 This application was constructed with Enhydra JDDI, a tool for rapid prototyping of simple applications.

Installing JBuilder

Borland JBuilder is a graphical IDE for Java development, as described in "JBuilder and the Kelp Tools." Lutris Enhydra Professional Edition includes Borland JBuilder Foundation. To install JBuilder, follow the installation instructions in the index.html file in the Jbuilder directory on the CD.

Although Enhydra Standard Edition does not include Borland JBuilder, you can download JBuilder Foundation for free from the Borland web site: http://www.borland.com/jbuilder.

JBuilder Foundation includes a complete JDK that you can use with Enhydra. If you install JBuilder first, you can then configure Enhydra to use the JBuilder JDK.

Installing the Kelp Tools

The Kelp Tools for JBuilder and Oracle JDeveloper are included in both Enhydra Standard Edition and Enhydra Professional Edition. You should install Enhydra 3.0 and either JBuilder or JDeveloper before installing Kelp.

For detailed system requirements and installation instructions, see Enhydra/kelp/kelpdoc.html.

Windows

To install the Kelp tools on Windows:

The InstallShield program will install Kelp and make the Kelp tools accessible from the IDE menus.

Linux and Solaris

To install the Kelp tools on Linux or Solaris:

On Linux and UNIX systems, you need to manually configure your tools for use with Kelp. The zip files include a readme.html file that includes instructions for setting up the Kelp tools and the sample project.


Lutris Technologies
http://www.lutris.com
1200 Pacific Ave., Suite 300
Santa Cruz, CA 95060
Voice: (831) 471-9753
Fax: (831) 471-9754
documentation@lutris.com
<< Contents< PreviousNext >Index >>
© 2000 by Lutris Technologies, Inc. All Rights Reserved