Upgrading Cloudera Data Science Workbench 1.7.2 or higher from CDH 6 to CDP Private Cloud Base 7.x

The following general outline describes how to upgrade your Cloudera Data Science Workbench cluster from CDH 6 to CDP Private Cloud Base. Refer to the relevant linked Cloudera Manager and CDH upgrade documentation for detailed steps required for this procedure.

  1. Before upgrading to 1.8, if you are using LDAPs, make sure the certificate uses a key of at least 2048 bits.
    If CDSW is configured to talk to an LDAP server for authentication, and that LDAP connection is over https, and the certificate uses a 1024 bit RSA key, connection attempts will fail and no one will be able to log in.
  2. Migrate CDSW from RPM to CSD: see the instructions to migrate to CDP files.
  3. Download the correct CDSW CSD files for CDP Private Cloud Base.
    The correct CSD file names are:
    • For CDH 6: CLOUDERA_DATA_SCIENCE_WORKBENCH_CDH6_1.x.y.jar
    • For CDP Private Cloud Base: CLOUDERA_DATA_SCIENCE_WORKBENCH_CDPDC_1.x.y.jar
  4. Upgrade cluster from CDH 6 to CDP Private Cloud Base 7.x:
    1. Stop Cloudera Data Science Workbench.
    2. Log on to the Cloudera Manager Server host.
    3. Place the CSD files in /opt/cloudera/csd.
      This is the default location for CSD files.
    4. Restart Cloudera Manager Server.
    5. Upgrade to Cloudera Data Science Workbench 1.7.2 (or higher). During the upgrade process, as you install, distribute, and activate the new parcel, take care to ensure that both CDSW CSD files (for CDH 6 and CDP Private Cloud Base) are present on the Cloudera Manager Server host.
    6. Upgrade CDP Private Cloud Base based on the CDP Private Cloud Base upgrade documentation.
    7. Remove any existing CDH 6 CSDs from the Cloudera Manager Server host. This step is optional.
    8. Restart Cloudera Data Science Workbench.