Project

General

Profile

Requality-manual-installation » History » Revision 7

Revision 6 (Viktoria Kopach, 03/17/2014 05:48 PM) → Revision 7/33 (Viktoria Kopach, 03/17/2014 05:54 PM)

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 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. 
 # "Sun/Oracle Java SE":http://www.oracle.com/technetwork/java/index.html 6.0. 
 # "Eclipse Platform":http://eclipse.org/ 3.5, (3.7.1 recommended). You can use Platform Runtime Binary (about 50MB) or any other package based on it. 
 # "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) XULRunner Eclipse plugin: update site. For Linux you can use "WebKit":http://www.webkit.org/ instead of XULRunner. 
 # "CVS":http://www.eclipse.org/eclipse/platform-cvs/, "Subversive":http://eclipse.org/subversive/, "EGit":http://www.eclipse.org/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":http://www.oracle.com/technetwork/java/index.html | Cell 2 | Cell 3 | Cell 4 | Cell 5 | Cell 6 | Cell 7 | 
 | "Eclipse Platform":http://eclipse.org/ | Cell 2 | Cell 3 | Cell 5 | Cell 5 | Cell 6 | Cell 7 | 
 | "XULRunner":https://developer.mozilla.org/en-US/docs/Mozilla/Projects/XULRunner | Cell 2 | Cell 3 | Cell 5 | Cell 5 | Cell 6 | Cell 7 | 

 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 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":http://help.eclipse.org/indigo/index.jsp?topic=%2Forg.eclipse.platform.doc.user%2Ftasks%2Ftasks-124.htm. 

 h2. 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"_ 

 h2. 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). 

 h1. 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: 

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

 h3. Install 
 To 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. 
 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. 
 !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. 
 Restart Eclipse after installation. 

 h2. 2. Installing to dropins directory 

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

 h3. Delete 
 You should do following steps to delete Requality that is installed in eclipse/dropins directory: 
 # Run Eclipse with Requality. Set any not-Requality perspective. Close Eclipse. 
 # Delete Requality-directory from eclipse/dropins. 
 # Run Eclipse to update data about installed plugins. Close Eclipse. 

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