Licensing
This tab shows the product the console runs as, the capacity your licenses allow for each node tier against what the vault devices use, and the installed licenses. It is also where you install and remove licenses.
How licensing works
A license is a signed license file, which is a .zip archive issued for this appliance. The console installs it in its built-in license manager.
The license manager checks the signatures. It also checks that the archive was issued for this appliance's Appliance ID, shown on Setup & Settings > Phone Home in the Appliance Identity section. An archive issued for another appliance is refused.
One archive can carry several licenses, for example the product features, a support license, and a capacity license for one node tier.
The installed licenses decide two things.
The product
- A license with the advanced AirGap feature runs the console as AirGap for ObjectScale R2.
- Otherwise, the console runs as AirGap for ObjectScale R1. This applies with the base feature only, with no license, or when every license has expired.
The navigation updates as soon as a license is installed or removed. No reload is needed.
Capacity per node tier
Capacity licenses allow a number of TB of usable capacity for each node tier (A, H, F). The license manager compares them with what the enabled vault devices use. It raises an alarm when the use is higher. Nothing is blocked or switched off.
Current License
| Field | Description |
|---|---|
| Product | AirGap for ObjectScale R1 or R2, as described above. |
| Customer | The license holder named in the installed licenses. |
| Expires | The earliest expiry date of the installed licenses, with a "days left" badge. It shows "Does not expire" when no installed license expires. |
The "days left" badge uses these colors:
- Green: more than 30 days.
- Amber: 8 to 30 days.
- Red: 7 days or fewer.
A yellow banner appears when no valid license is installed. It gives the reason:
- No license is installed.
- The licenses are expired or have no AirGap feature.
- The license manager is not running. See the console log.
Capacity by Node Tier
The page shows one card for each node tier (A, H, F).
| Field | Description |
|---|---|
| TB used | The usable capacity, in whole TB, of the nodes of that tier in the enabled vault devices. The node count is shown on the right. |
| TB licensed | The capacity the installed licenses allow for that tier. It shows "unlimited" when a license sets no limit, and 0 when no license covers the tier. |
The TB used value comes from the node inventory. Its usable capacity is read from ObjectScale. The hardware-model read is disabled in 3.0, so every vault node counts as tier A (archive).
When more TB is used than licensed, the bar turns red and "Over the licensed capacity" appears. The license manager then raises alarm LI-003 (Licensed capacity exceeded). The alarm clears by itself once the use is within the license again, for example after you install a larger license.
Installed Licenses
The table shows one row for each installed archive.
| Column | Description |
|---|---|
| License | The archive's license token, for example AGVA_A_TYPE_ECS_100_TB. |
| Contents | The licenses in the archive and their quantity, for example a node-tier capacity license with its TB. |
| Holder and Expires | As named in the archive's licenses. |
| Remove | Removes every license installed from that archive, after a confirmation. The product and the capacity cards update at once. |
Install License
Choose the license archive (.zip) issued for this appliance, then click Install License. The result is one of these:
| Result | Meaning |
|---|---|
| License installed | Every license in the archive was installed. |
| License partly installed | Some licenses were installed. The list below the message says why the others were not. |
| License not installed | Nothing was installed. The list says why. |
Installing an archive again, or a newer archive for the same license, replaces the earlier licenses.
Requesting a license
- Open Setup & Settings > Phone Home and copy the Appliance ID.
- Send it to your account representative.
- Install the license archive you receive on this tab.
Alarms
The license manager raises these alarms. See the Alarms help for the full list. Each alarm clears by itself when the condition is gone.
| Alarm | Description |
|---|---|
| LI-001 | License expiring. A license is close to its expiry date. |
| LI-002 | License expired. |
| LI-003 | Licensed capacity exceeded. More usable TB than licensed on a node tier. |
| LI-004 | No support license installed. |
Each alarm shows the license manager's own message.
- LI-001 and LI-002 also show the licenses concerned, the customer, and the expiry date. They show the days remaining, or the days since the license expired.
- LI-003 shows the used and licensed TB of each node tier, as on the capacity cards.
Troubleshooting
For license messages and fixes, see the Licensing section of the Troubleshooting page.