Instant ASP Logo


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.

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   OK                
Servlet Interface 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                
Servlet Interface iASP iASP iASP iASP iASP iASP iASP iASP iASP               JRun/JServ                    
Novell Netware                     OK  OK OK OK                          
Servlet Interface                       NSG   NSG                            
SCO UNIOKWARE OK OK OK OK OK OK OK OK OK OK                                  
Servlet Interface 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
Servlet Interface 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
Servlet Interface 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
Servlet Interface iASP iASP iASP iASP iASP iASP iASP iASP iASP               JRun/JServ                    
FreeBSD OK       OK OK OK OK OK               OK                    
Servlet Interface 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.0
OK OK   WS 2.0
WS 3.0
    OK OK OK
Servlet Interface iASP iASP iASP iASP iASP iASP iASP iASP iASP   iASP iASP   iASP iASP     iASP       iASP          
Mac OS                                           OK OK      
Servlet Interface                                           ServletExec ServletExec      
SGI                               OK                    
Servlet Interface                               JRun/JServ                    
HPUX                               OK                    
Servlet Interface                               JRun/JServ                    
IBM AS/400                                

OK

  OK        
 
IBM S/390                                  

OK

  OK  
IBM RS/6000                                                    
 

 


General Installation on
Unix-based, Windows-based or Novell Netware Platform

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

  1. Shut down your web server.

  2. Uncompress the iasp.tar file with the following command:
    "tar -xvf iasp.tar".
    An "iasp" directory will be generated under the current directory.

  3. Change to this "iasp" directory and type './install.sh'.

  4. Follow the installation scripts instructions to install Instant ASP.

Windows (.exe file)

  1. After you have downloaded Instant ASP, copy the Instant ASP installation executable to any convenient folder (e.g. \temp).

  2. Shut down your web server.

  3. 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):

Figure 1
iasp.gif (3340 bytes)

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:

Please refer to the following pages for detailed Instant ASP installation instructions on the following web servers:
Apache Web Server (on a UNIX platform that does not support Dynamic Shared Objects (DSO))
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
Please refer to the following page for detailed instructions on configuring Instant ASP with the following servlet interface:
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)

Running Instant ASP

To run Instant ASP, follow the steps below:
  1. Make sure that Instant ASP files have been installed according to the instructions above.

  2.  
  3. Restart the Web server;

  4. SECURITY ADVISORYPlease 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.
     
  5. Point your web browser at http://<servername>/iasp (or http://<servername> if you installed Instant ASP as your Web server's root);

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