Configuring iASP on Sun Web Server

The following instructions show how to configure your Sambar Server to run your ASP applications with iASP.

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

    sunweb1.gif (5114 bytes)

  3. In the Server List column, under the Web Server folder, select the Servlets item.

    sunweb2.gif (8707 bytes)

  4. Specify the following global servlet settings:
    For Enable Servlets, check the box.
    For Servlet Engine, choose Shared Servlet Engine from the drop down list.
    For Server 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
    NOTE: Make sure you replace the /iasp directory above with your correct Instant ASP installation path.

  5. In the Server List column, under the Web Server folder, select the Web Sites item.

    sunweb3.gif (5919 bytes)

  6. Highlight a web site from the Web Sites List column.
  7. Right-click Web Server and choose Web Site Manager... from the pop-up menu.

    sunweb4.gif (4293 bytes)

  8. Choose Properties from the drop-down list in the Web Site Manager.

    sunweb5.gif (3844 bytes)

  9. Select URL Aliases from the list of properties you can modify.

    sunweb6.gif (6228 bytes)
  10. Specify the following URL Aliases properties:
    Site URI: *.asp.
    Directory/URL Alias: DispatcherServlet.
    Type: servlet.

  11. Select Site Properties from the list of properties you can modify.

    sunweb7.gif (6098 bytes)
  12. For Document Root, specify the Instant ASP root directory.

    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.

  13. Choose Servlets from the drop-down list in the Web Site Manager.
  14. Select Manager in the Servlets column.
  15. In the Servlet Manager, click the Add button to add a new servlet.

    sunweb8.gif (8347 bytes)

  16. Specify the following information in the appropriate fields of the new row.
    Servlet Name: DispatcherServlet
    Code: Dispatcher.DispatcherServlet
    Loading: startup

  17. Save your changes and restart your Web server.

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

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

  19. 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-2002, Halcyon Software Inc. All rights reserved.