Learn about License Manager, a free, opt-in service that allows you to bring your own licenses (BYOL) into Oracle Cloud Infrastructure.
Licenses are defined in terms of their requirements and entitlements, according to the metric the license is created for. License Manager helps you better understand your licensing needs, and eases making business decisions based on your licensing needs. After you have created your licenses, your licensing requirements are calculated every hour.
Use License Manager to perform the following tasks:
License Manager supports the following Oracle products and options:
To use Oracle Cloud Infrastructure, an administrator must be a member of a group granted security access in apolicy by a tenancy administrator. This access is required whether you're using the Console or the REST API with an SDK, CLI, or other tool. If you get a message that you don't have permission or are unauthorized, verify with the tenancy administrator what type of access you have and whichcompartment your access works in.
If you're new to policies, seeGetting Started with Policies andCommon Policies.
To use License Manager, the following policy statements are required:
ALLOW GROUP<Group Name> to Manage licensemanager-settings in tenancyALLOW GROUP<Group Name> to Manage licensemanager-record in tenancyEach service in Oracle Cloud Infrastructure integrates with IAM for authentication and authorization, for all interfaces (the Console, SDK or CLI, and REST API).
An administrator in an organization needs to set upgroups ,compartments , andpolicies that control which users can access which services, which resources, and the type of access. For example, the policies control who can create new users, create and manage the cloud network, create instances, create buckets, download objects, and so on. For more information, seeManaging Identity Domains. For specific details about writing policies for each of the different services, seePolicy Reference.
If you're a regular user (not an administrator) who needs to use the Oracle Cloud Infrastructure resources that the company owns, contact an administrator to set up a user ID for you. The administrator can confirm which compartment or compartments you can use.
The License ManagerOverview page provides an overall summary of your license activity. The page allows you to get quick insights into your most utilized licenses, Bring Your Own License (BYOL) resources needing the most licenses by OCPUs and ECPUs, an overall count of BYOL and license included resources, and licenses at or near expiration.
To view theOverview page and its details, open the navigation menu and selectGovernance & Administration. Under License Management, selectOverview. The License ManagerOverview page opens.
The top of the page has tiles to indicate the totals for the following:
Following the totals summary, theTop Utilized Product Licenses table displays the following:
TheTop BYOL resources by OCPUs table lists the following:
TheTop BYOL resources by ECPUs table lists the following:
Open the navigation menu and selectGovernance & Administration. UnderLicense Manager, selectProduct Licenses.
TheProduct Licenses page opens. Here you can view and manage license entitlements and requirements, in the metric a license was created for.
TheProduct Licenses page lists all product licenses in a table containing the following information:
You can view license entitlements and requirements, in the metric a license was created for, from theProduct Licenses page. Licenses that don't meet your licensing requirements have a status ofIssues Found.
If selectingPerpetual, specify theSupport Contract End Date.
If selectingTerm-Limited, specify both theLicense End Date and theSupport Contract End Date.
If selectingCount, specify a license quantity value in the field (default is 1).
UnderImage, selectChoose Image. TheBrowse All Images panel opens. TheImage Source field changes based on whether the license you are creating is anOracle orThird Party license.
When creating anOracle license,Oracle Images is selected and the list of available images is displayed. Choose from the list of BYOL Oracle enterprise images and solutions enabled for Oracle Cloud Infrastructure. For any image underImage Name, you can select the down arrow (
) to expand theImage Build details, and select the version number for the particular image. Only one image can be selected when creating the product license, but you can add more images after creation.
When creating a third-party license,Partner Images is selected and the list of available third-party partner images is displayed, in terms of theImage Name and thePublisher. Select the down arrow (
) to expand theImage Build details, and select the version number for the particular partner image. As with Oracle images, one image can be selected when creating the product license, but you can add more images after creation.
After choosing the image, select the option to indicate that you agree to the legal terms for the chosen image. SelectSelect Image.
You can import the following types of licenses:
See your support contract for any licensing details, and account for any usage outside of Oracle Cloud Infrastructure when entering quantities for Full Use licenses. You can import several files but they can only be imported one at a time.
To import Oracle product licenses:
bulkUploadTemplate.xlsx template is downloaded to your computer. The template file has the following fields:From theProduct Licenses page you can select the linked product license name, or selectView from the license's theActions menu, to open the details page of the license.
The license's details page contains the following information:
On a product license details page you can perform the following tasks:
TheConsumption table shows BYOL resource license requirements in the tenancy, allowing you to view the resources that are attributed to a license and their individual licensing requirements. Data is delayed by one hour. The table is organized in terms of the following:
The warning icon indicates that you might not have licenses created for mandatory options to meet the licensing needs of a specific resource, per the license portability rules. You can navigate directly to the resources shown in the list by selecting the direct link for each resource OCID shown in theConsumption table. As a result, you can make right-sizing changes as needed.
SelectDownload CSV to get a CSV version of the consumption information. The CSV file also has the same field listing as theConsumption table, including aMissing Licensing Requirements field. TheOCI Metric of Resource field in the CSV file also indicates whether the resource refers to OCPU or ECPU.
TheLicense Records table shows all the license records in a product license. FromLicense Records you can view all license record details, add more license records, and edit or delete license records. The table has the following fields:
From the record's theActions menu, selectAdd. TheAdd License Record panel opens.
You can add license records in the same manner as when you'readding a new product license. Optionally, add any tagging options, or selectAdd to add the record. A message is displayed that the new record was saved successfully, and theLicense Records table reloads to display the new record.
From the record's theActions menu, selectEdit. TheEdit License Record panel opens.
You can modify the same fields as when you'readding a new product license. Optionally, add any tagging options, or selectSave when finished editing. A message is displayed to indicate that you saved successfully and theLicense Records table reloads to display the updated record.
From the record's theActions menu, selectDelete.
Confirm the record deletion and selectDelete. TheLicense Records table reloads with the deleted record removed.
TheImages table shows the list of images associated with the product license. The table has the following fields:
From the record's theActions menu, selectAdd Image. TheBrowse All Images panel opens.
You can add images in the same manner as when you'readding a new product license. Agree to the legal terms and selectSelect Image when you're ready to add the new image.
A message is displayed that the new image was saved successfully, and the image appears in theImages table.
From the image's theActions menu, selectRemove from an image's theActions menu.
Confirm the image removal and selectRemove. TheImages table updates with the image removed.
The License ManagerNotifications page allows you to manage the list of email addresses that can be notified about expirations or subscription overages. Emails are sent on a weekly basis.
If there are items that require action, you receive an email that provides a License Manager summary. The email highlights the product licenses that are over-subscribed, and license records near or past their license or support contract expiration dates.
To manage notifications, open the navigation menu and selectGovernance & Administration. UnderLicense Management, selectNotifications. The License ManagerNotifications page opens.
In theEmail Recipients field, enter one or more email addresses to receive alert notifications. You can include several addresses by separating them using commas, spaces, tabs, or newlines.
SelectSave. A message is displayed to indicate that the email addresses were saved successfully.
To manage bulk uploads:
To manage compartment configuration:
To manage license metrics:
To manage product licenses:
To manage license records:
To manage top utilized product licenses and resources:
For information about using the API and signing requests, seeREST API documentation andSecurity Credentials. For information about SDKs, seeSDKs and the CLI.
Use the following in theLicense Manager API for license management.
To manage bulk uploads:
To manage compartment configuration:
To manage license metrics:
To manage product licenses:
To manage license records:
To manage top utilized product licenses and resources: