hahtsite 4.0 ide and ip installation guide - pitney...

HAHTsite IDE and IP Installation Guide

IDE and IPInstallation

Guiderelease 4.0

© Copyright 1999 HAHT Software, Inc.All Rights Reserved

May 1999MN01-C-00-400-00

NoticeNo 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.

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

Portions Copyright© 1992-1996 Summit Software Company.

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)

Contents

About This Book

What’s in this book . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . v

Conventions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . v

HAHTsite installation directory . . . . . . . . . . . . . . . . . . . . . . . . . . . . viHAHTsite IDE and HAHTsite IP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . vi

Other HAHTsite documentation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . vi

“Getting Started” . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . viOnline documentation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . viHAHTsite OLE Interface Guide . . . . . . . . . . . . . . . . . . . . . . . . . . . . .vii

Other HAHTsite products . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . vii

HAHT Software’s commitment to you . . . . . . . . . . . . . . . . . . . . . . . . . . viii

Telephone . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . viiiEmail . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . viiiWorld Wide Web . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . viii

1 Before Starting the Installation

The products that come with the HAHTsite IDE/IP. . . . . . . . . . . . . . . . . 1

System requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2

The HAHTsite IDE/IP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .2The HAHTsite Application Server: Developer Edition . . . . . . . . . . . .2Apache Web server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .2

Installing your Web server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3

Before installing the IDE/IP on a standalone machine . . . . . . . . . . . . . . 3

2 Installing HAHTsite IDE/IP

iii

What the setup program does . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5

IDE/IP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .5The Application Server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .6Apache Web server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .6

Contents

Running the setup program (all platforms) . . . . . . . . . . . . . . . . . . . . . . . 6

Installing the Apache Web server . . . . . . . . . . . . . . . . . . . . . . . . . . . .9Installing the IDE/IP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .15Installing the HAHTsite Application Server: Developer Edition . . . .20

Installing INTERSOLV ODBC Drivers. . . . . . . . . . . . . . . . . . . . . . . . . . . 29

3 What’s Next?

What setup tasks do I need to perform? . . . . . . . . . . . . . . . . . . . . . . . . 31

Debugging Java projects (Sun VM). . . . . . . . . . . . . . . . . . . . . . . . . . . . . 33

Connecting the Web server to the Application Server . . . . . . . . . . . . . 34

Apache . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .34Microsoft Internet Information Server (IIS) . . . . . . . . . . . . . . . . . . .34Netscape Enterprise Server 2.0 . . . . . . . . . . . . . . . . . . . . . . . . . . . . .35

Using the Sun Java 2 virtual machine . . . . . . . . . . . . . . . . . . . . . . . . . . 35

Verifying the installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 36

Complete installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .36The IDE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .36The Application Server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .37Starting the Application Server manually . . . . . . . . . . . . . . . . . . . . .37

4 Removing HAHTsite Products from Your System

What the uninstall utility does . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 39

Uninstalling the HAHTsite IDE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 40

Uninstalling the Application Server . . . . . . . . . . . . . . . . . . . . . . . . . . . . 40

iv

About This Book

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 bookThe table below summarizes the book’s contents.

Conventions

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.

v

The conventions used in this book are described here.

About This Book

HAHTsite installation directoryThis 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 IPMost 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.

Other HAHTsite documentationThe HAHTsite IDE/IP includes this additional documentation:

• HAHTsite IDE and IP User’s Guide

• HAHTsite IDE Programming Guide (IDE only)

• HAHTsite Widget Programming Guide (IDE only)

“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 documentationIn 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.

vi

• 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.

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 GuideThe 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 (inHAHTsiteInstallDir\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 productsIn 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.

vii

About This Book

HAHT Software’s commitment to youWe 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• [email protected] General Information

• [email protected] Sales

• [email protected] Support

World Wide Web• www.haht.com

viii

• Java virtual machines from Sun and Microsoft — fobyte-codes. The Sun virtual machine (version 1.1.7) HAHTsite automatically, and you have the option oMicrosoft virtual machine (version 5.3165). HAHT redo install the Microsoft VM for performance reason

1Before 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/IPHere 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.

1

r interpreting Java is installed with f installing the commends that you

s.

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 requirementsThis section lists the system requirements for the IDE/IP, the Application Server, and the Apache Web server.

The HAHTsite IDE/IPThe 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 EditionThe 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

2

The Web server must support CGI 1.1 or greater.

Apache Web serverThe Apache Web server has the following requirements:


• 5 MB of disk space

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

Installing your Web serverIf 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 machineAll 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:

!

3

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.


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.1Subnet 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.

4

• registers properties of the IDE/IP in the operating sy

2Installing 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 doesThis section describes what the setup program does when you install the IDE/IP, the Application Server, and Apache.

IDE/IPThe 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

5

stem’s registry

Chapter 2: Installing HAHTsite IDE/IP

The Application ServerThe 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 serverThe 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

6

Note - At the beginning of the application server installation process, you have the option of installing Microsoft’s Java virtual machine.


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.

7

Click the Next button.

4 The Enter Serial Number dialog appears.


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 products that you want to install.

8


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

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?”

9

Installing the Apache Web serverThe 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


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.

10

Click Next to proceed.

2 If you have not previously read and accepted Apache’s license agreement, that agreement is displayed in the Software License Agreement dialog.


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

3 The Apache Setup Options dialog appears.

11

Click Typical for a full installation.


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 to Install dialog appears.

12


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.

6 The Apache DNS and Doctree Information dialog appears.

13


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.

Field Description

DNS DNS hostname and domain name

Port Port number

Doctree Path Path for static files

14

8 The Select Program Folder dialog is displayed.


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

15

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


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.

2 The Setup Options dialog appears.

16


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

3 The Select Directory for HAHTsite IDE 4.0 dialog appears.

17


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 appears.

18


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

19

directory location for HAHTsite.

6 The Select Program Folder dialog is displayed.


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

20

EditionNote - 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.


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.

21


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

22

directory.

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


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

ODBC Drivers Microsoft ODBC 3.0 drivers

23


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.

24


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.

Field Description

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

Web Server Static Alias the alias for static Web pages

25


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.

26


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.

Field Description

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

the alias for dynamic Web pages.

27


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.

28

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

You have now finished Application Server installation. Proceed to Chapter 3, “What’s Next?”


Installing INTERSOLV ODBC DriversYour 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.

29


30

your Application Server is configured to use a Sun Java virtual machine.

set that system’s PATH environment variable, and configure the Application Server correctly.

p

3What’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

Install the JDK on your Application Server machine,

“Debugging Java projects (Sun VM)” on

31

age 33.

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 HAHTsite IDE and IP User’s Guide.

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 HAHTsite IDE and IP User’s Guide.

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

32


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

33

dialog and restart the Application Server.


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.

ApacheApache 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.

34

Click OK.

5 Select Virtual Directory, and type the appropriate alias (such as/HScgibin). Then click OK.


Netscape Enterprise Server 2.0Use 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 machineThis 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

35

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.


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

Complete installationFor 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 IDEIf 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.

• The HAHTsite IDE appears. Here is an example.

36


The Application ServerThere 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.

37

Starting the Application Server manuallyUse this procedure to start the Application Server.


• 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.

38

sections describe how to use the uninstall utility for eac

4Removing HAHTsite Products from Your System

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

What the uninstall utility doesThe 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

39

h product.

Chapter 4: Removing HAHTsite Products from Your System

Uninstalling the HAHTsite IDE1 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 Server1 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.

3 Click Yes to uninstall the Application Server.

40

hahtsite 4.0 ide and ip installation guide - pitney...

Documents