Aarkam - SAT (Standalone Tier Primary Substrate) Consensus Plane Installation • ARK-ROKKA-COORD-0203

Rokka Coordinator Quorum & Consensus Setup

Deploying the distributed control plane, Raft MON consensus quorum, and Rendezvous (HRW) placement resolver.

Last updated: Nov 03, 2026 Classification: Sovereign Tier-4 Enterprise

---
title: "Rokka Coordinator Quorum & Consensus Setup"
description: "Deploying the distributed control plane, Raft MON consensus quorum, and Rendezvous (HRW) placement resolver."
category: "Installation"
order: 3
badge: "Consensus Plane"
icon: "compass"
documentId: "ARK-ROKKA-COORD-0203"
status: "Production Standard"
classification: "Sovereign Tier-4 Enterprise"
tier: "Aarkam - SAT (Standalone Tier Primary Substrate)"
version: "V-1.0.0-GA (Production Stable)"
readingTime: "3 min read"
audience: "Distributed Systems Engineers & Storage Administrators"
scope: "Rokka Sovereign Storage Engine"
---

<div class="wiki-spec-card">
  <div class="wiki-spec-grid">
    <div class="wiki-spec-item">
      <span class="wiki-spec-label">Document Identifier</span>
      <span class="wiki-spec-value text-[#10B981]">ARK-ROKKA-COORD-0203</span>
    </div>
    <div class="wiki-spec-item">
      <span class="wiki-spec-label">Standard Status</span>
      <div><span class="status-pill status-normative">Production Standard</span></div>
    </div>
    <div class="wiki-spec-item">
      <span class="wiki-spec-label">Consensus Protocol</span>
      <span class="wiki-spec-value text-amber-300">Raft MON Quorum</span>
    </div>
    <div class="wiki-spec-item">
      <span class="wiki-spec-label">Release Version</span>
      <span class="wiki-spec-value text-cyan-300">V-1.0.0-GA (Production Stable)</span>
    </div>
  </div>
</div>

<p><strong>Rokka.Coordinator</strong> (<code>rokka-coordinator</code>) is the distributed consensus authority and cluster topology controller. It manages cluster membership, dynamic <strong>Rendezvous (Highest Random Weight - HRW)</strong> shard placement across physical failure domains, and maintains operator credentials within embedded <strong>Kdouja LSM</strong> key-value tables.</p>

<hr />

<h2 id="prerequisites-quorum">1. Prerequisites &amp; Quorum Sizing</h2>
<ul>
  <li><strong>Quorum Sizing:</strong> Production deployments require an odd number of coordinators (<span class="math">\(N = 3\)</span> or <span class="math">\(N = 5\)</span>) across independent physical hosts or racks to guarantee Byzantine-free partition tolerance.</li>
  <li><strong>Network Ports:</strong> Port <code>7774</code> (HTTP/2 gRPC) and <code>57774</code> (HTTPS / mTLS) between all coordinator nodes, storage daemons, and client ingress gateways.</li>
  <li><strong>Resource Footprint:</strong> 4 Physical Cores, 8 GB ECC RAM, and 50 GB fast NVMe partition for Raft transaction logs and LSM state.</li>
</ul>

<hr />

<h2 id="configuration-coordinator">2. Configuration (<code>coordinator.settings.json</code>)</h2>
<p>On each quorum host, configure <code>/opt/aarkam/rokka/coordinator.settings.json</code> (or <code>C:\Program Files\Aarkam\Rokka\coordinator.settings.json</code>):</p>

<div class="wiki-code-block relative group my-3 rounded-xl border border-slate-800 bg-[#060a14] overflow-hidden">
  <div class="code-header flex items-center justify-between px-3 py-1.5 bg-slate-900/90 border-b border-slate-800 text-[10px] font-mono text-slate-400">
    <span class="uppercase font-bold text-emerald-400">json</span>
    <button type="button" onclick="copyCodeSnippet(this)" class="hover:text-white px-2 py-0.5 rounded bg-slate-800 border border-slate-700 transition cursor-pointer print:hidden">Copy</button>
  </div>
  <pre class="p-3.5 overflow-x-auto text-xs font-mono text-slate-200 leading-relaxed m-0"><code class="language-json">{
  "Logging": {
    "LogLevel": {
      "Default": "Information",
      "Rokka.Coordinator": "Information"
    }
  },
  "Coordinator": {
    "NodeId": "COORD-NODE-01",
    "ClusterName": "PROD-SOVEREIGN-CLUSTER",
    "HeartbeatIntervalMs": 150,
    "ElectionTimeoutMs": 300,
    "DataDirectory": "/var/lib/rokka/coordinator",
    "PeerNodes": [
      "https://coord-01.rokka.internal:57774",
      "https://coord-02.rokka.internal:57774",
      "https://coord-03.rokka.internal:57774"
    ]
  },
  "Kestrel": {
    "Endpoints": {
      "gRPC": {
        "Url": "http://0.0.0.0:7774",
        "Protocols": "Http2"
      },
      "mTLS": {
        "Url": "https://0.0.0.0:57774",
        "Protocols": "Http2"
      }
    }
  }
}</code></pre>
</div>

<hr />

<h2 id="service-installation">3. Production Service Registration</h2>

<h3 id="linux-systemd">3.1 Linux systemd Service (<code>/etc/systemd/system/rokka-coordinator.service</code>)</h3>
<div class="wiki-code-block relative group my-3 rounded-xl border border-slate-800 bg-[#060a14] overflow-hidden">
  <div class="code-header flex items-center justify-between px-3 py-1.5 bg-slate-900/90 border-b border-slate-800 text-[10px] font-mono text-slate-400">
    <span class="uppercase font-bold text-emerald-400">ini</span>
    <button type="button" onclick="copyCodeSnippet(this)" class="hover:text-white px-2 py-0.5 rounded bg-slate-800 border border-slate-700 transition cursor-pointer print:hidden">Copy</button>
  </div>
  <pre class="p-3.5 overflow-x-auto text-xs font-mono text-slate-200 leading-relaxed m-0"><code class="language-ini">[Unit]
Description=Aarkam Rokka Sovereign Coordinator &amp; Raft Quorum Daemon
After=network.target
Wants=network.target

[Service]
Type=simple
User=root
WorkingDirectory=/opt/aarkam/rokka
ExecStart=/opt/aarkam/rokka/rokka-coordinator
Restart=always
RestartSec=3s
LimitNOFILE=1048576
LimitMEMLOCK=infinity
Environment="ASPNETCORE_ENVIRONMENT=Production"

[Install]
WantedBy=multi-user.target</code></pre>
</div>

<h3 id="windows-powershell">3.2 Windows Server Service Registration</h3>
<div class="wiki-code-block relative group my-3 rounded-xl border border-slate-800 bg-[#060a14] overflow-hidden">
  <div class="code-header flex items-center justify-between px-3 py-1.5 bg-slate-900/90 border-b border-slate-800 text-[10px] font-mono text-slate-400">
    <span class="uppercase font-bold text-cyan-400">powershell</span>
    <button type="button" onclick="copyCodeSnippet(this)" class="hover:text-white px-2 py-0.5 rounded bg-slate-800 border border-slate-700 transition cursor-pointer print:hidden">Copy</button>
  </div>
  <pre class="p-3.5 overflow-x-auto text-xs font-mono text-slate-200 leading-relaxed m-0"><code class="language-powershell">Set-Location "C:\Program Files\Aarkam\Rokka"
.\install-rokka.ps1 -StartServices</code></pre>
</div>

<hr />

<h2 id="verification">4. Verification &amp; Quorum Health</h2>
<div class="wiki-code-block relative group my-3 rounded-xl border border-slate-800 bg-[#060a14] overflow-hidden">
  <div class="code-header flex items-center justify-between px-3 py-1.5 bg-slate-900/90 border-b border-slate-800 text-[10px] font-mono text-slate-400">
    <span class="uppercase font-bold text-emerald-400">bash</span>
    <button type="button" onclick="copyCodeSnippet(this)" class="hover:text-white px-2 py-0.5 rounded bg-slate-800 border border-slate-700 transition cursor-pointer print:hidden">Copy</button>
  </div>
  <pre class="p-3.5 overflow-x-auto text-xs font-mono text-slate-200 leading-relaxed m-0"><code class="language-bash"># Run pre-flight health doctor
am doctor --coordinator http://localhost:7774

# Query cluster quorum state
am cluster status</code></pre>
</div>

Document Identifier ARK-ROKKA-COORD-0203

Standard Status

Production Standard

Consensus Protocol Raft MON Quorum

Release Version V-1.0.0-GA (Production Stable)

Rokka.Coordinator (rokka-coordinator) is the distributed consensus authority and cluster topology controller. It manages cluster membership, dynamic Rendezvous (Highest Random Weight - HRW) shard placement across physical failure domains, and maintains operator credentials within embedded Kdouja LSM key-value tables.

1. Prerequisites & Quorum Sizing

Quorum Sizing: Production deployments require an odd number of coordinators (\(N = 3\) or \(N = 5\)) across independent physical hosts or racks to guarantee Byzantine-free partition tolerance.
Network Ports: Port 7774 (HTTP/2 gRPC) and 57774 (HTTPS / mTLS) between all coordinator nodes, storage daemons, and client ingress gateways.
Resource Footprint: 4 Physical Cores, 8 GB ECC RAM, and 50 GB fast NVMe partition for Raft transaction logs and LSM state.

2. Configuration (`coordinator.settings.json`)

On each quorum host, configure /opt/aarkam/rokka/coordinator.settings.json (or C:\Program Files\Aarkam\Rokka\coordinator.settings.json):

json

{
  "Logging": {
    "LogLevel": {
      "Default": "Information",
      "Rokka.Coordinator": "Information"
    }
  },
  "Coordinator": {
    "NodeId": "COORD-NODE-01",
    "ClusterName": "PROD-SOVEREIGN-CLUSTER",
    "HeartbeatIntervalMs": 150,
    "ElectionTimeoutMs": 300,
    "DataDirectory": "/var/lib/rokka/coordinator",
    "PeerNodes": [
      "https://coord-01.rokka.internal:57774",
      "https://coord-02.rokka.internal:57774",
      "https://coord-03.rokka.internal:57774"
    ]
  },
  "Kestrel": {
    "Endpoints": {
      "gRPC": {
        "Url": "http://0.0.0.0:7774",
        "Protocols": "Http2"
      },
      "mTLS": {
        "Url": "https://0.0.0.0:57774",
        "Protocols": "Http2"
      }
    }
  }
}

3. Production Service Registration

3.1 Linux systemd Service (`/etc/systemd/system/rokka-coordinator.service`)

ini

[Unit]
Description=Aarkam Rokka Sovereign Coordinator & Raft Quorum Daemon
After=network.target
Wants=network.target

[Service]
Type=simple
User=root
WorkingDirectory=/opt/aarkam/rokka
ExecStart=/opt/aarkam/rokka/rokka-coordinator
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-coordinator
sudo systemctl status rokka-coordinator

3.2 Windows Server Service Registration

powershell

Set-Location "C:\Program Files\Aarkam\Rokka"
.\install-rokka.ps1 -StartServices

4. Verification & Quorum Health

bash

# Run pre-flight health doctor
am doctor --coordinator http://localhost:7774

# Query cluster quorum state
am cluster status

← Previous Article

AarkamIO Sovereign Enterprise Cloud & Control Plane

Rokka S3 Gateway & Ahmodi SIMD Engine Setup

Rokka Coordinator Quorum & Consensus Setup

1. Prerequisites & Quorum Sizing

2. Configuration (coordinator.settings.json)

3. Production Service Registration

3.1 Linux systemd Service (/etc/systemd/system/rokka-coordinator.service)

3.2 Windows Server Service Registration

4. Verification & Quorum Health

2. Configuration (`coordinator.settings.json`)

3.1 Linux systemd Service (`/etc/systemd/system/rokka-coordinator.service`)