PowerEdge: iDRAC9 Cannot Connect Remote Image over IPv6 using Nondefault Port and eHTML5

Summary: Mapping a RemoteImage over IPv6 with a nondefault webserver port and eHTML5 plugin fails on Integrated Dell Remote Access Controller 9 (iDRAC9)

This article applies to This article does not apply to This article is not tied to any specific product. Not all product versions are identified in this article.
Check out other resources

Symptoms

Attempting to map a remote ISO using IPv6 to a webserver running on a nonstandard port http/80 https/443 fails on Integrated Dell Remote Access Controller 9 (iDRAC9) when idrac.virtualconsole.plugintype is set to eHTML5. 

The following interfaces are impacted as iDRAC leverages the same eHTML5 code. 

  • Remote File Share option from iDRAC UI
  • RACADM remoteimage command
  • REDFISH VirtualMedia.InsertMedia action 

RemoteFileShare/Racadm Error Example

$ racadm remoteimage -c -l http://[fd00:11::249]:8080/repo/w10-pe-new.iso
ERROR: Unable to perform requested operation.

Redfish Error Example 

2022-02-22 00:13:37 Error : HTTP Status : 400 ; POST /redfish/v1/Managers/iDRAC.Embedded.1/VirtualMedia/CD/Actions/VirtualMedia.InsertMedia failed after 0 seconds
{
    "error": {
        "@Message.ExtendedInfo": [
            {
                "Message": "Unable to mount remote share http://[fd00:11::249]:8080/iso/bootimage.iso [[2620].",
                "MessageArgs": [
                    http://[fd00:11::249]:8080/iso/bootimage.iso [[2620]
                ],
                MessageArgs@odata.count: 1,
                "MessageId": "IDRAC.2.5.RAC0720",
                "RelatedProperties": [
                    "#/Image"
                ],
                RelatedProperties@odata.count: 1,
                "Resolution": "Retry the operation.",
                "Severity": "Informational"
            }
        ],
        "code": "Base.1.8.GeneralError",
        "message": "A general error has occurred. See ExtendedInfo for more information"
    }
}

Cause

The URL ports are hard coded http/80 and https/443 for IPv6 as eHTML5 implementation does not differentiate ':'s in IPv6 address vs. ':' for the server port in the URL. 

Resolution

Dell has addressed the issue with the eHTML5 plugin in the June 2022 release 5.10.30.00.

Workaround 
Change the idrac.virtualconsole.plugintype to HTML5.

$ racadm help idrac.virtualconsole.plugintype
PluginType                -- Specifies the plugin type to use when running Virtual Console from a browser.
Usage                     -- 0-ActiveX; 1-Java; 2-HTML5; 3-eHTML5; Default - 3
Required License          -- Virtual Console
Dependency                -- While there are active Virtual Console, Virtual Media or Remote File Share sessions, the value cannot be changed from ActiveX/Java/HTML5 to eHTML5 or from eHTML5 to ActiveX/Java/HTML5.

$ racadm set idrac.virtualconsole.plugintype 2
[Key=idrac.Embedded.1#VirtualConsole.1]
Object value modified successfully

$ racadm remoteimage -c -l http://[fd00:11::249]:8080/repo/w10-pe-new.iso
Remote Image is now Configured

$ racadm remoteimage -s
Remote File Share is Enabled
UserName
Password
ShareName http://[fd00:11::249]:8080/repo/w10-pe-new.iso

Affected Products

iDRAC9
Article Properties
Article Number: 000195913
Article Type: Solution
Last Modified: 13 مايو 2026
Version:  7
Find answers to your questions from other Dell users
Support Services
Check if your device is covered by Support Services.