HAHTsite IDE and IP Installation Guide

(1)

HAHTsite IDE and IP

Installation Guide

(2)

IDE and IP

Installation

Guide

release 4.0

(3)

May 1999 MN01-C-00-400-00

Notice

No part of this publication may be copied, photocopied, reproduced, transmitted, transcribed, or reduced to any electronic medium or machine-readable form without the prior written consent of HAHT Software, Inc. Information in this document is subject to change without notice. Names and information used in examples are fictitious.

U.S. GOVERNMENT RESTRICTED RIGHTS. It is acknowledged that the Software and the Documentation were developed at private expense, that no part is in the public domain, and that the Software and Documentation are Commercial Computer Software provided with RESTRICTED RIGHTS under Federal Acquisition Regulations and agency supplements to them. Use, duplication, or disclosure by the U.S. Government is subject to restrictions as set forth in subparagraph (c)(1)(ii) of The Rights in Technical Data and Computer Software clause at DFAR 252.227-7013 et. seq. or subparagraph (c)(1) and (2) of the Commercial Computer Software—96 Restricted Rights at FAR 52.227-19, as applicable. Contractor is HAHT Software, Inc., 4200 Six Forks Road, Raleigh, NC 27609. Rights are reserved under copyright laws of the United States with respect to unpublished portions of the Software.

Trademarks

HAHT, HAHT Software, HAHTsite, e-Scenario, and “e-nable your enterprise” are trademarks or U.S. registered trademarks of HAHT Software, Inc.

This product includes software developed by the Apache Group for use in the Apache HTTP server project (http://www.apache.org/).

Any other corporate names, product names, tradenames, trademarks, service marks, or service names owned or registered by any other company and mentioned herein are the property of their respective companies. Specifications subject to change without notice.

HAHT Software, Inc. 4200 Six Forks Road Raleigh, NC 27609 USA

(919) 786-5100 (888) 438-4248 (in the USA) (919) 786-5200 (Technical Support)

(4)

C on t en t s

About This Book

What’s in this book . . . v

Conventions . . . v

HAHTsite installation directory . . . vi

HAHTsite IDE and HAHTsite IP . . . vi

Abo u t T h is Bo o k

This book provides instructions on installing and configuring the HAHTsite® Integrated Development Environment (IDE) and Integrated Publisher (IP). Unless otherwise noted, the information in this book applies to Windows 95, Windows 98, and Windows NT 4.0.

What’s in this book

The table below summarizes the book’s contents.

Conventions

The conventions used in this book are described here.

Chapter Contents

Chapter 1, “Before Starting the Installation”

Describes the products that come with HAHTsite and presents some important

information you need to be aware of before you start the installation.

Chapter 2, “Installing HAHTsite IDE/IP”

Provides step-by-step instructions on installing the HAHTsite IDE/IP software.

Chapter 3, “What’s Next?” Describes the installation tasks you need to perform after you’ve run the setup program, and tells you how to verify that the installation was successful.

Chapter 4, “Removing HAHTsite Products from Your System”

Describes how to remove the HAHTsite products from your system.

(7)

About This Book

HAHTsite installation directory

This book uses the variable HAHTsiteInstallDir as a placeholder for the HAHTsite installation directory (for example, C:\HAHTsite). When you see this variable, you should replace it with the name of the HAHTsite installation directory on your system.

HAHTsite IDE and HAHTsite IP

Most of the topics in this book apply to both the HAHTsite IDE and the HAHTsite IP. This book uses the term IDE/IP when describing these topics. When describing the few topics that apply only to the IDE, this book uses the term IDE.

“Getting Started”

The HAHTsite IDE/IP also includes an introduction to HAHTsite, lessons in using HAHTsite, and sample (HAHT_Intro) projects in Java and HAHTtalk Basic. Choose Getting Started from the Help menu.

Online documentation

In addition to the printed books, you can use the IDE/IP’s online help system. As well as context-sensitive help for each of the dialogs, the online help system includes:

• Overview information about the IDE/IP.

• Step-by-step instructions on how to use the IDE/IP’s features.

• Reference pages for the HAHTtalk Basic language, HAHTsite’s Server Object Model, and the SQL Assistant.

(8)

About This Book

• Information about using HAHTtalk Basic’s Dialog Editor (used in building widgets).

To open the help system, choose Contents from the Help menu.

HAHTsite OLE Interface Guide

The HAHTsite IDE provides an OLE interface that you can access from your custom Widgets. The OLE objects and methods are described in the HAHTsite OLE Interface Guide, which you can access from the IDE’s Help menu. The HAHTsite OLE Interface Guide is an HTML document.

The HAHTsite OLE Interface Guide is also installed as a HAHTsite project (in

HAHTsiteInstallDir\sdk\oleapi). This enables you to add comments to the guide or to copy the guide’s examples into the HAHTsite IDE and test them.

Other HAHTsite products

In addition to the IDE and the IP, the HAHTsite family of products includes the HAHTsite Application Server, which works with any Web server to execute HAHTsite applications. The Application Server runs on the Windows NT, HP/UX, Solaris, and AIX operating systems. It executes application logic, enables complete access to multiple data sources, maintains session information, and dynamically generates HTML pages.

(9)

About This Book

HAHT Software’s commitment to you

We want you to be completely satisfied with your HAHT Software products. If you have questions about HAHTsite, the HAHTsite IDE, the HAHTsite IP, or the HAHTsite Application Server, you can contact HAHT Software in the following ways:

Telephone

• (919) 786-5200 Technical Support (Voice)

• (919) 786-5252 Technical Support (FAX)

• (888) 438-4248 Sales (Voice—in the USA)

• (919) 786-5100 Office (Voice)

• (919) 786-5250 Office (FAX)

Email

• info@haht.com General Information

• sales@haht.com Sales

• support@haht.com Support

World Wide Web

(10)

1

Before Starting the

Installation

This chapter describes the products that come with HAHTsite®_{and their} system requirements. The chapter also describes how to configure your dial-up TCP/IP driver if you are installing HAHTsite on a machine that is running Windows 95 and does not have a network adapter card.

The products that come with the HAHTsite

IDE/IP

Here is a description of the products that come with the HAHTsite Integrated Development Environment (IDE) and Internet Publisher (IDE/IP):

• The HAHTsite IDE/IP — for creating Web site applications.

• The HAHTsite Application Server: Developer Edition — for testing HAHTsite applications during the development cycle. The Developer Edition is a subset of the HAHTsite Application Server, but the Developer Edition is not licensed for use in a production environment. The

HAHTsite Application Server is packaged separately from the IDE and the Developer Edition.

• The Apache Web server (version 1.3.4) — a freeware Web server that can be used with the Application Server. The HAHTsite Application Server works, however, with any Web server program.

• Java virtual machines from Sun and Microsoft — for interpreting Java byte-codes. The Sun virtual machine (version 1.1.7) is installed with HAHTsite automatically, and you have the option of installing the Microsoft virtual machine (version 5.3165). HAHT recommends that you do install the Microsoft VM for performance reasons.

(11)

Chapter 1: Before Starting the Installation

• VisiBroker for Java — CORBA software from Inprise Corporation.

• INTERSOLV ODBC drivers — ODBC lets Web-site authors create HAHTsite applications that access databases. Your CD-ROM includes INTERSOLV ODBC drivers that you can evaluate for 90 days. (You install these drivers using a different setup program than the one you use for the IDE/IP.) Your site may include one or more HAHTsite Application Server hosts that you can use to test your applications. If so, you need install only the IDE/IP on your workstation. But if you want a complete development environment on your local workstation, you can install the Application Server: Developer Edition and (optionally) the Microsoft VM and the Apache Web server.

System requirements

This section lists the system requirements for the IDE/IP, the Application Server, and the Apache Web server.

The HAHTsite IDE/IP

The HAHTsite IDE/IP requires at least:

• An Intel-compatible PC with Windows 95 or 98, or Windows NT 4.0 or later

• 32 MB memory • 50 MB free disk space

The HAHTsite Application Server: Developer Edition

The Application Server requires at least:

• An Intel-compatible PC running Windows 95 or 98, or Windows NT 4.0 or later

• 32 MB RAM, because a Web server must run on the same machine • 10 MB free disk space

The Web server must support CGI 1.1 or greater.

(12)

• 5 MB of disk space

• An active 32-bit Microsoft TCP/IP subsystem must be installed and set up.

Installing your Web server

If you plan to test your applications locally, and to use a Web server other than Apache, install the Web server before starting setup. The IDE/IP setup needs to read your Web server’s configuration files in order to configure sites correctly.

Before installing the IDE/IP on a

standalone machine

All Web servers use a TCP/IP connection to communicate. In addition, HAHTsite requires a TCP/IP connection for remote debugging. On a Windows 95 standalone system (a machine that doesn’t have a TCP/IP network

connection), you need to configure your dial-up TCP/IP driver before you install the complete HAHTsite development environment: the HAHTsite IDE, the Web server, and the Application Server: Developer Edition. (This step is not necessary for a Windows 98 system.) This configuration enables your browser to talk to a Web server running on the same machine. If you are installing only the IDE, you do not need to perform this procedure, but you will not be able to test a HAHTsite application that includes nonstatic pages. Once you configure your TCP/IP connection, you do not need an on-line, dial-up connection to use the full HAHTsite development environment.

Caution - You must perform the steps listed below

before installing your Web server or HAHTsite. The installation procedures for both the Web server and HAHTsite use the IP address you specify here.

Use this procedure to configure your TCP/IP connection:

1 Go to the Control Panel, and double-click on the Network icon. 2 Select the Configuration tab in the Network dialog.

3 From the list of available network components, select the

TCP/IP > Dial-up Adapter, and click Properties.

!

(13)

The TCP/IP Properties dialog appears.

4 Click the IP Address tab. Select the Specify an IP Address radio button.

The IP Address and Subnet Mask fields are activated.

5 Enter an IP address and Subnet Mask address. You can use the following

values:

IP Address: 192.168.1.1 Subnet Mask: 255.255.255.0

6 Click OK and then OK again to exit.

You are now ready to start the installation.

Note - If you plan to use Apache with HAHTsite and already

have Apache installed on your machine, reinstall Apache when you are given the option during the HAHTsite

installation. Reinstalling Apache lets the new TCP/IP settings take effect.

(14)

2

Installing HAHTsite

IDE/IP

This chapter describes what the setup program does and contains step-by-step instructions for installing the products that come with the HAHTsite IDE/IP. The wording in the instructions and the example screen images may refer to the IDE, but the instructions are valid for both the IDE and the IP.

What the setup program does

This section describes what the setup program does when you install the IDE/IP, the Application Server, and Apache.

IDE/IP

The installation program for the IDE/IP:

• creates an installation directory if it doesn’t already exist

• creates clipart, include, lessons, lib, native, program, samples,

scripts, sdk, sites, sitesbackup, template, and widgets subdirectories • creates a program group containing the IDE, Help, the Web Server Utility,

the IDE’s readme file, and an uninstall utility

• installs ODBC and sets up an ODBC data source for the sample applications that are provided with the IDE

(15)

Chapter 2: Installing HAHTsite IDE/IP

The Application Server

The installation program for the Application Server:

• creates an installation directory if it doesn’t already exist

• searches for installed Web servers to use in creating site files that are used by the Application Server and the IDE. Only one Web server can be selected during installation. Use the Web Server Utility to make changes once setup is complete.

• creates approot, bin, cgibin, conf, javaroot, logs, and userroot

subdirectories

• creates entries in the HAHTsite program group for the Application Server and its uninstall utility

• registers the Application Server’s properties in the operating system’s registry

• installs ODBC

Apache Web server

The installation program for Apache:

• installs a version of the Apache Group’s Web server

• creates a program group for Apache that includes the executable and the Apache documentation

Running the setup program (all platforms)

The setup program divides the installation into phases that may be invoked in sequence or separately:

• Installing the Apache Web server • Installing the HAHTsite IDE/IP • Installing the Application Server

Note - At the beginning of the application server installation

process, you have the option of installing Microsoft’s Java virtual machine.

(16)

You can also select a Complete installation, which will install all of these components.

Upgrades

If you are upgrading from an earlier version of HAHTsite, the setup program prompts you before overwriting the previous installation.

To begin installation

1 Exit all Windows programs.

2 Insert the HAHTsite CD-ROM into the appropriate drive and start the

setup program:

• Select the Run... command from the Start menu. Type:

drive:\setup.exe, where drive is the drive containing the CD-ROM.

• Or go to the Control Panel’s Add/Remove Programs dialog. On the

Install/Uninstall tab, click Install and follow the prompts until the setup program starts.

3 A dialog informs you that the setup program is being prepared, and the

Welcome dialog appears.

Click the Next button.

(17)

Enter the serial number from the label on the back of your HAHTsite CD jewel case, and click Next.

5 If Microsoft’s Java virtual machine (VM) is not installed on your system —

or if an out-of-date version of the VM is installed — you are asked whether you want to install the Microsoft Java VM. If you click Yes, the Microsoft Java VM setup is run; then, you are returned to the HAHTsite setup program.

6 The Master Setup Choices dialog appears. This dialog lets you choose the

(18)

On the Master Setup Choices dialog, click one of the options shown in the table below.

Installing the Apache Web server

The setup program searches your system for installed Web servers. If it finds any, Setup gives you the option of installing Apache over a previous Apache

Option Installs these products If you choose this option... Complete • Apache (optional)

• IDE

• Application Server

Continue with “Installing the Apache Web server” on page 9 and follow the sequence down to “Installing

INTERSOLV ODBC Drivers” on page 29. IDE IDE only Proceed to “Installing the IDE/IP” on

page 15. Application

Server

• Apache (optional) • Application Server

Continue with “Installing the Apache Web server” on page 9 followed by “Installing the HAHTsite Application Server: Developer Edition” on page 20. Apache Apache only Continue with “Installing the Apache Web server” on page 9. Then go on to Chapter 3, “What’s Next?”

(19)

installation, or in addition to another Web server. If setup doesn’t find a Web server, it asks you if you want to install the Apache Web server.

To bypass Apache installation

1 Answer No to the question about installing Apache.

2 Proceed either to “Installing the IDE/IP” on page 15 (if you selected

Complete) or “Installing the HAHTsite Application Server: Developer Edition” on page 20 (if you selected Application Server).

To install the Apache Web server

1 If you indicated that you want to install the Apache Web server, a

Welcome dialog appears.

Click Next to proceed.

(20)

Read the license agreement, and click Yes to agree to its terms.

3 The Apache Setup Options dialog appears.

(21)

Click Custom to choose which components to install. The available components are:

• Application Files • Apache Manual • Additional Modules • Source Code

4 The Select Directory For Apache dialog appears, to let you specify a

destination directory for Apache.

Click Next to accept the default directory, or browse for a new directory and then click Next.

5 If you chose Custom installation in Step 3 on page 11, the Select Options

(22)

In the list of components, check the components you want to install, and clear the check boxes for components you want to omit from the

installation. Then click Next.

(23)

The setup program determines the available IP addresses on your system and populates the DNS, Port, and Doctree Path fields. In most cases, you should accept these default values by clicking Next. However, make sure that the port number shown is not being used by another Web server, such as Microsoft’s Personal Web Server for Windows. If the port number shown is being used by another Web server, enter a different port number before clicking Next.

7 The Apache CGI Information dialog appears.

The CGI alias and corresponding path are used for HAHTsite’s dynamic pages. The setup program populates these fields with default values. Click Next to accept these defaults.

8 The Select Program Folder dialog is displayed.

Field Description

DNS DNS hostname and domain name

Port Port number

(24)

Choose a name for the Apache program folder:

• Click Next to accept the default.

• Or type a new folder name and then click Next.

• Or select a name from the list of existing folders and then click Next.

9 The Web server files are copied to your disk, which completes the Apache

installation. You can now do one of the following:

• If you are installing only the Apache Web server, proceed to Chapter

3, “What’s Next?”

• If you selected Complete, proceed to “Installing the IDE/IP” on page

15.

• If you selected Application Server, proceed to “Installing the HAHTsite

Application Server: Developer Edition” on page 20.

Installing the IDE/IP

In most cases, you will want to perform a “Typical” setup, which installs all the IDE components.

(25)

To install the IDE/IP

1 An information dialog informs you that the setup program is preparing

the HAHTsite IDE setup program. Then a software license agreement is presented (if you haven’t already accepted such an agreement during a previous installation).

Read the license agreement, and then click Yes to accept its terms.

(26)

Specify whether you want to perform a Typical installation or a Custom installation. A typical installation installs all of the IDE components, and a custom installation enables you to install some or all of the following components: • ODBC Drivers • Program Files • Sample Files • Help Files • SDK Files • Clipart Images

(27)

In the Select Directory dialog, choose the destination directory for the IDE/IP:

• Click Next to accept the default destination directory for the IDE. • Click Browse... to select another destination directory. Then click

Next.

4 If you chose Custom in Step 2 on page 16, a Select Option to Install dialog

(28)

Check the items you want to install, and clear the check boxes for items you want to exclude from the installation. Your choices are:

• ODBC Drivers — Microsoft ODBC 3.0 drivers

• Program Files — HAHTsite IDE executables and DLLs • Sample Files — HAHTsite files that are used in tutorials

• Help Files — All online documentation and interactive help files • SDK Files — HAHTsite SDK executables, DLLs, and source files • Clipart Images — Clip art to enhance your Web pages

5 If you are installing over a previous version of HAHTsite, a dialog warns

you that you will lose any changes you’ve made to the HAHTsite default templates or to the HAHTsite sample projects.

• If the confirmation dialog is displayed, click Yes to continue and

overwrite the previous versions of these files.

• Click No if you do not want to overwrite the previous installation.

The Select Directory dialog reappears so that you can indicate a new directory location for HAHTsite.

(29)

In this dialog, choose a name for the IDE/IP program folder:

• Click Next to accept the default.

• Or type a new folder name and then click Next.

• Or select a name from the list of existing folders and then click Next.

7 File installation begins.

The setup program displays progress bars as the setup program starts installing the IDE software.

8 If you are installing only the IDE, the Setup Complete dialog appears.

• If you don’t want to view the ReadMe file, clear its checkbox. • Click Finish to exit the installation.

• Proceed to Chapter 3, “What’s Next?”

If you selected Complete installation, continue with the Application Server installation.

Installing the HAHTsite Application Server: Developer

Edition

Note - If you selected Application Server, go to “Installing the

Apache Web server” on page 9; then, return here at the conclusion of the Apache prompts.

(30)

1 If haven’t already accepted the terms of a HAHTsite software license

agreement, you’ll be prompted to do so now. Read the agreement and click Yes.

2 You’ll then see the Setup Options dialog, which lets you specify the

components of the Application Server that you want to install.

• Choose Typical to install everything except VisiBroker for Java. • Choose Custom to customize the installation contents.

3 The Select Directory For Application Server Developer 4.0 dialog appears.

This dialog lets you specify the destination directory for the Application Server.

(31)

Click Next to accept the default, or click Browse... to select another directory and then click Next.

Note - If you’re doing a Complete installation (all

components), the default Destination Directory will be the directory in which you installed the IDE. It’s fine to install the IDE and the Application Server in the same directory.

4 If you have a previous version of the HAHTsite Application Server on your

machine, a confirmation dialog asks whether you want to overwrite the previous version.

Click Yes to overwrite the previous installation, or No to return to the Select Directory... dialog, where you can specify a new installation directory.

5 If you chose Custom installation, the Select Options to Install dialog

(32)

Check each item you want to install, and clear the check boxes for any items you want to omit from the installation:

Then click Next.

6 The Select Program Folder dialog appears. The dialog lets you specify the

program folder into which the program icons will be placed.

Item Description

Application Server Files

Executable files for the HAHTsite Application Server

CORBA: VisiBroker for Java

All files necessary to use CORBA with HAHTsite applications

(33)

Click Next to accept the default, or select or type in another name and then click Next.

7 Web server detection begins. If setup finds one or more Web servers, you’ll

see the Web Server Detection - Static Alias dialog and should continue with this step. If setup does not find a Web server, you’ll see a Web Server Information dialog and should skip to Step 8.

Setup displays the name of each Web server it finds, as well as its hostname and port and its static alias.

(34)

At the bottom of the screen you will see the document root path (doctree) — the physical location in which the static Web pages are stored. If the Web server you want to use appears in the list, select it, click Next, and proceed to Step 9. If setup did not detect the Web server you want to use, click the Manual button and proceed to Step 8.

8 At this point, you will see a Web Server Information dialog that enables

you to enter information about the Web server you want to use and that server’s static alias.

Web server the name of an installed Web server that is recognized by the Application Server setup Web Server Virtual

Host

the hostname and port number

(35)

Generally, you’ll need to enter the correct port number, select the

appropriate type of Web server, and set the Path to your server’s document root directory. Then click Next.

9 Dynamic Web server detection begins. If setup finds one or more Web

servers that have CGI aliases defined, you’ll see the Web Server Detection - Dynamic Alias dialog and should continue with this step. If setup does not find a Web server with a CGI alias, you’ll see a Web Server Information dialog and should skip to Step 10.

Setup displays the name of each dynamic Web server it finds, as well as its hostname and port and its dynamic alias.

(36)

At the bottom of the screen you will see the Web server’s CGI directory — the physical location in which dynamic Web pages are stored. If the Web server you want to use appears in the list, select it, click Next, and proceed to Step 11. If setup did not detect the Web server you want to use, click the Manual button and proceed to Step 10.

10 At this point, you will see a Web Server Information dialog that enables

you to enter information about the Web server you want to use and that server’s dynamic alias.

Web server the Web server that you’ll be using with your Application Server

Web Server Virtual Host

the hostname and port number

Web Server Dynamic Alias

(37)

Generally, you’ll need to enter the correct port number, select the appropriate type of Web server, and set the Path to your server’s CGI directory. Then click Next.

11 File installation begins. The setup program displays progress bars as the

setup program starts installing the Application Server software.

12 After file installation, a dialog asks whether you want the Application

Server to start automatically whenever you start your system.

If you click No, you will need to start the Application Server manually after a system boot.

13 The Setup Complete dialog appears. Click Finish to exit the installation

script.

(38)

Installing INTERSOLV ODBC Drivers

Your CD-ROM includes trial INTERSOLV ODBC drivers that you can evaluate for 90 days. If you decide that you want to use the drivers after the 90-day expiration, you will need to purchase a license from INTERSOLV.

To install the drivers, run SETUP.EXE in the \ISODBC directory of the release CD.

If you install the Application Server and the trial ODBC drivers on a remote machine, when the drivers expire, your browser will appear to hang when it accesses your Web application that uses the ODBC drivers. To prevent this, purchase the fully licensed drivers from INTERSOLV before your 90-day trial period expires.

(39)

(40)

3

What’s Next?

This chapter identifies any setup tasks that you need to perform after the installation and directs you to a procedure for each task. This chapter also describes how you can verify that your installation was successful.

What setup tasks do I need to perform?

The table below identifies the setup tasks that you may need to perform after the initial installation.

If... Then you need to... Go to this section

You will be building a Java project with dynamic pages or a HAHTtalk Basic project that calls server-side Java. (The HAHTsite software does not include a Java compiler.)

Install a Java compiler, such as the one available with Sun’s Java Developer’s Kit. Then, configure the IDE to use that compiler.

Chapter 2, “Using the IDE/IP’s Windows and Toolbars” in the

HAHTsite IDE and IP User’s Guide.

You want to debug Java applications and your Application Server is configured to use a Sun Java virtual machine.

Install the JDK on your Application Server machine, set that system’s PATH environment variable, and configure the Application Server correctly.

“Debugging Java projects (Sun VM)” on page 33.

(41)

Chapter 3: What’s Next?

You decide to use a different Web server than you chose during installation.

Make sure your Web server is set up with a CGI alias for HAHTsite, and then run the Web Server Utility to create the necessary Web server

information files.

“Connecting the Web server to the

Application Server” on page 34.

You want HAHTsite to use the Sun Java 2 (1.2) virtual machine to interpret Java byte-codes.

Install the new Java virtual machine, and then configure the Application Server to use it.

“Using the Sun Java 2 virtual machine” on page 35.

You installed the IDE and now want to configure the IDE for publishing to the HAHTsite Application Server or to the HAHTsite Application Server: Developer Edition.

Create a site definition for your Application Server configuration, and add it to your project.

Chapter 4, “Working with Sites” in the

Any of your HAHTsite applications use databases (unless you plan to use only flat-file ODBC drivers).

Set up connectivity to an ODBC data source. When you install the IDE or the

Application Server, the setup program installs ODBC drivers if you choose the “Typical” installation option. ODBC lets Web authors create programs with HAHTsite that access databases. You will not, however, have database connectivity until you connect to an ODBC data source on both the client and the server side.

Appendix C, “Adding an ODBC Data Source” in the

(42)

Debugging Java projects (Sun VM)

You don’t have to do any special setup to debug Java projects if your Application Server is using the Microsoft virtual machine. However, before you can run the debugger on a Java application being executed by a Sun Java VM, you must performs several tasks.

To enable the debugger to work

1 On the machine where your Application Server is running, install either

the Java Development Kit version 1.1.7 or the Java 2 Platform (also known as the JDK 1.2). The revision level of the JDK should match your

Application Server’s Java Virtual Machine Type (Sun 1.1 or Sun Java 2).

2 If you installed the Java Development Kit 1.1.7, add JDKInstallDIR/bin

to your system’s PATH environment variable.

3 Add the path to the required ZIP or JAR file to your Application Server’s

System Java Class Path. If you have the JDK 1.1.7 installed, add the path

JDKInstallDIR\lib\classes.zip, and if you have the Java 2 Platform installed, add the path JDKInstallDIR\lib\tools.jar.

To perform this step:

• Stop the Application Server by clicking the Stop button.

• Click the Configure button to bring up the Configure Application

Server dialog.

• Add the path to the ZIP or JAR file — including the name of the file —

to the System Java Class Path.

Before you click the OK button in the Configure Application Server dialog, continue with Step 3.

4 Specify a TCP/IP port on the Application Server to be used for debugging.

In the Configure Application Server dialog, you’ll see that the field “TCP/IP port for Sun Java debugger connection” has been set to 9150. This setting indicates that TCP/IP port 9150 is reserved for use by the debugger. If this port is being used by another application, specify a different debugger port.

Once you’ve set the debugger port, you can click OK to close the configuration dialog and restart the Application Server.

(43)

Connecting the Web server to the

Application Server

Note - The instructions in this section are for using the

standard CGI interface between the Web server and the HAHTsite Application Server: Developer Edition. The NSAPI and ISAPI interfaces are supported only by the full HAHTsite Application Server, not the Developer Edition.

The following sections describe how to set up a CGI alias for several

Web-server products, namely, Apache, Microsoft Internet Information Server (IIS), and Netscape Enterprise Server 2.0. Once you’ve set up a CGI alias, run the HAHTsite Web Server Utility to create Web server information files, and then create a site definition using the Administer Sites feature of the HAHTsite IDE/IP.

Apache

Apache does not provide a graphical user interface for configuring the Web server. Therefore, you must set up the CGI alias by editing a configuration file in Apache’s conf directory. For information on how to edit this configuration file, see the Apache documentation that comes with the Web server.

Microsoft Internet Information Server (IIS)

Use this procedure to assign the CGI-BIN mapping for IIS.

1 In the IIS program group, go to the Internet Service Manager. (You must

have Administrator privileges to see the services in the Internet Service Manager.)

2 Double-click the computer that has www listed as its service. 3 Click Add.

4 Browse to the subdirectory that you selected as your Web server’s cgibin

directory when you installed the Application Server. This is the directory where you directed the installation program to place such files as

hsrun.exe. The default directory is usually \inetpub\wwwroot\scripts. Click OK.

5 Select Virtual Directory, and type the appropriate alias (such as

(44)

Netscape Enterprise Server 2.0

Use this procedure to assign a CGI-BIN mapping for Netscape.

1 Start the Server’s administrative utility. 2 On the main screen, click Programs.

The Programs menu appears

3 Click CGI Directory.

The Current CGI Directories dialog appears.

4 Change the prefix for Alias to cgi-bin and map the alias to the

subdirectory that you selected as your Web server’s cgibin directory when you installed the Application Server. This is the directory where you directed the installation program to place such files as hsrun.exe.

Using the Sun Java 2 virtual machine

This section explains the steps you should take to configure the Application Server to use the Sun Java 2 virtual machine.

To use the Sun Java 2 VM at runtime (with the Application Server)

1 Configure your Application Server’s Java Virtual Machine Type to be Sun

Java 2.

2 Edit your Application Server’s System Java Class Path.

Replace HAHTsiteInstallDir\lib\rt.jar with the path to the new Java 2 JAR file. If you installed the Java VM in the directory D:\jdk1.2\jre, this path would look like this: D:\jdk1.2\jre\lib\rt.jar.

3 Set your operating system’s PATH environment variable so that it includes:

• the bin directory that contains your JDK 1.2 compiler

• the directory where you installed the Java VM (the directory

containing jvm.dll)

For instance, you would add the following directories to your PATH

D:\jdk1.2\bin;D:\jdk1.2\jre\bin\classic

if your JDK 1.2 compiler was installed in D:\jdk1.2 and the Java VM was installed in D:\jdk1.2\jre.

(45)

Verifying the installation

This section describes how to verify that you successfully performed a complete installation, or successfully installed the IDE or the Application Server.

Complete installation

For a complete installation that includes Apache, the setup program does the configuration for you. The best way to verify that the installation was successful is to use the instructions in the HAHTsite IDE and IP User’s Guide to publish a project and browse a dynamic page in the project. For you to browse a dynamic page, the IDE, Apache, and the Application Server must be connected correctly, which means the installation succeeded.

The IDE

If you installed the IDE only, you can verify the installation by starting the IDE:

• In the program group for HAHTsite, click the HAHTsite IDE icon.

(46)

The Application Server

There are two ways to verify that the Application Server was installed successfully.

• During the installation, if you specified that you wanted the Application Server to start up automatically at system startup, then the Application Server should already be running on your machine. You should see the HAHTsite 4.0 Application Server icon on your task bar. Here is an example.

• During the installation, if you specified that you do not want the

Application Server to start automatically at system startup, then you need to start the Application Server manually. The next section describes how to start the Application Server manually.

Starting the Application Server manually

(47)

• In the Start menu’s program group for HAHTsite, click on the HAHTsite Application Server’s icon. Here is an example.

Making this menu selection starts the Application Server, and the HAHTsite 4.0 Application Server icon appears. Here is an example.

(48)

4

Removing HAHTsite

Products from Your

System

This chapter describes how you can remove HAHTsite products from your system.

What the uninstall utility does

The setup program provides an uninstall utility for the HAHTsite IDE and the Application Server.

The uninstall utility removes: • shared program files • standard program files • folder items

• program folders • program directories • program registry entries

Note that the uninstall utilities do not remove shared program files or files that Microsoft standards designate as Core Windows files. The following sections describe how to use the uninstall utility for each product.

(49)

Chapter 4: Removing HAHTsite Products from Your System

Uninstalling the HAHTsite IDE

1 Exit the HAHTsite IDE if it is open.

2 Select the Uninstall HAHTsite IDE icon from the program group for

HAHTsite (or use the Control Panel’s Add/Remove Program utility). A confirmation dialog verifies that you want to remove the program and all of its components.

3 Click Yes to uninstall the HAHTsite IDE.

Uninstalling the Application Server

1 If the Application Server is running, stop it and exit the program.

• Click the HAHTsite 4.0 webapps Server icon.

• When the program’s window appears, click the Stop button. • Exit the program.

2 Select the Uninstall HAHTsite App Server Dev icon from the program

group for HAHTsite (or use the Control Panel’s Add/Remove Program utility).

A confirmation dialog verifies that you want to remove the program and all of its components.

HAHTsite IDE and IP Installation Guide