Licensing actions

Obtaining an install ID

To acquire the token for the command, see “Installing, activating, uninstalling, or transferring licenses”.

To obtain an Install ID:

  1. Use the following command to obtain the SDN controller-assigned install_id value.

    curl [options] -H "X-Auth-Token:" \
    https://<controller_ip>:8443/sdn/v2.0/licenses/installid

    • Replace <token>with the token created in step 2.

    • Replace <controller_ip> with your controller IP address.


      NOTE: If you are installing a High Availability license, enter the IP address of the lead controller.


    A numerical install_id appears. For example: 1249679

  2. Record your install_id for use in the next part of the license registration process.

Activating a license on the controller

Using your license key, you must now activate a license on the controller, completing the license registration and activation process.

To activate a license on the controller:

  1. If your previous cURL session has closed or timed out, re–enter the authentication command to obtain a new token. See Section “Authentication manager”.

  2. Use this command to activate the license on the controller.

    curl [options] -H "X-Auth-Token:<token>" \
    -d <license_key> \
    https://<controller_ip>:8443/sdn/v2.0/licenses

    • Replace <token> with the token you obtained using the authentication command.

    • Replace <license_key> with the key obtained in “Registering your license and obtaining a license key”. You can view the key by logging on to the My Network portal and selecting My Licenses, as shown in Figure 34.

    • Replacec<controller_id> with your controller IP address.


      NOTE: If you are installing a High Availability license, enter the IP address of the lead controller.


The installed license information appears in JSON format, as shown below.

Installed license output

{
  "license" : {
    "install_id" : 1249679,
    "serial_no" : 13,
    "license_metric" : "HA Controller",
    "product" : "HP VAN SDN Ctrl Base",
    "metric_qty" : 500,
    "license_type" : "PRODUCTION",
    "base_license" : false,
    "creation_date" : "2013-09-06T00:26:52.248+0000",
    "activated_date" : "2013-09-06T00:26:52.248+0000",
    "expiry_date" : "2014-01-14T00:26:52.248+0000",
    "license_status" : "ACTIVE"
  }
}

Uninstalling licenses to prepare for transfer

To uninstall licenses, see “Installing, activating, uninstalling, or transferring licenses”.

  1. Use the following command to obtain information about all installed licenses on your controller.

    curl [options] -H "X-Auth-Token:<token>" \
    https://<controller_ip>:8443/sdn/v2.0/licenses

    • Replace <token> with the token created in step 1.

    • Replace controller_ip with your controller IP address.


      NOTE: If you are uninstalling a High Availability license, enter the IP address of the lead controller.


    The installed license information appears in JSON format, as shown below.

    All installed licenses output

    {
      "licenses" : [{
        "install_id" : 12491640,
        "serial_no" : 12,
        "license_metric" : "Controller Node",
        "product" : "HP VAN SDN Ctrl Base",
        "metric_qty" : 52,
        "license_type" : "PRODUCTION",
        "base_license" : true,
        "creation_date" : "2013-09-06T00:26:52.248+0000",
        "activated_date" : "2013-09-06T00:26:52.248+0000",
        "expiry_date" : "2014-01-14T00:26:52.248+0000",
        "license_status" : "ACTIVE"
      },{
    }
     "licenses" : {
        "install_id" : 12491640,
        "serial_no" : 13,
        "license_metric" : "HA Controller",
        "product" : "HP VAN SDN Ctrl Base",
        "metric_qty" : 500,
        "license_type" : "PRODUCTION",
        "base_license" : false,
        "creation_date" : "2013-09-06T00:26:52.248+0000",
        "activated_date" : "2013-09-06T00:26:52.248+0000",
        "expiry_date" : "2014-01-14T00:26:52.248+0000",
        "license_status" : "ACTIVE"
      }]
    }
    

  2. Record each serial_no value.

  3. Use the following command to uninstall, or deactivate, each active license on your controller:

    curl [options] -H "X-Auth-Token:" \
    -d deactivate \
    https://<controller_ip>:8443/sdn/v2.0/licenses/<serial_number>/action

    • Replace <token> with the token you obtained using the authentication command.

    • Replace <controller_ip> with your controller IP address.


      NOTE: If you are installing a High Availability license, enter the IP address of the lead controller.


    • Replace <serial_number with the serial number of the license you want to deactivate. You can view the key by logging on to the My Network portal and selecting My Licenses, as shown in Figure 34.

    The license uninstall key appears in JSON format, as shown below.

    License uninstall key output

    {
      "license" : {
        "install_id" : 1249679,
        "serial_no" : 13,
        "license_metric" : "HA Controller",
        "product" : "HP VAN SDN Ctrl Base",
        "metric_qty" : 500,
        "license_type" : "PRODUCTION",
        "base_license" : false,
        "creation_date" : "2013-09-06T00:26:52.248+0000",
        "activated_date" : "2013-09-06T00:26:52.248+0000",
        "expiry_date" : "2014-01-14T00:26:52.248+0000",
      "license_uninstall_key" : "MYOCD9JMCRRRM-IRTEQ2QUNBYCB-6Q6CJIEIJFKIQ-VAI2QUJBYC433"
        "license_status" : "INACTIVE"
      }
    }
     

  4. Record your license_uninstall_key. For example:

    Security token obtained from output

    The license_uninstall_key obtained from the example in the previous step is:

    MYOCD9JMCRRRM-IRTEQ2QUNBYCB-6Q6CJIEIJFKIQ-VAI2QUJBYC433