## Initial Checks

If you try to use a browser to connect to a web*Mathematica* server and it does not operate in the expected way, try the following steps.

### Check the Server

Make absolutely certain that your servlet container is working correctly. If you cannot connect to the demonstration examples that come with your container, then web*Mathematica* is unlikely to work. Furthermore, Wolfram Research will not be able to give more than minimal assistance until your servlet container is working.

### Check the URL

If your servlet container works but web*Mathematica* does not, make sure you are using a correct URL. These are case sensitive, so make sure you use capital letters in the same places as the documentation describes. For example, http://localhost:8080/webMathematica/Examples/Hello.jsp is the appropriate usage. Make sure that this URL is consistent with the way you connect to your servlet container. If you need to specify a port number for your servlet container, you will need to use this for web*Mathematica*. For example, the default settings for direct access for Tomcat is port 8080. A URL for a different servlet container might be different. The URLs in this document are all specified for Tomcat.

If you do not specify the URL correctly, you may see a Not Found (404) error in your browser.

### Check the Initial Page

If the initial page that is returned to your browser in response to a web*Mathematica* URL, such as http://localhost:8080/webMathematica/Examples/Hello.jsp, contains some other indication of an error, study it carefully. Some typical problems include configuration errors, such as failure to locate a configuration file or failure to launch *Mathematica*. Studying the initial page and rereading the installation instructions or looking at the specific problems listed later in this section may help to resolve the problem.

If no initial page is returned, your server is not operating. As noted above, if your server does not work, web*Mathematica* cannot work.

If the initial page does not help resolve your problem, please save the page. It may be useful at some later stage.

### Check the Kernel Monitor

The kernel monitor contains information on the configuration of the web*Mathematica* site and also can print out information if your server is misconfigured. You should be able to find the monitor via http://localhost:8080/webMathematica/Resources/Tools/KernelMonitor.jsp. (You may have some different URL for accessing your server.) The monitor is described in more detail in a previous section.

### Check the Logging System

The logging system is a good place to start to search for information on problems.

### Check the Console Shell

Some servlet containers are launched from a command line in a console shell, and this may contain relevant information on any problems.

### Check *Mathematica*

Run *Mathematica* in the same way that it is run from the servlet container. For example, under Unix, the servlet container often runs as tomcat, so this should be used to run *Mathematica*. Do this for both the *Mathematica* kernel and front end.

Under Unix, a typical command to run the *Mathematica* kernel as tomcat is as follows.

Here is a typical command to run the *Mathematica* front end as tomcat.

Under Windows, it is possible to run the *Mathematica* kernel and front end from the Start menu.

Running *Mathematica* like this will help to identify problems that may prevent the web system from launching *Mathematica*. One source of problems is caused by a failure to find a license to run *Mathematica*. You can resolve this by making sure that the valid *Mathematica* license is present in the *Mathematica* layout, probably by placing a mathpass file into $InstallationDirectory/Configuration/Licensing.