System Management

interface <eno8303 | eno8403 | eno12399np0 | eno12409np1 | ib0 | ib1 | ib2 | ib3>

Enters a network interface context.

Syntax Description

eno8303

Management port 0 (out of band)

eno8403

Management port 1 (out of band)

eno12399np0

Management port 2 (out of band)

eno12409np1

Management port 3 (out of band)

ib0

InfiniBand interface 0

ib1

InfiniBand interface 1

ib2

InfiniBand interface 2 (UFM 3.0 only)

Sib3

InfiniBand interface 3 (UFM 3.0 only)

Default

N/A

Configuration Mode

config

History

1.3.0

Example

Related Commands

N/A

Notes

N/A

show interfaces [eno8303 | eno8403 | eno12399np0 | eno12409np1 | ib0 | ib1 | ib2 | ib3]

Displays information about the network interfaces.

Syntax Description

eno8303

Management port 0 (out of band)

eno8403

Management port 1 (out of band)

eno12399np0

Management port 2 (out of band)

eno12409np1

Management port 3 (out of band)

ib0

InfiniBand interface 0

ib1

InfiniBand interface 1

ib2

InfiniBand interface 2 (UFM 3.0 only)

ib3

InfiniBand interface 3 (UFM 3.0 only)

Default

N/A

Configuration Mode

enable

History

1.6.0

Updated example and added command syntax

1.4.1

First release

Example

Related Commands

interface <ifname> ip address <IP address> <netmask>

Notes

ip address <IP address> <netmask>

Sets the IP address and netmask of this interface.

Syntax Description

IP address

IPv4 address

netmask

Subnet mask of IP address

Default

N/A

Configuration Mode

config interface

History

1.3.0

Example

Related Commands

interface

Notes

The command sequence is important. The ip address command should be used first during automation since it clears both default-gateway and name-server settings

ipv6 address <IPv6 address>/<netmask>

Configures static IPv6 address and netmask to this interface, static option is possible.

Syntax Description

IPv6 address/netmask

Configures a static IPv6 address and netmask. Format example: 2001:db8:1234::5678/64.

Default

N/A

Configuration Mode

config interface management

History

1.3.0

Example

Related Commands

N/A

Notes

N/A

hostname <hostname>

Sets a static system hostname.

Syntax Description

hostname

String

Default

Configuration Mode

config

History

1.3.0

Example

Related Commands

N/A

Notes

N/A

ip name-server <no ip name-server>

no ip name-server

Configures DNS servers to be used.

The no form of the command clears the name server.

Syntax Description

IPv4 address

IPv4 address

IPv6 address

IPv6 address

Default

No server name

Configuration Mode

config

History

1.4.2

Updated command description and added the a no form of the command

1.3.0

First release

Example

ufmapl (config)# ip name-server 9.9.9.9

Related Commands

N/A

Notes

The command sequence is important. The ip name-server command should be used during automation, after running the ip address and the ip default-gateway commands

{ip | ipv6} host <hostname> <ip-address>

no {ip | ipv6} host <hostname> <ip-address>

Sets the static domain name.

The no form of the command clears the domain name.

Syntax Description

hostname

String

ip-address

IPv4 or IPv6 address

Default

N/A

Configuration Mode

config

History

1.5.0

Example

Related Commands

show hosts

Notes

show hosts

Displays hostname, DNS configuration, and static host mappings.

Syntax Description

N/A

Default

N/A

Configuration Mode

Any configuration mode

History

1.4.0

Example

Related Commands

N/A

Noes

N/A

show {ip | ipv6} route [static]

Displays the routing table in the system.

Syntax Description

static

Filters the table with the static route entries

Default

N/A

Configuration Mode

Enable

History

1.6.0

Example

Related Commands

{ip | ipv6} route

Notes

show {ip | ipv6} default-gateway [static]

Displays the default gateway.

Syntax Description

static

Displays the static configuration of the default

gateway

Default

N/A

Configuration Mode

Enable

History

1.6.0

Example

Related Commands

{ip | ipv6} default-gateway

Notes

ntp enable

Enables NTP.

Syntax Description

N/A

Default

N/A

Configuration Mode

config

History

1.3.0

Example

Related Commands

N/A

Notes

N/A

ntp server <address>

no ntp server <address>

Configures an NTP server

The no form of the command removes NTP server

Syntax Description

address

IPv4 or IPv6 address

Default

N/A

Configuration Mode

config

History

1.4.2

Updated the command description and added a no form of the command

1.3.0

First release

Example

Related Commands

N/A

Notes

N/A

ntp peer <address>

no ntp peer <address>

Configures an NTP peer

The no form of the command removes the NTP peer

Syntax Description

address

IPv4 or IPv6 address

Default

N/A

Configuration Mode

config

History

1.4.2

Added the no form of the command

1.3.0

First release

Example

Related Commands

N/A

Notes

N/A

image fetch <URL>

Downloads a system image from a remote host.

Syntax Description

URL

HTTPS, SCP and SFTP are supported

Example: scp://username[:password]@hostname/path/filename

Default

N/A

Configuration Mode

config

History

1.5.0

Example

Related Commands

show images

Notes

• The image format must be as follows: ufm-appliance-<version>-omu.tar

• Please delete the previously available image, prior to fetching the new image

• See section In-Service Upgrade at UFM Enterprise Appliance Upgrade

image install <image-name>

Installs an image file.

Syntax Description

image name

Specifies the image name

Default

N/A

Configuration Mode

config

History

1.5.0

Example

Related Commands

show images

Notes

• The image should be installed on the standby node only. Installation on the master node is not allowed.

• Once the installation is complete, perform system reboot using the command:

  Copy

  Copied!

              
  
              
  reload
          

image delete <image-name>

Deletes the specified image file from the hard drive.

Syntax Description

image-name

Specifies the image name

Default

N/A

Configuration Mode

config

History

1.5.0

Example

Related Commands

show images

Notes

show image

Displays information about the system images and boot parameters.

Syntax Description

N/A

Default

N/A

Configuration Mode

Any configuration mode

History

1.5.0

Example

Related Commands

image delete

image fetch

image install

Notes

debug generate dump

Generates a debug dump.e

Syntax Description

N/A

Default

N/A

Configuration Mode

config

History

1.9.0

Example

Related Commands

file debug-dump

Notes

The dump can then be manipulated using the “file debug-dump...” commands

show files debug-dump [<filename>]

Displays a list of debug dump files.

Syntax Description

filename

Displays a summary of the contents of a particular debug dump file

Default

N/A

Configuration Mode

Any configuration mode

History

1.9.0

Example

Related Commands

file debug-dump

Notes

file debug-dump {delete {<filename> | latest} | email {<filename> | latest} | upload {{<filename> | latest} <URL>}}|

Manipulates debug dump files.

Syntax Description

filename

The specified file name

latest

Delete, upload, or e-mail the latest debug dump file to a remote host

URL

HTTP, HTTPS, FTP, TFTP, SCP and SFTP are supported

Example: scp://username[:password]@hostname/path/filename

Default

N/A

Configuration Mode

config

History

1.9.0

First release

Example

Related Commands

Notes

show logging

Displays the logging configurations.

Syntax Description

N/A

Default

N/A

Configuration Mode

Any configuration mode

History

1.9.0

Example

Related Commands

logging

Notes

username root disable

no username root disable

Disable logging into root account

The no form of the command reenable login into root account

Syntax Description

N/A

Default

N/A

Configuration Mode

config

History

1.4.1

Example

Related Commands

N/A

Notes

N/A

username root password <password>

Changes the root user password.

Syntax Description

password

Specifies a password for the user in string form.

Default

N/A

Configuration Mode

config

History

1.8.0

Updated command name

1.4.2

First release

Example

Related Commands

N/A

Notes

N/A

show aaa

Displays the AAA configuration.

Syntax Description

N/A

Default

N/A

Configuration Mode

Enable

History

1.6.0

Example

Related Commands

aaa authentication login default

Notes

tacacs-server {key <secret> | timeout <seconds>}

no tacacs-server {key | timeout}

Sets global TACACS+ server attributes.

The no form of the command resets the attributes to default values.

Syntax Description

key

Set a secret key (shared hidden text string) known to the system and to the TACACS+ server

timeout

Timeout in seconds (1-60)

Default

1 second

Configuration Mode

config

History

1.6.0

Example

Related Commands

show tacacs

tacacs-server host

Notes

Each TACACS+ server can override the global secret parameter using the command "tacacs-server host"

tacacs-server host <ip-address> {auth-port <port> | key <secret>}

no tacacs-server host <ip-address> {auth-port <port>}

Configures TACACS+ server attributes.

The no form of the command removes the TACACS+ server.

Syntax Description

ip-address

TACACS+ server IP address

auth-port

TACACS+ server UDP port number

key

Set a secret key (shared hidden text string) known to the system and to the TACACS+ server

Default

Default TCP port is 49

Configuration Mode

config

History

1.6.0

Example

Related Commands

show tacacs

tacacs-server

Notes

• TACACS+ servers are tried in the order they are configured

• If the user does not specify a parameter for this configured TACACS+ server, the configuration will be taken from the global TACACS+ server configuration. Refer to "tacacs-server" command.

show tacacs

Displays TACACS+ configurations.

Syntax Description

N/A

Default

N/A

Configuration Mode

Enable

History

1.6.0

Example

Related Commands

tacacs-server

tacacs-server host

Notes

show version

Displays version information for the currently running system image.

Syntax Description

N/A

Default

N/A

Configuration Mode

Any configuration mode

History

1.8.0

Updated command output, added system serial number and a note

1.4.2

Updated command output

1.4.0

First release

Example

Related Commands

N/A

Notes

For devices with IDM v1.0.0, the serial number (SN) is generated based on ODM SN since the NVIDIA SN is not available

show files system [detail]

Displays usage information of the file systems on the system.

Syntax Description

detail

Displays more detailed information on file-system

Default

N/A

Configuration Mode

Any configuration mode

History

1.6.0

Example

Related Commands

Notes

license install <url>

Installs a UFM appliance OS license file from a remote host.

Syntax Description

url

https, sftp are supported. Example: sftp://username:password@hostname/path/filename

Default

N/A

Configuration Mode

config

History

1.4.1

First release

1.4.3

Added the first note in the "Notes" row.

Example

Related Commands

license delete

show license

Notes

• The license installation is used to access the SHELL in cases where the root account is disabled. For UFM Enterprise license installation, please refer to Activating the UFM Enterprise License.

• The license format must be as follow: *.lic

• The license installation overrides the existing license, if present.

• To generate UFM appliance OS license, the management interface MAC address (eno8303) should be provided to NVIDIA by running the "show interfaces" command.

license delete

Deletes a UFM appliance OS license file from the hard drive.

Syntax Description

N/A

Default

N/A

Configuration Mode

config

History

1.4.1

Example

Related Commands

license install

show license

Notes

N/A

show license

Displays UFM appliance OS license information.

Syntax Description

N/A

Default

N/A

Configuration Mode

config

History

1.4.1

Example

Related Commands

license install

license delete

Notes

N/A

_shell

Runs a UNIX command shell such as bash. This shell command replaces the CLI; when the user exits the shell, they will be returned to the CLI.

Syntax Description

N/A

Default

N/A

Configuration Mode

enable

History

1.8.0

Added a note

1.4.1

First release

Example

Related Commands

license install

license delete

show license

Notes

The OS license check is disabled by default. To enable it, set:

            

            
[security]:os-license = true in /opt/ufmcli/conf/ufmcli_cfg.yaml
        

docker load <image name>

Loads a docker image from a TAR archive.

Syntax Description

image name

Name of the TAR image to be loaded

Default

N/A

Configuration Mode

config

History

1.7.0

Example

Related Commands

image fetch

show docker images

docker remove

Notes

The image should be downloaded into the UFM Enterprise appliance from a remote host

docker pull <image-name>[:<version>]

Pulls a docker image from a docker repository.

Syntax Description

image-name [:<version>]

Image name

Format: Name:Version

If only “Name” is provided, “version” defaults to latest

Default

N/A

Configuration Mode

config

History

1.7.0

Example

Related Commands

show docker images

docker remove

Notes

docker remove image <image-name> <image-version>

Removes an image from the Linux docker service.

Syntax Description

image-name

Name of the image to be deleted

image-version

Version of the image to be deleted

Default

N/A

Configuration Mode

config

History

1.7.0

Example

Related Commands

show docker images

docker remove

Notes

show docker images

Displays docker images.

Syntax Description

N/A

Default

N/A

Configuration Mode

enable

History

1.7.0

Example

Related Commands

show docker ps

docker remove

docker pull

docker load

Notes

show docker ps

Displays docker containers.

Syntax Description

N/A

Default

N/A

Configuration Mode

enable

History

1.7.0

Example

Related Commands

show docker images

docker remove

docker pull

docker load

Notes

docker prune image

Removes all dangling docker prune images.

Syntax Description

N/A

Default

N/A

Configuration Mode

config docker

History

1.8.0

Example

Related Commands

show docker images

docker remove image

Notes