Groups
![](../../__attachments/391872573/image2023-3-13_9-46-50.png?inst-v=9faf47d4-7060-40c4-b0f6-6c85db0afb12)
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, or subset.
Groups are created using the "New group" button in the menu under "Groups"
You have to specify a name, for example "DevTeams" and click Create group.
Groups can be found under the collapsable node Groups.
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. Depending on which option you choose, the credentials needed to connect to it will change dynamically.
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 on Custom JDBC URL and enter a valid jdbc url.
Click Test connection to validate the connection properties or custom JDBC url.
Environments
This page will 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.
Runtime will compare current progress to the elapsed time to calculate an estimated remaining time. If a run has been paused for a long time (such as when it has gone into an error state and paused) this estimate will likely be inaccurate.
If an environment has been started and returns an error, the environment will pause and change colors to red. When this happens, click on the environment in order to access the error message and to resolve the underlying issue, or abort the run.
Options
Rename group
You can easily rename an existing group by going to Options → Rename
Delete group
Deleting a group will also delete all underlying environments. Therefore; exercise caution doing this.
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.