HAHTsite IDE and IP Installation Guide

Transcription

1 HAHTsite IDE and IP Installation Guide

2 IDE and IP Installation Guide release 4.0

3 Notice Copyright 1999 HAHT Software, Inc. All Rights Reserved May 1999 MN01-C 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 et. seq. or subparagraph (c)(1) and (2) of the Commercial Computer Software 96 Restricted Rights at FAR , as applicable. Contractor is HAHT Software, Inc., 4200 Six Forks Road, Raleigh, NC 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. Portions Copyright Summit Software Company. This product includes software developed by the Apache Group for use in the Apache HTTP server project ( 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 Six Forks Road Raleigh, NC USA (919) (888) (in the USA) (919) (Technical Support)

4 Contents About This Book What s in this book v Conventions v HAHTsite installation directory vi HAHTsite IDE and HAHTsite IP vi Other HAHTsite documentation vi Getting Started vi Online documentation vi HAHTsite OLE Interface Guide vii Other HAHTsite products vii HAHT Software s commitment to you viii Telephone viii viii World Wide Web viii 1 Before Starting the Installation The products that come with the HAHTsite IDE/IP System requirements The HAHTsite IDE/IP The HAHTsite Application Server: Developer Edition Apache Web server Installing your Web server Before installing the IDE/IP on a standalone machine Installing HAHTsite IDE/IP What the setup program does IDE/IP The Application Server Apache Web server iii

5 Contents Running the setup program (all platforms) Installing the Apache Web server Installing the IDE/IP Installing the HAHTsite Application Server: Developer Edition Installing INTERSOLV ODBC Drivers What s Next? What setup tasks do I need to perform? Debugging Java projects (Sun VM) Connecting the Web server to the Application Server Apache Microsoft Internet Information Server (IIS) Netscape Enterprise Server Using the Sun Java 2 virtual machine Verifying the installation Complete installation The IDE The Application Server Starting the Application Server manually Removing HAHTsite Products from Your System What the uninstall utility does Uninstalling the HAHTsite IDE Uninstalling the Application Server iv

6 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 book The table below summarizes the book s contents. Chapter Chapter 1, Before Starting the Installation Chapter 2, Installing HAHTsite IDE/IP Chapter 3, What s Next? Chapter 4, Removing HAHTsite Products from Your System Contents Describes the products that come with HAHTsite and presents some important information you need to be aware of before you start the installation. Provides step-by-step instructions on installing the HAHTsite IDE/IP software. 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. Describes how to remove the HAHTsite products from your system. Conventions The conventions used in this book are described here. v

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. Other HAHTsite documentation The 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 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. vi

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

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) Technical Support (Voice) (919) Technical Support (FAX) (888) Sales (Voice in the USA) (919) Office (Voice) (919) Office (FAX) info@haht.com General Information sales@haht.com Sales support@haht.com Support World Wide Web viii

10 Before Starting the Installation 1 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 ). HAHT recommends that you do install the Microsoft VM for performance reasons. 1

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. Apache Web server The Apache Web server has the following requirements: 2

12 Chapter 1: Before Starting the Installation 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. 3

13 Chapter 1: Before Starting the Installation 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: Subnet Mask: 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

14 Installing HAHTsite IDE/IP 2 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 registers properties of the IDE/IP in the operating system s registry 5

15 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. 6

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. 4 The Enter Serial Number dialog appears. 7

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

18 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? 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 9

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. 2 If you have not previously read and accepted Apache s license agreement, that agreement is displayed in the Software License Agreement dialog. 10

20 Read the license agreement, and click Yes to agree to its terms. 3 The Apache Setup Options dialog appears. Click Typical for a full installation. 11

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

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. 6 The Apache DNS and Doctree Information dialog appears. 13

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. Field DNS Port Doctree Path Description DNS hostname and domain name Port number Path for static files 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. 14

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

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. 2 The Setup Options dialog appears. 16

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 3 The Select Directory for HAHTsite IDE 4.0 dialog appears. 17

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

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. 6 The Select Program Folder dialog is displayed. 19

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

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

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

32 Check each item you want to install, and clear the check boxes for any items you want to omit from the installation: Item Application Server Files CORBA: VisiBroker for Java ODBC Drivers Description Executable files for the HAHTsite Application Server All files necessary to use CORBA with HAHTsite applications Microsoft ODBC 3.0 drivers 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. 23

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

34 Field Web server Web Server Virtual Host Web Server Static Alias Description the name of an installed Web server that is recognized by the Application Server setup the hostname and port number the alias for static Web pages 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. 25

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

36 Field Web server Web Server Virtual Host Web Server Dynamic Alias Description the Web server that you ll be using with your Application Server the hostname and port number the alias for dynamic Web pages. 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 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. 27

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. You have now finished Application Server installation. Proceed to Chapter 3, What s Next? 28

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

39 30

40 What s Next? 3 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.) You want to debug Java applications and your Application Server is configured to use a Sun Java virtual machine. Install a Java compiler, such as the one available with Sun s Java Developer s Kit. Then, configure the IDE to use that compiler. Install the JDK on your Application Server machine, set that system s PATH environment variable, and configure the Application Server correctly. Chapter 2, Using the IDE/IP s Windows and Toolbars in the HAHTsite IDE and IP User s Guide. Debugging Java projects (Sun VM) on page

41 Chapter 3: What s Next? If... Then you need to... Go to this section You decide to use a different Web server than you chose during installation. You want HAHTsite to use the Sun Java 2 (1.2) virtual machine to interpret Java byte-codes. 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. Any of your HAHTsite applications use databases (unless you plan to use only flat-file ODBC drivers). 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. Install the new Java virtual machine, and then configure the Application Server to use it. Create a site definition for your Application Server configuration, and add it to your project. 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. Connecting the Web server to the Application Server on page 34. Using the Sun Java 2 virtual machine on page 35. Chapter 4, Working with Sites in the HAHTsite IDE and IP User s Guide. Appendix C, Adding an ODBC Data Source in the HAHTsite IDE and IP User s Guide. 32

42 Debugging Java projects (Sun VM) Chapter 3: What s Next? 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 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 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 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. 33

43 Chapter 3: What s Next? 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 /HScgibin). Then click OK. 34

44 Chapter 3: What s Next? 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. 35

45 Chapter 3: What s Next? 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. The HAHTsite IDE appears. Here is an example. 36

46 Chapter 3: What s Next? 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 Use this procedure to start the Application Server. 37

47 Chapter 3: What s Next? 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

48 Removing HAHTsite Products from Your System 4 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. 39

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. 3 Click Yes to uninstall the Application Server. 40