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 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.

A Cloudera Enterprise license is required for the following features:
  • LDAP and SAML authentication
  • Configuration history
  • Alerts delivered as SNMP traps
  • Backup and disaster recovery
  • Operational reports
  • Cloudera Navigator
  • Commands such as Rolling Restart, History and Rollback, and Send Diagnostic Data
For details see Cloudera Express and Cloudera Enterprise Features.

Continue reading:

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.
  • Basic Edition - a cluster running core CDH services: HDFS, Hive, Hue, MapReduce, Oozie, Sqoop, YARN, and ZooKeeper.
  • Flex Edition - a cluster running core CDH services plus one of the following: Accumulo, HBase, Impala, Navigator, Solr, Spark.
  • Data Hub Edition - a cluster running core CDH services plus any of the following: Accumulo, HBase, Impala, Navigator, Solr, Spark.

License Expiration

When a Cloudera Enterprise license expires, the following occurs:
  • Cloudera 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.

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

To start a trial, on the License page, click Try Cloudera Enterprise Data Hub Edition for 60 Days.
  1. Cloudera Manager displays a pop-up describing the features enabled with Cloudera 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 satisfied with the assignments, click Continue.
  5. Configure database settings:
    1. 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 external databases.
        1. Enter the database host, database type, database name, username, and password for the database that you created when you set up the database.
      • If you are adding the Oozie service, you can change your Oozie configuration to control when data is purged in order to improve performance, cut down on 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.
    2. 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 Review Changes screen displays.
  6. 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. Click Continue. The wizard starts the services.
  7. At this point, your installation is upgraded. Click Continue.
  8. 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 documentation.

Upgrading from a Cloudera 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 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 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. Configure database settings:
    1. 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 external databases.
        1. Enter the database host, database type, database name, username, and password for the database that you created when you set up the database.
      • If you are adding the Oozie service, you can change your Oozie configuration to control when data is purged in order to improve performance, cut down on 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.
    2. 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 Review Changes screen displays.
  10. 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. Click Continue. The wizard starts the services.
  11. At this point, your installation is upgraded. Click Continue.
  12. 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 documentation.

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.

You do not need to restart Cloudera Manager for the new license to take effect.