Affected versions: IBM AIX 7.3

📖 ~1 min read

Table of contents
  1. Symptom & Impact
  2. Environment & Reproduction
  3. Root Cause Analysis
  4. Quick Triage
  5. Step-by-Step Diagnosis
  6. Solution – Primary Fix
  7. Solution – Alternative Approaches
  8. Verification & Acceptance Criteria
  9. Rollback Plan
  10. Prevention & Hardening
  11. Related Errors & Cross-Refs
  12. References & Further Reading

Symptom & Impact

Client LPAR loses hdisk after VIOS update or DLPAR.

Environment & Reproduction

vhost mapping changed or padmin lost reservation.

Root Cause Analysis

vSCSI lun_id/serial mismatch between VIOS and client.

Quick Triage

On VIOS run lsmap -all and lsdev -dev hdiskN -attr.

Step-by-Step Diagnosis

On client run lsdev -Cc disk and cfgmgr -v output.

Illustrative mockup for aix-7.3 — vios_virtual_scsi_mappin_diag
Diagnostic view for vios-virtual-scsi-mapping-mismatch — Illustrative mockup — Progressive Robot

Solution – Primary Fix

Re-create mapping with mkvdev -vdev hdiskN -vadapter vhostX -dev vtscsiN.

Still having issues? Our IT Solutions & Services team can diagnose and resolve this for you. Get in touch for a free consultation.

Illustrative mockup for aix-7.3 — vios_virtual_scsi_mappin_fix
Remediation steps for vios-virtual-scsi-mapping-mismatch — Illustrative mockup — Progressive Robot

Solution – Alternative Approaches

Add NPIV vfchost mapping if SAN connectivity allows.

Verification & Acceptance Criteria

Client cfgmgr brings hdisk online with same PVID.

Rollback Plan

rmvdev -vtd vtscsiN to back out incorrect mapping.

Prevention & Hardening

Document VIOS-to-client LUN map; use reserve_policy=no_reserve.

Co-occurs with PowerHA cl_lvm and varyonvg errors.

Related tutorial: View the step-by-step tutorial for aix-7.3.

View all aix-7.3 tutorials on the Tutorials Hub →

Browse all common problems & solutions on the Tutorials Hub.

References & Further Reading

IBM Docs: PowerVM VIOS administration.

Need Expert Help?

If you cannot resolve this yourself, our team offers hands-on Server Management, Managed IT Services, and flexible Support Plans. Contact us today — we respond within one business day.