As of DC/OS 1.12, deleting a node involves two steps: telling DC/OS to mark the node as
GONE, and stopping the corresponding Mesos slave systemd unit.
If your node has gone down in an unplanned way, you only have to Decommission the node.
Decommission the node
When Mesos detects that a node has stopped, it puts the node in the
UNREACHABLE state because Mesos does not know if the node is temporarily stopped and will come back online, or if it is permanently stopped. You can explicitly tell Mesos to put a node in the
GONE state if you know a node will not come back.
Once a node is decommissioned, the corresponding agent ID is marked as
GONE internally and not allowed to come back and re-register with the master. Any tasks running on the node are transitioned to
You should decommission nodes in the following situations.
You are deleting a node, especially if you are deleting multiple nodes. DC/OS is configured to only allow one node to be marked
UNREACHABLEevery 20 minutes, so if you do not explicity decommission nodes, it can take a long time for Mesos to mark your nodes as
UNREACHABLEand allow services to reschedule tasks on another node.
If you are working with stateful services, like the DC/OS data services. It is expensive for stateful services to reschedule tasks, so the services need to know that an agent is not going to come back online before they reschedule.
When a node has gone down in an unplanned way.
Enter the following command from the DC/OS CLI to identify the node that is to be decommissioned.
Enter the following command from the DC/OS CLI to tell Mesos to mark a node as
dcos node decommission <mesos-agent-id>
Once the node has been decommissioned (this is equivalent to using the
MARK_AGENT_GONE Mesos API), the node will be told to perform the following tasks:
- Shut down (kill) all executors (tasks) running on the agent node
- Stop the Mesos slave process (but it will get automatically re-started by systemd)
Shut down the node
If the DC/OS node is still running, the Mesos slave process will continue to try to register (and be disallowed, due to the agent being marked gone). You can stop these attempts by stopping the Mesos slave process, which is run as a
SSH to the agent node you wish to shut down.
Enter the following commands to stop the node.
- Private agent
sudo sh -c 'systemctl stop dcos-mesos-slave'
- Public agent
sudo sh -c 'systemctl stop dcos-mesos-slave-public'