22

2.1.2 Setting up Tomcat

This  section  describes  setting  up  Tomcat  on  Unix  and  Windows.  The  main  web  site  for  Tomcat  is

http://jakarta.apache.org; a list of useful links is maintained in Links Appendix: Tomcat.

Unix

Before you run Tomcat, you should first make sure you have set up a JDK on your machine; this was described in

the 

previous section

.

Download

 information

 for

 current

 versions

 of

 Tomcat

 is

 given

 at

http://documents.wolfram.com/webmathematica/updates/install/tomcat/current .  A  variety  of  archive  formats  are

available; one of these should be unpacked in some central location, for example /usr/local. You may also wish

to change the name of the top level directory. The actual location of Tomcat and the name of the top level directory

are entirely up to you.  Sample shell instructions for these steps are shown below (note that tar xvfz archive

will give you more information on what files are being extracted). Other versions of Tomcat are available from the

Apache web site, http://jakarta.apache.org.

[server1]$ cd /usr/local

[server1]$ tar xfz jakarta tomcat 4.1.18.tar.gz

[server1]$ mv jakarta tomcat 4.1.18 tomcat

On some platforms, such as Solaris, the default tar command does not work to unpack the Tomcat archive as shown

above.  One  would  need  to obtain  the  GNU  tar  utility  from http://www.gnu.org/directory/GNU/tar.html  in  order to

use the options shown.

It  is  often  useful  to  create  a  low privilege  account,  such  as  tomcat,  to  run  your  servlet  container.  It  is  probably

helpful if this account has a home directory so that your X server and Mathematica can store preferences  informa 

tion. If you create such an account, you may need to change ownership of the Tomcat layout so it can be run by this

account.

[server1]$ chown  R tomcat tomcat

The main top level directory of Tomcat contains some important directories, including:

tomcat

    bin

conf

logs

webapps

The bin directory contains commands for running Tomcat; the conf directory contains site configuration files; the

logs directory  contains various log files; the webapps directory  is where you will install webMathematica. You

should be able to launch Tomcat immediately from the bin directory, making sure to be the tomcat user.

[server1]$ su tomcat

[server1]$ cd tomcat/bin

[server1]$ ./startup.sh

At  this  point,  you  should  be  able  to  connect  to  Tomcat  via  a  URL  such  as  http://localhost:8080.  If  this  does  not

return the Tomcat front page, then something is wrong with your setup. If you look at the log files, it may help you

track  down  your  problem.  Make  sure  that  you  have

 1988 2003

 set

 Wolfram

 your

 Research,

 JAV

 Inc. All

A_HO

 rights

ME

 reserved.

 variable  as  described  in  the  installing

Java for Unix

 section.