Requality Installation¶

To install the latest stable version of Requality, please use the following update site:
http://forge.ispras.ru/repo/requality/site/

System requirements¶

1. Windows or Linux. x86 and x64 architectures supported. If using x86 architecture all tools listed below should be x86 too. If using x64 all used tools could be x86 all or x64 all. Currently there is no supported browser engine for Windows x64, that could be integrated to Eclipse, so you should use x86 versions for Windows x64.
2. Sun/Oracle Java SE 6.0.
3. Eclipse Platform 3.5, (3.7.1 recommended). You can use Platform Runtime Binary (about 50MB) or any other package based on it.
4. XULRunner 1.9.2.19 (currently Eclipse doesn’t support XULRunner 2.0 and later) XULRunner Eclipse plugin: update site. For Linux you can use WebKit instead of XULRunner.
5. CVS, Subversive, EGit (recommended) or any other Eclipse Team Provider — it depends on your version control system.

Dependency	Min version	Recommended version	Windows x86	Windows x86-64	Linux x86	Linux x86-64
Sun/Oracle Java SE	Cell 2	Cell 3	Cell 4	Cell 5	Cell 6	Cell 7
Eclipse Platform	Cell 2	Cell 3	Cell 5	Cell 5	Cell 6	Cell 7
XULRunner	Cell 2	Cell 3	Cell 5	Cell 5	Cell 6	Cell 7

Preparation to Requality installation¶

Eclipse installation¶

To install Eclipse unpack the archive to any convenient place. This creates an ''eclipse'' sub-directory.
If using Java 7, to turn on backward compatibility mode add following string to the end of ''eclipse.ini'' file
-Djava.util.Arrays.useLegacyMergeSort=true
Following instructions expects you to know how to install Eclipse plugins from an update site.

Browser integration to Eclipse¶

Requality requires browser engine to be integrated to Eclipse. Mozilla Foundation XULRunner and WebKit are supported.
It’s recommended to use update site (see System requirements) 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 (see System requirements).
Unpack the archive to a convenient place. After that if using Windows you should register XULRunner in the system. Use following command:
''xulrunner.exe --register-global''
In Windows 7 this command should be run by administrator.
You shouldn’t install duplicate XULRunner if Mozilla Firefox has already been installed. Copy ''xulrunner.exe'' to Firefox folder and run above-mentioned command.
Or you just can add following information to the system registry (check the correctness of paths and versions!):

Windows Registry Editor Version 5.00
[HKEY_LOCAL_MACHINE\SOFTWARE\mozilla.org]
[HKEY_LOCAL_MACHINE\SOFTWARE\mozilla.org\GRE]
[HKEY_LOCAL_MACHINE\SOFTWARE\mozilla.org\GRE\1.9.2.19]
"Version"="1.9.2.19"
"GreHome"="C:\\Program Files\\Mozilla Firefox"
"xulrunner"="true"
"abi"="x86-msvc"
"javaxpcom"="1"
[HKEY_LOCAL_MACHINE\SOFTWARE\mozilla.org\Mozilla]
"CurrentVersion"="1.9.2.19"

Installation of plugin for interaction with control version system¶

Control version system provides collective work with requirements. Check if there are plugins to interact with chosen version control system (CVS, 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).

Requality installation¶

There are 2 ways how to install the tool:

• Installing Requality from update site
  We recommend installing from the update site because it makes version update easier. It uses Eclipse Update Manager – usual Eclipse Platform procedure to install plugins from the update site. Requality update site: http://forge.ispras.ru/repo/requality/site/
• Installing Requality to dropins directory
  Eclipse Platform supports another way of extention by adding plugin to eclipse/dropins directory.

We take a closer look of these two ways below:

1. Installing Requality by Eclipse Update Manager (from update site)¶

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

In opened window insert Requality update site address.

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

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''.

Restart Eclipse after installation.
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 thу opened window (''Available Updates'') select Requality plugin and continue installation with the help of plugin update wizard.

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

2. Installing to dropins directory¶

Install
To install Requality unpack the archive to eclipse/dropins directory.¶

Delete
You should do following steps to delete Requality that is installed in eclipse/dropins directory:

1. Run Eclipse with Requality. Set any not-Requality perspective. Close Eclipse.
2. Delete Requality-directory from eclipse/dropins.
3. Run Eclipse to update data about installed plugins. Close Eclipse.

Update
Delete previous Requality version, then install new version as it described in ''Install'' and ''Delete'' sections.¶