Managing Licenses

Minimum Required Role: Full Administrator

When you install Cloudera Manager, you can select among the following editions: Cloudera Express (no license required), a 60-day Cloudera Enterprise Cloudera Enterprise trial license, or Cloudera Enterprise (which requires a license). To obtain a Cloudera Enterprise license, fill in this form or call 866-843-7207.

Accessing the License Page

To access the license page, select Administration > License.

If you have a license installed, the license page indicates its status (for example, whether your license is currently valid) and displays the license details: the license owner, the license key, the license start date, the expiration date, and the deactivation date. Typically the expiration date is the same as the deactivation date, when enterprise features will be disabled.

If you have obtained a license key with a future start date, you can install Cloudera Manager in advance of the start date. Before the license start date, Cloudera Manager will operate with the same functionality as Cloudera Express. On the start date, the enterprise features are enabled.

At the right side of the page a table shows the usage of licensed components based on the number of hosts with those products installed. You can move the cursor over the to see an explanation of each item.

Cloudera offers the following two types of licenses:
  • Cloudera Express

    Cloudera Express includes a free license that provides access to CDH, Cloudera's Apache Hadoop distribution, and a subset of cluster management features available with Cloudera Manager, for up to 100 total CDH hosts.

    Note the following:
    • Cloudera Manager will not allow you to add hosts to a CDH 6.x cluster if the total number of hosts across all CDH 6.x clusters will exceed 100.
    • Cloudera Manager will not allow you to upgrade any cluster to CDH 6.x if the total number of managed CDH6.x cluster hosts will exceed 100. If an upgrade from Cloudera Manager 6.0 to 6.1 fails due to this limitation, you must downgrade Cloudera Manager to version 6.0, remove some hosts so that the number of hosts is less than 100, then retry the upgrade.
  • Cloudera Enterprise
    Cloudera Enterprise is available on a subscription basis in five editions, each designed around how you use the platform:
    • Essentials Edition provides superior support and advanced management for core Apache Hadoop.
    • Data Science and Engineering Edition for programmatic data preparation and predictive modeling.
    • Operational Database Edition for online applications with real-time serving needs.
    • Data Warehouse Edition for BI and SQL analytics.
    • Enterprise Data Hub Edition provides for complete use of the platform.
    All editions are available in your environment of choice: cloud, on-premise, or a hybrid deployment. For more information, see the Cloudera Enterprise Data Sheet.

License Expiration

Before a license expires, the Cloudera Manager Admin Console displays a message that indicates the number of days left on a license, starting at 60 days before expiration and counting down to 30, 14, and 0 days. Contact Cloudera Support before expiration to receive an updated license.

When a Cloudera Enterprise license expires, the following occurs:
  • Cloudera Enterprise Cloudera Enterprise Trial - Enterprise features are disabled.
  • Cloudera Enterprise - All services will continue to run as-is. The Cloudera Manager Admin Console will be disabled, meaning that you will not be able to view or modify clusters. Key Trustee KMS and the Key Trustee server will continue to function on the cluster, but you cannot change any configurations or add any services. On license expiration, the only action you can take in the Cloudera Manager Admin Console is to upload a new, valid license.

Trial Licenses

You can use a trial license only once; when the 60-day trial period expires or you have ended the trial, you cannot restart the trial. With the trial license, you can upgrade to a Cloudera Enterprise license or downgrade to an express license.

When a trial ends, enterprise features immediately become unavailable. However, data or configurations associated with the disabled functions are not deleted, and become available again once you install a Cloudera Enterprise license.

Ending a Cloudera Enterprise Cloudera Enterprise Trial

If you are using the trial edition the License page indicates when your license will expire. However, you can end the trial at any time (prior to expiration) as follows:
  1. On the License page, click End Trial.
  2. Confirm that you want to end the trial.
  3. Restart the Cloudera Management Service, HBase, HDFS, and Hive services to pick up configuration changes.

Upgrading from Cloudera Express to a Cloudera Enterprise Cloudera Enterprise Trial

To start a trial, on the License page, click Try Cloudera Enterprise Cloudera Enterprise for 60 Days.
  1. Cloudera Manager displays a pop-up describing the features enabled with Cloudera Enterprise Cloudera Enterprise. Click OK to proceed. At this point, your installation is upgraded and the Customize Role Assignments page displays.
  2. Under Reports Manager click Select a host. The pageable host selection dialog box displays.
    The following shortcuts for specifying hostname patterns are supported:
    • Range of hostnames (without the domain portion)
      Range Definition Matching Hosts
      10.1.1.[1-4] 10.1.1.1, 10.1.1.2, 10.1.1.3, 10.1.1.4
      host[1-3].company.com host1.company.com, host2.company.com, host3.company.com
      host[07-10].company.com host07.company.com, host08.company.com, host09.company.com, host10.company.com
    • IP addresses
    • Rack name
  3. Select a host and click OK.
  4. When you are finished with the assignments, click Continue.
  5. Choose the database type:
    • Keep the default setting of Use Embedded Database to have Cloudera Manager create and configure required databases. Record the auto-generated passwords.

    • Select Use Custom Databases to specify the external database host and enter the database type, database name, username, and password for the custom database.
    • If you are adding the Oozie service, you can change your Oozie configuration to control when data is purged to improve performance, reduce database disk usage, improve upgrade performance, or to keep the history for a longer period of time. See Configuring Oozie Data Purge Settings Using Cloudera Manager.
  6. Click Test Connection to confirm that Cloudera Manager can communicate with the database using the information you have supplied. If the test succeeds in all cases, click Continue; otherwise, check and correct the information you have provided for the database and then try the test again. (For some servers, if you are using the embedded database, you will see a message saying the database will be created at a later step in the installation process.)

    The Cluster Setup Review Changes screen displays.

  7. Review the configuration changes to be applied. Confirm the settings entered for file system paths. The file paths required vary based on the services to be installed. If you chose to add the Sqoop service, indicate whether to use the default Derby database or the embedded PostgreSQL database. If the latter, type the database name, host, and user credentials that you specified when you created the database.
  8. At this point, your installation is upgraded. Click Continue.
  9. Restart Cloudera Management Services and audited services to pick up configuration changes. The audited services will write audit events to a log file, but the events are not transferred to the Cloudera Navigator Audit Server until you add and start the Cloudera Navigator Audit Server role as described in Adding Cloudera Navigator Roles. For information on Cloudera Navigator, see Cloudera Navigator Data Management Overview.

Upgrading from a Cloudera Enterprise Cloudera Enterprise Trial to Cloudera Enterprise

  1. Purchase a Cloudera Enterprise license from Cloudera.
  2. On the License page, click Upload License.
  3. Click the Select License File field.
  4. Browse to the location of your license file, click the file, and click Open.
  5. Click Upload.

Upgrading from Cloudera Express to Cloudera Enterprise

  1. Purchase a Cloudera Enterprise license from Cloudera.
  2. On the License page, click Upload License.
  3. Click the Select License File field.
  4. Browse to the location of your license file, click the file, and click Open.
  5. Click Upload.
  6. Cloudera Manager displays a pop-up describing the features enabled with Cloudera Enterprise Cloudera Enterprise. Click OK to proceed. At this point, your installation is upgraded and the Customize Role Assignments page displays.
  7. Under Reports Manager click Select a host. The pageable host selection dialog box displays.
    The following shortcuts for specifying hostname patterns are supported:
    • Range of hostnames (without the domain portion)
      Range Definition Matching Hosts
      10.1.1.[1-4] 10.1.1.1, 10.1.1.2, 10.1.1.3, 10.1.1.4
      host[1-3].company.com host1.company.com, host2.company.com, host3.company.com
      host[07-10].company.com host07.company.com, host08.company.com, host09.company.com, host10.company.com
    • IP addresses
    • Rack name
  8. When you are satisfied with the assignments, click Continue.
  9. Choose the database type:
    • Keep the default setting of Use Embedded Database to have Cloudera Manager create and configure required databases. Record the auto-generated passwords.

    • Select Use Custom Databases to specify the external database host and enter the database type, database name, username, and password for the custom database.
    • If you are adding the Oozie service, you can change your Oozie configuration to control when data is purged to improve performance, reduce database disk usage, improve upgrade performance, or to keep the history for a longer period of time. See Configuring Oozie Data Purge Settings Using Cloudera Manager.
  10. Click Test Connection to confirm that Cloudera Manager can communicate with the database using the information you have supplied. If the test succeeds in all cases, click Continue; otherwise, check and correct the information you have provided for the database and then try the test again. (For some servers, if you are using the embedded database, you will see a message saying the database will be created at a later step in the installation process.)

    The Cluster Setup Review Changes screen displays.

  11. Review the configuration changes to be applied. Confirm the settings entered for file system paths. The file paths required vary based on the services to be installed. If you chose to add the Sqoop service, indicate whether to use the default Derby database or the embedded PostgreSQL database. If the latter, type the database name, host, and user credentials that you specified when you created the database.
  12. At this point, your installation is upgraded. Click Continue.
  13. Restart Cloudera Management Services and audited services to pick up configuration changes. The audited services will write audit events to a log file, but the events are not transferred to the Cloudera Navigator Audit Server until you add and start the Cloudera Navigator Audit Server role as described in Adding Cloudera Navigator Roles. For information on Cloudera Navigator, see Cloudera Navigator Data Management Overview.

If you want to use the Cloudera Navigator Metadata Server, add its role following the instructions in Adding Cloudera Navigator Roles.

Renewing a License

  1. Download the license file and save it locally.
  2. In Cloudera Manager, go to the Home page.
  3. Select Administration > License.
  4. Click Upload License.
  5. Browse to the license file you downloaded.
  6. Click Upload.

Cloudera Manager requires a restart for the new license to take effect.