JavaScript is not currently enabled, but is required for full CodeSonar manual search and browse functionality.

If you are viewing this file in your hub's Web GUI, enable JavaScript in your browser: you will also need it for GUI functionality.

If you opened this file directly from disk, your browser may be directly suppressing JavaScript functionality: certain browsers perform this suppression on local files (but not files delivered by web servers) for security reasons.

CodeSonar® 9.2p0 CONFIDENTIAL CodeSecure Inc
General

GUI Reference: License Utilization

View the licensed limits on CodeSonar resources - enabled users, anonymous sessions, and per-file charges - and the current utilization of those resources.



Important Note: the CodeSonar Web GUI makes extensive use of JavaScript. Make sure JavaScript is enabled in your web browser.

Navigating To

From Settings: In the Other Links tab, click License Utilization.
From any GUI page
with the standard footer:
In the page footer, click see licensing details.
By URL: http://hub_location/lines.html

Page Properties

Output formats CSV, JSON, XML (lines.xsd)
Visibility Filter Applied none
RBAC Permissions Needed
Page AccessG_LICENSE_READ
G_LICENSE_UTILIZATION_READ
G_LIST_USERS
Page Contents/FunctionalityG_LICENSE_READ
G_LICENSE_WRITE

Contents and Usage

The following annotated screenshot shows the various parts of a License Utilization page.

Annotated Screenshot: License Utilization page standard header breadcrumbs heading Edit License(s) field Save button Request a new license link utilization summary line count table standard footer

Standard Header See GUI Reference: Standard Header.
Breadcrumbs Home > License Utilization
where Home links to the GUI Home page.
Page Heading License Utilization
Edit License(s) field Only active for users with G_LICENSE_WRITE permission.

Otherwise, a Configure License link is provided. If you click this button you will be prompted to sign in as a user with suitable permissions, then returned to the License Utilization page.

To install or update a license key, enter the license key text in this field and click Save.

Generally, you will do this if you have received an updated license key file from CodeSecure. For full information, see How Licenses Work: License Key Installation and Updates.

Save [Requires G_LICENSE_WRITE] Click to save the contents of the Edit License(s) field and update the license key(s) for the hub accordingly. If the hub is also reading license key information from other locations, those locations are listed to the right of the button.

Once the license key is updated, the License Utilization page will display the limits for the new license key.

"Request a new license key" link Click to obtain a new "unsigned (standard) license key" for the machine your hub is running on. CodeSonar will generate and display the unsigned license key, along with a link to request a signed version of the license key from CodeSecure. For full details, see Installation: Hub License: Obtaining a License Key.

If you are using a floating license key, do not use the Request a new license key link. Instead, follow the instructions at CodeSonar Installation: Floating License Key: Obtain and Set Up the License Key.

Utilization Summary One sentence for each licensed CodeSonar resource.

annotated screenshot fragment: utilization summary

License Charges Table A table listing the license charge for each file on the hub.
  • The table has the standard pagination controls.
  • Each file basename (case-insensitive) is only counted once, even if
    • there are multiple files with the same basename, or
    • a file is analyzed multiple times, or
    • a file occurs in more than one project.
    If there are multiple file instances with the same basename, the instance with the most Lines With Code is counted. When several instances have the same Lines With Code, the oldest such instance is listed: we refer to this as the largest-oldest instance. Note that instance information will appear even if the instance is no longer present on the hub (for example, because the project or analysis it belonged to has been deleted).
  • The available table columns are as follows. Columns displayed by default are marked with an asterisk (*).
    File *  
    Path The File Path.
    Project * The Name of the project in which the largest-oldest instance of the file occurs.
    Analysis ID  
    Charge *  
Standard Footer See GUI Reference: Standard Footer.

Related Tasks

 

To report problems with this documentation, please visit https://support.codesecure.com/.