Technical blog

Hosting WIRIS cas in a Windows server
18 Nov 2011

Motivation

WIRIS cas "hosting in your server" is only officially released for a Linux server. Some users have requested a Windows version so we provide a workaround to install the WIRIS cas server components into a Windows server.

WIRIS cas can be installed in a Windows server following the same architecture as the Linux case:

  1. It requires the installation of Java and a Java Application Server like Tomcat. A java Web application must be deployed (war file).
  2. The daemon engine must be launched somehow. At present there is no Windows service to do this task.

Installation procedure

  1. Follow the same instructions as the Linux components.
  2. Download and copy the WIRIS cas windows kernel at the folder <wiris>/kernel in such a way that the following file must exist <wiris>/kernel/windows/OmegaKernel.exe (where <wiris> is the folder where the WIRIS cas daemon engine was copied). There is no need to remove the Linux kernel because the WIRIS cas server will detect automatically that is running under Windows.

Launching the daemon engine

From the command line,

cd <wiris>/server
java -Xmx128m Server

note that the java program should be in the command path. 

Using omega_start.sh script to launch the daemon has the benefit to run it in background, however it will need that cygwin is installed.

Release notes WIRIS cas
14 Oct 2011

Release 2.3.4 - October 2011

  • Added compatibility with new Mac OS X Lion
  • WIRIS desktop. The Linux version uses first the Java installed in the OS.
  • Fixed compatibility with Tomcat 6.0

Release 2.3.1 - November 2010

  • Fixed MacOS problem when installed in a folder with a blank space
  • Save session in a single step. Save plot in a single step. This fixes the save feature in MacOS X 1.6
  • Solved minor specific problems on calculus and command simplify

Release 2.3.0 - September 2010

Release 2.2.2 - November 2009

Release 2.2 - July 2009

Release 2.1.4 - April 2009

  • Improved plotter aspect_ratio attribute
  • Improved representation for atan(1/x) and absolute value function

Release 2.1.3 - February 2009

Release 2.1.2 - June 2008

  • slider
  • plot(y=f(x))
  • plot(f(x,y)=0)
  • multiple plotter synchronization
  • WIRIS desktop. Import and export features to HTML
  • Language translation of documents

Release 2.1.1 - April 2008

  • write command accepts formulas directly
  • string_substitution to generate fancy formulas in the plotter
  • Added the max_width attribute to the text_boxes that allows wrapping text in the plotter
  • More languages for WIRIS desktop
  • Fix issues about measure units. x meter, y centimetre
  • Fix important Mac issues
  • Fixed an issue about priority and measure units: 4m 1cm / 3m 2c
  • Release 2.1 - September 2006
  • Differential equations solving
  • Taylor series expansion
  • Complex solutions of polynomial equations
  • Improvement of the limit calculation
  • Print capabilities enhancement
  • Undo-redo
  • Fonts and colours
  • Exact computation of eigenvalues and vectors for integer matrices.
  • Series summation, series convergence study

Release 2.0 - September 2005

  • 3d geometry and representation
  • New design of the toolbar, including tooltips
  • Toolbar configuration. A toolbar for primary education is provided
  • Now is possible to use = instead of = =
Installation instructions: WIRIS plugin for NicEdit
29 Sep 2011

 

 

DOWNLOAD

1 Requirements

  • NicEdit 0.9 or higher installed.
  • A valid license to install the plugin in a production environment; otherwise, you can use the downloaded file just for demo purposes.

2 Copy files

Unzip NicEdit WIRIS Plugin and copy the nicedit_wiris directory in any directory of your web server. For example, in nicedit/nicedit_wiris.

2.1 For PHP servers

  1. Give execution right to the web server user on the PHP files contained at nicedit/nicedit_wiris/integration.
  2. Give write permissions to nicedit/nicedit_wiris/cache and nicedit/nicedit_wiris/formulas directories to the web server user. Those folders will be used to store formula MathML codes and temporal images.

2.2 For ASP.NET servers

  1. Create an application through your IIS control panel with root directory at nicedit/nicedit_wiris/integration.
  2. Give write permissions to nicedit/nicedit_wiris/cache and nicedit/nicedit_wiris/formulas directories to the web server user. Those folders will be used to store formula MathML codes and temporal images.

2.3 For ASP servers

  1. Give write permissions to nicedit/nicedit_wiris/cache and nicedit/nicedit_wiris/formulas directories to the web server user. Those folders will be used to store formula MathML codes and temporal images.

2.4 As Java servlet

  1. Install the pluginwiris_engine.war in your Java web applications server. For example, tomcat.
  2. By default, the javascript code loads the pluginwiris_engine from the root of web application server (/pluginwiris_engine/app). However, if you want to store the pluginwiris_engine in another path, you should edit these javascript codes.
    1. Open nicedit/nicedit_wiris/editor_plugin.js.
    2. Change the variables _wrs_conf_editorPath, _wrs_conf_CASPath, _wrs_conf_createimagePath and _wrs_conf_createcasimagePath with your preferred values.
    3. Save changes.

3 Configure

3.1 On PHP, ASP.NET and ASP integrations

Edit nicedit/nicedit_wiris/configuration.ini to set your own values. This table specifies all possible parameters.

3.2 On Java integration

Edit WEB-INF/pluginwiris/configuration.ini to set your own values. This table specifies all possible parameters.

It is essential to establish the value of the parameters wiriscachedirectory and wirisformuladirectory.

4 Activate the WIRIS plugin for NicEdit on your own platform

In order to use WIRIS in NicEdit, you only have to add this HTML code after including the NicEdit script:

<script type="text/javascript">var nicedit_wiris_path = '[nicedit_wiris path]';</script>
<script type="text/javascript" src="[nicedit_wiris path]/core/core.js"></script>
<script type="text/javascript" src="[nicedit_wiris path]/nicedit_wiris.js"></script>

For example:

<script type="text/javascript" src="nicedit/nicEdit.js"></script>
<script type="text/javascript">var nicedit_wiris_path = 'nicedit/nicedit_wiris';</script>
<script type="text/javascript" src="nicedit/nicedit_wiris/core/core.js"></script>
<script type="text/javascript" src="nicedit/nicedit_wiris/nicedit_wiris.js"></script>

Finally, you have to instantiate the NicEdit editors with the fullPanel parameter setted to true.

5 Check that the plugin works correctly

In order to check if the plugin is installed correctly, there is a page that makes some tests on your server. Open this link to see where is your test page.

6 Clean and backup your WIRIS plugin for NicEdit

Check this page.

Editors
5 Sep 2011

Editors doc

Platforms
5 Sep 2011

Docs platforms