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.
176 lines
7.8 KiB
Markdown
176 lines
7.8 KiB
Markdown
# 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
|
|
```bash
|
|
/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
|
|
```bash
|
|
/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
|
|
```bash
|
|
# 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
|
|
```bash
|
|
/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
|
|
```bash
|
|
# 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
|
|
```bash
|
|
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
|
|
```bash
|
|
curl -s http://localhost:8020/health # Multimodal Service
|
|
curl -s http://localhost:8021/health # Modality Optimization
|
|
```
|
|
|
|
### Blockchain Services
|
|
```bash
|
|
# 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
|