Offline activation
Activate a Digicom product on an air-gapped server using a request file and a license file.
Use this when the server running the product cannot reach the internet. You exchange two small files with Digicom instead. No network access is needed on the server.
Before you start
- The product's data directory is on persistent storage. If it is lost, the installation gets a new identity and the license file no longer matches it.
- In Docker or Kubernetes, optionally set
PORTCULLIS_INSTALLATION_IDto a fixed value, see Online activation. - Your license must allow offline use. If you're unsure, ask your Digicom contact.
Steps
- Generate the request. In the product's license screen, click Generate activation
request. Save the file (for example
omf-prod-01.req). - Send it to Digicom. Email the
.reqfile to Digicom support. Mention your company name and, if you have it, your license key's last 5 characters. The file contains no secrets: only the product, a fingerprint of this installation, the hostname, platform, product version and a random number. - Receive the license file. Digicom returns a
.licfile made for this installation. - Import it. In the product's license screen, click Import license file and select the
.licfile. - Check that the product shows the expected customer name, expiry date and limits.
Don't generate a new request while you wait for Digicom's reply. The license file is matched to the request it was made from, and a newer request may replace the pending one. If you did generate a new request, send that one instead.
Renewals and changes
An offline installation doesn't contact Digicom, so changes (renewal, more vehicles, new modules) reach it only through a new license file.
- Digicom sends you a new
.licfile for the existing installation. No new request is needed. - Import it with Import license file. The product accepts it because it is newer than the current file.
The product warns administrators before the current file expires. If you see that warning and haven't received a new file, contact Digicom.
Decommissioning
Offline installations can't release their slot themselves. When you retire the server, ask Digicom to deactivate it. See Moving to a new server.