Aarkam / Aarkam Wiki / Installation / Abodi Storage Node Daemon & Predictive Diagnostics ARK-DOC-ABODI-INSTALL-v1.0.0
Aarkam - SAT (Storage Substrate) Storage Daemon Installation • ARK-DOC-ABODI-INSTALL-v1.0.0

Abodi Storage Node Daemon & Predictive Diagnostics

Deploying the Abodi daemon on physical storage hosts for 66,048-byte sector-aligned Direct I/O and out-of-band SMART failure forecasting.

Last updated: Nov 03, 2026 Classification: Sovereign Tier-4 Enterprise
Document Identifier ARK-DOC-ABODI-INSTALL-v1.0.0
Standard Status
Production Standard
Storage Substrate Kdouja Direct I/O (66,048B)
Release Version V-1.0.0-GA (Production Stable)

The Abodi Sovereign Storage & Diagnostics Node Daemon (Abodi) is deployed as a resident background service on every physical storage host across the cluster. It serves two foundational functions:

  1. Embedded Kdouja PageStore: Exposes unbuffered, sector-aligned 66,048-byte physical block I/O directly to NVMe and SAS SSD storage devices, bypassing the OS kernel page cache entirely.
  2. Hardware Harvester & Predictive Diagnostics: Continuously queries raw NVMe/SMART counters, thermal sensors, and bus error rates to forecast drive failure up to 72 hours in advance using Weibull and Holt-Winters statistical models.

1. Physical Disk Preparation (Native 4Kn & IT-Mode)

Storage controllers must be configured in strict IT-Mode (no hardware RAID). Drives must be formatted with native 4Kn (4096-byte) sector geometry:

bash
# 1. Identify NVMe block devices
lsblk -d -o NAME,SIZE,MODEL,ROTA

# 2. Check sector format (must show 4096 bytes)
sudo nvme id-ns -H /dev/nvme0n1 | grep -i "lbaf"

# 3. Create dedicated storage partition directory
sudo mkdir -p /var/lib/rokka/storage

2. Automated Installation & Service Setup

2.1 Linux (Ubuntu 22.04/24.04, RHEL 8/9)

bash
# Unpack package
sudo mkdir -p /opt/rokka/abodi
sudo unzip abodi-v1.0.0-linux-x64.zip -d /opt/rokka/abodi
cd /opt/rokka/abodi
sudo chmod +x Abodi install-abodi.sh

# Run automated production installer
sudo ./install-abodi.sh \
  --node-code "NODE-01" \
  --rokka-url "http://127.0.0.1:7774" \
  --storage-dir "/var/lib/rokka/storage" \
  --enrollment-token "ET1.YOUR_ENROLLMENT_TOKEN"

# Verify systemd service status
sudo systemctl status rokka-abodi

2.2 Windows Server (PowerShell Administrator)

powershell
Set-Location "C:\Rokka\Abodi"
.\install-abodi.ps1 `
  -NodeCode "NODE-WIN-01" `
  -RokkaUrl "http://127.0.0.1:7774" `
  -EnrollmentToken "ET1.YOUR_ENROLLMENT_TOKEN" `
  -StorageDir "D:\rokka_storage"

# Verify service
Get-Service -Name "Rokka.Abodi.Agent"

3. Network Port & Firewall Configuration

Port Protocol Binding Operational Purpose
57775 gRPC (mTLS) 0.0.0.0 Direct I/O Kdouja Chunk Streaming & Replication across nodes.
7775 gRPC (Cleartext) 127.0.0.1 Local Intra-Node Direct Block Allocation Endpoint.
57776 HTTPS / REST (mTLS) 0.0.0.0 Node Telemetry, Hardware Manifest, and SMART Diagnostics API.
7776 HTTP / REST (Cleartext) 127.0.0.1 Local Host Diagnostic and Liveness Probe Endpoint.