Updating an existing CDH/Cloudera Manager deployment to access downloads with authentication

Access to Cloudera Manager binaries for production purposes requires authentication. To access the binaries at the locations below, you must first have an active subscription agreement and obtain a license key file along with the required authentication credentials (username and password).

If your deployment was not installed using authenticated downloads and if you need to add hosts to an existing cluster or add a new cluster, you must follow the steps in this topic to configure your deployment to access the downloads.

Note that as of February 1, 2021, the download URLs on archive.cloudera.comhave changed. They are the same as the previous URLs, except that /p is added to the URL, after archive.cloudera.com. Depending on where you use the URL, you may also need to prepend your credentials to the URL. The instructions below contain that information. For example: 
https://username:password@archive.cloudera.com/p/...
For a complete list of download URLs, see:
Add hosts to an existing cluster
See
Add a new cluster
If you are adding a CDH cluster that is the same version of CDH as another cluster managed by the same instance of Cloudera Manager, no further action is required. To add a new cluster with a different supported version of CDH, see
New Installations
You must use the new URLs and include your username and password to access downloads for a new installation. See Cloudera Installation Guide.
Upgrades
You must use the new URLs and include your username and password to access downloads for the upgrade. See the Cloudera Enterprise Upgrade Guide.

If your deployment was installed or upgraded using authenticated downloads, no further action is needed.

Obtain Credentials

The license key file and authentication credentials are provided in an email sent to customer accounts from Cloudera when a new license is issued. If you have an existing license with a CDP Private Cloud Base Edition entitlement, you might not have received an email. In this instance you can identify the authentication credentials from the license key file. If you do not have access to the license key, contact your account representative to receive a copy.

The license key file and authentication credentials are provided in an email sent to customer accounts from Cloudera when a new license is issued. If you have an existing license with a Cloudera Enterprise entitlement, you might not have received an email. In this instance you can identify the authentication credentials from the license key file. If you do not have access to the license key, contact your account representative to receive a copy.

To identify your authentication credentials using your license key file, complete the following steps:

  1. From cloudera.com, log into the cloudera.com account associated with the Cloudera Enterprise license and subscription agreement.
  2. On the Cloudera CDH Download page, select the version that you want to install and click Get It Now!.
  3. Scroll down to the Credentials Generator at the bottom of the page.
  4. In the Generate Credentials text box, copy and paste the text of the “PGP Signed Message” within your license key file and click Get Credentials. The credentials generator returns your username and password.

When you obtain your authentication credentials, use them to form the URLs below, where you can access the Cloudera repositories in the Cloudera Archive.

Prepare your deployment

There are two options for access to the downloads:

Add hosts managed by Cloudera Manager using parcels

  1. Follow the steps to add hosts using the Add Host Wizard. See the following links:
  2. When you get to the Select Repository page, in the Cloudera Manager Agent section, select Custom Repository and enter one of the following:
    • If you have downloaded the repository and set up a local repository server, enter URL for the local repository.
    • If the cluster has access to the internet, enter the URL to the public Cloudera repository on archive.cloudera.com. See Cloudera Manager Version and Download Information to obtain the URL.
      For example: 
      https://username:password@archive.cloudera.com/p/cm6/6.2.1.4505/redhat7/yum/
  3. Continue with add cluster wizard to install the Cloudera Manager Agent, and, optionally the JDK.

Add hosts managed by Cloudera Manager using packages

  1. Follow the steps to add hosts using the Add Host Wizard. See the following links:
  2. When you get to the Select Repository page, in the Cloudera Manager Agent section, select Custom Repository and enter one of the following:
    • If you have downloaded the repository and set up a local repository server, enter URL for the local repository.
    • If the cluster has access to the internet, enter the URL to the public Cloudera repository on archive.cloudera.com. See Cloudera Manager Version and Download Information to obtain the URL.
      For example: 
      https://username:password@archive.cloudera.com/p/cm6/6.2.1.4505/redhat7/yum/
  3. In thew CDH and other software section, select Use Packages.

    The available versions of CDH display. Do not select any of these.

  4. Select Custom Repository.
  5. Enter the custom repository URL.
    • If you have downloaded the package repository and have set up a local repository server, enter URL for the local repository.
    • If the cluster has access to the internet, enter the URL to the public Cloudera package repository on archive.cloudera.com. See CDH Download Information to obtain the URL.
      For example: 
      https://username:password@archive.cloudera.com/p/cdh6/6.2.1/redhat7/yum/
  6. In the Select the specific release of the Cloudera Manager Agent you want to install on your hosts. section, click Custom Repository.
  7. Enter the URL for the Cloudera Manager package repository. For example: 
    https://username:password@archive.cloudera.com/p/cm6/6.2.1.4505/redhat7/yum/
  8. Continue with add cluster wizard to install the Cloudera Manager Agent, and, optionally the JDK.

Adding a Cluster to an existing Cloudera Manager deployment using Parcels

  1. Follow the steps to add a cluster. See the following links:
  2. When you get to the Select Repository page, In the Cloudera Manager Agent section, select Custom Repository.
  3. Enter the URL for the Cloudera Manager package repository. For example: 
    https://username:password@archive.cloudera.com/p/cm6/6.2.1.4505/redhat7/yum/
  4. In thew CDH and other software section, select Use Parcels.

    The available versions of CDH display.

  5. Select the version of CDH that you want to install. If you want to use a version of CDH that is not displayed:
    1. Click Parcel Repositories & Network Settings.
    2. In the Remote Parcel Repository URLs section, click the + icon do one of the following:
      • If you have downloaded the parcel repository and have set up a local repository server, enter the URL for the local repository.
      • If the cluster has access to the internet, enter the URL to the public repository on archive.cloudera.com See CDH 6.x Download Information to obtain the URL. For example: 
        https://username:password@archive.cloudera.com/p/archive.cloudera.com/p/cdh6/6.2.1/parcels/

      The available versions of CDH display.

    3. Select the version of CDH you want to install.
  6. Click Continue and follow the remaining steps in the add cluster wizard to install the Cloudera Manager Agent, and, optionally the JDK.

Adding a Cluster to an existing Cloudera Manager deployment using Packages

  1. Follow the steps to add a cluster. See the following links:
  2. When you get to the Select Repository page, In the Cloudera Manager Agent section, select Custom Repository.
  3. Enter the URL for the Cloudera Manager package repository. For example: 
    https://username:password@archive.cloudera.com/p/cm6/6.2.1.4505/redhat7/yum/
  4. In thew CDH and other software section, select Use Packages.

    The available versions of CDH display. Do not select any of these.

  5. Select Custom Repository.
  6. Enter the custom repository URL.
    • If you have downloaded the package repository and have set up a local repository server, enter URL for the local repository.
    • If the cluster has access to the internet, enter the URL to the public Cloudera package repository on archive.cloudera.com. See CDH Download Information to obtain the URL.
      For example: 
      https://username:password@archive.cloudera.com/p/cdh6/6.2.1/redhat7/yum/
  7. Continue with add cluster wizard to install the Cloudera Manager Agent, and, optionally the JDK.