Uninstall Portworx using a Nomad job

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 a 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:2.10.0"
        network_mode = "host"
        ipc_mode = "host"
        privileged = true
        args = [

        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

Delete the wiper job once completed:

nomad job stop px-node-wiper
nomad system gc

Last edited: Tuesday, May 9, 2023