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 Altus 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: [
    "https://archive.cloudera.com/spark2/csd/SPARK2_ON_YARN-2.0.0.cloudera2.jar",
    "https://archive.cloudera.com/kudu/csd/KUDU-5.10.0.jar",
  ]
}
```

During deployment bootstrap, Altus 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 can 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, Altus Director installs CSD files into the custom location instead of the default location.

CSD Support Before Altus Director 2.4

The ability to define CSDs for installation in deployment templates is a new feature for Altus Director 2.4. For earlier versions of Altus 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 can install additional CSDs into Cloudera Manager after Altus 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 can include the products corresponding to the CSDs, as if Altus Director itself had originally installed them.