Project

General

Profile

Requality-manual-installation » History » Version 24

Viktoria Kopach, 08/29/2014 06:47 PM

1 1 Alexey Khoroshilov
h1. Requality Installation
2
3
To install the latest stable version of Requality, please use the following update site:
4
http://forge.ispras.ru/repo/requality/site/
5 2 Viktoria Kopach
6 4 Viktoria Kopach
h1. System requirements
7 2 Viktoria Kopach
8 24 Viktoria Kopach
# 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-. If using x64 all tools could be either x86 (all at the same time) or x64 (all at the same time).
9
# "Sun Java SE":http://www.oracle.com/technetwork/java/javase/downloads/index.html (recommended 7.0, supported 6.0 and higher).
10
# "Eclipse Platform":https://eclipse.org/downloads/ (3.7 recommended). You can use minimal Eclipse package Platform Runtime Binary (about 50MB) or any other package based on it.
11
To install Eclipse unpack the archive to any convenient place. This creates an ''eclipse'' sub-directory.
12
# "XULRunner":https://developer.mozilla.org/en-US/docs/Mozilla/Projects/XULRunner 1.9.2.19. XULRunner Eclipse plugin: http://forge.ispras.ru/repo/xulrunner-eclipse/site/. For Linux you can use "WebKit":http://www.webkit.org/ instead of XULRunner.
13
# "Subversive":http://eclipse.org/subversive/, "EGit":http://www.eclipse.org/egit/ or any other Eclipse Team Provider — it depends on your version control system. EGit is recommended.
14 3 Viktoria Kopach
15 1 Alexey Khoroshilov
|_. Dependency |_. Min version |_. Recommended version |_. Windows x86, x86-64 |_. Linux x86 |_. Linux x86-64 |
16 21 Viktoria Kopach
| "Sun/Oracle Java SE":https://www.java.com/en/download/ | 6.0 | 7.0 | x86 | x86 | x86 or x86-64 |
17 24 Viktoria Kopach
| "Eclipse Platform":http://eclipse.org/ |3.7.2 | 4.3.2 | x86 | x86 | x86 or x86-64 |
18 6 Viktoria Kopach
| "XULRunner":https://developer.mozilla.org/en-US/docs/Mozilla/Projects/XULRunner | 1.9.2.19 | 1.9.2.19 | x86 | x86 | x86 or x86-64 |
19
20
h1. Preparation to Requality installation
21
22 24 Viktoria Kopach
h2. Step 1. Eclipse installation
23 1 Alexey Khoroshilov
24
To install Eclipse unpack the archive to any convenient place. This creates an ''eclipse'' sub-directory.
25 19 Alexey Khoroshilov
26 24 Viktoria Kopach
h2. Step 2. Browser integration to Eclipse
27 1 Alexey Khoroshilov
28 23 Viktoria Kopach
Requality requires a browser engine to be integrated with Eclipse. Mozilla Foundation XULRunner and WebKit are supported.
29 1 Alexey Khoroshilov
30 22 Viktoria Kopach
NOTE! After Requality installation you can check if browser engine has been installed successfully. See instructions below in "After installation" section.
31 1 Alexey Khoroshilov
NOTE! To use XULRunner on Windows x86_64 install "Visual C++ 2010 runtime":http://www.microsoft.com/en-us/download/details.aspx?id=13523
32
33 24 Viktoria Kopach
For *Eclipse 4.4* on *Linux* it''s necessary to use WebKit because of Eclipse 4.4 "incompatibility":http://www.eclipse.org/swt/faq.php#browserlinux with XULRunner. To install WebKit you should install libwebkitgtk-1.0-0. For example, on Ubuntu/Debian run in command line following command:
34
sudo apt-get install libwebkitgtk-1.0-0
35 17 Alexey Khoroshilov
36 24 Viktoria Kopach
For *Eclipse 3.8 and higher* to install Mozilla XULRunner it''s required to download an appropriate "XULRunner 10.0.4":http://ftp.mozilla.org/pub/mozilla.org/xulrunner/releases/10.0.4esr/runtimes/, unpack downloaded archive to any convenient place and add two following string to the end of ''eclipse.ini'' file: 
37
@-Dorg.eclipse.swt.browser.DefaultType=mozilla
38
-Dorg.eclipse.swt.browser.XULRunnerPath=<path to XULRunner>@
39
For example, if XULRunner was unpacked to C:\xulrunner, second string should be:
40 1 Alexey Khoroshilov
@-Dorg.eclipse.swt.browser.XULRunnerPath=C:\xulrunner@
41 23 Viktoria Kopach
42 24 Viktoria Kopach
For *Eclipse 3.7 and lower* follow the same instructions but use "XULRunner":http://ftp.mozilla.org/pub/mozilla.org/xulrunner/releases/1.9.2.19/runtimes/
43 23 Viktoria Kopach
44 24 Viktoria Kopach
h2. Step 3 (optional). Installation of plugin for interaction with control version system
45
46 23 Viktoria Kopach
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).
47 17 Alexey Khoroshilov
48 6 Viktoria Kopach
h1. Requality installation
49
50 24 Viktoria Kopach
There are 2 ways how to install the tool: to eclipse/dropins directory or by Eclipse Update Manager. The first one allows using the tool both in Eclipse environment and in console mode. The second one simplifies the process of the tool version update, but restricts the use by only Eclipse environment.
51 6 Viktoria Kopach
52 24 Viktoria Kopach
h2. Installing Requality by Eclipse Update Manager (from update site)
53 6 Viktoria Kopach
54 24 Viktoria Kopach
*Install*
55
56
To install Requality by Eclipse Update Manager open Main menu and choose ''Install New Software...'' 
57
58 1 Alexey Khoroshilov
!InstallNewSoftware.png!
59 6 Viktoria Kopach
60
In opened window insert Requality update site address.
61 9 Viktoria Kopach
62 6 Viktoria Kopach
!AddUpdateSiteRequality.png!
63 1 Alexey Khoroshilov
64
Name: Requality
65
Location: http://forge.ispras.ru/repo/requality/site/
66
67
!InstallRequality.png!
68
69
Then choose Requality plugin from the available plugins list and follow install plugin Wizard.
70
While installing there will appear Security Warning about unsigned content. Push ''OK''.
71
72
!SecurityWarning.png!
73
74
Restart Eclipse after installation.
75
76
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.
77
78
79 24 Viktoria Kopach
*Delete*
80 6 Viktoria Kopach
81
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.
82 9 Viktoria Kopach
Restart Eclipse after deletion.
83 6 Viktoria Kopach
84 24 Viktoria Kopach
*Update*
85 6 Viktoria Kopach
86
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.
87 10 Viktoria Kopach
88 6 Viktoria Kopach
!RequalityUpdate.png!
89
90 24 Viktoria Kopach
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.
91 13 Alexey Khoroshilov
92 24 Viktoria Kopach
h2. Installing to dropins directory
93
94
*Install*
95
96
To install Requality unpack the archive to eclipse/dropins directory.
97
98
*Delete*
99
100
You should do following steps to delete Requality that is installed in eclipse/dropins directory:
101
Run Eclipse with Requality. Set any not-Requality perspective. Close Eclipse.
102
Delete Requality-directory from eclipse/dropins.
103
Run Eclipse to update data about installed plugins. Close Eclipse.
104
105
*Update*
106
107
Delete previous Requality version, then install new version as it described in ''Install'' and ''Delete'' sections.
108
109 22 Viktoria Kopach
110
h1. After installation
111
112
After Requality installation it''s recommended to check if browser has been successfully installed to Eclipse.
113
In Eclipse main menu select ''Window -> Preferences''. In ''Preferences'' select menu ''Requality''. On the right you can see what browser engines are integrated with ''Eclipse'' and which one is currently in use.
114
115
!CheckEngine_en.png!
116
117
To change active browser engine click on ''Browser Engine'' field and select required one in the drop-down list. Then save changes by ''Apply'' button. After that Eclipse should be restarted for the changes to take effect.
118
If required browser engine has ''not available'' status in the drop-down list, this means that either you have not installed it yet or the installation has been failed. You can activate only browser engine with status ''available''.