963910c787
Some checks failed
Documentation Validation / validate-docs (push) Failing after 9s
Documentation Validation / validate-policies-strict (push) Failing after 3s
Integration Tests / test-service-integration (push) Successful in 1m59s
Python Tests / test-python (push) Successful in 23s
Security Scanning / security-scan (push) Successful in 1m48s
P2P Network Verification / p2p-verification (push) Successful in 3s
Blockchain Synchronization Verification / sync-verification (push) Failing after 9s
Multi-Node Blockchain Health Monitoring / health-check (push) Successful in 2s
Remove obsolete aitbc-gpu.service references across documentation, scripts, and deployment files. GPU functionality is now unified into aitbc-marketplace.service (port 8007). Update blockchain health check to use gitea-runner hostname for aitbc2. Clarify WAL mode comment in database.py to reference btrfs raid instead of generic disk I/O errors. Mark cross-link validation checks as complete in compliance audit.
7.8 KiB
7.8 KiB
AITBC Port Mapping Guide - March 30, 2026
🚀 Complete Service Port Allocation
🔧 Core Services (8000-8009) - Essential Infrastructure
| Port | Service | Endpoint | Status | Description |
|---|---|---|---|---|
| 8000 | Coordinator API | http://localhost:8000/health |
✅ Active | Main orchestration and coordination |
| 8001 | Exchange API | http://localhost:8001/api/health |
✅ Active | Trading and exchange functionality |
| 8002 | Marketplace API | http://localhost:8002/health |
✅ Active | GPU compute marketplace |
| 8003 | Wallet API | http://localhost:8003/health |
✅ Active | Digital wallet management |
| 8004 | Explorer | http://localhost:8004/health |
✅ Active | Blockchain explorer interface |
| 8005 | Available | - | 🔄 Free | Available for future core service |
| 8006 | Blockchain RPC | - | ✅ Active | Blockchain RPC (systemd service) |
| 8007 | Web UI | http://localhost:8007/ |
✅ Active | Web user interface |
| 8008 | Available | - | 🔄 Free | Available for future core service |
| 8009 | Available | - | 🔄 Free | Available for future core service |
🚀 AI/Agent/GPU Services (8010-8019) - Advanced Features
| Port | Service | Endpoint | Status | Description |
|---|---|---|---|---|
| 8010 | GPU Service | http://localhost:8010/health |
✅ Active | GPU-accelerated processing |
| 8011 | Learning Service | http://localhost:8011/health |
✅ Active | Machine learning and adaptation |
| 8012 | Agent Coordinator | http://localhost:8012/health |
✅ Active | Agent orchestration and coordination |
| 8013 | Agent Registry | http://localhost:8013/health |
✅ Active | Agent registration and discovery |
| 8014 | OpenClaw Service | http://localhost:8014/health |
✅ Active | Edge computing and agent orchestration |
| 8015 | AI Service | http://localhost:8015/health |
✅ Active | Advanced AI capabilities |
| 8016 | Available | - | 🔄 Free | Available for future AI/agent service |
| 8017 | Available | - | 🔄 Free | Available for future AI/agent service |
| 8018 | Available | - | 🔄 Free | Available for future AI/agent service |
| 8019 | Available | - | 🔄 Free | Available for future AI/agent service |
📊 Other Services (8020-8029) - Specialized Services
| Port | Service | Endpoint | Status | Description |
|---|---|---|---|---|
| 8020 | Multimodal Service | http://localhost:8020/health |
✅ Active | Multi-modal data processing |
| 8021 | Modality Optimization | http://localhost:8021/health |
✅ Active | Modality optimization engine |
| 8022 | Available | - | 🔄 Free | Available for future specialized service |
| 8023 | Available | - | 🔄 Free | Available for future specialized service |
| 8024 | Available | - | 🔄 Free | Available for future specialized service |
| 8025 | Available | - | 🔄 Free | Available for future specialized service |
| 8026 | Available | - | 🔄 Free | Available for future specialized service |
| 8027 | Available | - | 🔄 Free | Available for future specialized service |
| 8028 | Available | - | 🔄 Free | Available for future specialized service |
| 8029 | Available | - | 🔄 Free | Available for future specialized service |
🔧 Service Configuration Files
Core Services
/etc/systemd/system/aitbc-coordinator-api.service # Port 8000
/etc/systemd/system/aitbc-exchange-api.service # Port 8001
/etc/systemd/system/aitbc-marketplace.service # Port 8002
/etc/systemd/system/aitbc-wallet.service # Port 8003
apps/blockchain-explorer/main.py # Port 8004
/etc/systemd/system/aitbc-web-ui.service # Port 8007
Blockchain Services
/etc/systemd/system/aitbc-blockchain-node.service # Systemd service
/etc/systemd/system/aitbc-blockchain-rpc.service # Port 8006 (from blockchain.env)
AI/Agent/GPU Services
# GPU functionality unified into aitbc-marketplace.service (port 8007)
/etc/systemd/system/aitbc-learning.service # Port 8011
apps/agent-services/agent-coordinator/src/coordinator.py # Port 8012
apps/agent-services/agent-registry/src/app.py # Port 8013
/etc/systemd/system/aitbc-openclaw.service # Port 8014
apps/coordinator-api/src/app/services/advanced_ai_service.py # Port 8015
Other Services
/etc/systemd/system/aitbc-multimodal.service # Port 8020
/etc/systemd/system/aitbc-modality-optimization.service # Port 8021
🎯 Port Allocation Strategy
Core Services (8000-8009)
- Purpose: Essential AITBC infrastructure
- Services: Coordinator, Exchange, Marketplace, Wallet, Explorer, Web UI
- Blockchain: Node and RPC services
- Priority: Highest - required for basic AITBC functionality
AI/Agent/GPU Services (8010-8019)
- Purpose: Advanced AI, agent orchestration, and GPU processing
- Services: GPU, Learning, Agent Coordinator, Agent Registry, OpenClaw, AI
- Priority: High - enhances AITBC capabilities
- Features: Machine learning, agent management, edge computing
Other Services (8020-8029)
- Purpose: Specialized and experimental services
- Services: Multimodal processing, modality optimization
- Priority: Medium - optional enhancements
- Features: Multi-modal data processing, optimization engines
🚀 Health Check Commands
Quick Health Check
# Run comprehensive health check
/opt/aitbc/health-check.sh
# Check specific service categories
curl -s http://localhost:8000/health # Coordinator API
curl -s http://localhost:8001/api/health # Exchange API
curl -s http://localhost:8002/health # Marketplace API
curl -s http://localhost:8003/health # Wallet API
curl -s http://localhost:8004/health # Explorer
curl -s http://localhost:8007/ # Web UI
AI/Agent/GPU Services
curl -s http://localhost:8010/health # GPU Service
curl -s http://localhost:8011/health # Learning Service
curl -s http://localhost:8012/health # Agent Coordinator
curl -s http://localhost:8013/health # Agent Registry
curl -s http://localhost:8014/health # OpenClaw Service
curl -s http://localhost:8015/health # AI Service
Other Services
curl -s http://localhost:8020/health # Multimodal Service
curl -s http://localhost:8021/health # Modality Optimization
Blockchain Services
# Check blockchain services (systemd)
systemctl status aitbc-blockchain-node.service
systemctl status aitbc-blockchain-rpc.service
📋 Port Usage Summary
- Total Services: 16 active services
- Used Ports: 8000-8007, 8010-8015, 8020-8021
- Available Ports: 8005, 8008-8009, 8016-8019, 8022-8029
- Port Conflicts: None resolved ✅
- Status: Perfect organization achieved ✅
🔄 Recent Changes (March 30, 2026)
Port Reorganization Complete
- ✅ Resolved all port conflicts
- ✅ Sequential port assignment within ranges
- ✅ Services grouped by function and importance
- ✅ Complete documentation synchronization
- ✅ Perfect port allocation strategy compliance
Service Migration Summary
- Explorer: Moved from 8022 → 8004 (Core Services)
- Web UI: Moved from 8016 → 8007 (Core Services)
- Learning Service: Moved from 8010 → 8011 (AI/Agent/GPU)
- Agent Coordinator: Moved from 8011 → 8012 (AI/Agent/GPU)
- Agent Registry: Moved from 8012 → 8013 (AI/Agent/GPU)
- OpenClaw Service: Moved from 8013 → 8014 (AI/Agent/GPU)
- AI Service: Moved from 8009 → 8015 (AI/Agent/GPU)
- Modality Optimization: Moved from 8023 → 8021 (Other Services)
- Multimodal Service: Moved from 8005 → 8020 (Other Services)
Last Updated: March 30, 2026
Status: ✅ Perfect port organization achieved
Next Review: As needed for new service additions