docs(admin): add Oracle ASM administration skill#42
Draft
guborges wants to merge 1 commit into
Draft
Conversation
Refs oracle#41 Add db/admin/asm-management.md covering Standalone Grid Infrastructure and RAC Grid Infrastructure ASM administration. The repository had no dedicated ASM skill, even though ASM is referenced as adjacent context in db/architecture/rac-concepts.md, db/architecture/exadata-features.md, db/architecture/oracle-cloud-oci.md, db/architecture/multitenant.md, db/admin/backup-recovery.md, and db/admin/redo-log-management.md. The new file follows the SKILL_AUTHORING_GUIDE.md structure and the shape of the existing db/admin/ files (dataguard.md, rman-basics.md, backup-recovery.md, redo-log-management.md, undo-management.md): - Overview and architecture (ASM instance, processes, disk groups, disks, files, allocation units, COMPATIBLE.ASM / COMPATIBLE.RDBMS). - Redundancy levels (EXTERNAL, NORMAL, HIGH, FLEX) and failure groups. - Disk discovery via AFD, ASMLib, and udev, with ASM_DISKSTRING guidance. - Disk-group lifecycle: CREATE, ALTER, DROP, rebalance behaviour and POWER tuning. - Day-to-day operations: add/drop disks, resize, online file move, ASMCMD essentials. - Monitoring through V$ASM_DISK, V$ASM_DISKGROUP, V$ASM_OPERATION, V$ASM_CLIENT, V$ASM_FILE, V$ASM_TEMPLATE, V$ASM_ATTRIBUTE, with daily-health and rebalance-progress queries and clear alerting guidance. - Diagnostic-first walkthroughs for ORA-15014, ORA-15032, ORA-15040, and ORA-15042. - Best practices and a Common Mistakes section that covers failure group placement, ASM_DISKSTRING scoping, FORCE drop misuse, rebalance power during business hours, disk-group naming across environments, and free-space validation before disk drop. - Oracle Version Notes (19c vs 26ai) covering FLEX disk groups, rebalance POWER ceiling, AFD positioning, and mixed-version ceiling rules. - Cross-links to db/architecture/rac-concepts.md, db/architecture/exadata-features.md, db/admin/redo-log-management.md, db/admin/backup-recovery.md, and db/agent/ora-error-catalog.md. - Sources limited to Oracle 19c documentation (ASM Administrator's Guide, Reference, ASMCMD command reference, Grid Infrastructure Linux installation guide, ORA-15000 error messages page). Update db/SKILL.md so the routing table mentions ASM under db/admin/ and add an Investigate an ASM disk-group issue entry to Common Multi-Step Flows. Signed-off-by: Gustavo Evangelista <gustavoborges2@gmail.com>
krisrice
reviewed
Jun 4, 2026
krisrice
left a comment
krisrice
left a comment
Member
There was a problem hiding this comment.
Held during review because the PR is still marked draft. I did not find a content blocker in the sampled ASM skill, but I did not merge a draft PR.
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
2 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Refs #41
Summary
Adds
db/admin/asm-management.md, a single-file skill covering Oracle Automatic Storage Management administration for both Standalone Grid Infrastructure and RAC Grid Infrastructure. Updatesdb/SKILL.mdso the routing table and Common Multi-Step Flows reflect the new content.Opening as a draft so maintainers can shape the scope before review. The proposal in #41 includes an open question on whether to keep this as one file or split into
asm-diskgroups.md+asm-monitoring.md+asm-troubleshooting.md. The current PR is the single-file shape; happy to split if maintainers prefer.Why this skill
ASM was already mentioned as adjacent context in six existing skills:
db/architecture/rac-concepts.mddb/architecture/exadata-features.mddb/architecture/oracle-cloud-oci.mddb/architecture/multitenant.mddb/admin/backup-recovery.mddb/admin/redo-log-management.mdBut day-to-day administration (disk-group lifecycle, disk add/drop with rebalance, ASMCMD, monitoring views, diagnostic flows for the most common ASM errors) had no home. ASM underpins almost every Oracle deployment on Exadata, ODA, RAC, and Oracle Cloud DB systems, so this gap shows up the moment an agent or operator needs to reason about disk-group state.
What is in the file
Following
SKILL_AUTHORING_GUIDE.mdand matching the existingdb/admin/files in tone and length (~420 lines, in line withdataguard.md,rman-basics.md,backup-recovery.md):COMPATIBLE.ASM/COMPATIBLE.RDBMSattributes).EXTERNAL,NORMAL,HIGH,FLEX) and failure groups, including a multi-failgroupCREATE DISKGROUPexample.ASM_DISKSTRING) and the trade-offs between AFD, ASMLib, and udev rules.CREATE,ALTER,DROP, rebalance semantics,POWERtuning, suspend/resume.V$ASM_*views; ready-to-run health and rebalance-progress queries; explicit alerting guidance.ORA-15014,ORA-15032,ORA-15040,ORA-15042.ASM_DISKSTRINGscoping,FORCEdrop misuse, rebalance power during business hours, disk-group naming across environments, and free-space validation before disk drop.## Oracle Version Notes (19c vs 26ai)—FLEXdisk groups,POWERceiling, AFD positioning, mixed-version compatibility ceiling.db/architecture/rac-concepts.md,db/architecture/exadata-features.md,db/admin/redo-log-management.md,db/admin/backup-recovery.md, anddb/agent/ora-error-catalog.md.V$ASM_*, ASMCMD command reference, Grid Infrastructure Linux installation guide,ORA-15000error messages page).Scope guards
db/architecture/rac-concepts.md.db/sqlcl/sqlcl-mcp-server.md.Open questions for maintainers
db/admin/). If a split fits better, the natural cut isasm-diskgroups.md+asm-monitoring.md+asm-troubleshooting.md.db/SKILL.mdrow reads "Backup, recovery, RMAN, Data Guard, redo/undo logs, users, ASM" fordb/admin/. Happy to phrase it differently.ora-error-catalog→rac-concepts. Will adjust to the maintainers' preferred sequence.