Skip to main content

Upgrade or uninstall Trident

Contributors netapp-aruldeepa juliantap
PDFs

You can safely upgrade Trident for Docker without any impact to volumes that are in use. During the upgrade process there will be a brief period where docker volume commands directed at the plugin will not succeed, and applications will be unable to mount volumes until the plugin is running again. Under most circumstances, this is a matter of seconds.

Upgrade

Perform the steps below to upgrade Trident for Docker.

Steps

  1. List the existing volumes:

    docker volume ls
DRIVER              VOLUME NAME
netapp:latest       my_volume

  2. Disable the plugin:

    docker plugin disable -f netapp:latest
docker plugin ls
ID                  NAME                DESCRIPTION                          ENABLED
7067f39a5df5        netapp:latest       nDVP - NetApp Docker Volume Plugin   false

  3. Upgrade the plugin:

    docker plugin upgrade --skip-remote-check --grant-all-permissions netapp:latest netapp/trident-plugin:21.07
    Note The 18.01 release of Trident replaces the nDVP. You should upgrade directly from the netapp/ndvp-plugin image to the netapp/trident-plugin image.

  4. Enable the plugin:

    docker plugin enable netapp:latest

  5. Verify that the plugin is enabled:

    docker plugin ls
ID                  NAME                DESCRIPTION                             ENABLED
7067f39a5df5        netapp:latest       Trident - NetApp Docker Volume Plugin   true

  6. Verify that the volumes are visible:

    docker volume ls
DRIVER              VOLUME NAME
netapp:latest       my_volume
Important If you are upgrading from an old version of Trident (pre-20.10) to Trident 20.10 or later, you might run into an error. For more information, refer to Known Issues. If you run into the error, you should first disable the plugin, then remove the plugin, and then install the required Trident version by passing an extra config parameter: docker plugin install netapp/trident-plugin:20.10 --alias netapp --grant-all-permissions config=config.json

Uninstall

Perform the steps below to uninstall Trident for Docker.

Steps

  1. Remove any volumes that the plugin created.

  2. Disable the plugin:

    docker plugin disable netapp:latest
docker plugin ls
ID                  NAME                DESCRIPTION                          ENABLED
7067f39a5df5        netapp:latest       nDVP - NetApp Docker Volume Plugin   false

  3. Remove the plugin:

    docker plugin rm netapp:latest