GIS Labs
Documentation
Licensing4 min read

Activating a licence

Online and offline activation, virtual machines, moving to new hardware, and expiry.

A licence is a signed .gdl file bound to the machine it is activated on. Open GeoDoctor’s Activation screen and use whichever way suits the server:

Online — the GeoDoctor computer reaches the internet#

  1. Choose “Activate online” and enter the licence key from your email.
  2. Your request reaches GIS Labs by itself.
  3. GIS Labs checks it, approves it and signs your licence file, usually within a few hours.
  4. The licence arrives online: GeoDoctor collects and installs it by itself.

Note

Online activation needs two things: the GeoDoctor computer can reach gislabs.dev, and the build is the customer build GIS Labs supplies. A build made for testing says that online activation is not available in it; use the offline route below, which needs neither.

Offline — no internet on the GeoDoctor computer#

  1. Choose “Export .gdr”. The file holds this machine’s fingerprint and no personal data.
  2. Upload it in the portal, under Licences, and answer two questions: is the machine physical or virtual, and will it be online or air-gapped. Or email the file to [email protected] with the same two answers.
  3. We email you when your .gdl licence file is ready. Download it from the portal and load it on the “.gdl file” tab.

The offline route never needs gislabs.dev to be reachable from the server: carry the .gdr out and the .gdl back on a removable drive. It is the route for air-gapped servers.

Note

One licence, one installation. The same key on another machine is refused as installed on another machine. An online installation checks in with gislabs.dev; if it cannot reach it, it keeps working through its offline grace period and shows the days left.

Virtual machines#

A virtual machine can be copied with its hardware identity, so a licence has a policy for virtual machines. An air-gapped virtual machine needs a licence made with the policy “allow”. Say so when you request it; see “Virtual machines and licences”.

Moving to new hardware#

Choose “Deactivate this machine” in GeoDoctor on the old server: it releases the licence so it can be used on another machine. Then activate on the new one. If the old server no longer runs, email [email protected] and we release it. There is no charge.

Expiry#

After the end date a grace period applies, then GeoDoctor becomes read-only: you can view data and export reports, but new operations are disabled. Renewing restores full function, and nothing is deleted.

Stuck on something not covered here? Email [email protected] — a person replies within one business day.