Instant ASP Logo


Configuring Instant ASP on Sun Web Server

Before continuing, please make sure that Sun Web Server (SWS 2.1) is properly installed and running.

  1. Sign on to the SWS Admin server by pointing your web browser at the following URL:

    http://<hostname>:2380/admin/server_admin.html


  2. In the SWS Admin server, select or create a web server.  The following example uses a default web server named "sws_server" (figure 1).

    figure 1
    sunweb1.gif (5114 bytes)

  3. In Server List column under the Web Server folder, choose "Servlets". The items here must be configured in the Servlet Settings column (figure 2).

    Enable Servlets: Enable this option.
    Servlet Engine: Choose "Shared Servlet Engine" from the drop down list.

    Servlet CLASSPATH: In addition to default settings, add all the Instant ASP libraries to the end of the string, for example:

    /usr/jsdk/examples:/iasp/lib/classes:/iasp/lib/activation.jar:/iasp/lib/ejbcorba.jar:/iasp/lib/iasplib.jar:
    /iasp/lib/jsdk.jar:/iasp/lib/buttons.jar:/iasp/lib/iasp_image.jar:/iasp/lib/iasp_sock.jar:/iasp/lib/iasp_chart.jar:
    /iasp/lib/iasp_mail.jar:/iasp/lib/iasp_pop3.jar:/iasp/lib/iasp_exec.jar:/iasp/lib/rjax.jar


    figure 2
    sunweb2.gif (8707 bytes)

    NOTE: Make sure you replace the /iasp directory above with your correct Instant ASP installation path.

  4. Choose "Web Sites" from the Server List column under the Web Server folder, and highlight a web site from the Web Sites List column (figure 3).

    figure 3
    sunweb3.gif (5919 bytes)

  5. Right-click Web Server and choose the "Web Site Manager" command from the pop-up menu (figure 4).

    figure 4
    sunweb4.gif (4293 bytes)

  6. Choose "Properties" from the drop-down list box in the Web Site menu (figure 5).

    figure 5
    sunweb5.gif (3844 bytes)

  7. Choose "URL Aliases", and add the following configuration (figure 6):

    Site URI: *.asp
    Directory/URL Alias: DispatcherServlet
    Type: servlet


    figure 6
    sunweb6.gif (6228 bytes)

  8. Choose "Site Properties", and modify the "Document Root" so that it points to the Instant ASP root directory (figure 7).

    figure 7
    sunweb7.gif (6098 bytes)

    NOTE
    : This step is not necessary--it simply allows you to easily view the Instant ASP documentation and sample files. If you do not set your document root to the Instant ASP root directory, make sure you have a path to get to the Instant ASP folder from your web browser.

  9. Choose Servlets from the list box in the Web Site menu, and then click "Manager" in the   "Servlets" Column. Click the Add button to add a new servlet (figure 8).

    figure 8
    sunweb8.gif (8347 bytes)

  10. In the Add/Edit Servlet Properties dialog, specify the following configuration:

    Servlet Name: DispatcherServlet
    Code: Dispatcher.DispatcherServlet

    Enable the Load at Startup option.


  11. Save your changes and restart your Web server.

  12. Verify that Instant ASP is running correctly by pointing your web browser at

    http://<hostname>/<path to Instant ASP directory>


  13. Choose the "Hello World" sample from the General samples link in the left-hand pane. You will see several lines displaying the phrase, "Hello World", in increasing font sizes.


If you encounter any problems or errors, please contact support@halcyonsoft.com


Copyright © 1998-2000, Halcyon Software Inc. All rights reserved.