Custom Service Descriptors

A custom service descriptor (CSD) is a file that describes a product for use with Cloudera Manager. When a product is accompanied with a CSD, Cloudera Manager can support configuration, distribution, and monitoring of that product. See CSD Overview for an overview of CSDs.

Most products available via parcel are accompanied by a CSD. Starting in Director 2.4, you can point to CSDs that Cloudera Director should download and install into Cloudera Manager during the bootstrap process. Once a CSD is installed, its corresponding product distributed in a parcel can then be installed properly in clusters managed by Cloudera Manager.

To install a CSD into Cloudera Manager, provide a URL for it in the deployment template, in the csds section.
```
cloudera-manager {
 ...
 csds: [
    "http://archive.cloudera.com/spark2/csd/SPARK2_ON_YARN-2.0.0.cloudera2.jar",
    "http://archive.cloudera.com/kudu/csd/KUDU-5.10.0.jar",
  ]
}
```

During deployment bootstrap, Cloudera Director will download each CSD from its URL and install it into the correct location for Cloudera Manager to recognize it.

Custom CSD Installation Directory

You may define a non-default location for CSD installation using the csd_repo_path Cloudera Manager server configuration property.
```
...
cloudera-manager {
 ...
 configs {
 csd_repo_path: /custom/path/to/csds
 ...
 }
}
```

When this configuration property is specified in a deployment template, Cloudera Director installs CSD files into the custom location instead of the default location.

CSD Support Before Cloudera Director 2.4

The ability to define CSDs for installation in deployment templates is a new feature for Cloudera Director 2.4. For earlier versions of Cloudera Director, use a different mechanism to install CSD files for Cloudera Manager. Here are some options:
  • Use a deployment post-creation script to download CSDs to the newly allocated Cloudera Manager instance. See Deployment Post-creation Scripts for more information.
  • Use an image for the Cloudera Manager instance which already includes CSDs.

Installing CSDs after Deployment Bootstrap

You may install additional CSDs into Cloudera Manager after Cloudera Director has bootstrapped it. Cloudera Manager must be restarted for it to recognize the new CSDs. Future bootstraps of new clusters that use the updated Cloudera Manager installation may include the products corresponding to the CSDs, as if Cloudera Director itself had originally installed them.