This article is not up to date and it has been substitute with new up to date content.

Please look the new up to date content.

WebRatio Installation Guide

7,082 views Published on Apr 12, 2013
Applies to: All versions
Table of contents

WebRatio is distributed in a single file. After you install and activate the tool you are able to manage your projects for building Enterprise Web Applications.

System Requirements

The system requirements for installing WebRatio are listed in the following table.

Operating Systems Windows 2000/XP/2003/Vista/7, Linux, Mac OS X
Java Runtime Environment 5.0 or higher version
RAM 512 Mb (1024Mb recommended)
Disk Space Minimum 500 Mb
Resolution Display 1024x768 (1280x1024 or higher recommended)

Install WebRatio

WebRatio can be used in the following operating systems:

  • Windows XP/Vista
  • Linux
  • Mac OS X

In the following sections the installation process for Windows and for Linux/Mac OS X is described. Look to the section that applies to your operating system.

Windows XP/Vista

Step 1: Download Necessary Components

To install WebRatio the following components are required:

Step 2: Install Java Development Kit

Double-click on the installer file and follow the installation instructions.

Step 3: Install WebRatio

To install WebRatio follow these steps:

  1. Double-click on the WebRatio installer. Click on the Next button to proceed with the installation.
  2. Choose components to install. By default there are two components selected: WebRatio and Tomcat. It's recommended to install both of them, especially it you do not have any other application server installed. If you already have an application server installed you can uncheck this option and use your own. Click on the Next button to proceed.
  3. Choose the Installation Path. By default the installation directory is "C:<Programs folder>WebRatioWebRatio <Version number>". If you are using Windows Vista or Windows 7 you may see an error referring to the proposed path. Just change it to solve the issue. Click on the Next button to proceed.
  4. Choose the Java Path. This is the folder in which the Java Development Kit is located. By default, the installation program identifies the valid location of the JDK in the local machine. If you have multiple JKDs installed you can change the path to the one you want to use. Click on the Install button to proceed.
  5. Complete the installation. The setup will extract all the necessary files in the chosen directory. Click on Next button at the end of the procedure
  6. Launch WebRatio. Click on the Finish button to end the installation and start WebRatio.

Linux / Mac OS X

To install WebRatio the following components are required:

Step 2: Install Java Development Kit

Step 3: Install WebRatio

To install WebRatio follow these steps:

  1. Unzip the downloaded file. The zip file for Linux / MacOs System contains both WebRatio and Tomcat. You can choose any folder on your computer.
  2. Change Permissions privileges. The launcher file "WebRatio" does not have all the required execution permissions in order to be executed. At command line:
  3. Launch WebRatio.  You need to set the execution permission to the WebRatio file before launching. At command line:
cd /home/<path_to_webratio_directory>
chmod 775 WebRatio

Note. If a blank window is displayed at the startup. This is a bug related to the Eclipse platform, Mozilla Firefox and its XULRunner version. It is described here: solve you must change the "WebRatio.ini" file. 

  1. Open the WebRatio.ini file, located in the "WebRatio" folder directory
  2. Append this: -Dorg.eclipse.swt.browser.XULRunnerPath=/dev/null
  3. Save the file.
  4. Relaunch WebRatio.


Step 4: Configure Tomcat

Tomcat must be manually configured in order to be executed. At command line:

cd /home/<path_to_tomcat_directory>
cd bin
chmod 775 *.sh

If the procedure correctly works, the console will display the environment variables:

A common error at this step is the lack of "JAVA_HOME" environment's variable, shown in the image below:

To solve this issue it's enough to add at "" file the declaration of the "JAVA_HOME" environment's variable, assigning it the installation path of JAVA component:

  1. Open the file, located in the "bin" folder of Tomcat
  2. Add declaration with relative assignment of the variable "JAVA_HOME" on the top of the file
  3. Save the file
  4. Relaunch the command.

Step 5: Configure built-in start and stop Tomcat options

WebRatio built-in options for starting and stopping Tomcat must be manually configured in order to be executed. At command line:

cd /home/<path_to_webratio_directory>
chmod 775 WebRatio/plugins/org.apache.ant_VERSION/bin/*

Activate WebRatio

Step 1: Retrieve License Information

  • If you installed the WebRatio Personal edition , the activation process asks you for username and password. You will see a spash screen like the following figure. If you do not have a profile on the official webratio website, you need to register. If you forgot your password you can retrieve it using the related link.


  • If you purchased a license, then you will receive an email from containing your license information. Use these information in the spash screen below.


  • Click on the Activate button

Step 2: Select the Activation Mode

Choose the desired Activation Mode. It's possible to choose between two different modes:

  • License Server mode (not available in Personal mode). The License server is a Web application that manages the maximun number of WebRatio workstations that can run concurrently. When a user starts WebRatio using the License Server mode, the machine connects to the License Server to check the availability of a floating license. The License Server ensures that the number of currently active WebRatio installations is below the number of available floating licenses.
  • Standalone mode. The WebRatio license is validated once at its first usage through an Internet connection to the WebRatio Activation Server. Starting from that moment on the installation works for the time period defined in the license. This approach binds the activation to the physical machine on which WebRatio is installed. Once activated, WebRatio can be used offline (without Internet connection).

Activate Standalone License

Using the Automatic Activation

The Automatic Activation connects to the WebRatio Activation System and check whether there's a valid activation for the current installation or not. If the information is found, then your WebRatio copy is correclty activated.

Using the Manual Activation

The Manual Activation must be used when you do not have direct access to the internet or your network policy does not allow you to reach the activation website. Remember to held the dialog open until the end of the activation process. Here is a description of the dialog information:

  1. Link to the WebRatio Manual Activation page
  2. User name and serial number
  3. Request code
  4. Slot that will be filled in with the Activation code

To activate WebRatio follow these steps:

  1. Click on the link (A)
  2. In the new popup window insert the user name and serial number (retrieved from B) and click on "Confirm"
  3. In the next window insert the Request code (retrieved from C) and click on "Activate"
  4. From the last window copy the given Activation code in the slot D
  5. Click on the Finish button

Activate License Server License

Choosing License Server Mode and clicking on the Next button, the information needed to connect to the license server will be asked. Once filled in the form and click on Finish button, the license server is contacted, a test for an available license is done and the license is assigned.

Retrieve License Information

In any moment it's possible to see the information about your license. From the main menu choose Help->License Information. A dialog is shown containing information about License Type, License Name, License Serial Number, License Expiration Date.

Resetting the License

In any moment you can reset the licence, which means to trigger the activation procedure. This procedure will delete the activation information and, if necessary, the username and serial number information. In order to reset the license choose the Help->Reset License Information menu option and click on the Ok button in the opening window. Once reset is ended it's possible to restart the activation procedure from the first step of the procedure.


This article is not up to date and it has been substitute with new up to date content.

Please look the new up to date content.