Administration

The administration entry opens when you click the configuration icon in the blue header bar of the application.

This entry is only visible for users with the Administrator role.

The following screen has 4 entries: 

• Users
• Agents
• API Tokens
• License

Users

After installation only one user exists: Administrator with the role Adminsitrator.

The Administrator can Manage Projects, Environments and Applications. The Adminsitrator can also manage Users.

You can add users with the Adminsitator role or the Users role.

Users having the Users role will only be able to access the Dashboard and start the visible Scenarios for envrionments they are added to.

In this screen you can add and edit users. 

You can change the Username, the full name, the password and the email address.

Currently the email address is not used.

API Tokens

To enable API calls using curl or wget API Tokens are required. 

Only API Calls made by a User with a valid API Token are allowed to perform Runtime actions.

 A Token is generated in DATPROF Runtime by clicking the "Generate API Token" button.

To use the token specify in the api call:  --header "X-auth-token:<TOKEN>"

Currently only the user Admin is allowed to use API calls. 

You can copy the key to the clipboard for easy script creation.

You can add more then one Token

You can revoke Tokens from the database to restrict access to Runtime.

For security reasons the token is only visible once in Runtime , just after creating it. If you want to use it copy it immediately.

License

The license is entered during installation.

In this screen you can check and update the license if the license is about to expire.

You can clearly see if the license is Valid , Almost expired or Expired.

Almost Expired:
As of 30 days  before expiring a yellow notification bar is shown on  top of the application telling you the license will expire within a certain amount of days. You are able to hide this notification bar.
Expired:
After expiring a red notification bar is shown on top of the application telling you the license has expired.

Once the expiration date has passed it is not possible to upload, install or uninstall applications . 
You can still run applications, you cannot hide the notification bar.

30 Days after expiring you can no longer run applications. In order to be able to continue working with the software, a valid license code has to be supplied. 

In this screen you can also see the type of license used and the properties of this licences:

-          Number of parallel processes.

-          Number of allowed users.

-          Number of allowed environments.

-          Number of allowed applications.

-          Number of allowed agents.

-          Use of API allowance.

Agents

Agents are vital for Runtime. Every agent is a Java process that is started by Runtime to execute database tasks. Therefor an agent is both required to install an application (in the database) and to run the application. You may have multiple agents.

Agents belong to the DATPROF Runtime and will be used by different applications. In other words, applications share Agents.

Note:
An application requires only one available agent. The parallel setting you enter has nothing to do with the number of agents but applies to the threads within an agent.

To create an Agent first select Agents in the menu pane. And then click the Add agent button.

This will immediately create an entry on the screen and an entry in the Runtime Meta Data Service database.

Every agent has three attributes, ID, Status

• ID: This is a unique number identifying the agent.
• Status of the Agent
  • UNAVAILABLE: The Agent is created but not running.
  • AVAILABLE: The Agent is started and a java process is waiting to execute a task.
  • RUNNING: The Agent is executing a task.
  • PAUSED: The Agent is paused on user request by pausing the application .

As you mentioned the Agents use the UUID as the name. On the filesystem in the Runtime Data folder you have an agents folder. In this agents folder a subfolder is created for every agent using the UUID as its name. In this folder you’ll find a.o. the code to run and the agent logfiles.

Managing agents can be done with the buttons at the right side, the action depends on the current status.

STATUS                  ACTIONS

• UNAVAILABLE:     Start and Delete
• AVAILABLE:          Stop and Delete
• PAUSED:               -             
• RUNNING:            Stop

Deleting a Paused or Running agent is not possible.

Note: An application in Error will keep an agent in a Running state.