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 Enterprise Data Hub Edition 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, and the expiration date of the license, if there is one.

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

    A free and unlimited license that provides access to CDH, Cloudera's Apache Hadoop distribution and a subset of cluster management features available with Cloudera Manager. You can begin a trial or upgrade to Cloudera Enterprise with a Cloudera Express license.

  • Cloudera Enterprise
    Cloudera Enterprise is available on a subscription basis in five editions, each designed around how you use the platform:
    • Basic Edition provides superior support and advanced management for core Apache Hadoop.
    • Data Engineering Edition for programmatic data preparation and predictive modeling.
    • Operational Database Edition for online applications with real-time serving needs.
    • Analytic Database 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.

When a Cloudera Enterprise license expires, the following occurs:
  • Cloudera Enterprise Enterprise Data Hub Edition Trial - Enterprise features are no longer available.
  • Cloudera Enterprise - Cloudera Manager Admin Console displays a banner indicating license expiration. Contact Cloudera Support to receive an updated license. In the meanwhile, all enterprise features will continue to be available.

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 Enterprise Data Hub Edition 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 Enterprise Data Hub Edition Trial

To start a trial, on the License page, click Try Cloudera Enterprise Enterprise Data Hub Edition for 60 Days.
  1. Cloudera Manager displays a pop-up describing the features enabled with Cloudera Enterprise Enterprise Data Hub Edition. 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 Enterprise Data Hub Edition Trial to Cloudera Enterprise

  1. Purchase a Cloudera Enterprise license from Cloudera.
  2. On the License page, click Upload License.
  3. Click the document icon to the left of the Select a License File text field.
  4. Go 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 document icon to the left of the Select a License File text field.
  4. Go 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 Enterprise Data Hub Edition. 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.