Installation: Hub License: Obtaining a License

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

Before you obtain the license, 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 licensing and can go on to Installation: Finishing Up.

For a hub located at <hostname>:<port>, obtain a license 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" 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 based on the information you collected and on your licensing terms, then mail the license text to you. The license text will resemble an extended version of the unsigned license 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, you can configure the hub as described in Hub Setup: Hub Configuration.

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