IBM AIX 7.1 – Common Problem 137 – Diagnosis and Fix

📖 ~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

`startwpar -v app1` exits with `0960-019` and `app1` stays in `D` (defined) state.

Environment & Reproduction

AIX 7.2 global environment hosting a system WPAR with shared `/usr` and a private `/home`.

Root Cause Analysis

WPAR rootvg LV is missing or `/wpars/app1` mountpoint is stale after a global reboot.

Quick Triage

Run `lswpar -L app1`, `lsvg -l rootvg`, and `mount | grep wpars`.

Step-by-Step Diagnosis

Capture `/var/adm/wpars/app1.log` and `errpt -j ` for the failed start.

Solution – Primary Fix

Recreate missing mounts: `mkwpar -p -f /etc/wpars/app1.cfg` and retry `startwpar app1`.

Solution – Alternative Approaches

Restore from a WPAR backup: `restwpar -f /backup/app1.savewpar`.

Verification & Acceptance Criteria

`lswpar` shows `app1` in `A` (active) state and `clogin app1` succeeds.

Rollback Plan

`stopwpar -F app1` and revert to the previous global-only configuration.

Prevention & Hardening

Back up WPAR specs with `savewpar` after every change and monitor via `wparexec` health checks.

Related Errors & Cross-Refs

Related to `0960-018` mount failures and `0960-021` resource controller errors.

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

View all aix-7.1 tutorials on the Tutorials Hub →

Browse all common problems & solutions on the Tutorials Hub.

References & Further Reading

IBM Docs: AIX WPAR administration, `mkwpar`, `savewpar`.