Groups

Introduction

A Group is a logical unit to hold Environments. It makes it easier to cluster specific environments together. For example all environments related to a certain application, purpose, team, subset or masking, etc. A single environment cannot be created within multiple groups. In that case you would have multiple environments that refer to the same target database. 

Groups are created using the "New group" button in the menu under "Groups" 

You just have to specify a name, for example "DevTeams" and click Create group. 

Groups can be found under the collapsable node Group.s

The Group details screen allows you to manage and add one or more Environments.

---

Add environment

Within a Group you must create one or more Environments before you can install and run an Application.

An Environment contains a reference to the target database on which installed applications will be executed. 

Click on the button "Add environment" to fill in the environment details. 

Name

Provide a name for this environment. It must be unique. You are allowed to change names afterwards.

Database Type 

Choose the database type of this environment. 

Connection Properties

Depending on the selected database type, you have to fill in the connection details.

Custom JDBC URL

In some occassions it could be necassary to define the JDBC connection URL yourself. Click the Custom JDBC URL and enter a valid jdbc url. 

Click Test connection to validate the connection properties or custom JDBC url. 

---

Environments

This page wil show all the environments of the selected group. This consists of the name of the environment, installed applications, database type and connection details. If in installed application is currently being executed inside an environment a progress bar is shown. Based on previous runs an estimate will be calculated how long the run will remaining. 

 When previous runs have halted for a long time due to errors, the remaining time can be not calculated precisely. 

When a environment has errors during the run. The environment will highlight in red. You can navigate to the environment to actually see what went wrong.  

---

Options

Rename group

You can easily rename an existing group by going to Options → Rename

Delete group

 Use this option with care.

Existing groups can be removed by using this menu item.

It will remove:

• All Environments (with the Run history, Audit reports, installations and parameters)
• The Group itself

A dialog will show up to verify if you really want to remove this group.