24

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). These instructions assume that you are using the Terminal application found in

Applications > Utilities > Terminal.

[server1]$ cd /Library

[server1]$ sudo /usr/bin/gnutar xfz jakarta tomcat 4.1.18.tar.gz

[server1]$ sudo mv jakarta tomcat 4.1.18 tomcat

It is often good to create a low privilege account, such as tomcat, to run your servlet container. You can accom 

plish this via the System Preferences panel. 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]$ sudo 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 set your JAVA_HOME variable as described in the installing Java

for Mac OS X section.

The bin directory also contains a script, shutdown.sh, used for shutting down Tomcat.

Please also note  that for webMathematica  to fully function,  one would  need  to log  on via  the Mac OS  X console.

This is necessary since the Mathematica front end makes use of the Mac OS X windowing environment. 

2.2 Installing and Configuring Mathematica

Install Mathematica from the Mathematica CD ROM using the Getting Started with Mathematica manual appropri 

ate  for your  platform  on  the  computer  you  wish to  use  for  your  web  server.  You should  choose  a  single machine

installation  and  install  an  appropriate  license  as  described  in  the  manual.  When  you  have  finished,  you  should  be

able to run Mathematica interactively  to validate your installation. If Mathematica cannot run, then webMathemat 

ica cannot run.

If you already have an installation of Mathematica 4.2 on your server, you do not need to install Mathematica again

but  can  proceed  with  the  remaining  installation  steps.  With  an  existing  installation  of  Mathematica  4.2,  you  may

place your webMathematica license information into a different location, as described in the section on the installa 

tion of the webMathematica web application. Placing the license information in a different location will ensure that

an interactive  usage of Mathematica on your server  does not interfere with the operation of your webMathematica

site.  One  possible  alternative  directory  is  the  webMa

 1988 2003

them

 Wolfram

atic

 Research,  Inc.

a/WE

 All rights

B IN

 reserved.

F/conf  directory  as  demonstrated  in

the section on installing webMathematica  into Tomcat. Note that if you install the license in a special file you will

have to set the  pwfile option when you run Mathematica outside of webMathematica.