![]() ![]() ![]() ![]() |
![]() |
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.
Follow these steps to install and configure Enhydra:
- If you do not already have the Java Development Kit (JDK) 1.2.2, install Java2, as described in "Downloading and Installing Java 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.
- 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."
- Configure Enhydra, following the instructions in "Configuring Enhydra."
- Use your web browser to view the online documentation, as described in "Viewing Online Documentation."
- If you want to run the sample applications, follow the instructions in "Running the Sample Applications."
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."
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 thislutris-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.
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.
- If you are using Windows NT, log on as a user with Administrator privileges.
- If you are upgrading from a previous version of Enhydra, delete the old files.
- Exit all Windows programs.
- Double-click on the file
LutrisEnhydra3.0.exe
in theEnhydra/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 ofLutrisEnhydra3.0.exe
to launch InstallShield.
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:
- Select
lutris-enhydra3.0.zip
for a zip archive
- Select
lutris-enhydra3.0.tar.gz
for a GNU tar archive
- Select
Lutris-Enhydra-3.0-1.i386.rpm
for Red Hat package managerChoose "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.
To use the Red Hat Package Manager (
RPM
) file for Enhydra, log on asroot
, and enter the following command:
rpm -ivh Lutris-Enhydra-3.0-1.i386.rpmThis installs Enhydra in the
/usr/local/lutris-enhydra3.0
directory. To install Enhydra in a different location, enter the following command, replacingdir
with the name of the desired directory:
rpm -ivh --prefix dir Lutris-Enhydra-3.0-1.i386.rpmAfter 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:
unzip lutris-enhydra3.0.zipNote: 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
.
After installing Enhydra, you must configure it as follows:
- On Windows, open a Cygwin shell window; enter the commands below in this window. On UNIX, you may use any shell window.
- Change to the Enhydra root directory, for example:
- Enter the following command, where JDK_LOC represents the directory where the JDK 1.2 is installed:
For example, if the JDK is installed in
/jdk1.2.2
, use the command:
./configure
/jdk1.2.2Windows: 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 inE:\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:
setenv PATHOn Windows systems, to change the path used by applications run from the Cygwin shell, edit the file
.bashrc
in theenhydra
directory.This will enable you to run XMLC, DODS, and the Multiserver Administration Console from the command line.
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:
- Release notes, frequently asked questions (FAQ) list, and license information. For updated release notes, refer to the Enhydra.org web site.
- General information on the Enhydra Multiserver Administration Console, in the
admin
directory
- Enhydra developer documentation, in the
developer
directory
- Javadoc API reference documentation, in the
user-doc
directory
- XMLC documentation, including Javadoc for the Document Object Model, in the
xmlc
directory
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:
- On the CD, go to the directory
Enhydra/install/cuts/demos.
- Decompress the
lutris-enhydra-demos3.0.tar.gz
orlutris-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:
- 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
- To access the sample applications, enter the following URL into your browser:
http://localhost:xxx
, wherexxxx
represents the port you specified for the samples during installation. For example, if you specified port 9050, enterhttp://localhost:9050.
- 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 islutris
or you may create your own account.
1 This application was constructed with Enhydra JDDI, a tool for rapid prototyping of simple applications.
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 theJbuilder
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
.To install the Kelp tools on Windows:
- For JBuilder, double-click on
Enhydra/kelp/cuts/jb-kelp1.1.exe
to run the InstallShield program.
- For JDeveloper, double-click on
Enhydra/kelp/cuts/jdev-kelp1.1.exe
to run the InstallShield program.The InstallShield program will install Kelp and make the Kelp tools accessible from the IDE menus.
To install the Kelp tools on Linux or Solaris:
- For JBuilder, extract the zip file
Enhydra/kelp/cuts/jb-kelp1.1.zip
to your system.
- For JDeveloper, extract the zip file
Enhydra/kelp/cuts/jdev-kelp1.1.zip
to your system.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 |