Hosting WIRIS CAS at your server

1 Requirements

• Linux/Solaris Operating System with a 2.6.* kernel (other OS to be considered)
• Java Virtual Machine 1.4 or superior
• Java Application Server Containers (for example, Tomcat)
• Server processor: Intel Pentium 2GHz or equivalent. If the system is provided with some kind of multiprocessor technology (dual, hyper-threading or true multiprocessor), WIRIS benefits from it.
• Server memory: 1 GB
• Server Hard Drive: 1 GB

2 Download

You need a licence in order to access the download page for the server installation. If you have acquired such a licence, you can proceed to the download page.

3 Setup

Three things must be installed in order to have a WIRIS cas server running properly: the web application, the mathematical engine and the user manual.

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 below) and the user manuals will be installed in the same folder.

In what follows, 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:

WIRIS CAS Configuration Error!
Missing configuration file ...\WEB-INF\configuration.properties
You can use the file configuration.sample.properties as example

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

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.

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 called WIRIS CAS startup script in the download page (a licence is required). This script considers that WIRIS is installed in the home of a user called wirisd). Thanks to this script, every time that the computer is restarted, the WIRIS kernel daemon will start properly.

3.3 User manual

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

4 Upgrade

In order to upgrade WIRIS cas, you only need to deploy the Web application, uncompress the mathematical kernel in the same folder and copy-paste the user manual. Then, you need to restart the daemon, which is the mathematical kernel:

. ./omega_stop.sh
. ./omega_start.sh

By decompressing the kernel in the same folder, you manage to keep the folder database, that registers useful information about the use of the tool. Otherwise, you need to copy the folder database in a new location while the daemon is not running.

5 Tests

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

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

or (if you have multiple languages)

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>/