Starting, Stopping, and Restarting Cloudera Manager Agents

Starting Agents

To start Agents, the supervisord process, and all managed service processes, use one of the following commands:
  • Start
    sudo service cloudera-scm-agent start
  • Clean Start
    • RHEL-compatible 7 and higher:
      sudo service cloudera-scm-agent next_start_clean
      sudo service cloudera-scm-agent start
    • All other Linux distributions:
      sudo service cloudera-scm-agent clean_start
    The directory /var/run/cloudera-scm-agent is completely cleaned out; all files and subdirectories are removed, and then the start command is executed. /var/run/cloudera-scm-agent contains on-disk running Agent state. Some Agent state is left behind in /var/lib/cloudera-scm-agent, but you should not delete that. For further information, see Server and Client Configuration and Process Management.

Stopping and Restarting Agents

To stop or restart Agents while leaving the managed processes running, use one of the following commands:
  • Stop
    sudo service cloudera-scm-agent stop
  • Restart
    sudo service cloudera-scm-agent restart

Hard Stopping and Restarting Agents

To stop or restart Agents, the supervisord process, and all managed service processes, use one of the following commands:
  • Hard Stop
    • RHEL-compatible 7 and higher:
      sudo service cloudera-scm-agent next_stop_hard
      sudo service cloudera-scm-agent stop
    • All other Linux distributions:
      sudo service cloudera-scm-agent hard_stop
  • Hard Restart
    • RHEL-compatible 7 and higher:
      sudo service cloudera-scm-agent next_stop_hard
      sudo service cloudera-scm-agent restart
    • All other Linux distributions:
      sudo service cloudera-scm-agent hard_restart
    Hard restart is useful for the following situations:
    1. You are upgrading Cloudera Manager and the supervisord code has changed between your current version and the new one. To properly do this upgrade you need to restart supervisor too.
    2. supervisord freezes and needs to be restarted.
    3. You want to clear out all running state pertaining to Cloudera Manager and managed services.
  • Clean Restart
    • RHEL-compatible 7 and higher:
      sudo service cloudera-scm-agent next_start_clean
      sudo service cloudera-scm-agent restart
    • All other Linux distributions:
      sudo service cloudera-scm-agent clean_restart

      Runs hard_stop followed by clean_start.

Checking Agent Status

To check the status of the Agent process, use the command:
sudo service cloudera-scm-agent status