Hosting Wiris CAS at your sever

The software and hardware requirements to install Wiris CAS 2.4 or superior are the following:

  • 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. Suppose the system is provided with some multiprocessor technology (dual, hyper-threading or true multiprocessor), Wiris CAS benefits from it.
  • Server memory: 1 GB
  • Server Hard Drive: 1 GB

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

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

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

Status 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 on your download page. This script considers that Wiris CAS is installed in the home of a user called wiris). Thanks to this script, every time 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.

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, it would be best if you restarted 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, which registers useful information about using the tool. Otherwise, you need to copy the folder database to a new location while the daemon is not running.

It is possible to test that the calculator works properly by 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

You can find the manual at

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