Volume & Erasure Code Administration

This section covers disk volume lifecycle, hardware-accelerated Cauchy Reed-Solomon profile tuning, and live pool migration policies.

1. am volume — Physical Mounts & Disk Storage

Manage raw disk mounts attached to individual storage nodes:

# List all physical volumes mounted across the cluster
am volume list --format table

# Inspect volume health, I/O latency, and segment utilization
am volume inspect vol-nvme-01

# Mount a new NVMe partition into Kdouja engine
am volume mount storage-node-01 /mnt/aarkam/data02 --segment-size 256MB

# Unmount a volume gracefully after running internal sync
am volume unmount storage-node-01 vol-nvme-02 --drain-timeout 30m

2. am ec — Cauchy Reed-Solomon Codec & Benchmarks

The am ec suite allows engineers to benchmark AVX-512 vector performance and simulate failure tolerance:

# Benchmark Cauchy Reed-Solomon SIMD speed on local host CPU
am ec bench --data-chunks 8 --parity-chunks 3 --block-size 4MB --threads 8

# List supported erasure coding profiles and their overhead ratios
am ec profile list

# Test data reconstruction speed for 3 lost chunk vectors
am ec test-reconstruct --profile ahmodi-8-3 --corrupt-chunks 3

3. am transcode — Storage Policy Migration

Transcoding allows live, zero-downtime conversion between replication and erasure coding profiles:

# Start background policy transcode from 3x replication to Cauchy (8+3)
am transcode start --source-pool default-rep3 --target-pool sovereign-ec83 --bandwidth-limit 1GB/s

# Monitor active transcode progress and remaining byte estimate
am transcode status --watch 5s

# Pause active transcode during peak business hours
am transcode pause