Groups

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 "DATPROF Demo Group", and click Save

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 unique name for this environment. This name will help you identify and distinguish it from other configured environments in your system.

The name must be unique across all your environments, though you can update it at any time from the environment settings without affecting the connection or stored data.

Tips for naming:

• Use descriptive names that reflect the environment's purpose (e.g., "Production Database," "Dev Azure Storage," "Customer Files S3")

• Consider including the environment type or location for easier identification

• Keep names concise but meaningful

Type

Choose the type of environment you'd like to connect to. We support both database connections and file storage systems across multiple platforms:

• Databases: Connect directly to your relational or NoSQL databases

• File Storage: Access files from local systems, Azure Blob Storage, or Amazon S3

The connection form will automatically adapt based on your selection, displaying only the relevant credential fields needed for that specific data source. For example:

• Database connections will prompt for host, port, username, password, and database name

• Local file storage will require a directory path

• Azure connections will ask for your storage account name and access key

• AWS S3 will need your access key ID, secret access key, and bucket name

For detailed instructions on configuring file storage connections, see our File Masking documentation.

Connection Properties

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

Custom JDBC URL

In some occasions it could be necessary 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. After successfully validating the connection, press “Add environment” to save the environment.

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 calculates the estimated remaining time by comparing the current progress against the elapsed time. However, if the process is paused for a significant duration, such as during an error state, the estimate may become inaccurate.

If an environment encounters an error after starting, it will pause and its status color will change to red. To address this, click on the environment to view the error message. From there, you can either resolve the issue or abort the run.

Options

Clicking the "Options" button in the top-right corner opens a menu with the following options:

• Edit
  Rename an existing group by selecting Options → Edit.

• Manage Permissions
  To manage permissions at the user or group level, select Options → Manage Permissions.
  These permissions apply to all environments within the group. If you prefer not to assign permissions at the group level, you can set them individually for each environment.

• Delete Group
  Deleting a group will remove all associated environments, including their run history, audit reports, installations, and parameters.
  Use this option with caution.
  A confirmation dialog will appear to verify that you wish to delete the group and its contents.