Cloudera Machine Learning Command Line Reference

This topic describes the commands available to the cdsw command line utility that exists within a Cloudera Machine Learning workspace. This utility is meant to manage your Cloudera Machine Learning workspace. Running cdsw without any arguments will print a brief description of each command.

In addition, there is a cdswctl CLI client that offers different functionality that is meant for use by data scientists to manage their sessions. For information about that, see cdswctl Command Line Interface Client.
Command Description and Usage
cdsw start

Initializes and bootstraps the master host. Use this command to start Cloudera Machine Learning.

cdsw stop

De-registers, resets, and stops a host.

On a worker host, this command will remove the worker from the cluster.

On the master host, this command will bring down the application and effectively tear down the Cloudera Machine Learning deployment.

cdsw restart

Run on the master host to restart application components.

To restart a worker host, use cdsw stop, followed by cdsw join. These commands have been explained further in this topic.

cdsw join

Initializes a worker host. After a worker host has been added, run this command on the worker host to add it to the Cloudera Machine Learning cluster.

This registers the worker hosts with the master, and increases the available pool of resources for workloads.

cdsw status

Displays the current status of the application.

Starting with version 1.4, you can use cdsw status -v or cdsw status --verbose for more detailed output.

The cdsw status command is not supported on worker hosts.

cdsw validate

Performs diagnostic checks for common errors that might be preventing the application from running as expected.

This command should typically be run as the first step to troubleshooting any problems with the application, as indicated by cdsw status.

cdsw logs

Creates a tarball with diagnostic information for your Cloudera Machine Learning installation.

If you file a case with Cloudera Support, run this command on each host and attach the resulting bundle to the case.

cdsw version

Displays the version number and type of Cloudera Machine Learning deployment (RPM or CSD).

cdsw help

Displays the inline help options for the Cloudera Machine Learning CLI.