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 files containing all the data required by the application to properly work (schema-X.X.X.sql and init-X.X.X.sql, X.X.X being the latest version available) on Nexus in the sql.zip file : Nexus repository and import it into the newly created database as shown below.
psql -U gazelle your_database < schema-X.X.X.sql psql -U gazelle your_database < init-X.X.X.sql
Gazelle Test Management need the package graphviz to display graph (Display relations between actors and transactions for a given integration profile)
sudo apt install graphviz
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.
With the release 5.15.0, Gazelle Test Management needs a file to interact with the SSO application.
This application read the configuration of the SSO in a file located in
/opt/gazelle/cas. We need to create this folder and the configuration file
mkdir /opt/gazelle/cas touch /opt/gazelle/cas/gazelle-tm.properties chown -R jboss:jboss-admin /opt/gazelle/cas chmod -R g+w /opt/gazelle/cas
The file gazelle-tm.properties has shall be created and save in /opt/gazelle/cas.
The file shall contain the following statements :
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 new home page support multiple sections, each section contains HTML content, and pre-defined css classes.
For the current version (6.3.0), the application doesn’t provide a graphical interface to manage these sections, therefore, an administrator should insert manually his HTML content in the table “tm_sections”.
The update script update-6.3.0.sql (init-6-3-X.sql as wel) contains a default HTML content that match predefined styles for the IHE Connectathon 2022. An administrator could change the column content in the tm_section database with his custom HTML.
By default, two sections (Documentation and Announcement) are displayed only in the home page, the other two sections (Tool index and Credits) are visible through all the application pages.
update tm_section update content='<YOUR_HTML_CONTENT>' where id=<SECTION_ID>
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.