1.1       Requirements

1.2       Download

1.3       Setup

1.3.1        Web application

1.3.2        Mathematical daemon

1.3.3        Manual

1.4       Tests

• Linux server with a 2.6.* kernel
• Java Virtual Machine 1.4 or greater
• Java Application Container (Tomcat, ...)

Download the files and follow the setup section for installation

1. Web application: wiris.war (hist)
2. Mathematical daemon kernel (engine): wiris-linux.tar.gz (hist)
3. Manuals in different languages:

Catalan	manual_net_ca.tar.gz (hist)
Dutch	manual_net_nl.tar.gz (hist)
English	manual_net_en.tar.gz (hist)
Estonian	manual_net_et.tar.gz (hist)
French	manual_net_fr.tar.gz (hist)
German	manual_net_de.tar.gz (hist)
Italian	manual_net_it.tar.gz (hist)
Spanish	manual_net_es.tar.gz (hist)

Let us remember that three things must be installed: the web application, the mathematical engine and the manual.

1.3.1      Web application

The setup of the web application is as simple as deploying the war file inside the application container. You can not use the war file directly without unzipping it because a configuration file must be provided (see bellow) and the manuals will be installed in the same folder.

In the sequel, we will consider that the setup machine name is <domain> and the context name of the web application inside the application container is WIRIS (these names are only examples).

Now, it is possible tot test that the servlets are properly setup writing in the browser URL:

http://<domain>/wiris/servlet/wiris.servlets.MyHello

The first time you go to the above URL you will get the error

This only means that a file with the name configuration.properties file must be provided with the ISO 639-1 code of the current available languages:

ISO 639-1 code for languages in alphabetical order

1.3.2      Mathematical daemon kernel

Chose a folder for the installation of the kernel daemon and unzip the file wiris-linux.tar.gz there.

The folder database should be accessible with write permission from the daemon when executing.

Important! If you are updating the version, the following files should be copied from the previous installation:    database/statistics.bin    database/session_number The above target files can be rewritten if they exist. They will exist if the server has been executed once.

In the mentioned folder, the daemon is started typing

. ./omega_start.sh

The above script startups the daemon in background.

To stop, type

. ./omega_stop.sh

Observe that both the web application and the mathematical kernel daemon are deployed in the same machine. These two components communicate with each other with the port 31415.

Startup script

To finish, the omega_start.sh and omega_stop.sh scripts have to be called from the startup and shutdown of the operating system (see the example script wiris startup script, this scripts consider that WIRIS is installed in the home of a user called, also, wiris). Thanks to this script, every time that the computer is restarted, the WIRIS kernel daemon will start properly.

1.3.3      Manual

To setup the manual, it suffices to unzip the files in the same folder as the web application.

It is possible to test that the calculator works properly opening a browser and typing the URL:

http://<domain>/wiris/<lang>/index.html

Once the calculator is opened, test some operations.

The manual could be found at

http://<domain>/wiris/manual/<lang>/