Skip to content

Conversation

Dan-Heath
Copy link
Contributor

@Dan-Heath Dan-Heath commented Aug 25, 2025

Description

Per SPE-1197, a customer had some questions about what happens when the Boundary Enterprise license expires. These included:

  • What happens when the license expires? Is there a grace period?
  • Are there any notifications prior to expiration?
  • How do you update a license key and is there downtime?
  • What is the recommended upgrade path?

These scenarios were documented in the Vault docs, and the customer expected to find the information in the Boundary docs too.

This PR updates the Boundary Enterprise licensing documentation with more information about what happens in the scenarios listed above.

View the preview deployment

PCI review checklist

  • I have documented a clear reason for, and description of, the change I am making.
  • If applicable, I've documented a plan to revert these changes if they require more than reverting the pull request.
  • If applicable, I've documented the impact of any changes to security controls.
    Examples of changes to security controls include using new access control methods, adding or removing logging pipelines, etc.

@Dan-Heath Dan-Heath added this to the deferred milestone Aug 25, 2025
@Dan-Heath Dan-Heath self-assigned this Aug 25, 2025
@Dan-Heath Dan-Heath marked this pull request as ready for review August 25, 2025 16:32
@Dan-Heath Dan-Heath requested review from a team as code owners August 25, 2025 16:32
Comment on lines 77 to 96
{
"id": "SJkaNV09xP",
"source": "https://hashicorp.com/boundary/nixos/controller+worker",
"specversion": "1.0",
"type": "error",
"data": {
"error": "error from licensing watcher: invalid license or license is expired",
"error_fields": {},
"id": "e_33IKa8BqB3",
"version": "v0.1",
"op": "licensing.StartWatching"
},
"datacontentype": "text/plain",
"time": "2025-08-01T16:54:14.34408533-07:00"
}
==> Boundary dev environment self-terminating
==> Health is enabled, waiting 0s before shutdown
==> Boundary dev environment graceful shutdown triggered, interrupt again to enter shutdown
```
Copy link
Collaborator

@stellarsquall stellarsquall Aug 25, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

because this is a log message and not a code snippet, I don't think we need to enable the copy button

<CodeBlockConfig hideClipboard>

```plaintext
{
  "id": "SJkaNV09xP",
  "source": "https://hashicorp.com/boundary/nixos/controller+worker",
  "specversion": "1.0",
  "type": "error",
  "data": {
    "error": "error from licensing watcher: invalid license or license is expired",
    "error_fields": {},
    "id": "e_33IKa8BqB3",
    "version": "v0.1",
    "op": "licensing.StartWatching"
  },
  "datacontentype": "text/plain",
  "time": "2025-08-01T16:54:14.34408533-07:00"
}
==> Boundary dev environment self-terminating
==> Health is enabled, waiting 0s before shutdown
==> Boundary dev environment graceful shutdown triggered, interrupt again to enter shutdown
```

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thank you! Updated.

Copy link
Collaborator

@stellarsquall stellarsquall left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

this looks great!

Ongoing sessions continue to run, but you will not be able to create any new sessions.

Prior to the expiration date, Boundary logs 5 warnings to the event stream at the following intervals:

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Are you able to provide an example of what that log looks like? That would be helpful for users to configure alerting on this, just in case.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
Projects
None yet
Development

Successfully merging this pull request may close these issues.

3 participants