Try

Hosting WIRIS CAS at your server

1 Requirements

The software and hardware requeriments to install WIRIS cas 2.4 or supperior are as follows:

  • Linux Operating System with a 2.6.* kernel (other OS to be considered)
  • Java Virtual Machine 1.5 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

Four things must be installed in order to have a WIRIS cas server running properly:

  1. the configuration web application (wirisconfig-XXX.war),
  2. the web application (wiris-XXX.war),
  3. the mathematical engine (wiris-linux-XXX.tar.gz) and
  4. the user manual (manual_net_XX.tar.gz).

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).

3.1 Configuration file

From your private page, download the wirisconfig-XXX.war file. It contains license details and branding customization. Rename it to wirisconfig.war.

Deploy it inside your Java application container. Then check the tests page:

http://<domain>/wirisconfig/test.html

3.2 Web application

Download and rename the file to wiris.war.

The setup of the web application is as simple as deploying the war file inside the application container.

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

http://<domain>/wiris/

Note that even WIRIS cas opens propertly, it is not able to calculate until you install the Mathematical daemon kernel.

3.3 Mathematical daemon kernel

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

The /kernel/linux/OmegaKernel.exe file must have execution permissions.

The folder database must have write permissions for the daemon.

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.

Testing the kernel. It is possible to test that the kernel is working properly. From where WIRIS cas was copied:

java -cp server com.wiris.test.TestCalculate

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

If you are not using a custom user to run the kernel, but the default root user, please define the $HOME variable in any way, even $HOME=/dev/null.

3.4 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.

WIRIS cas is also provided with a self test at:

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

The manual could be found at

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