Online activation
Activate a Digicom product on a server that can reach the internet.
Use this when the server running the Digicom product can make outbound HTTPS connections. If it can't, use Offline activation.
Before you start
- You have the license key from Digicom. It looks like
OMF-7KQ2M-HX9TB-P4WRN-3ZC8D. Treat it like a password. - The server can reach the Portcullis API host over outbound HTTPS. See Network requirements.
- The product's data directory is on persistent storage. It holds the installation's
identity and its license file. In Docker or Kubernetes, use a persistent volume, and
optionally set
PORTCULLIS_INSTALLATION_ID(see below).
Steps
- Install and start the product as described in its install guide.
- Open the product's license or setup screen.
- Enter the license key. Lowercase, spaces and missing dashes are fine.
- Confirm. The product contacts Portcullis, receives a signed license file and stores it.
- Check that the product shows the expected customer name, expiry date and limits, for example "Licensed to Acme Logistics until 2027-11-14, 500 vehicles".
That's it. From now on the product checks in automatically (typically once a day) to refresh its license and pick up renewals or changes from Digicom. You don't need to do anything when your contract is renewed.
Containers: PORTCULLIS_INSTALLATION_ID
Each installation has an installation ID, stored in the data directory. If the data directory is lost, the product looks like a new installation and uses another of your license's installation slots.
In Docker or Kubernetes you can pin the ID with an environment variable. Set it to a fixed value (a UUID is a good choice) that is unique to this installation:
environment:
PORTCULLIS_INSTALLATION_ID: "3f0b6a0e-6a52-4c1e-9a55-1d2f8f0c7b11"- Keep the value the same across restarts and upgrades.
- Don't reuse the value for a different installation. Two installations with the same ID look to Digicom like a copied installation.
If something goes wrong
The product shows an error message. Look it up in Troubleshooting. The most common ones:
| Message / code | What to do |
|---|---|
LICENSE_NOT_FOUND | Check the key for typos and that it's for this product. |
MACHINE_LIMIT_REACHED | All installation slots are in use. Deactivate an old installation, or contact Digicom. |
| Network error | Check outbound HTTPS to the Portcullis API host. |