WebRatio Installation Guide
From Wiki
|
|
|
Contents |
Introduction
The WebRatio product is available for the following Operating Systems:
- Windows XP/Vista
- Linux
- Mac OS X
These are the minimum system requirements:
- Java Development Kit: 5.0 version o higher
- RAM: 512 Mb (1024Mb recommended)
- Minimum disk space: 500 Mb
- Resolution display: 1024x768 (1280x1024 or higher recommended)
The WebRatio installation files can be downloaded from the WebRatio official website previous registration. In the following sections the installation process for Windows and for Linux/Mac OS X is described. Feel free to skip the section that does not apply to your system.
Installation Process for Windows
-
Install Java 5.0 JDK or higher
- Download the latest version of the Java 2 Development Kit (JDK) from the Java official website.
- Double-click on the installer file and follow the installation instructions.
-
Install WebRatio 5 software
- Download. Download WebRatio from the official website.
- Start the installation. Double-click on the WebRatio installer. You will see a window like the following.
Click on the Next button to proceed with the installation. - Choose components to install. By default there are two components selected
- WebRatio
- Jakarta Tomcat.It's recommended to check this option, especially when there isn't any other application server installed. However it is possible to uncheck the "Jakarta Tomcat" component and use a different one (see "Which application servers can I use with a WebRatio generated application?" for details).
Click on the Next button to proceed.
- Choose the Installation Path.By default the directory is "C:\<Programs folder>\WebRatio\WebRatio <Version number>".(Windows Vista and Windows 7 may display an error using this path. In this case it's enough to change the directory).
Click on the Next button to proceed. - 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.It's possibile to choose a different path.
Click on the Install button to proceed. - Complete the installation. The WebRatio setup procedure will extract all the necessary files in the chosen directory.
Click on Next button at the end of the procedure
-
Launch WebRatio. Click on the Finish button to end the installation and start WebRatio
Installation Process for Linux / Mac OS X
- Install Java 5.0 JDK or higher
-
Install WebRatio 5 software
- Download. Download the WebRatio zip file installation from the official website.
- Start installation. Unzip the previously downloaded file. The zip file for Linux / MacOs System contains WebRatio and Tomcat.
- Change Permissions privileges. WebRatio has been successfully installed and can be launched. However, by default, the launcher file "WebRatio" has not all the required execution permissions in order to work. You have to change those permissions simply by using the console and the command line described just below:
- Open the console
- Reach the WebRatio folder directory
- Set the execution permissions to the WebRatio file applying the chmod command:
chmod 775 WebRatio
- Launch WebRatio. By double-clicking on the launcher file or using the console with the command:
./WebRatio
Tomcat Setup
Tomcat must be manually configured in order to be executed. Just follow these steps:
- From console, reach the Tomcat folder directory
- Select the "bin" folder
- Apply the chmod command
chmod 775 *.sh
- From the console, launch the startup.sh file
./startup.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 "catalina.sh" file the declaration of the "JAVA_HOME" environment's variable, assigning it the installation path of JAVA component:
- Open the catalina.sh file, located in the "bin" folder of Tomcat
- Add declaration with relative assignment of the variable "JAVA_HOME" on the top of the file
JAVA_HOME=/usr/lib/jvm // current path is only as example
- Save the file
- Relaunch the startup.sh command.
License Activation
The first time WebRatio is launched a valid license is requested. Without this license it's not possible to work with WebRatio.
N.B.To complete successfully the activation process, it is mandatory that the machine could access the 8082 port.
In order to activate WebRatio follow these steps:
- Create or open a Web Project
- Insert the received username and serial information in the popup window and click on Next button.
- Choose the desired Activation Mode. It's possible to choose between two different modes:
- License server mode (not available in Trial mode).The License server is a server that manages the maximun number of WebRatio installations that can run concurrently. When a user starts WebRatio using the License Server mode, the machine connects to the License Server to check the presence of an available 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 central WebRatio Activation Server. Starting from that moment on the installation will work 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).
- License Server Mode. Choosing License Server Mode and clicking on the Next button, the information needed to reach 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. - Standalone mode. Choosing Standalone mode and clicking on the Next button, the license validation process will ask user to choose among two further modes:
- Activate WebRatio by using the automatic Internet service. This is an automatic procedure that connects WebRatio to the Central WebRatio Activation Center, through a secure Internet service, and checks for an available license.
- Activate WebRatio by manually connecting to WebRatio web site. This procedure is useful when the automatic one fails for the presence of a proxy or of a particular network configuration.Click on the Next button to proceed.
The Manual Activation Window, must be held open until the process of license activation is not ended. Here is a description of the inputs defined in the window:
To activate WebRatio follow these steps:
| 
|
License Information
When the license activation process is completed, it's possible to verify the license information simply by choosing the Help->License Information menu option.
This window contains information about:
- License Type
- User's Name
- User's Serial Number
- License Expiration Date
- Extensions activated
License Reset
If for any reason license validation is not ended correctly, it's possible to apply a reset 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.
