unloadopt error "An error occurred while attempting to unload the virtual target optical device."

Troubleshooting

Problem

$ unloadopt -vtd vtopt0

An error occurred while attempting to unload the virtual target

optical device.

Symptom

I need to unload the virtual media image loaded in the VIOS Virtual Media Library in preparation to update the VIOS, but unloadopt command fails.

In the following example, lsvopt command shows virtual media disk, "AIX7.3", loaded on Virtual Target Device (VTD), vtopt0.

$ lsvopt
VTD Media Size(mb)
vtopt0 AIX7.3 8007

Cause

The VTD status may be Defined.

Environment

PowerVM VIOS 3.1

Diagnosing The Problem

Check the VTD status. It needs to be Available.

$ lsmap -vadapter vhost0

SVSA            Physloc                                      Client Partition ID

--------------- -------------------------------------------- ------------------

vhost0          U8286.42A.219XXXX-V6-C2                      0x00000002

VTD                   vtopt0

Status                Defined

LUN                   0x8200000000000000

Backing device        /var/vio/VMLibrary/AIX7.3

Physloc

Mirrored              N/A

Resolving The Problem

If the VTD status is in Defined state, try to make it Available using cfgdev command, e.g.

$ cfgdev -dev vtopt0

Verify the VTD status

$ lsmap -vadapter vhost#

Once it is back Available, try to unload it again.

$ unloadopt -vtd vtopt0

Verify the media has been unloaded. The command output should show No Media for the VTD.

$ lsvopt

VTD             Media                                                 Size(mb)

vtopt0          No Media                                                   n/a

Related Information

Virtual media repository commands

Document Location

Worldwide

[{"Type":"MASTER","Line of Business":{"code":"LOB57","label":"Power"},"Business Unit":{"code":"BU058","label":"IBM Infrastructure w\/TPS"},"Product":{"code":"SSPHKW","label":"PowerVM Virtual I\/O Server"},"ARM Category":[{"code":"a8m50000000L0FdAAK","label":"PowerVM VIOS-\u003EVirtual SCSI (VSCSI)-\u003EVirtual Media Repository (VML)"}],"ARM Case Number":"TS014931615","Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"All Versions"}]

Was this topic helpful?

Document Information

More support for:
PowerVM Virtual I/O Server

Component:
PowerVM VIOS->Virtual SCSI (VSCSI)->Virtual Media Repository (VML)

Software version:
All Versions

Document number:
7092056

Modified date:
08 December 2023

UID

ibm17092056

IBM Support

Tips