26

Another reason to modify MSP.conf is to store your webMathematica license in its own password file, for exam 

ple,  webMathematica/WEB INF/conf/mathpass.  It  would  then  be  necessary  to  modify  MSP.conf  to

ensure  that  Mathematica  uses  this  location.  The  following  shows  how  this  could  be  done  for  a  typical  Windows

installation.

MathLinkArguments= linkname   c:\\Program Files\\Wolfram 

Research\\

Mathematica

\\4.2\\MathKernel.exe  mathlink  pwfile 

"c:/Program Files/tomcat/webapps/webMathematica/WEB 

INF/conf/mathpass"    linkmode launch

A typical setting for MSP.conf to use a special mathpass file under Unix is shown below.

MathLinkArguments= linkname   math  mathlink  pwfile 

/usr/local/tomcat/webapps/webMathematica/WEF 

INF/conf/mathpass    linkmode launch

Under Unix, you may need to add a FrontEndLaunchCommand parameter so the front end can run properly. In

the following example, the front end will be launched to use DISPLAY 1 with fixed geometry and in server mode.

For more information on running the front end under Unix, see the documentation section 

Configuring  for the X

Window System

.

FrontEndLaunchCommand=mathematica  mathlink  display :1  nogui 

 geometry 1000x500+10+10

2.3.2 If You Do Not Use Tomcat

JRun

JRun  is  a  sophisticated  application  server.  It  contains  a  web based  wizard  to  guide  you  through  the  installation

process. You will need to follow JRun specific instructions to install the webMathematica web application that are

given  in  this  section.  Please  note  that  you  need  to  use  JRun  4.0  or  higher  in  order  to  use  the  webMathematica

custom  tags.  If  you  use JRun  3.x, you  can still  use webMathematica  as  described  in  the  section  on 

Classic  web 

Mathematica Technology

. These installation instructions are appropriate for JRun 4.

First, unpack the webMathematica archive into a location on your server that is accessible by JRun, e.g. E:\web 

Mathematica. At this time you can make any necessary changes to MSP.conf. For example, you may wish to

set  the  MathLinkArguments  or  the  FrontEndLaunchCommand  as  described  in  the  section  for  

installing

into Tomcat

.

Now  use  the  JRun  Management  Console,  which  under  Windows  is  accessible  via  Start >Programs 

>Macromedia  JRun4 >JRun  Management  Console.  Alternatively,  you  can  use  the  URL

http://localhost:8000.  You  will  need  to  enter  the  username  and  password  that  were  specified  when  JRun  was

installed.  Once  you gain  access,  click  on  the  default  link  on  the  left  frame  to  expand  its contents.  In  the  main

frame,  you  should  see  information  about  the  default  server,  which  has  the  title  J2EE  Components  on

default.

Click on the add button under Web Applications to add the webMathematica web application. You will see a

new  page,  entitled  Deploy  Web  Application,  with  a  field  called  Source  File  Path.  Click  on  the

Browse button   this will bring up a file browsing window. Navigate to the location (e.g. E:\webMathematica)

where you have extracted  the files from the webMathematica archive. Select the webMathematica folder icon, and

click on the Open button. This will change the Source File Path to E:\webMathematica. You can now

click  on Deploy. After a  few moments, you will see  a  screen that allows you to  customize  various details  of  the

installation, depending on the version of JRun that you are using. You can choose the default values and then click

the  Apply  button.  A  message  informing  you  that

 1988 2003

 the

 Wolfram

 deployment

 Research,  Inc. All

 of

 rights

 web

 reserved.

Mathematica  has  been  successful  will

appear.