--- title: "Viewing virtual appliance license status using the CLI" slug: "viewing-virtual-appliance-license-status-using-the-cli" tags: ["Endpoint Security (HX)", "Product Usage"] updated: 2026-09-09T22:45:38Z published: 2026-09-09T22:45:38Z canonical: "docs.trellix.com/viewing-virtual-appliance-license-status-using-the-cli" --- > ## Documentation Index > Fetch the complete documentation index at: https://docs.trellix.com/llms.txt > Use this file to discover all available pages before exploring further. # Viewing virtual appliance license status using the CLI Use the commands in this section to view current token status and configuration information. To view license token status: 1. Log in to the virtual appliance. 2. Enable the enable CLI mode: ``` hostname > enable                     ``` 3. View the status: ``` hostname # show licenses tokens                     ``` To view license token configuration: 1. Log in to the virtual appliance. 2. Enable the enable CLI mode: ``` hostname > enable                     ``` 3. View the configuration: ``` hostname # show licenses tokens configured                     ``` ### Examples The following example shows license token configuration information for the vNX-04 virtual sensor. ``` vNX-04 # show licenses tokens configured License token configuration:    Query Enabled:          yes    Query lead time:        25% (15 min)    Query Retry interval:   1 min ``` The following example shows the current status of license tokens on the vNX-04 virtual sensor. ``` vNX-04 # show licenses tokens Token Summary :    Token Active :                 yes    Token Required :               yes    Token Lease :        Lease Active:              yes        Lease Time Remaining :     12 min    Token Grace Period :        Grace Period Active :      no        Grace Period Available :   yes        Grace Period Remaining :   360 min    Token Server Current Time :    2019/07/25 14:49:21 Token Details :    Next Token :                  Sequence Number :          186          Lease Duration :           60 min        Timestamp :                2019/07/25 14:47:21    Active Token :        Sequence Number :          185        Lease Duration :           60 min        Timestamp :                2019/07/25 14:01:21    Previous Token :        Sequence Number :          184        Lease Duration :           60 min        Timestamp :                2019/07/25 13:15:21 ``` ### Output Fields The following table describes the` show licenses tokens configured `command output fields. | Field | Description | | --- | --- | | Query Enabled | Whether the virtual appliance is enabled to request license token renewals. | | Query Lead time | The percentage of the lease duration before the active lease expires at which the virtual appliance should request license token renewal. This value is 25 percent of the lease duration (15 minutes). | | Query Retry interval | How soon the license token renewal is tried again after an unsuccessful attempt. This value is one minute. | The following table describes the` show licenses tokens `command output fields. The output fields and values depend on the current license token status. For example, when a token has not been obtained yet, the` Next Token `field is` (not fetched)`. | Field | Description | | --- | --- | | **Token Active** | Whether the current token is active. | | **Token Required** | Whether a token is required to keep the product license active. | | **Token Lease** | | Lease Active | Whether the lease on the current token is active. | | Lease Time Remaining | Number of minutes before the lease expires. | | **Token Grace Period** | | Grace Period Active | Whether the virtual appliance is currently using grace time because its license token expired. | | Grace Period Available | Whether the appliance has available grace time to use if necessary. | | Grace Period Remaining | The number of minutes remaining in the grace period. The maximum is 360 minutes (six hours). | | **Token Server Current Time** | Current date and time of the token server. | | **Next Token** | | Sequence Number | Number identifying the next token on the token server. | | Lease Duration | Number of minutes the next token will last. | | Timestamp | Date and time the next token was obtained. | | **Active Token** | | Sequence Number | Number identifying the license token that is currently in use. | | Lease Duration | Number of minutes the lease on the token will last. | | Timestamp | Date and time the current token was obtained. | | **Previous Token** | | Sequence Number | Number identifying the last token that was used. | | Lease Duration | Number of minutes the lease on the token lasted. | | Timestamp | Date and time the previous token was obtained. | :