This is documentation for an earlier version of webMathematica.
View current User Guide (Version 3.3)

Documentation2. Installation


2.5 Upgrading from webMathematica 1.0

This section discusses some of the issues that will concern you if you already have webMathematica 1.0. If you are using an older servlet container this may be a good opportunity to upgrade to something more recent. You should note that to use all the features of webMathematica 2.0 a servlet container that supports the JSP API 1.2 is required. If you are going to upgrade your servlet container you could follow the instructions at the beginning of this chapter as though this was a fresh installation of webMathematica 2.0.

A summary of the new features can be found in the section webMathematica 2.0 New Features.

2.5.1 Install Mathematica 4.2

webMathematica 2.0 comes with a copy of Mathematica 4.2 and this should be installed as discussed in the section on Installing and Configuring Mathematica.

If you have installed any applications into your copy of Mathematica 4.1 you will need to make them available to Mathematica 4.2, this is discussed in the section Installing Packages. Note that you should not copy the MSP application from Mathematica 4.1 to Mathematica 4.2.

2.5.2 Install the webMathematica Web Application

To install the webMathematica web application you will need to remove your current webMathematica web application out of your servlet container. For Tomcat, this is a simple matter of moving the webMathematica directory from the webapps directory. You may need some of the material in this web application so you should probably keep it somewhere accessible. After this you can follow the instructions for Installing the webMathematica Web Application.

2.5.3 Configure the New Layout

If you made any special configuration to your old version of webMathematica you may want to make similar changes in webMathematica 2.0. Two relevant files are web.xml and MSP.conf. In addition, the security system is configured in a different way.


Warning: you should not copy the web.xml file from webMathematica 1.0 into webMathematica 2.0. Some of the settings are incompatible between the two versions and will prevent webMathematica 2.0 from running correctly.

In both webMathematica 1.0 and 2.0 the web.xml file is found in the directory webMathematica/WEB-INF. You should only make changes in this file if you are certain that you understand the intent of the setting.


In webMathematica 1.0 this is found in the Configuration directory in the MSP Mathematica application. In webMathematica 2.0 it is found in the directory webMathematica/WEB-INF/conf. You should copy specific configuration parameters rather than taking the entire file. MSP.conf contains the location of Mathematica, so you should make sure that it refers to the Mathematica 4.2 installed earlier. In addition, you should not set the MSPDirectory in webMathematica 2.0 but use the default location, webMathematica/WEB-INF/MSPScripts.

Note that the security system is configured differently, this is described in the next section.

Security Configuration

The mechanism for locating the security configuration file has changed from webMathematica 1.0. Now the security configuration file is named in the pool configuration file and is located in a central configuration directory in webMathematica/WEB-INF/conf. Previously the configuration file could be loaded from anywhere on the Mathematica path.

This change was made because loading the security configuration from a single central location is more secure. Since the default security system of webMathematica is very conservative, any sites that do not move their security files will run with a higher level of security than is expected. Security is discussed in a later section.

2.5.4 Move Content to the New Layout

Now you should copy your content from your old layout. In webMathematica 1.0 you will have developed MSP scripts the location for which was set manually in MSP.conf with the MSPDirectory parameter (the recommended location was inside the MSP Mathematica application). In webMathematica 2.0 they are located in webMathematica/WEB-INF/MSPScripts. As described earlier there is no need to modify MSP.conf. You can just copy your MSP scripts from their old into the new location.

webMathematica 2.0 provides a new way to do HTML templating based on JSP custom tags. You may want to experiment with converting your material to these tags. This is described in the section Converting MSP Scripts to JSPs.

If you installed the MathML update for webMathematica 1.0, you should be aware that this is built into webMathematica 2.0 and that Mathematica 4.2 does not need all the patches that were introduced in this update for Mathematica 4.1.

2.5.5 Finalize the Installation

When you have installed webMathematica 2.0 you should test your installation. A good URL to use is http://localhost:8080/webMathematica/Examples/Specification.jsp. This will print the version numbers of your installation. You should confirm that you have webMathematica 2.0 and Mathematica 4.2.