20

2. Installation

These installation instructions  focus on setting  up a servlet container and installing webMathematica. As explained

previously

, webMathematica is based on a standard Java technology called servlets; support for servlets is typically

provided  by  a  program  called  a  servlet  container.  You  must  set  up  the  servlet  container  before  adding

webMathematica.

The flow of installation is as follows:

      Set up a servlet container.

      Set up Mathematica using the Mathematica CD ROM from your distribution.

      Install the webMathematica web application into your servlet container using the webMathematica Tools 

CD ROM from your distribution.

      For Unix, you may need to set up an X server.

      Possible optional installation steps.

      Finally, you will test your webMathematica site.

More  information  on  installation  of  webMathematica  can  be  obtained  from  the  Wolfram  Research  at

http://documents.wolfram.com/webmathematica/updates/install.

2.1 Setting up a Servlet Container

Before you start to install webMathematica, you need an installation of Java and a servlet container. If you already

have these components, you may skip this section.

There are many different servlet containers, but one that is particularly convenient is Tomcat, which can be obtained

from

 http://jakarta.apache.org.

 Another

 popular

 server

 container

 is

 JRun,

http://www.macromedia.com/software/jrun/.  Since  Tomcat  is  a  common  way  to  run  webMathematica,  we  have

added information on installing and setting it up on 

Unix

 and 

Windows

.

webMathematica  has  been  tested  with  both  Tomcat  and  JRun  as  well  as  other  containers  listed  at

http://www.wolfram.com/products/webmathematica/technology/specifications.html . If you have a particular interest

or experience in running webMathematica with other containers, please contact Wolfram Research. However, if you

do not have expertise with these other containers, we recommend you use Apache Tomcat.

When your servlet container is functioning correctly, as demonstrated by running its sample servlets, you are ready

to install webMathematica. If your servlet container does not work, then webMathematica cannot work. The remain 

ing steps in this section show you how to set up Java and Tomcat. If you are not using Tomcat you should skip this

section and study the documentation for your servlet container.

 .