Requality

h1. Requality Installation

To install the latest stable version of Requality, please use the following update site:

http://forge.ispras.ru/repo/requality/site/

h1. System requirements

# Windows and Linux (both x86 and x86-64) are supported. Please note if you use Windows x86-64, all the tools have to be x86 (32-bits), because there is no supported browser engine for Windows x86-64, that could be integrated into Eclipse.

# "Sun/Oracle Java SE":https://www.java.com/en/download/ 6.0.

# "Eclipse Platform":https://eclipse.org/downloads/ 3.5, (3.7.2 recommended). You can use any Eclipse package ( e.g. Eclipse Standard).

# "XULRunner":https://developer.mozilla.org/en-US/docs/Mozilla/Projects/XULRunner 1.9.2.19 (currently Eclipse doesn’t support XULRunner 2.0 and later). For Linux you can use "WebKit":http://www.webkit.org/ instead of XULRunner.

# "EGit":http://www.eclipse.org/egit/ (recommended), "Subversive":http://eclipse.org/subversive/ or any other Eclipse Team Provider — it depends on your version control system.

|_. Dependency |_. Min version |_. Recommended version |

| "Sun/Oracle Java SE":https://www.java.com/en/download/ | 6.0 | 7.0 |

| "Eclipse Platform":http://eclipse.org/ | 3.5 | 3.7.2 |

| "XULRunner":https://developer.mozilla.org/en-US/docs/Mozilla/Projects/XULRunner | 1.9.2.19 | 1.9.2.19 |

h1. Preparation to Requality installation

h2. Eclipse installation

To install Eclipse unpack the archive to any convenient place. This creates an ''eclipse'' sub-directory.

If you use Java 7, turn on backward compatibility mode by adding the following string to the end of ''eclipse.ini'' file

@-Djava.util.Arrays.useLegacyMergeSort=true@

h2. Browser integration to Eclipse

Requality requires browser engine to be integrated to Eclipse. Mozilla Foundation XULRunner and WebKit are supported.

It is recommended to use update site (http://forge.ispras.ru/repo/xulrunner-eclipse/site/) to install Eclipse plugin for XULRunner.

If it is unsuitable for some reason there is another way to install XULRunner.

Download XULRunner archive from page http://ftp.mozilla.org/pub/mozilla.org/xulrunner/releases/1.9.2.19/runtimes/.

Unpack the archive to any convenient place and add the following string to the end of ''eclipse.ini'' file: 

@-Dorg.eclipse.swt.browser.XULRunnerPath=<path to XULRunner>@

For example, if XULRunner was unpacked to C:\xulrunner, the string should be:

@-Dorg.eclipse.swt.browser.XULRunnerPath=C:\xulrunner@

To install WebKit on Ubuntu you should install libwebkitgtk-1.0-0 package, e.g.:

 @sudo apt-get install libwebkitgtk-1.0-0@

h2. Installation of plugin for interaction with control version system

Version  control system provides support for collobarative work with requirements. Check if there are plugins to interact with chosen version control system (Subversion, git and others) in Eclipse. If needed, appropriate plugin could be installed from Eclipse repository. In the case of Subversion it is recommended to use Subversive plugin (Subclipse plugin is not recommended).

h1. Requality installation

h3. Install

Install Requality by Eclipse Update Manager open Main menu and choose ''Install New Software...''

!InstallNewSoftware.png!

In opened window insert Requality update site address.

!AddUpdateSiteRequality.png!

Name: Requality

Location: http://forge.ispras.ru/repo/requality/site/

!InstallRequality.png!

Then choose Requality plugin from the available plugins list and follow install plugin Wizard.

While installing there will appear Security Warning about unsigned content. Push ''OK''.

!SecurityWarning.png!

Restart Eclipse after installation.

For more information about installation of plugins from update sites see "the following instructions":http://help.eclipse.org/indigo/index.jsp?topic=%2Forg.eclipse.platform.doc.user%2Ftasks%2Ftasks-124.htm.

h3. Delete

To delete the plugin choose in menu Help -> About Eclipse. In the opened window (''About Eclipse'') push button ''Installation Details'', in ''Eclipse Installation Details'' window select required plugin - Requality, push ''Uninstall'' and continue deletion with the help of plugin delete wizard.

Restart Eclipse after deletion.

h3. Update

To update Requality that was installed by Eclipse Update Manager choose in main menu Help -> Check for Updates. Wait until updates search finish. In the opened window (''Available Updates'') select Requality plugin and continue installation with the help of plugin update wizard.

!RequalityUpdate.png!

There are 2 reasons why the plugin can not be in the list: the plugin is not installed or there are no updates.

To update Requality plugin, select it, click on the ''Next'' button and follow instructions.