Go to main content

Oracle® ILOM Administrator's Guide for Configuration and Maintenance Firmware Release 4.0.x

Exit Print View

Updated: July 2020

CLI and Web Host Storage Device Properties

User Interface Configurable Target and User Role:
  • SP CLI: /SP/services/kvms/remote_virtual_device

  • Web: Remote Control > Host Storage Device

  • User Role: Admin (a) role is required to configure the Remote Device properties. Read-Only (o) role is required to view the current settings.

disabled (for systems using SP firmware 3.2.4 or earlier)
miniroot (for newer SPARC M7 and T7 series servers with Solaris OS image preinstalled and using SP firmware or later)
disabled |remote|miniroot
The Mode property controls the Host Storage Device redirection behavior.
  • Disabled — Select Disabled to deactivate the host storage redirection service in Oracle ILOM

  • Remote — Select Remote to redirect a virtual storage image mounted on a remote NFS, SAMBA, or SSHFS server as an attached host storage device.

  • Miniroot — Select Miniroot to configure the SP to point to the pre-loaded Solaris Miniroot package that is currently installed on the managed server. For instructions on how to upload a new Solaris Miniroot package to managed server from SP, see Uploading a New Solaris Miniroot Package From SP to Host .

    Note -  The Miniroot option is available only on SPARC T7, M7, or later SPARC series servers.

CLI Syntax for mode:
Single server:
set /SP/services/kvms/host_storage_device mode=[disabled|remote|miniroot]

Note -  The Miniroot option is available on SPARC T7 and M7 servers only.

Multi-domain server:
set /Servers/PDomains/PDomains-n/SP/services/kvms/host_storage_device mode=[disabled|remote| miniroot]
Server URI
NFS, Samba, or SSHFS URI

Note -  As Oracle ILOM firmware version 4.0.3, the SSHFS server URI option is available for configuration. This option supports user authentication through the use of a username and password or a user generated SSH key. To use SSH key-based authentication, copy the public key for the authentication type used (either DSA or RSA) from /SP/services/ssh/keys/rsa |dsa to the account for username and put it in the .ssh/authorized_keys file. For additional information about generating a public SSH key for user authentication, see,

CLI Authentication Using Local User SSH Key .

Note -  The SAMBA option supports user authentication through the use of username and password.

When the Host Storage Device Mode is set to Remote, enter the location of the image on the remote server using either the NFS, Samba, or SSHFS protocol.
  • To enter a URI using NFS, use the following format: nfs://server:/path/file

    Sample NFS URI: nfs://

  • To enter a URI using Samba, use the following format: smb://server:/path/file or smb://server/path/file

    Sample Samba URI: smb://

  • To enter a URI using SSHFS, use the following format: sshfs://host:/file_path

    Sample SSFS URI: sshfs://

CLI Syntax for target_URI:
Single server:
set /SP/services/kvms/host_storage_device target_URI=NFS_or_Samba_or_SSHFS_URI
Multi-domain server:
set /Servers/PDomains/PDomain_n/SP/services/kvms/host_storage_device target_URI=NFS_or_Samba_or_SSHFS_URI
Remote Storage User Name
SAMBA Server username or SSHFS Server user name
If you are mounting the virtual storage device using a SAMBA or SSHFS server URI, authentication is required.
When Host Storage Device mode is set to Remote, do the following:
  • For SAMBA URI redirection, enter SAMBA Server user name.

  • For SSHFS URI redirection, enter your SSHFS Server user name.

CLI Syntax for username:
Single server:
set /SP/services/kvms/host_storage_device username=username
Multi-domain server:
set /Servers/PDomains/PDomain_n/SP/services/kvms/host_storage_device username=username
Remote Storage Password
SAMBA Server password or SSHFS Server password
If you are mounting the virtual storage device using Samba, authentication is required.
When Host Storage Device mode is set to Remote, do the following:
  • For SAMBA URI redirection, enter your SAMBA Server password.

  • For SSHFS URI redirection, enter your SSHFS Server password when not using SSH keys for authentication.

CLI Syntax for password:
Single server:
set /SP/services/kvms/host_storage_device password=password
Multi-domain server:
set /Servers/PDomains/PDomain_n /SP/services/kvms/host_storage_device password=password
The read-only Status property indicates the operational state of the Remote Device redirection service. The possible values of the Status property are as follows:
  • Connecting – Indicates that the transfer to the host over USB has terminated or has not been established

  • Device not mounted – The virtual storage device image was not mounted successfully.

  • Disabled – The Service State property for Remote Device redirection is set to disabled.

  • Internal file error – A problem occurred in Oracle ILOM when attempting to mount the device.

  • Operational – The virtual storage device redirection has been started successfully.

  • Remote file transfer error – There was an error when transferring data for the remote device.

  • Remote file configured in URI not found – The file specified in the URI was not found on the remote system.

  • Remote storage is currently connected via KVMS – If the remote host storage device is connected to the Remote System Console Plus then the host storage device can not be used.

  • Remote target not available – The path to the virtual storage device image is not valid.

  • URI not configured – The remote server URI was not set.

  • URI not valid for requested operation – The remote server URI is not valid.

  • Username or password not configured (Samba only) – The user name or password was not set.

CLI Syntax for status:
Single server:
show /SP/services/kvms/host_storage_device status
Multi-domain server:
show /Servers/PDomains/PDomain-n/SP/services/kvms/host_storage_device status