23

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 Unix

 section.

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

Information on launching 

Tomcat automatically on Unix

 is given in a later section.

Windows

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  convenient  way  to  install  Tomcat

is to download the self installing executable. You should launch the installer and follow the instructions it provides.

If you choose not to use the self installing executable, then unpack the binary distribution into a convenient location.

Other versions of Tomcat are available from the Apache web site, http://jakarta.apache.org.

After installation is complete, you may wish to inspect the main top level directory of Tomcat, which 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.

The  installer  adds  a  Start  Menu  Group  from  which  you  can  run  Tomcat.  You  should  test  it  via  a  URL  such  as

http://localhost:8080.  If  Tomcat  does  not  run  correctly,  you  should  open  a  command  prompt  window,  change

directories  ("cd")  to  the  bin  directory  (in  the  main  top level  directory  of  Tomcat)  and  try  running  the

startup.bat batch file (this can also be accomplished by double clicking on the file via the Windows Explorer).

Starting and stopping Tomcat from the Start Menu is very convenient (this is also a new feature of Tomcat 4.1), but

for running  Tomcat  as  a production  server  under  Windows  you  may wish to run it as a  Windows  Service.  This  is

described in the section on launching 

Tomcat automatically on Windows.

Mac OS X

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 /Library. You may also wish to

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

directory are entirely up to you. /Library is useful because it can be viewed via the Finder. Other versions of

Tomcat are available from the Apache web site, http://jakarta.apache.org.

Note that the default OS X tar command does not work to unpack the Tomcat archive as shown below. One would

need to use the  GNU tar utility (gnutar), which should reside in /usr/bin/, to use the options shown. One could

also use Stuffit Expander (version 7.0.1 and later) which uncompresses *.tar.gz archives.

 .