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

Installation: Hub License Key: Obtaining a License Key

If you need to set up a license key for a new or upgraded CodeSonar hub and do not have a suitable signed license key, you will need to obtain one. This section provides instructions for creating an unsigned license key and submitting it for signing. If you already have a license key, go on to Hub License Key: Set Up A Standard License Key.

Before you obtain the license key, make sure you have done the following.

If you have simply connected to a hub for which someone else is responsible, including any SaaS hub, you do not need to set up a license key and can go on to Installation: Finishing Up.

For a hub located at <hostname>:<port>, obtain a license key as follows.

  1. If the CodeSonar Web GUI is not already open, open it now.
    http://<hostname>:<port>/
  2. If you are not already signed in as Administrator, sign in now.
    1. Click the Sign In link (at the top right of the page).
      CodeSonar will open a page for you to enter credentials.
    2. Enter Administrator in the Username field.
    3. Enter the Administrator password in the Password field.
      (If you have just started a new hub, you will have set a password for Administrator as part of that process.)
    4. Click Sign In.
    If this is the first time the Administrator account has been used, you will be asked to specify an email address for the account.
  3. Click the see licensing details link in the GUI footer.
    The License Utilization page will open. Directly under the page heading will be a text field labeled Edit License(s).
  4. Click the Request a new license link, which is located below the Save button.

    CodeSonar will generate and display a new "unsigned license key" for <hostname>. It will look (something) like the following.

    "ip addresses" : [ "198.51.100.0" ],
    "lock mutex" : "Global\\codesonar_license",
    "mac addresses" : [ "02:00:5e:fe:c6:33:64:00" ],
    "machine" : "alexmachine",
    "name" : "CodeSonar",
    "user" : "alex",
    "version" : 401,
    "volumes" : [ "A438-C3F3" ]
    
  5. Click the https://links.codesonar.com/request-license/ link (labeled Request a signed version of this license).

    This will open the CodeSecure License Request Form. Some fields will be populated with the information you have just collected.

  6. Fill in the remaining fields.
  7. Click Submit.
    CodeSecure will generate a license key based on the information you collected and on your licensing terms, then mail the license key text to you. The license key text will resemble an extended version of the unsigned license key that you submitted to CodeSecure. In particular, it will include a "signature" attribute.
    This process will usually take one working day.

    While you are waiting to receive the signed license key, you can configure the hub as described in Hub Setup: Hub Configuration.

  8. When you have received the signed license key, inspect it. Does it does it contain an attribute of the form "floating":true?
 

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