Go to main content

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

Exit Print View

Updated: April 2018

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 NSF or SAMBA 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 (SPARC M7, T7, S7-2L).

    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 or Samba URI
When the Host Storage Device Mode is set to Remote, enter the location of the image on the remote server using either the NFS or Samba 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://

CLI Syntax for target_URI:
Single server:
set /SP/services/kvms/host_storage_device target_URI=NFS_or_Samba_URI
Multi-domain server:
set /Servers/PDomains/PDomain_n/SP/services/kvms/host_storage_device target_URI=NFS_or_Samba_URI
SMB User Name
SAMBA Server username
If you are mounting the virtual storage device using Samba, authentication is required.
When the Host Storage Device Mode is set to Remote, enter your user name for the remote SAMBA server.
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
SMB Password
SAMBA Server password
If you are mounting the virtual storage device using Samba, authentication is required.
When Host Storage Device Mode is set to Remote, enter the password associated with the SMB User Name specified.
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