Server components - Hosting at your server

MathType Editor and Hand server components are usually used as software as a service (SaaS) hosted at www.wiris.net. The various integrations are configured to call them and, for most situations, the requests to www.wiris.net are kept behind the scenes. These components are available both for Java and .NET.
In case you need to use the services from your server, you will need to purchase a license.

You will normally use the MathType Web with a Formula plugin but there are occasions where the MathType Web can be used alone. For example, a learning platform could provide a quizzes system and the students could type the answer of the mathematical questions with MathType Web.

Download package

1. Installing as Java Web application

Requirements

  • Oracle Java 1.6 or higher
  • Java application server

Installation

  1. Download the Java version of the MathType Editor server components.
  2. Deploy the war file into your application server.
  3. Product key: For version 3.5.5 and higher, you need to include your product key in the WEB-INF/web.xml file located inside the war file. The license will be validated against our server whenever you restart your application.

Testing the application

You can go to the following url to test the proper installation of MathType Web.

    http://<your-domain>/<context>/test.html

Configuring your plugins

In case you are using the MathType Integrations for editing formulas, you will need to change the configuration.ini file with the following values:

   wirisimageservicehost = <your-domain>
   wirisimageserviceport = 80
   wirisimageservicepath = /<context>/render

2. Installing as ASP .NET Web application

Requirements

  • .NET Framework 2.0 or higher
  • IIS 5.1 or higher

Installation

  1. Download the ASP .NET version of the MathType Editor server components.
  2. Deploy the zip file into IIS with ASP .NET enabled and create a Web application.
  3. Product key: From version 3.11.1 you need to include your product key in MathType Web web.config file. The license will be validated against our server whenever you restart your application.
  4. Open IIS and look for the folder resources/fonts
  5. Right click on it and choose Properties
  6. Go to HTTP Headers tab and add the following one
  7. Custom Header Name = Access-Control-Allow-Origin
  8. Custom Value Name = *

Feel free to move files around and create your own Web.config file.

Note: If you use .NET 4.0 or above use the values of web.config 4.0.

Testing the application

You can test the application typing the following URL in your browser:

   http://<your-domain>/<web-app-path>/editorservice.aspx/render?mml=<mi>x</mi>

This will test the rendering service. The response should be an image with the specified equation, in this case just an 'x'.

In some rare cases MathType Editor server components may not initialize correctly, which will prevent usage of the rendering services.

If an error message is returned instead for the request above then MathType Editor server components have failed to initialize.

Recycling the application pool where the application has been installed in should fix the problem.

Configuring your plugins

In case you are using the MathType Integrations for editing formulas, you will need to change the configuration.ini file with the following values:

   wirisimageservicehost = <your-domain>
   wirisimageserviceport = 80
   wirisimageservicepath = /<web-app-path>/editorservice.aspx/render

Performance

Though resource consumption depends on the type of usage, the following rule holds:

2 core + 1.5Gb RAM 800 formulas/minute

In fact, 1 core + 1.5Gb RAM is the recommended minimum specification for your server. One thing to note is that the above correspondence refers to formulas being edited. Displaying formulas is typically not an issue. For example, they can be in the cache provided by the MathType integration.

How many concurrent users can MathType Editor support in a typical scenario?

To give a rough estimate for user count, assume that each user connected to your server edits, on average, 1 formula every three minutes. In this case, a liberal estimate for the number of concurrent users would be:



That is, we can expect to support 2400 concurrent users with the given conditions. We should note that this is assuming that there aren't peaks in the number of users editing a new formula at once. To summarize, we can use the following as a rough guideline:

2 core + 1.5Gb RAM 2400 concurrent users

Download package

1. Installing as Java Web application

Requirements

  • Oracle Java 1.6 or higher
  • Java application server

Installation

  • Download the Java version of the MathType Hand server components.
  • Deploy the war file into your application server.

Product key: You need to include your product key in the WEB-INF/web.xml file located inside the war file. The license will be validated against our server whenever you restart your application.

Testing the application

You can go to the following URL

    http://<your-domain>/<web-server-path>

and go to the "diagnosis page" to test the proper installation of MathType hand.

Then on the left-side menu, you can "Test" your MathType hand installation and also you can see and edit some "Examples".

2. Installing as ASP .NET web application

Requirements

  • .NET Framework 2.0 or higher
  • IIS 5.1 or higher

Installation

  • Download the ASP .NET version of the MathType Hand server components.
  • Deploy the zip file into IIS with ASP .NET enabled and create a web application.

Product key: You need to include your product key in MathType Hand web.config file. The license will be validated against our server whenever you restart your application.

Note: If you're using a version prior to IIS 7

  1. Open IIS and look for the folder resources/fonts
  2. Right click on it and choose Properties
  3. Go to HTTP Headers tab and add the following one
  4. Custom Header Name = Access-Control-Allow-Origin
  5. Custom Value Name = *
  6. Feel free to move files around and create your own web.config file.

Note: If you use .NET 4.0 or above use the values of web.config 4.0.

Testing the application

You can test the application typing the URL in your browser

    http://<your-domain>/<web-app-path>

and go to the "diagnosis page" to test the proper installation of MathType hand.

Then on the left side menu, you can "Test" your MathType hand installation and also you can see and edit some "Examples".

Performance

Though resource consumption depends on the type of usage, the following rule holds:

2 core + 1.5Gb RAM 200 formulas/minute

In fact, 1 core + 1.5Gb RAM is the recommended minimum specification for your server. One thing to note is that the above correspondence refers to formulas being edited. Displaying formulas is typically not an issue. For example, they can be in the cache provided by the MathType plugin.

How many concurrent users can MathType Editor + Hand support in a typical scenario?

To give a rough estimate for user count, assume that each user connected to your server edits, on average, 1 formula every three minutes. In this case, a liberal estimate for the number of concurrent users would be:



That is, we can expect to support 600 concurrent users with the given conditions. We should note that this is assuming that there aren't peaks in the number of users editing a new formula at once. To summarize, we can use the following as a rough guideline:

2 core + 1.5Gb RAM 600 concurrent users