NVIDIA UFM Enterprise User Manual v6.18.0
NVIDIA UFM Enterprise User Manual v6.18.0

UFM Plugins

UFM plugin management can be done either via the manage_ufm_plugins.sh script or via the Web UI.

UFM Plugin Management Using themanage_ufm_plugins.sh Script

The manage_ufm_plugins.sh script, located in the /opt/ufm/scripts directory, is designed to manage UFM plugins through the command line interface.

To see the actions supported by this script, run:

Copy
Copied!
            

/manage_ufm_plugins.sh  --help usage: manage_ufm_plugins.sh <command> [<args>] positional arguments: {show,get-all,enable,start,stop,disable,add,upgrade,remove_image,remove,is-running,is-enable,get-http-proxy-port,debug,deploy,deploy-bundle}                        Commands    show                Show plugins info    get-all             get all loaded plugins    enable              Enable plugin    start               Start plugins    stop                Stop all plugins    disable             Disable plugin    add                 Add plugin    upgrade             Upgrade plugin    remove_image        Remove plugin`s image    remove              Remove plugin    is-running          Test plugin is running    is-enable           Test plugin is enabled    get-http-proxy-port                        Get plugin HTTP proxy port    debug               Debug    deploy              Deploy plugin image    deploy-bundle       Deploy bundle of plugins

Optional Arguments:

Copy
Copied!
            

-h, --help            show this help message and exit -v, --version         Print version information

Each supported option has its own help flag, which can be received by requesting help for a specific parameter. For example:

Copy
Copied!
            

./manage_ufm_plugins.sh  add --help

Usage:

Copy
Copied!
            

manage_ufm_plugins.pyc <command> [<args>] add [-h] -p <[A-Za-z0-9_-] Name size: 32> [-t <[A-Za-z0-9._-] Name size: 128>]

Optional Arguments:

Copy
Copied!
            

-h, --help            show this help message and exit   -p <[A-Za-z0-9_-] Name size: 32>, --plugin-name <[A-Za-z0-9_-] Name size: 32>                        Plugin name   -t <[A-Za-z0-9._-] Name size: 128>, --plugin-tag <[A-Za-z0-9._-] Name size: 128>                    Plugin tag

The following table lists the supported commands and provides their description and information on the parameters.

Command

Description

Parameters

show

Shows information about running plugins

N/A

get-all

Gets information about deployed plugins in JSON format

N/A

enable

Enables plugin

Loaded Parameter: plugin image name

start

Starts UFM plugin

Loaded Parameter: plugin name

stop

Stops UFM plugin

Loaded Parameter: plugin name

disable

Disables UFM plugin

Loaded Parameter: plugin name

add

Adds UFM plugin

Loaded Parameter: image name

upgrade

Upgrades UFM plugin

Loaded Parameter: plugin name

remove_image

Removes UFM plugin’s image

Loaded Parameter: plugin image name

remove

Removes UFM plugin

Loaded Parameter: plugin name

is-running

Tests plugin is running

Loaded Parameter: plugin name

is-enable

Tests plugin is enabled

Loaded Parameter: plugin name

get-http-proxy-port

Gets plugin HTTP proxy port

Loaded Parameter: plugin name

deploy

Deploys plugin image

Loaded Parameter: -f flag with path to UFM plugin image

deploy-bundle

Deploys bundle of plugins

Loaded Parameter: -f flag with path to tarball file, that will contain number of UFM plugins. All the plugin images from the tar ball will be deployed to UFM. Operation could take some time. The progress of the plugin images from the tar file deployment will be printed to terminal, including error messages, if exists.


© Copyright 2024, NVIDIA. Last updated on Aug 19, 2024.