Skip to main content

vm commands

Use the vm commands to list, mount, or umount the virtual media.

vm command syntax

OneCli.exe [misc] vm <command> [options]
Table 1. vm commands and syntax examples
CommandSyntax exampleDescription
list
OneCLI vm list --bmc <bmc connection info>

List the virtual media status on BMC.

mount
OneCLI vm mount --id <virtual media id> --path 
<httpfs or nfs url> --bmc <bmc connection info>

Mount virutal media on BMC by using ID.

umount
OneCLI vm umount --id <virtual media id> --bmc 
<bmc connection info>

Unmount virutal media on BMC by using ID.

Table 2. vm command specific parameters
ParameterRequired/OptionalNotes
--cacertOptionalSpecifies the path of CACert.

--id, -I

Only required in the mount and umount commands.

Specify the virtual media ID, for example, RDOC1, EXT1, and Remote1.

For ThinkBMC, the virtual media ID is CD.
Note
ThinkBMC is the BMC for the ThinkServer systems listed in OneCLI features supported on the ThinkServer/WenTian servers.

--path, -P

Only required in the mount and umount commands.

  • For the ThinkSystem servers, specify the URL of virtual media path, which supports NFS and HTTPFS.

    NFS URL address form:

    • nfs://ipaddress:/path/to/file

    • nfs://domain-name:/path/to/file

    HTTPFS URL address:

    • https://ipaddress[:port]/path/to/file

    • https://domain-name[:port]/path/to/file

  • For the ThinkSystem V4 servers and HR350M V3, support local virtual media(ISO or IMG).

  • For WenTian or ThinkSystem-Hyperscale servers, support NFS and CIFS in ThinkBMC.

    NFS form:

    • nfs://host[:port]/path/to/file

    CIFS form:

    • cifs://[username:password@]host[:port]/path/to/file

    HTTPS form (WenTian G3/G5 and ThinkSystem-Hyperscale):

    • https://username:password@ipaddress[:port]/path/to/file

Note
The domain-name can be alphanumeric characters, period (.), hyphen (-) or underline (_). It must contain at least two domain items. The port number is optional
--verify-certificateOptionalVerify server certificates for SSL connections.
--writeprotectedOptionalMount the virtual media with write protected.

  • --bmc/imm, -b

  • --bmc-cim-port, -p

  • --bmc-password, -w

  • --bmc-username, -u

  • --config

  • --check-trust, -C

  • --help,-h

  • --never-check-trust, -N

  • --nolog, -n

  • --output, -o

  • --quiet, -q

Optional

Refer to Table 2.

Example of the vm command

OneCli.exe misc vm list -b USERID:PASSWORD@xxx.xxx.xxx.xxx