Skip to Content
PortcullisDocs
Operators (customer IT)

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_ID to a fixed value, see Online activation.
  • Your license must allow offline use. If you're unsure, ask your Digicom contact.

Steps

  1. Generate the request. In the product's license screen, click Generate activation request. Save the file (for example omf-prod-01.req).
  2. Send it to Digicom. Email the .req file 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.
  3. Receive the license file. Digicom returns a .lic file made for this installation.
  4. Import it. In the product's license screen, click Import license file and select the .lic file.
  5. 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.

  1. Digicom sends you a new .lic file for the existing installation. No new request is needed.
  2. 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.

On this page