Aarkam - SAT (Storage Substrate)
Data Plane
Installation
•
ARK-ROKKA-GW-0204
Rokka S3 Gateway & Ahmodi SIMD Engine Setup
Deploying the high-throughput AWS SigV4 S3 REST gateway powered by Ahmodi AVX-512 Cauchy Reed-Solomon erasure coding.
Document Identifier
ARK-ROKKA-GW-0204
Standard Status
Production Standard
Erasure Coding Engine
Ahmodi SIMD Cauchy RS
Release Version
V-1.0.0-GA (Production Stable)
Rokka.Gateway (rokka-gateway) is the wire-speed, high-concurrency S3 API ingress and erasure coding engine. It provides complete compatibility with the standard AWS S3 REST API (AWS SigV4), housing the vectorized Ahmodi Cauchy Reed-Solomon math engine ($12.5\text{ GB/s/core}$) and streaming hedged reads to eliminate P99 tail latency across NVMe storage nodes.
1. Ahmodi SIMD Cauchy Engine & Hedged Reads
When an application streams an object PUT request to rokka-gateway:
- Streaming Chunk Partitioning: The gateway segments the stream into uniform Cauchy data fragments without intermediate disk spooling.
- Vectorized Galois Field Parity: Ahmodi utilizes AVX-512/AVX2 SIMD instructions to generate parity chunks over $\text{GF}(2^8)$ at memory bus speed.
- AES-256-GCM Inline Cipher: Hardware VAES encrypts each payload fragment with dedicated per-object rotating keys.
- Parallel Forwarding: Padded direct I/O chunks are concurrently streamed to Abodi storage daemons across independent fault domains.
- Speculative Hedged Reads: On GET operations, the gateway queries $K$ shards concurrently; if any node experiences latency jitter exceeding $5\text{ ms}$, redundant shard requests are dispatched immediately.
2. Configuration (gateway.settings.json)
Configure /opt/aarkam/rokka/gateway.settings.json (or C:\Program Files\Aarkam\Rokka\gateway.settings.json):
json
{
"Logging": {
"LogLevel": {
"Default": "Information",
"Rokka.Gateway": "Information"
}
},
"Gateway": {
"ClusterName": "PROD-SOVEREIGN-CLUSTER",
"CoordinatorEndpoint": "http://127.0.0.1:7774",
"ErasureCoding": {
"DefaultDataShards": 8,
"DefaultParityShards": 3,
"EnableSimdVectorization": true
},
"HedgedReads": {
"EnableSpeculativeExecution": true,
"TriggerThresholdMs": 5
}
},
"Kestrel": {
"Endpoints": {
"Http": {
"Url": "http://0.0.0.0:7772",
"Protocols": "Http1AndHttp2"
},
"Https": {
"Url": "https://0.0.0.0:57772",
"Protocols": "Http1AndHttp2"
}
}
}
}
3. Production Service Registration
3.1 Linux systemd Service (/etc/systemd/system/rokka-gateway.service)
ini
[Unit]
Description=Aarkam Rokka Sovereign S3 & Cauchy REST Gateway
After=network.target rokka-coordinator.service
Wants=rokka-coordinator.service
[Service]
Type=simple
User=root
WorkingDirectory=/opt/aarkam/rokka
ExecStart=/opt/aarkam/rokka/rokka-gateway
Restart=always
RestartSec=3s
LimitNOFILE=1048576
LimitMEMLOCK=infinity
Environment="ASPNETCORE_ENVIRONMENT=Production"
[Install]
WantedBy=multi-user.target
bash
sudo systemctl daemon-reload
sudo systemctl enable --now rokka-gateway
sudo systemctl status rokka-gateway
3.2 Windows Server Service Registration
powershell
Set-Location "C:\Program Files\Aarkam\Rokka"
.\install-rokka.ps1 -StartServices
4. Verification & S3 Client Operations
bash
# Set S3 endpoint to Rokka Gateway
export AWS_ENDPOINT_URL="http://localhost:7772"
# Bucket and object smoke tests
aws --endpoint-url $AWS_ENDPOINT_URL s3 mb s3://enterprise-data
aws --endpoint-url $AWS_ENDPOINT_URL s3 ls