License Management

The TEMU System Debugger is license gated. A valid license (with the gui or all feature) is required before the main window opens.

Licenses are shared with the emulator through the same local TEMU/TGSS license database, so a license installed with the temu command line tool is immediately visible to the debugger, and a license installed from the debugger is available to temu. For license concepts, node-locked and floating licenses, and license server setup, see Getting Started.

Startup License Check

When the debugger starts, it validates the installed licenses before building the main window.

If a usable license is found, the debugger continues to the main window without prompting.
If no usable license is found, the License Management dialog opens as a blocking gate. Install or activate a license, then click Continue.
Continue stays disabled until the license state allows the session to proceed.
Clicking Cancel closes the debugger.

Opening the License Manager

Choose About License… to open the License Management dialog at any time during a session. Outside the startup gate the dialog is a normal management window, so you can close it with Close and keep working.

License Status

The top of the dialog summarizes the state of the current session.

State: One of Licensed, Unlicensed, Unknown, or Error.
Summary: A short description of why the debugger is in that state.
Detail: The full message from the license backend, including any error text.

Installed Licenses

The Installed Licenses tab browses the licenses already present in the shared local license database.

Each row shows the license ID and its status text.
The license the debugger is currently using is marked with a check mark, the suffix (Active), and bold text.
Licenses that cannot be used by the GUI (such as licenses missing the gui or all feature or expired licenses) are shown grayed out.
Refresh re-reads the license database, which is useful after installing a license from another tool such as the temu CLI.

Selecting a row fills the License Details panel:

Activation Status: Whether the selected license is the one currently in use.
Kind: Node-locked, Node and user locked, or Floating.
Pool ID: The license pool the license belongs to.
License ID: The identifier used when activating or revoking the license.
MAC Binding: The hardware address the license is locked to, when applicable.
Username Binding: The user the license is locked to, when applicable.
Project: The project recorded in the license.
Products: The products the license covers, for example the emulator and the debugger.
Features: The licensed features, listed per product.
Expiration: The expiration date of the license, in UTC.
Checkout Expiration: For floating licenses, when the current checkout lapses.
Refresh Interval: How often a floating license is refreshed against the license server.
Support End: The end of the support period recorded in the license.
Summary and Detail: The status text reported for the selected license.

Activating a License

Select a license and click Activate, or double-click the row. The button reads Active License and is disabled when the selected license is already the active one.

The activated license is remembered, so the same license is preferred the next time the debugger starts.

Activation only chooses which installed license the debugger uses. It does not install anything, and it does not consume an extra activation.

Installing a New License

Use the Install New License tab to add a license without leaving the debugger.

Paste a license token, UUID, or activation key into the text box, or click Browse File… and select a license file. The file filter accepts .lic, .txt, and .token files.
Check the License Token Preview panel on the right. It decodes the pasted text as you type and shows the same fields as the details panel, so you can confirm the kind, products, bindings, and expiration before installing.
Click Install License.
A message box reports whether the license was accepted.

On success the input is cleared and the dialog switches to the Installed Licenses tab with the new license selected. Use Clear to discard the pasted text without installing it.

Revoking or Releasing a License

The button above the installed license list adapts to the selected license.

Release License…: Shown for floating licenses. Returns the checked-out license to the license server after a confirmation prompt.
Revoke License…: Shown for node-locked and node-and-user-locked licenses. Invalidates the license on the current machine.

Revocation is intended for retiring or migrating hardware. The dialog shows the full notice before proceeding, and revocations are limited in number.

When a revocation succeeds, a Revocation Proof window shows the revocation key. Use Copy to Clipboard and send the key to Terma to release the license fully.

Revocations cannot be used as a substitute for floating licenses. If the hardware fails before the license can be revoked, contact Terma for activation.

License Alerts and the Grace Period

If a license validation ever fails, a License Alert window appears in front of the main window.

The alert is non-modal, so you can keep working and save what you need.
If the connection to the license server is disrupted, the software will still run for some time.
Open License Manager opens the License Management dialog so you can install or activate a working license.
Close Warning hides the alert, but the grace period counts down.

If the license becomes valid again before the grace period expires, the alert disappears and the session continues normally.

If the grace period expires, the blocking license dialog opens again. Resolve the license to continue, or cancel the dialog to close the debugger.