You must activate your DashO installation with a license key before you can use it. PreEmptive sends a license key for each purchased license and for each evaluation license.
DashO uses two license types:
- User licenses: Intended for developers working on development machines. For example, you can use a User License to integrate DashO into your build process or edit your DashO configuration with the Config Editor.
- Build licenses: Intended for build agents that build production-ready software. You may publicly distribute software produced when you use a Build License to run DashO.
All DashO evaluation licenses are User Licenses.
Different license types allow you to use DashO in different ways. Make sure you activate DashO with the correct license key.
Licenses can be either floating or non-floating. Floating Licenses support shared and dynamically provisioned build environments and require an Internet connection whenever DashO runs. Non-Floating Licenses are activated on specific machines and can continue to operate without an Internet connection after activation.
Before You Begin
Before you activate DashO:
- Install DashO.
- Have your license key available.
- Verify that you are using the correct license type for your scenario.
Internet Connection Requirements
DashO requires an Internet connection to activate licenses and validate licensing information.
- Product activation requires access to the PreEmptive licensing services.
- Floating licenses require an active Internet connection whenever DashO is running.
If your organization uses a firewall or proxy server, ensure that DashO can reach the following endpoints:
| URL | Purpose |
https://activation.preemptive.com |
Product activation |
https://licensing.preemptive.com |
License validation |
https://registration.preemptive.com |
Product registration |
If these endpoints are blocked, activation or license validation may fail.
Connection Retry Behavior
To reduce build failures caused by temporary network interruptions,DashO automatically retries failed connections after a short delay.
If the licensing service is undergoing planned maintenance, DashO retries the connection every 30 seconds for up to 30 minutes by default.
You can customize this behavior using the following environment variables:
| Environment variable | Description | Default |
DASHO_MAINTENANCE_RETRY_DELAY |
Delay between connection attempts, in seconds. | 30 seconds |
DASHO_MAINTENANCE_RETRY_TIMEOUT |
Total retry period before reporting a failure, in minutes. | 30 minutes |
Both values must be specified as positive whole numbers.
Activate with the Config Editor
The DashO Activation Tool provides a graphical interface for activating DashO when you don't provide license information through a Java property, environment variable, or command-line argument.
If you haven't activated DashO, the Activation Tool starts automatically when you start the Config Editor.
- Start the Config Editor.
- Select Click here to activate DashO.
- The Activation Tool opens your web browser to preemptive.com. Enter your credentials and select Log in.
- Follow the prompts to use your web browser to activate DashO.
- On systems that do not support automatic browser communication, enter the Activation Token manually. and select Activate.
- Your web browser communicates back to the Activation Tool via a localhost HTTP request. Wait for the Activation Tool to verify the activation.
- When the activation succeeds, select Finish.
DashO saves a successful activation on the machine, allowing it to run without needing to activate again.
Note: You can change your license at any time by selecting Help > Change Product License.
With a Java Property or an Environment Variable
Set the DASHO_LICENSE Java property or environment variable to a license key formatted as a license string.
If you have a Build License, your license string is just your license key. If you have a User License, your license string is your license key and your email address separated by a colon, for example: 00000000000000000000000000000000:jdoe@mycompany.com.
When you set this property or variable, DashO activates itself with the stored license key each time it runs. The Java property takes precedence over the environment variable.
This method is useful for dynamically provisioned build agents because your build system can set the variable automatically. When you activate DashO on a dynamically provisioned build agent, the license must be a Floating License.
DashO does not save a license key that it reads from the environment variable. If you later unset the variable, activate DashO using another method.
Activate with an Argument
Pass a license key formatted as a license string to DashO's build interfaces.
You can pass the license key to:
- DashO Command Line
- DashO GUI Command Line
- PreMark Command Line
DashO does not save a license key that it reads from the command line. If you stop passing the argument, activate DashO using another method.
For more information, see Using the Command Line Interface.
Precedence
When DashO runs, it obtains the license key and registration information in the following order:
- If you use the
--licenseargument, DashO uses that value to activate DashO for the current run only. - Otherwise, if the
DASHO_LICENSEJava property is set, DashO uses that property's value to activate DashO for the current run only. - Otherwise, if the
DASHO_LICENSEenvironment variable is set, DashO uses that variable's value to activate DashO for the current run only. - Otherwise, if you previously activated DashO on the machine through the Config Editor, DashO uses that registration information.
- Otherwise, if you're running the Config Editor, DashO prompts you for a license key. DashO uses the key to activate the machine and saves the registration information for future runs.
- Otherwise, DashO returns an error.
Troubleshooting
If activation fails, check the following items first:
| Issue | What to check |
| Activation or validation fails | Verify that the required licensing endpoints are accessible through your firewall or proxy configuration. |
| Package activation fails | Confirm that you are using an environment variable or command argument. |
| DashO still asks for activation | Confirm that the license value is valid and available in the environment where DashO runs. |
Next Steps
After activating DashO: