Configuring iASP on Lotus Domino Web Server R5

The following instructions show how to configure your Lotus Domino Web Server to run your ASP applications with iASP.

NOTE: We assume that you have installed Instant ASP under c:\iasp. If you have installed it in different directory, please be sure to make appropriate changes when you follow the steps below.

  1. Add the following lines to the JavaUserClasses variable in the NOTES.INI file that is located in your Domino installation directory:
    JavaUserClasses=c:\iasp\lib\iasplib.jar;c:\iasp\lib\activation.jar;c:\iasp\lib\mail.jar;c:\iasp\lib\pop3.jar;c:\iasp\lib\rjax.jar;
    c:\iasp\lib\iasp_image.jar;c:\iasp\lib\iasp_chart.jar;c:\iasp\lib\iasp_mail.jar;c:\iasp\lib\iasp_pop3.jar;c:\iasp\lib\iasp_exec.jar;
    c:\iasp\lib\iasp_sock.jar;c:\iasp\lib\ejbcorba.jar;c:\iasp\lib\classes;c:\iasp\lib\buttons.jar;c:\iasp\servlets

  2. Optionally, append the JavaUserClasses variable definition with any other full paths to directories or .jar/.zip files that contain Java classes to be used with iASP (for example, a JDBC driver).

  3. Enable ASP servlet support on your Domino server:
    From the Domino Administrator, click the Configuration tab.

    1. Choose Server, and then open the Server document.
    2. Click the Internet Protocols - Domino Web Engine tab.
    3. In the Java servlet support field, choose Domino Servlet Manager.
    4. In the Class path field, add the following line:
          c:\iasp\iasplib.jar;c:\iasp\servlets
    5. In the Servlet file extension field, add the following extension: *.asp.
    6. Save the settings.
      For more information, refer to the "Managing Java servlets on a Web server" topic in your Domino Administration Help topics.
  4. Add the following lines to the servlets.properties file that is located in the DATA directory in your Domino installation directory:

    servlet.iasp.code=Dispatcher.DispatcherServlet
    servlet.iasp.extension=asp
    servlets.startup=iasp

  5. Create a virtual iasp directory for your web server. (Create a URL mapping from /iasp to the iASP installation directory, c:\iasp.)

  6. Restart your Domino server.

IMPORTANT:

  • For JdbcOdbc bridge users: The JVM (Java Virtual Machine) included with Domino does not have all the native libraries to support JdbcOdbc bridge.
    To get the required native libraries that support JdbcOdbc bridge, determine which version of JVM you have with Domino, and install the same version of JRE (Java Runtime Environment) from the Sun website. After you have installed JRE, add the JRE bin directory path to your PATH environment variable.
    After you restart your Domino server, you can use JdbcOdbc bridge in ASP code to connect to your database via ODBC.
  • For JDBC driver users: you must add the path of your JDBC driver .jar/.zip file to the JavaUserClasses variable in the NOTES.INI file (located in the Domino installation directory) before you can use it with iASP.
  • The same configuration steps should work on other platforms.

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


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