This is the documentation for Cloudera Manager 5.0.0.
Documentation for other versions is available at Cloudera Documentation.

Managing Licenses

When you install Cloudera Manager, you can choose to select Cloudera Express (no license required), a 60-day Cloudera Enterprise Data Hub Edition trial license, or Cloudera Enterprise (which requires a license). You can later end a trial license or upgrade your license.

Continue reading:

About Trial Licenses

You can use the trial license only once; once the 60-day trial period has expired or you have ended the trial, you cannot restart it.

When a trial ends, features that require a Cloudera Enterprise license immediately become unavailable. However, data or configurations associated with the disabled functions are not deleted, and become available again when you install a Cloudera Enterprise license. Trial expiration or termination has the following effects:
  • Only local users can log in (no LDAP or SAML authentication).
  • Configuration history is unavailable.
  • Alerts cannot be delivered as SNMP traps.
  • Operational reports are inaccessible (but remain in the database).
  • Commands such as Rolling Restart, History and Rollback (under the Configuration tab), Send Diagnostic Data, and starting Cloudera Navigator roles are disabled or not available.

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

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 displays.
    The following shortcuts for specifying host names 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. The Database Setup page displays.
  5. Configure settings for required databases:
    1. Choose the database type:
      • Leave the default setting of Use Embedded Database to have Cloudera Manager create and configure all required databases. Make a note of the auto-generated passwords.
      • Select Use Custom Databases to specify external databases. Enter the database host, database type, database name, username, and password for the databases that you created when you set up databases for Cloudera Manager.
    2. Click Test Connection to confirm that Cloudera Manager can communicate with the databases 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 databases and then try the test again. (For Hive, if you are using the embedded database, you will see a message saying the database will be created at a later point in the installation process.) The Review Changes page 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. For example, you might confirm the NameNode Data Directory and the DataNode Data Directory for HDFS. 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 and Starting 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. Navigate 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. Navigate 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 . 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 host names 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. The Database Setup page displays.
  9. Configure settings for required databases:
    1. Choose the database type:
      • Leave the default setting of Use Embedded Database to have Cloudera Manager create and configure all required databases. Make a note of the auto-generated passwords.
      • Select Use Custom Databases to specify external databases. Enter the database host, database type, database name, username, and password for the databases that you created when you set up databases for Cloudera Manager.
    2. Click Test Connection to confirm that Cloudera Manager can communicate with the databases 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 databases and then try the test again. (For Hive, if you are using the embedded database, you will see a message saying the database will be created at a later point in the installation process.) The Review Changes page 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. For example, you might confirm the NameNode Data Directory and the DataNode Data Directory for HDFS. 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 and Starting 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 and Starting Cloudera Navigator Roles.

Adding and Starting Cloudera Navigator Roles

  1. Do one of the following:
    • Select Clusters > Cloudera Management Services > mgmt.
    • On the Status tab of the Home page, in Cloudera Management Services table, click the mgmt link.
  2. Click the Instances tab and click the Add button. The Customize Role Assignments page displays.
  3. Customize the assignment of role instances to hosts. The wizard evaluates the hardware configurations of the hosts to determine the best hosts for each role. The wizard assigns all worker roles to the same set of hosts to which the HDFS DataNode role is assigned. These assignments are typically acceptable, but you can reassign services to hosts of your choosing, if desired.

    Click a field below a role to display a dialog containing a pageable list of hosts. If you click a field containing multiple hosts, you can also select All Hosts to assign the role to all hosts or Custom to display the pageable hosts dialog.

    The following shortcuts for specifying host names 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

    Click the View By Host button for an overview of the role assignment by host ranges.

  4. When you are satisfied with the assignments, click Continue. The Database Setup page displays.
  5. Configure settings for required databases:
    1. Choose the database type:
      • Leave the default setting of Use Embedded Database to have Cloudera Manager create and configure all required databases. Make a note of the auto-generated passwords.
      • Select Use Custom Databases to specify external databases. Enter the database host, database type, database name, username, and password for the databases that you created when you set up databases for Cloudera Manager.
    2. Click Test Connection to confirm that Cloudera Manager can communicate with the databases 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 databases and then try the test again. (For Hive, if you are using the embedded database, you will see a message saying the database will be created at a later point in the installation process.) The Review Changes page displays.
  6. Review and accept any configuration changes (typically there are none). Click Accept. This returns you to the Instances page.
  7. Check the checkboxes next to navigator and navigatormetaserver (Flex Edition or Data Hub Edition only) .
  8. Select Actions for Selected > Start and confirm Start in the pop-up.
  9. Click Close.