WebRatio Installation Guide

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.

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:

• WebRatio
• Java Runtime Environment (http://www.oracle.com/technetwork/java/javase/downloads/index.html)

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:

• WebRatio
• Java Runtime Environment (http://www.oracle.com/technetwork/java/javase/downloads/index.html)

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:

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: https://bugs.eclipse.org/bugs/show_bug.cgi?id=234910. To solve you must change the "WebRatio.ini" file. 

Step 4: Configure Tomcat

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

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 "catalina.sh" file the declaration of the "JAVA_HOME" environment's variable, assigning it the installation path of JAVA component:

1. Open the catalina.sh 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
   JAVA_HOME=<path_to_jvm>
3. Save the file
4. Relaunch the startup.sh 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:

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 support@webratio.com 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.