Managing Trident

Installing Trident

Follow the extensive deployment guide.

Updating Trident

The plugin is not in the data path, therefore you can safely upgrade it without any impact to volumes that are in use. As with any plugin, 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.

  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.04
    

    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
    

    Note

    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, see 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
    

Uninstalling Trident

  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
    

Note

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, see 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