IBM Cloud Docs
Assigning software licenses to your account

Assigning software licenses to your account

To install software products in IBM Cloud®, the license for the software must be assigned to your account. You're entitled to install a specific version of the software for a specific period of time, for example, one year. Licenses, which are also referred to as entitlements, are purchased and acquired through IBM® Passport Advantage.

Acquiring a license

In most cases, someone in a procurement or financial role in your organization works with an IBM Cloud sales representative to purchase the license through IBM Passport Advantage. A part number is associated with the license for the software product to be used in IBM Cloud. The person acquiring the license is not typically the same person who installs the software in the IBM Cloud account. After a sales representative acquires the license through the Software Quote Order tool, it must be assigned to each account that requires entitlement for use of the software in IBM Cloud.

Assigning licenses to an account

When you assign licenses to your account, all users with access to your account can use them to install the software to which the licenses apply. If the procurement focal is not the owner of the account to which the license must be assigned, they must be assigned the administrator role on the License and entitlement account management service.

Complete the following steps to assign a license to an account:

  1. Log in to the IBM Cloud console and go to Manage > Account.
  2. Click Licenses.
  3. If you don't have any licenses assigned to the account, click Check IBM Passport Advantage to find all the licenses that are tied to your IBMid. If you have existing licenses, click Assign to assign more licenses to the account.

You can unassign a license from the account. Note, however, any IBM Cloud Schematics workspaces in which the license is used will be impacted.

Assigning licenses to an account by using the API

When you assign licenses to your account, all users with access to your account can use them to install the software to which the licenses apply. If the procurement focal is not the owner of the account to which the license must be assigned, they must be assigned the administrator role on the License and entitlement account management service.

To assign a license to an account, call the Catalog Management API as shown in the following example request:

String name = "{name}";
CreateLicenseEntitlementOptions createOptions = new CreateLicenseEntitlementOptions.Builder().name(name).build();
Response<LicenseEntitlement> response = service.createLicenseEntitlement(createOptions).execute();
System.out.println(response.getResult());
name = "{name}";
response = await service.createLicenseEntitlement({ 'name': name } );
console.log(response);
name = "{name}"
response = self.service.create_license_entitlement(name=name)
print(response)
createOptions := service.NewCreateLicenseEntitlementOptions()
createOptions.SetName("{name}")
_, response, _ := service.CreateLicenseEntitlement(createOptions)
fmt.Println(response)

You can unassign a license from the account. Note, however, any IBM Cloud Schematics workspaces in which the license is used will be impacted.