Instant ASP Logo


Configuring Instant ASP on Zeus Web Server

This page explains the procedure for installing Instant ASP on a Zeus web server (If you don't have it, you can click here to download it). Before attempting to install Instant ASP, please make sure that the Zeus web server is properly installed and running. Instant ASP has been tested with Zeus 3.1.8 on Linux and Solaris platforms. In theory, however, Instant ASP should run on all Zeus platforms.

NOTE: Some Instant ASP samples will not run properly since the Zeus servlet interface does not currently support sessions. For seesion support on Zeus, instead configuring with following steps, Apache JServ will need to be configured with Zeus webserver. Instructions for installing JServ are here.

  1. Using the Zeus administration server, click Web icon to select or create a new webserver. This example uses the name "iasptest" for the new webserver.
  2. Choose the New Server icon under Actions (figure 1).

    figure 1
    zeus.gif (5127 bytes)

  3. Add the following in the New Server window.
  4. e.g.:
    Server Name:iasptest
    Server URL:192.9.200.100:5000
    Document Root:/home/iasp
    Clone Server:default setting

    Then click the Create Server button.

  5. Double-click the Edit icon in Status window and browse the Module Configuration (figure 2 and 3).

  6. figure 2
    zeus1.gif (4892 bytes)


    figure 3
    zeus3.gif (23971 bytes)

  7. Select the Distributed option (figure 4).

  8. figure 4
    zeus2.gif (5905 bytes)

  9. Add the following under the 'Java Servlets' field in Edit Server Page:
  10. Service prefix: /servlet
    Servlet server: 192.9.200.100:5000

    NOTE: You should replace the IP address, 192.9.200.100, with YOUR IP address for the machine hosting the Zeus Webserver. 5000 is the port number assigned to Instant ASP.

  11. Click the Update button to save the changes.
  12. Return to Edit Server page and choose the Path Mapping option (figure 5).

  13. figure 5
    zeus3.gif (23971 bytes)

  14. Add the following under the Handler section:

    File extension: asp
    Handler: /servlet/Dispatcher.DispatcherServlet

    Click the Add button to finish the action.

  15. Next, configure Start file which can be found in %ZEUSHOME%/web/java/servlet directory. You will need to customize the changes to this script according to your own environment:

    e.g.:
  16. #! /bin/sh
    JAVAVM=/usr/jdk116/bin/java z
    CLASSPATH="/usr/jdk116/lib/classes.zip:/usr/local/zeus/web/java/servlet/ZeusServlet.zip:
    /java/lib/classes.zip:/iasp/lib/classes:/iasp/lib/activation.jar:/iasp/lib/iasplib.jar:/iasp/lib/buttons.jar:
    /iasp/lib/jsdk.jar:/iasp/lib/rjax.jar:/iasp/lib/ejbcorba.jar:/iasp/lib/iasp_image.jar:/iasp/lib/iasp_sock.jar:
    /iasp/lib/iasp_mail.jar:/iasp/lib/iasp_chart.jar:/iasp/lib/iasp_pop3.jar:/iasp/lib/iasp_exec.jar"
    ZEUSHOME=/usr/local/zeus
    ZEUS=/usr/local/zeus
    export CLASSPATH  ZEUSHOME
    exec $JAVAVM -DZEUSHOME=$ZEUSHOME uk.co.zeus.servlet.SockdServletGate $*

    NOTE: /user/jdk116/bin/java above should be replaced with the correct path to the Java virtual machine installed on your system. Similarly, substitute the /iasp directory with the directory in which you installed Instant ASP.

  17. Start Instant ASP server engine by executing the "start" script:
  18. % ./start iasptest

    NOTE: Substitute iasptest for the name you used for your webserver in step one above.

  19. After you execute the start script, you will see the following messages on your terminal:

  20. Zeus ServletServer/1.1 -(C) Zeus Technology Ltd 1998

    Starting server on port 5000 using prefix /servlet/ 

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

    http://<hostname:portnumber>/

  22. Choose the "Hello World" sample from the General samples link in the left-hand pane.
  23. 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.