Aarkam / Aarkam Wiki / Installation / Rokka S3 Gateway & Ahmodi SIMD Engine Setup ARK-ROKKA-GW-0204
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.

Last updated: Nov 03, 2026 Classification: Sovereign Tier-4 Enterprise
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:

  1. Streaming Chunk Partitioning: The gateway segments the stream into uniform Cauchy data fragments without intermediate disk spooling.
  2. Vectorized Galois Field Parity: Ahmodi utilizes AVX-512/AVX2 SIMD instructions to generate parity chunks over $\text{GF}(2^8)$ at memory bus speed.
  3. AES-256-GCM Inline Cipher: Hardware VAES encrypts each payload fragment with dedicated per-object rotating keys.
  4. Parallel Forwarding: Padded direct I/O chunks are concurrently streamed to Abodi storage daemons across independent fault domains.
  5. 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