Thanks for having chosen Gazelle !
Here is a guide to help you with installing Test Management.
Gazelle Test Management runs under Jboss AS 7.2.0 with a postgresql PostGresql 9.1 or higher database. For general considerations regarding the installation of the application server, read Jboss7 installation guide.
Test Management is an open source project under Apache2 licence. The sources are available on the INRIA’s Gitlab:
git clone https://gitlab.inria.fr/gazelle/applications/mixed/gazelle-tm.git
You can choose whatever database name you want. You will need to report it in the datasource section of the Jboss configuration.
su postgresql psql postgres=# CREATE USER gazelle; postgres=# CREATE DATABASE "your\_database" OWNER gazelle ENCODING UTF-8; postgres=# ALTER USER gazelle WITH ENCRYPTED PASSWORD 'password'; postgres=# \q exit
Download the file containing all the data required by the application to properly work at: https://gazelle.ihe.net/jenkins/job/gazelle-public-RELEASE/ws/gazelle-tm-ear/src/main/scripts/tm-first-import.data and import it into the newly created database using the pg_restore function as shown below.
pg_restore -U gazelle -h 127.0.0.1 -d your_database tm-first-import.data
You can either fetch the public EAR (released version) in our Nexus repository or compile the tool by your own.
Before compiling, go to the directory gazelle-tm and edit the file pom.xml. Open this file and adapt the properties of profile prod to your case:
cd gazelle-tm; mvn clean package -Pprod,distribution
The archive (EAR) and the distribution file are created and placed into gazelle-tm/gazelle-tm-ear/target directory.
Test Management requires JBoss 7.2.0 to have some additional libraries (see pre-requisites section).
Since version 5.10.0, Before you start your Jboss server, you shall configure the datasource at
Read details in the “Externalize datasources from tool projects” section of JBoss 7 installation page.
The datasource element to import in the standalone.xml file is available in the project.
Once you have copied the content of this file in your Jboss configuration:
You can retrieve those values in gazelle-tm’s pom.xml file for each profile.
Since version 5.11.0, you need to configure the mail session that is needed by the tool in the jboss configuration file
standalone.xml. Read details in the “Externalize mail server configuration” section of JBoss 7 installation page for further information.
Copy the gazelle-tm.ear into the “ standalone\deployments” directory of your JBoss 7 server. Finally, start your server. When the application is deployed, open a browser and go to http://yourserver/gazelle. If the deployment and the database initialization are successful you should see the home page.
This instance of Test Management you have just deployed is free of organization, user and testing session. Consequently, the next step will be to create your organization, your account (as an administrator of the application) and the testing session. A testing session is used to hold one event, for example a Connectathon, a showcase or whatever requiring the use of Test Management. If the first part of the installation is successful, you should see the Gazelle home page (see file entitled Home page before installation).
By hitting the “Start installation” button, you will reach a page dedicated to the different steps of the installation, for each step, a screen capture has been attached (see at the bottom of the page).
Create your Organization: In Test Management, each user is linked to an organization. Before creating your personal account, you have to register your Organization by providing its name. You are also asking for a keyword, the one will be used in the application to find out your organization and to build the keyword of the various systems you will register.
Create your Account: Provide the application with your first name, last name, email and password. This account will have the administration rights (admin_role).
Create the testing session: The testing session is mandatory for using Test Management. You can run several sessions in parallel. For each session you have to provide a long list of informations…
The home page is built of two blocks the administrators can customize when they are logged in.
The main panel is the one which is always displayed and with a header, by default, set to “Main Panel”.
The secondary panel is displayed only if it is not empty. It can be located above or below the main panel. To create it, hit the “create a second panel” button located at the bottom of the main panel.
Each of those two blocks depends on the selected language. That means that, you have to edit those panels in all languages supported by the application. For each panel, you can edit its header title.