Files
proxmox/docs/archive/deployment-reports/SANKOFA_DEPLOYMENT_STATUS.md
defiQUG fbda1b4beb
Some checks failed
Deploy to Phoenix / deploy (push) Has been cancelled
docs: Ledger Live integration, contract deploy learnings, NEXT_STEPS updates
- ADD_CHAIN138_TO_LEDGER_LIVE: Ledger form done; public code review repo bis-innovations/LedgerLive; init/push commands
- CONTRACT_DEPLOYMENT_RUNBOOK: Chain 138 gas price 1 gwei, 36-addr check, TransactionMirror workaround
- CONTRACT_*: AddressMapper, MirrorManager deployed 2026-02-12; 36-address on-chain check
- NEXT_STEPS_FOR_YOU: Ledger done; steps completable now (no LAN); run-completable-tasks-from-anywhere
- MASTER_INDEX, OPERATOR_OPTIONAL, SMART_CONTRACTS_INVENTORY_SIMPLE: updates
- LEDGER_BLOCKCHAIN_INTEGRATION_COMPLETE: bis-innovations/LedgerLive reference

Co-authored-by: Cursor <cursoragent@cursor.com>
2026-02-12 15:46:57 -08:00

148 lines
4.2 KiB
Markdown

# Sankofa Deployment Status Review
**Date:** 2026-01-20
**Status:** ⚠️ **IN PROGRESS** - Network Configuration Issue
---
## ✅ Completed Steps
### 1. Configuration Preparation
- ✅ Created `.env.r630-01` from template
- ✅ Verified Sankofa project exists at `/home/intlc/projects/Sankofa`
- ✅ Verified SSH access to r630-01 (192.168.11.11)
### 2. Container Deployment
-**All 4 containers deployed successfully:**
- VMID 7803: sankofa-postgres-1 (10.160.0.13) - PostgreSQL
- VMID 7802: sankofa-keycloak-1 (10.160.0.12) - Keycloak
- VMID 7800: sankofa-api-1 (10.160.0.10) - API
- VMID 7801: sankofa-portal-1 (10.160.0.11) - Portal
- ✅ All containers are running
- ✅ All containers have correct IP addresses assigned
- ✅ DNS configured on all containers (8.8.8.8, 1.1.1.1)
---
## ⚠️ Current Issues
### Critical: Network Connectivity Problem
**Problem:** Containers cannot reach gateway 10.160.0.1
**Symptoms:**
- Containers have correct IP addresses (10.160.0.10-13)
- Containers have correct routing (default via 10.160.0.1)
- ❌ Cannot ping gateway 10.160.0.1
- ❌ Cannot reach internet (needed for package installation)
**Root Cause:**
- VLAN 160 interface not configured on Proxmox host (r630-01)
- Host has vmbr0 (192.168.11.11/24) but no VLAN 160 interface
- Gateway 10.160.0.1 may not exist or be unreachable
**Network Configuration:**
```
Host (r630-01):
- vmbr0: 192.168.11.11/24 (VLAN 11 - MGMT-LAN)
- vmbr0v200: 10.200.0.1/20 (VLAN 200)
- ❌ No VLAN 160 interface
Containers:
- 7800: 10.160.0.10/22 (API)
- 7801: 10.160.0.11/22 (Portal)
- 7802: 10.160.0.12/22 (Keycloak)
- 7803: 10.160.0.13/22 (PostgreSQL)
- Gateway: 10.160.0.1 (UNREACHABLE)
```
---
## 🔧 Required Fixes
### 1. Configure VLAN 160 on Proxmox Host
**Option A: Create VLAN interface on vmbr0**
```bash
# On r630-01
ip link add link vmbr0 name vmbr0.160 type vlan id 160
ip addr add 10.160.0.1/22 dev vmbr0.160
ip link set vmbr0.160 up
# Make persistent in /etc/network/interfaces
```
**Option B: Verify router/gateway configuration**
- Check if 10.160.0.1 exists on router (UDM Pro or ER605)
- Verify VLAN 160 is configured on router
- Verify inter-VLAN routing is enabled
### 2. Alternative: Use Host as Gateway
If VLAN 160 gateway doesn't exist, configure host routing:
```bash
# Enable IP forwarding
echo 1 > /proc/sys/net/ipv4/ip_forward
# Add route for 10.160.0.0/22
ip route add 10.160.0.0/22 dev vmbr0
# Configure NAT if needed
iptables -t nat -A POSTROUTING -s 10.160.0.0/22 -o vmbr0 -j MASQUERADE
```
---
## 📋 Pending Steps
### Phase 3: Service Setup (Blocked by Network Issue)
- ⏸️ Setup PostgreSQL (requires internet access for packages)
- ⏸️ Setup Keycloak (requires internet access for packages)
- ⏸️ Deploy API service
- ⏸️ Deploy Portal service
### Phase 4: Verification & Documentation
- ⏸️ Verify services are running
- ⏸️ Test health endpoints
- ⏸️ Update cutover plan with actual IPs/ports
- ⏸️ Test internal connectivity from NPMplus
### Phase 5: Cutover
- ⏸️ Update NPMplus proxy hosts
- ⏸️ Verify SSL certificates
- ⏸️ Test end-to-end routing
- ⏸️ Update source-of-truth documentation
---
## 📊 Deployment Summary
| Component | Status | Notes |
|-----------|--------|-------|
| Containers Created | ✅ Complete | All 4 containers deployed |
| Network Configuration | ❌ Blocked | VLAN 160 not configured |
| PostgreSQL Setup | ⏸️ Pending | Requires network |
| Keycloak Setup | ⏸️ Pending | Requires network |
| API Deployment | ⏸️ Pending | Requires network |
| Portal Deployment | ⏸️ Pending | Requires network |
| Cutover Plan Update | ⏸️ Pending | Awaiting service deployment |
---
## 🎯 Next Actions
1. **IMMEDIATE:** Configure VLAN 160 on Proxmox host or verify router configuration
2. **After Network Fix:** Continue with PostgreSQL setup
3. **After Services Deployed:** Update cutover plan documentation
4. **Final:** Perform NPMplus cutover
---
## 📝 Notes
- Containers are using unprivileged mode
- Network configuration uses static IPs on VLAN 160
- Gateway 10.160.0.1 should be configured on router (UDM Pro or ER605)
- Inter-VLAN routing must be enabled for containers to reach internet
- No Cloudflare tunnels will be used (per user request)