22.5 Canceling a service
Context
A few methods exist to delete a service in Moab. If the service is a VM, you can use the mvmctl -d command and cancel any attached services (such as storage) by running canceljob on those services' tracking jobs.
For any service, you can destroy the contained objects and delete the service container using mvcctl -d as documented in the steps below, or you can delete each component of the service individually by running canceljob on the tracking jobs.
Do not remove out-of-band VMs by deleting the placeholder reservation that Moab creates to track its resources. Instead, verify that your resource manager no longer reports the VM, then run mvmctl -d.
To cancel a service
- When creating the service workflow, include a destroy job that will delete the service (all VMs, storage, etc.) when the main job is canceled.
- Set the DestroyObjects flag on the service's main VC.
- Run mvcctl -d on the VC. The DestroyObjects flag causes Moab to tear down the entire service, using destroy template jobs where they exist.
- Alternately, rather than doing steps 2-3, you can run canceljob on the select job of each workflow to delete the service. This will retain the main job while the destroy job runs. Once the destroy job completes successfully, the main job or VM-tracking job will cancel.
> mvcctl -m flags+=DestroyObjects vc1
> mvcctl -d vc1
vc1 and all of its objects are destroyed.
mvmctl -d will also destroy the VM; however, Moab does not automatically delete attached resource workflows, like storage mounts. You must use canceljob on the select (tracking) job of each attached workflow to destroy the whole service.