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 new clusters, 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 contacts 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 to an existing cluster 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, select Use Parcels.
  3. 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 More Options.
    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 5.x Download Information to obtain the URL. For example: 
        https://username:password@archive.cloudera.com/p/cdh/parcels/5.16.2

      The available versions of CDH display.

    3. Select the version of CDH you want to install.
  4. In the Select the specific release of the Cloudera Manager Agent you want to install on your hosts. section, click Custom Repository.
  5. Enter the URL for the Cloudera Manager package repository. For example: 
    https://<username>:<password>@archive.cloudera.com/p/cm5/redhat/6/x86_64/cm/5.16.2.4505
  6. Enter the URL for the GPG signing key in the Custom GPG Key URL field.
    For example: 
    https://<username>:<password>@archive.cloudera.com/p/cm5/redhat/6/x86_64/cm/RPM-GPG-KEY-cloudera
  7. Continue with Add Hosts wizard to install the Cloudera Manager Agent, and, optionally the JDK.

Add hosts to an existing cluster 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, select Use Packages.
  3. 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 package repository.
    • If the cluster has access to the internet, enter the URL to the public Cloudera package 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/cm5/redhat/7/x86_64/cm/5.16.2/
  4. In the Select the specific release of the Cloudera Manager Agent you want to install on your hosts. section, click Custom Repository.
  5. Enter the URL for the Cloudera Manager package repository. For example: 
    https://<username>:<password>@archive.cloudera.com/p/cm5/redhat/6/x86_64/cm/5.16.2.4505
  6. Enter the URL for the GPG signing key in the Custom GPG Key URL field.
    For example: 
    https://<username>:<password>@archive.cloudera.com/p/cm5/redhat/6/x86_64/cm/RPM-GPG-KEY-cloudera
  7. Continue with Add Hosts 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. Select Use Parcels.

    The available versions of CDH display.

  3. 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 More Options.
    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 5.x Download Information to obtain the URL. For example: 
        https://username:password@archive.cloudera.com/p/cdh/parcels/5.16.2

      The available versions of CDH display.

    3. Select the version of CDH you want to install.
  4. In the Select the specific release of the Cloudera Manager Agent you want to install on your hosts. section, click Custom Repository.
  5. Enter the URL for the Cloudera Manager package repository. For example: 
    https://<username>:<password>@archive.cloudera.com/p/cm5/redhat/6/x86_64/cm/5.16.2.4505
  6. Enter the URL for the GPG signing key in the Custom GPG Key URL field.
    For example: 
    https://<username>:<password>@archive.cloudera.com/p/cm5/redhat/6/x86_64/cm/RPM-GPG-KEY-cloudera
  7. 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 Packages

  1. Follow the steps to add a cluster. See the following links:
  2. Select Use Packages.
  3. Select Custom Repository
  4. 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/cdh5/redhat/7/x86_64/cdh/5.16.2/
  5. In the Select the specific release of the Cloudera Manager Agent you want to install on your hosts. section, click Custom Repository.
  6. Enter the URL for the Cloudera Manager package repository. For example: 
    https://<username>:<password>@archive.cloudera.com/p/cm5/redhat/6/x86_64/cm/5.16.2.4505
  7. Enter the URL for the GPG signing key in the Custom GPG Key URL field.
    For example: 
    https://<username>:<password>@archive.cloudera.com/p/cm5/redhat/6/x86_64/cm/RPM-GPG-KEY-cloudera
  8. Continue with add cluster wizard to install the Cloudera Manager Agent, and, optionally the JDK.