Uninstall Portworx using a Nomad job

This document presents the Nomad method of uninstalling a Portworx cluster. Please refer to the Uninstall on Kubernetes page if you are running Portworx on Kubernetes.

There are two steps to completely uninstall Portworx from Nomad:

  • Remove the Nomad Portworx job
  • Run the px-node-wiper Nomad batch job to uninstall Portworx binaries from Nomad client nodes

Remove Nomad portworx job

To remove the Portworx job, run the following command:

nomad job stop -purge portworx

Delete/wipe Portworx cluster

The commands used in this section are DISRUPTIVE and will lead to the loss of all your data volumes. Proceed with CAUTION.

Save the Nomad batch job in a file called px-node-wiper.nomad:

job "px-node-wiper" {
  type        = "batch"
  datacenters = ["dc1"]

  group "px-node-wiper" {
    count = 3

    constraint {
      operator  = "distinct_hosts"
      value     = "true"

    task "px-node-wiper" {
      driver = "docker"
      kill_timeout = "120s"   # allow portworx 2 min to gracefully shut down
      kill_signal = "SIGTERM" # use SIGTERM to shut down the nodes

      # container config
      config {
        image        = "portworx/px-node-wiper:"
        network_mode = "host"
        ipc_mode = "host"
        privileged = true

        volumes = [

      # resource config
      resources {
        cpu    = 1024
        memory = 2048

You will have to make changes to this file to match your portworx.nomad file, i.e., update datacenter, count and constraints.

Then, run the following command:

nomad run px-node-wiper.nomad

Wait for all instances to complete:

nomad status px-node-wiper
ID            = px-node-wiper
Name          = px-node-wiper
Submit Date   = 2019-05-08T01:17:53Z
Type          = batch
Priority      = 50
Datacenters   = dc1
Status        = dead
Periodic      = false
Parameterized = false

Task Group     Queued  Starting  Running  Failed  Complete  Lost
px-node-wiper  0       0         0        0       3         0

ID        Node ID   Task Group     Version  Desired  Status    Created  Modified
145b8fda  e074a6b0  px-node-wiper  0        run      complete  57s ago  34s ago
4b9f527f  6138409d  px-node-wiper  0        run      complete  57s ago  33s ago
d4ca97ae  2299a3b6  px-node-wiper  0        run      complete  57s ago  33s ago

Last edited: Wednesday, Apr 8, 2020