Human Echolocation WebApp

h1. Modifying the webapp

h2. Context

You want to change something in the interactive part of the application: the JSPs (Java Server Pages) that present the application in the browser -- or the servlets that process requests and hand off to the MATLAB layer -- and deploy the changed version.

You do not want to change any of the MATLAB code (see [[Modifying the MATLAB]] if you do).

h2. You will need

 * A computer with the "MATLAB Compiler Runtime":http://www.mathworks.co.uk/products/compiler/mcr/ (MCR) installed.

 ** This computer does *not* need a MATLAB licence.

 ** The computer must be the same kind (platform, architecture etc) as the one the web app will eventually be served from. It may be simplest if it is the same machine.

 ** It does *not* need to be the same kind of machine as the one with the licensed version of MATLAB used to compile the @isvr.jar@ file (see [[Modifying the MATLAB]]).

 ** The MATLAB Compiler Runtime must be of the same version as the MATLAB release that was used to compile the @isvr.jar@ file (see [[Modifying the MATLAB]]).

 * The Java development kit (JDK) of whichever version your MATLAB runtime expects. Current MATLAB seems to call for Java 7.

 * The @servlet-api.jar@ file from your web application server.

The most likely "production" setup is to have a workstation or server with a licensed copy of MATLAB on it, and to use that for [[Modifying the MATLAB]]; and then to have a separate, different machine (such as a Linux server) without MATLAB installed but with the MCR, which is used for both building and serving the web app.

h2. What to change; limitations

h2. How to rebuild