![]()
Getting Started with Instant ASP
Instant ASP uses Halcyon Software's own high-performance servlet interface to connect to supported web servers. There are two steps for running Instant ASP with your web server: installation and web server configuration.
Supported Platforms and Web Servers
Instant ASP is written in Java, and runs on all Java platforms. Internally, Halcyon Software's engineering team certifies Instant ASP on each platform. This certification process takes place either in house with the proper hardware and software, or is executed in a Halcyon Software partner's certification facilities. Please feel free to contact asp@halcyonsoft.com if you do not see support for a platform you require. Halcyon's goal is to make Instant ASP available on all web server platforms.
- represents Instant ASP certification process on that web server, "OK" means certification has been done;
- represents the servlet interface, "iASP" indicates iASP Servlet Interface, "NSG" indicates Novell Servlet Gateway for Netware, "JServ" indicates Apache JServ servlvet engine, blank cell means the web server has its own servlet interface.
- FT/ES - Netscape Fast Track/Eneterprise Server
- SWS - Sun WebServer 2.1
- JWS - Java Web Server
- L.D. - Lotus Domino
Platform Apache Netscape FT/ES SWS Zeus IIS L.D. JWS WebLogic WebSphere WebSTAR WebTen Xitami Sambar iServer 1.3.0 1.3.1 1.3.2 1.3.3 1.3.4 1.3.6 1.3.9 1.3.11 1.3.12 FT2.0.x FT3.0.x EP3.0.x EP3.5.x EP3.6.x iPlanet Sun Solaris Sparc OK OK OK OK OK OK OK OK OK OK OK OK OK OK OK iASP iASP iASP iASP iASP iASP iASP iASP iASP iASP iASP iASP iASP JRun/JServ Sun Solaris Intel OK OK OK OK OK OK OK OK OK OK OK OK iASP iASP iASP iASP iASP iASP iASP iASP iASP JRun/JServ Novell Netware OK OK OK OK NSG NSG SCO UNIOKWARE OK OK OK OK OK OK OK OK OK OK iASP iASP iASP iASP iASP iASP iASP iASP iASP iASP RedHat Linux (x86) OK OK OK OK OK OK OK OK OK OK OK OK OK iASP iASP iASP iASP iASP iASP iASP iASP iASP iASP JRun/JServ Cobalt Linux (x86/Mips) OK OK OK OK OK OK OK OK OK OK OK OK iASP iASP iASP iASP iASP iASP iASP iASP iASP JRun/JServ Caldera OpenLinux(x86) OK OK OK OK OK OK OK OK OK OK OK iASP iASP iASP iASP iASP iASP iASP iASP iASP JRun/JServ FreeBSD OK OK OK OK OK OK OK iASP iASP iASP iASP iASP iASP JRun/JServ Windows NT/98 OK OK OK OK OK OK OK OK OK OK OK OK OK 3.0
4.0OK OK WS 2.0
WS 3.0OK OK OK iASP iASP iASP iASP iASP iASP iASP iASP iASP iASP iASP iASP iASP iASP iASP Mac OS OK OK ServletExec ServletExec SGI OK JRun/JServ HPUX OK JRun/JServ IBM AS/400 OK IBM S/390 OK IBM RS/6000
General Installation on
Unix-based, Windows-based or Novell Netware PlatformThis section explains how to properly extract and install Instant ASP program files on your system. Instructions provided here are optimized for Linux, Solaris, SCO Unixware and Windows NT, but can be easily extended to other platforms. Please keep in mind that for whichever platform you choose, you must have a servlet interface provided by either your Web server (e.g. Zeus) or by a third party such as IBM, Live Software or New Atlanta (please note that third party servlet interfaces may negatively impact performance).
IMPORTANT: You MUST install JDK 1.1.x or higher BEFORE attempting to install Instant ASP. If you haven't got it, you can click here and download it.
Unix (.tar file)
Before extracting the file, make sure you have write permissions for the directory in which you wish to install Instant ASP. Follow the steps below.
- Shut down your web server.
- Uncompress the iasp.tar file with the following command:
"tar -xvf iasp.tar".
An "iasp" directory will be generated under the current directory.
- Change to this "iasp" directory and type './install.sh'.
- Follow the installation scripts instructions to install Instant ASP.
Windows (.exe file)
- After you have downloaded Instant ASP, copy the Instant ASP installation executable to any convenient folder (e.g. \temp).
- Shut down your web server.
- Double-click on iasp.exe to begin the Instant ASP installation process.
Novell Netware (exe file)
If you are installing Instant ASP on Novell Netware 5.0, please refer to the following link: Installing Instant ASP on Novell Netware 5.0
Configuring Instant ASP
Once the Instant ASP installation process has completed, the following dialog is displayed (figure 1):
Please refer to the following pages for detailed Instant ASP installation instructions on the following web servers:Figure 1
If you are running a Zeus or Sun web server, click the Cancel button to exit the wizard and click here to get more details of configuring iASP on these two web servers.
Figure 2
As the figure shows above, if you are running IIS, Apache, Netscape, Novell Netware or Xitami web server and wish to configure your web server for Instant ASP (recommended), select the web server you want to configure and click the Next button. The installation wizard will instruct you to add the Instant ASP servlet interface information to your web server configuration files, and will add /iasp as a virtual directory so that you can run the Instant ASP samples by pointing your web browser at http:<server-name>/iasp (see the next section for more details).
If you are running IIS, Apache or Netscape web server and wish to configure your web server for Instant ASP later, click the Cancel button to exit the wizard. You can configure iASP later by following the instructions below:
- If you are running Instant ASP on a Unix platform, go to the Instant ASP root directory and run the connector.sh script.
- If you are running Instant ASP on a Windows platform, run the Connector Wizard shortcut from the Instant ASP program group.
Apache Web Server (on a UNIX platform that does not support Dynamic Shared Objects (DSO))Please refer to the following page for detailed instructions on configuring Instant ASP with the following servlet interface:
Internet Information Server (IIS) 3.0
Internet Information Server (IIS) 4.0
Novell Netware 5.0
JavaWebServer
Lotus Domino Server R5
Zeus Web Server
iServer
Sambar Server
Sun Web Server
IBM WebSphere Application Server for AS/400
IBM WebSphere Application Server for S/390
IBM WebSphere Application Server 2.0 for NT4.0
IBM WebSphere Application Server 3.0 for NT4.0
BEA Weblogic Server™
Xitami Web Server
JServ for Apache Web Server
Apache JServ on Zeus Web Server
JRun on Zeus Web Server
ServletExec on WebSTAR Web Server (Mac OS)
ServletExec on WebTen Web Server (Mac OS)
To run Instant ASP, follow the steps below: Running Instant ASP
- Make sure that Instant ASP files have been installed according to the instructions above.
- Restart the Web server;
SECURITY ADVISORY: Please read the SECURITY ADVISORY before starting the iASP server.
On UNIX: go to Instant ASP root directory and run start-server.sh.
On Windows NT: click the 'Start Instant ASP' program item in the Instant ASP program group.
- Point your web browser at http://<servername>/iasp (or http://<servername> if you installed Instant ASP as your Web server's root);
- To verify that Instant ASP is running correctly, follow the "Instant ASP Samples" link, select "General" and click on "Run" for the "Hello World" sample.
If you encounter any problems or errors, please contact support@halcyonsoft.com.
Copyright © 1998-2000, Halcyon Software Inc. All rights reserved.