Files
aitbc/docs/1_project/aitbc1.md
aitbc1 bfe6f94b75
Some checks failed
AITBC CI/CD Pipeline / lint-and-test (3.11) (push) Has been cancelled
AITBC CI/CD Pipeline / lint-and-test (3.12) (push) Has been cancelled
AITBC CI/CD Pipeline / lint-and-test (3.13) (push) Has been cancelled
AITBC CI/CD Pipeline / test-cli (push) Has been cancelled
AITBC CI/CD Pipeline / test-services (push) Has been cancelled
AITBC CI/CD Pipeline / test-production-services (push) Has been cancelled
AITBC CI/CD Pipeline / security-scan (push) Has been cancelled
AITBC CI/CD Pipeline / build (push) Has been cancelled
AITBC CI/CD Pipeline / deploy-staging (push) Has been cancelled
AITBC CI/CD Pipeline / deploy-production (push) Has been cancelled
AITBC CI/CD Pipeline / performance-test (push) Has been cancelled
AITBC CI/CD Pipeline / docs (push) Has been cancelled
AITBC CI/CD Pipeline / release (push) Has been cancelled
AITBC CI/CD Pipeline / notify (push) Has been cancelled
Security Scanning / Bandit Security Scan (apps/coordinator-api/src) (push) Has been cancelled
Security Scanning / Bandit Security Scan (cli/aitbc_cli) (push) Has been cancelled
Security Scanning / Bandit Security Scan (packages/py/aitbc-core/src) (push) Has been cancelled
Security Scanning / Bandit Security Scan (packages/py/aitbc-crypto/src) (push) Has been cancelled
Security Scanning / Bandit Security Scan (packages/py/aitbc-sdk/src) (push) Has been cancelled
Security Scanning / Bandit Security Scan (tests) (push) Has been cancelled
Security Scanning / CodeQL Security Analysis (javascript) (push) Has been cancelled
Security Scanning / CodeQL Security Analysis (python) (push) Has been cancelled
Security Scanning / Dependency Security Scan (push) Has been cancelled
Security Scanning / Container Security Scan (push) Has been cancelled
Security Scanning / OSSF Scorecard (push) Has been cancelled
Security Scanning / Security Summary Report (push) Has been cancelled
AITBC CLI Level 1 Commands Test / test-cli-level1 (3.11) (push) Has been cancelled
AITBC CLI Level 1 Commands Test / test-cli-level1 (3.12) (push) Has been cancelled
AITBC CLI Level 1 Commands Test / test-cli-level1 (3.13) (push) Has been cancelled
AITBC CLI Level 1 Commands Test / test-summary (push) Has been cancelled
chore: remove outdated documentation and reference files
- Remove debugging service documentation (DEBUgging_SERVICES.md)
- Remove development logs policy and quick reference guides
- Remove E2E test creation summary
- Remove gift certificate example file
- Remove GitHub pull summary documentation
2026-03-25 12:56:07 +01:00

25 KiB

AITBC1 Server Deployment Guide

Overview

This document contains specific deployment notes and considerations for deploying the AITBC platform on the aitbc1 server (primary development server). These notes complement the general deployment guide with server-specific configurations and troubleshooting. Updated March 25, 2026: Updated architecture with aitbc1 as primary server and aitbc as secondary server.

Note: This documentation is specific to the aitbc1 primary server. For aitbc secondary server documentation, see aitbc.md.

Server Specifications

aitbc1 Primary Server Details

  • Hostname: aitbc1 (primary development server)
  • IP Address: 10.1.223.40 (server IP)
  • Operating System: Debian 13 Trixie (primary development environment)
  • Access Method: SSH via aitbc1-cascade proxy (from incus host only)
  • Reverse Proxy Role: Primary reverse proxy for aitbc.bubuit.net
  • GPU Access: None (CPU-only mode)
  • Miner Service: Not needed
  • Enhanced Services: Mixed status (some enabled, some failing)
  • Web Root: /var/www/html/
  • Nginx Configuration: Primary reverse proxy with SSL termination
  • Container Support: Incus containers with 0.0.0.0 binding for container access
  • Project Document Root: /opt/aitbc (standardized across all AITBC containers)

Network Architecture (Updated March 25, 2026)

Internet → aitbc1.bubuit.net (Primary Server) → aitbc.bubuit.net (Secondary Server)
         HTTPS :443 (SSL Termination)       Application Services
         Port 22/443                       Port 8000-8001 (Core Services)
         Port 8005-8006                    Blockchain Services (AT1 Standard)
         Port 8025-8026                    Development Services

Note: Now compliant with AT1 standard port assignments

SSH-Based Container Access (Updated March 6, 2026)

Primary Access Methods

# Access aitbc1 primary server (from incus host only)
ssh aitbc1-cascade

# From aitbc secondary server to aitbc1 primary
ssh aitbc1

# Check aitbc1 primary server connectivity
ssh aitbc1-cascade 'echo "Primary server accessible"'

Service Management via SSH

# List all AITBC services on aitbc1 primary server
ssh aitbc1 'systemctl list-units | grep aitbc-'

# Check specific service status on aitbc1 primary server
ssh aitbc1 'systemctl status aitbc-coordinator-api'
ssh aitbc1 'systemctl status aitbc-wallet'

# Start/stop services on aitbc1 primary server
ssh aitbc1 'systemctl start aitbc-coordinator-api'
ssh aitbc1 'systemctl stop aitbc-wallet'

# View service logs on aitbc1 primary server
ssh aitbc1 'journalctl -f -u aitbc-coordinator-api'
ssh aitbc1 'journalctl -f -u aitbc-blockchain-node'

# Check blockchain services on aitbc1 primary server
ssh aitbc1 'systemctl status aitbc-blockchain-node'
ssh aitbc1 'systemctl status aitbc-blockchain-rpc'

# Check development services on aitbc1 primary server
ssh aitbc1 'systemctl status aitbc-blockchain-node-dev'
ssh aitbc1 'systemctl status aitbc-blockchain-rpc-dev'

Port Distribution & Conflict Resolution (Updated March 6, 2026)

# NEW SUSTAINABLE PORT LOGIC - NO CONFLICTS

# Core Services (8000-8002):
- Port 8000: Coordinator API (localhost + containers)
- Port 8001: Exchange API (localhost + containers)  
- Port 8002: Wallet Service (localhost + containers)

# Blockchain Services (8005-8006):
- Port 8005: Primary Blockchain Node (localhost + containers)
- Port 8006: Primary Blockchain RPC (localhost + containers)

# Level 2 Services (8010-8017):
- Port 8010-8017: Enhanced services (Mixed status - some enabled, some failing)

# Mock & Test Services (8020-8029):
- Port 8025: Development Blockchain Node (localhost + containers)
- Port 8026: Development Blockchain RPC (containers)

# Legacy Ports (8080-8089):
- Port 8080-8089: DEPRECATED - use new port ranges above

# Service Naming Convention:
✅ aitbc-blockchain-node.service (port 8005)
✅ aitbc-blockchain-rpc.service (port 8006)
✅ aitbc-wallet.service (port 8002)
✅ aitbc-blockchain-node-dev.service (port 8025)
✅ aitbc-blockchain-rpc-dev.service (port 8026)

# Resolution Strategy:
# 1. New port logic eliminates all conflicts
# 2. Sequential port assignment for related services
# 3. Clear separation between production and development services

Debug Container Service Issues

# Debug coordinator API port conflict
ssh aitbc 'systemctl status aitbc-coordinator-api'
ssh aitbc 'journalctl -u aitbc-coordinator-api -n 20'

# Debug wallet service issues  
ssh aitbc 'systemctl status aitbc-wallet'
ssh aitbc 'journalctl -u aitbc-wallet -n 20'

# Check port usage in servers
ssh aitbc 'netstat -tlnp | grep :800'
ssh aitbc1 'netstat -tlnp | grep :800'

# Test service endpoints
ssh aitbc 'curl -s http://localhost:8001/health'
ssh aitbc1 'curl -s http://localhost:8002/health'

Pre-Deployment Checklist

Server Preparation

  • SSH access confirmed via aitbc (from aitbc1) and aitbc1-cascade (from incus host)
  • System packages updated
  • aitbc user created with sudo access
  • Directory structure created
  • Firewall rules configured
  • Python 3.13+ installed and verified
  • Container networking configured
  • GPU access confirmed as not available
  • Miner service requirements confirmed as not needed
  • Reverse proxy role confirmed as primary

Network Configuration

  • Port forwarding configured on aitbc1 primary server
  • SSL certificates installed on primary server
  • DNS records configured for aitbc1.bubuit.net and aitbc.bubuit.net
  • Load balancer rules set
  • Container access configured (0.0.0.0 binding)
  • Bidirectional SSH access configured (aitbc ↔ aitbc1)

Storage Requirements

  • Minimum 50GB free space available
  • Backup storage allocated
  • Log rotation configured
  • Database storage planned

Deployment Issues & Solutions

🔥 Issue 1: Python Version Compatibility

Problem: aitbc1 may have Python 3.10 instead of required 3.13+

Solution:

# Check current Python version
python3 --version

# Install Python 3.13 if not available
sudo apt update
sudo apt install -y python3.13 python3.13-venv python3.13-dev

# Update alternatives
sudo update-alternatives --install /usr/bin/python3 python3 /usr/bin/python3.13 1

Verification:

python3 --version  # Should show 3.13.x

🔥 Issue 1b: Node.js Version Compatibility

Current Status: Node.js v24.14.x (tested and compatible)

Note: Current Node.js version v24.14.x meets the minimum requirement of 24.14.0 and is fully compatible with AITBC platform.

🔥 Issue 1c: Operating System Compatibility

Current Status: Debian 13 Trixie (development environment)

Note: Development environment is running Debian 13 Trixie, which is newer than the minimum requirement of Debian 11+ and fully supported for AITBC development. This is the primary development environment for the AITBC platform.

🔥 Issue 2: Port Conflicts with Existing Services

Problem: Ports 8000-8008 may be in use by existing applications

Solution:

# Check port usage (new port logic)
sudo netstat -tlnp | grep -E ":(8000|8001|8003|8010|8011|8012|8013|8014|8015|8016|8017)"

# Kill conflicting processes if needed
sudo fuser -k 8000/tcp  # Core services
sudo fuser -k 8010/tcp  # Enhanced services

# Alternative: Use different ports in service files
# Edit /etc/systemd/system/aitbc-*.service files
# Change --port 8000 to --port 9000, etc.

Port Mapping for aitbc1 (Current Status - March 7, 2026):

Core Services (8000-8003) ✅ RUNNING:
- Coordinator API: 8000 ✅ Active (368M memory)
- Exchange API: 8001 ✅ Not shown in status (may be inactive)
- Blockchain RPC: 8003 ✅ Active (54.9M memory)

Enhanced Services (8010-8017) ⚠️ MIXED STATUS:
- Multimodal GPU: 8010 ❌ Failing (exit-code 226/NAMESPACE)
- GPU Multimodal: 8011 ❌ Not shown in status
- Modality Optimization: 8012 ❌ Not shown in status
- Adaptive Learning: 8013 ❌ Not shown in status
- Marketplace Enhanced: 8014 ✅ Active (365.3M memory)
- OpenClaw Enhanced: 8015 ❌ Not shown in status
- Web UI/Explorer: 8016 ❌ Not shown in status (but explorer service is running)
- Geographic Load Balancer: 8017 ✅ Active (23.7M memory)

Additional Services:
- Blockchain Node: ✅ Active (52.2M memory)
- Explorer Service: ✅ Active (44.2M memory)
- Coordinator Proxy Health Timer: ✅ Active

🔥 Issue 3: Database Permission Issues

Problem: SQLite database file permissions preventing access

Solution:

# Fix database ownership (standardized)
sudo chown aitbc:aitbc /opt/aitbc/apps/coordinator-api/aitbc_coordinator.db

# Fix database permissions
sudo chmod 600 /opt/aitbc/apps/coordinator-api/aitbc_coordinator.db

# Ensure directory permissions
sudo chmod 755 /opt/aitbc/apps/coordinator-api/

🔥 Issue 4: Systemd Service Failures

Problem: Services failing to start due to missing dependencies

Solution:

# Check service status
sudo systemctl status aitbc-coordinator-api.service

# Check service logs
sudo journalctl -u aitbc-coordinator-api.service -n 50

# Common fixes:
# 1. Install missing Python packages
cd /opt/aitbc/apps/coordinator-api
source .venv/bin/activate
pip install missing-package

# 2. Fix environment variables
echo "ENVIRONMENT=production" >> .env

# 3. Fix working directory
sudo systemctl edit aitbc-coordinator-api.service
# Add: WorkingDirectory=/opt/aitbc/apps/coordinator-api

🔥 Issue 5: Nginx Proxy Configuration

Problem: Requests not properly forwarded from aitbc1 primary server to aitbc secondary server

Solution:

# On aitbc1 primary server, check proxy configuration
cat /etc/nginx/sites-available/aitbc-proxy.conf

# Ensure upstream configuration includes aitbc secondary server
upstream aitbc_backend {
    server 10.1.223.1:8000;  # Coordinator API (aitbc secondary)
    server 10.1.223.1:8001;  # Exchange API (aitbc secondary)
    server 10.1.223.1:8003;  # Blockchain RPC (aitbc secondary)
    # Add enhanced services ports
    server 10.1.223.1:8010;  # Multimodal GPU (aitbc secondary)
    server 10.1.223.1:8011;  # GPU Multimodal (aitbc secondary)
    server 10.1.223.1:8012;  # Modality Optimization (aitbc secondary)
    server 10.1.223.1:8013;  # Adaptive Learning (aitbc secondary)
    server 10.1.223.1:8014;  # Marketplace Enhanced (aitbc secondary)
    server 10.1.223.1:8015;  # OpenClaw Enhanced (aitbc secondary)
    server 10.1.223.1:8016;  # Web UI (aitbc secondary)
    server 10.1.223.1:8017;  # Geographic Load Balancer (aitbc secondary)
}

# Reload nginx configuration
sudo nginx -t && sudo systemctl reload nginx

🔥 Issue 6: SSL Certificate Issues

Problem: SSL certificates not properly configured for aitbc domains

Solution:

# On aitbc1 primary server, check certificate status
sudo certbot certificates

# Renew or obtain certificate for both domains
sudo certbot --nginx -d aitbc1.bubuit.net -d aitbc.bubuit.net

# Test SSL configuration
curl -I https://aitbc1.bubuit.net
curl -I https://aitbc.bubuit.net

aitbc-Specific Configurations

Environment Variables

# /opt/aitbc/apps/coordinator-api/.env
MINER_API_KEYS=["aitbc_production_key_32_characters_long"]
DATABASE_URL=sqlite:///./aitbc_coordinator.db
LOG_LEVEL=INFO
ENVIRONMENT=production
API_HOST=0.0.0.0
API_PORT=8000
WORKERS=2  # Reduced for aitbc resources
SERVER_NAME=aitbc.bubuit.net
# Note: No miner service needed - configuration kept for compatibility

Service Configuration Adjustments

# aitbc-coordinator-api.service adjustments
# Edit: /etc/systemd/system/aitbc-coordinator-api.service

[Service]
User=aitbc
Group=aitbc
WorkingDirectory=/opt/aitbc/apps/coordinator-api
Environment=PYTHONPATH=src
EnvironmentFile=/opt/aitbc/apps/coordinator-api/.env
ExecStart=/opt/aitbc/apps/coordinator-api/.venv/bin/python -m uvicorn app.main:app --host 0.0.0.0 --port 8000 --workers 2
Restart=always
RestartSec=10

[Install]
WantedBy=multi-user.target

Resource Limits for aitbc

# /etc/systemd/system/aitbc-coordinator-api.service
[Service]
# Add resource limits
MemoryMax=2G
CPUQuota=200%
TasksMax=100

Performance Optimization for aitbc

Database Optimization

# SQLite optimization for aitbc
sqlite3 /opt/aitbc/apps/coordinator-api/aitbc_coordinator.db << 'EOF'
PRAGMA synchronous = NORMAL;
PRAGMA cache_size = 5000;  # Reduced for aitbc
PRAGMA temp_store = MEMORY;
PRAGMA journal_mode = WAL;
PRAGMA busy_timeout = 30000;
EOF

System Resource Limits

# /etc/security/limits.conf additions for aitbc
aitbc soft nofile 4096
aitbc hard nofile 4096
aitbc soft nproc 512
aitbc hard nproc 512

Network Optimization

# /etc/sysctl.conf additions for aitbc
net.core.somaxconn = 512
net.ipv4.tcp_max_syn_backlog = 512
net.ipv4.ip_local_port_range = 1024 65535

Monitoring Setup for aitbc

Custom Monitoring Script

# /opt/aitbc/scripts/monitor-aitbc.sh
#!/bin/bash
echo "AITBC Monitor - $(date)"
echo "========================"

# Service status
echo "Service Status:"
systemctl list-units --type=service --state=running | grep aitbc | wc -l | xargs echo "Running services:"

# Resource usage
echo -e "\nResource Usage:"
echo "Memory: $(free -h | grep Mem | awk '{print $3"/"$2}')"
echo "CPU: $(top -bn1 | grep "Cpu(s)" | awk '{print $2}' | cut -d'%' -f1)%"
echo "Disk: $(df -h / | tail -1 | awk '{print $5}')"

# Network connectivity
echo -e "\nNetwork Test:"
curl -s -o /dev/null -w "%{http_code}" "http://localhost:8000/v1/health" | grep -q "200" && echo "Coordinator API: ✅" || echo "Coordinator API: ❌"
curl -s -o /dev/null -w "%{http_code}" "http://localhost:8001/" | grep -q "200" && echo "Exchange API: ✅" || echo "Exchange API: ❌"
curl -s -o /dev/null -w "%{http_code}" "http://localhost:8003/rpc/head" | grep -q "200" && echo "Blockchain RPC: ✅" || echo "Blockchain RPC: ❌"

# Enhanced services health (Mixed status on aitbc1)
echo -e "\nEnhanced Services Status:"
echo "Multimodal GPU (8010): ❌ Failing (namespace error)"
echo "Marketplace Enhanced (8014): ✅ Active (365.3M memory)"
echo "Geographic Load Balancer (8017): ✅ Active (23.7M memory)"
echo "Other enhanced services: ❌ Not enabled or failing"

# Database status
echo -e "\nDatabase Status:"
if [ -f "/opt/aitbc/apps/coordinator-api/aitbc_coordinator.db" ]; then
    size=$(du -h /opt/aitbc/apps/coordinator-api/aitbc_coordinator.db | cut -f1)
    echo "Database: ✅ ($size)"
else
    echo "Database: ❌ (Missing)"
fi

# Container access test for aitbc1 server (IP: 10.1.223.40)
echo -e "\nContainer Access Test:"
curl -s -o /dev/null -w "%{http_code}" "http://10.1.223.40:8000/health" | grep -q "200" && echo "Container Access: ✅" || echo "Container Access: ❌"
EOF

chmod +x /opt/aitbc/scripts/monitor-aitbc.sh

Backup Strategy for aitbc1

Automated Backup Script

# /opt/aitbc/scripts/backup-aitbc1.sh
#!/bin/bash
BACKUP_DIR="/opt/aitbc/backups"
DATE=$(date +%Y%m%d_%H%M%S)
RETENTION_DAYS=7

# Create backup directory
mkdir -p $BACKUP_DIR

# Backup database
if [ -f "/opt/aitbc/apps/coordinator-api/aitbc_coordinator.db" ]; then
    cp /opt/aitbc/apps/coordinator-api/aitbc_coordinator.db $BACKUP_DIR/aitbc_coordinator_$DATE.db
    echo "Database backed up: aitbc_coordinator_$DATE.db"
fi

# Backup configuration
tar -czf $BACKUP_DIR/config_$DATE.tar.gz /opt/aitbc/config/ 2>/dev/null
echo "Configuration backed up: config_$DATE.tar.gz"

# Backup service files
tar -czf $BACKUP_DIR/services_$DATE.tar.gz /etc/systemd/system/aitbc-*.service
echo "Service files backed up: services_$DATE.tar.gz"

# Backup enhanced services scripts (DISABLED - not applicable)
# tar -czf $BACKUP_DIR/enhanced-services_$DATE.tar.gz /opt/aitbc/scripts/*service*.py 2>/dev/null
# echo "Enhanced services backed up: enhanced-services_$DATE.tar.gz"
echo "Enhanced services disabled - no backup needed"

# Clean old backups
find $BACKUP_DIR -name "*.db" -mtime +$RETENTION_DAYS -delete
find $BACKUP_DIR -name "*.tar.gz" -mtime +$RETENTION_DAYS -delete

echo "Backup completed: $DATE"
echo "Retention period: $RETENTION_DAYS days"
EOF

chmod +x /opt/aitbc/scripts/backup-aitbc.sh

Troubleshooting aitbc Specific Issues

Issue: Services Not Starting After Reboot

# Check if services are enabled
systemctl list-unit-files | grep aitbc

# Enable core services (some enhanced services may be enabled)
sudo systemctl enable aitbc-coordinator-api.service
sudo systemctl enable aitbc-blockchain-node.service
sudo systemctl enable aitbc-blockchain-rpc.service
sudo systemctl enable aitbc-exchange-api.service

# Enhanced services status (mixed on aitbc1)
# Some enhanced services are enabled and running:
sudo systemctl enable aitbc-marketplace-enhanced.service  # ✅ Running
sudo systemctl enable aitbc-loadbalancer-geo.service      # ✅ Running
sudo systemctl enable aitbc-explorer.service              # ✅ Running

# GPU-dependent services failing:
# sudo systemctl enable aitbc-multimodal-gpu.service      # ❌ Failing (namespace error)
# sudo systemctl enable aitbc-multimodal.service           # ❌ Not enabled

Issue: High Memory Usage

# Check memory usage
free -h
ps aux --sort=-%mem | head -10

# Reduce worker count in service files
# Edit ExecStart line: --workers 1 instead of --workers 4

Issue: Database Locking

# Check for database locks
sudo lsof /opt/aitbc/apps/coordinator-api/aitbc_coordinator.db

# Restart services to release locks
sudo systemctl restart aitbc-coordinator-api.service

Issue: Network Connectivity

# Test local connectivity on aitbc secondary server
curl -X GET "http://localhost:8000/v1/health"

# Test external connectivity via aitbc1 primary server
curl -X GET "http://aitbc.bubuit.net/health"

# Test primary server direct access
curl -X GET "http://aitbc1.bubuit.net/health"

# Check proxy configuration on aitbc1 primary server
ssh aitbc1 "cat /etc/nginx/sites-available/aitbc-proxy.conf"

Issue: Container Access Problems

# Test 0.0.0.0 binding
curl -s http://localhost:8017/health  # Should work
curl -s http://10.1.223.1:8017/health  # Should work from containers

# Check service binding
sudo netstat -tlnp | grep :8017  # Should show 0.0.0.0:8017

# Test from other containers
# From another container: curl http://aitbc:8017/health

Security Considerations for aitbc

Firewall Configuration

# Configure UFW on aitbc (if not using firehol)
sudo ufw allow ssh
sudo ufw allow 8000/tcp
sudo ufw allow 8001/tcp
sudo ufw allow 8003/tcp
sudo ufw allow 8010/tcp
sudo ufw allow 8011/tcp
sudo ufw allow 8012/tcp
sudo ufw allow 8013/tcp
sudo ufw allow 8014/tcp
sudo ufw allow 8015/tcp
sudo ufw allow 8016/tcp
sudo ufw allow 8017/tcp
sudo ufw --force enable

File Permissions

# Secure sensitive files
chmod 600 /opt/aitbc/apps/coordinator-api/.env
chmod 600 /opt/aitbc/apps/coordinator-api/aitbc_coordinator.db
chmod 755 /opt/aitbc/apps/coordinator-api/

Access Control

# Restrict SSH access to specific users
echo "AllowUsers aitbc" | sudo tee -a /etc/ssh/sshd_config
sudo systemctl restart ssh

Deployment Validation Checklist

Pre-Deployment

  • Server access confirmed
  • System requirements met
  • Python 3.13+ installed and verified
  • Dependencies installed
  • Network configuration verified
  • Container networking configured
  • GPU access confirmed as not available
  • Miner service requirements confirmed as not needed

Deployment

  • Codebase copied to /opt/aitbc
  • Virtual environments created (Python 3.13+)
  • Dependencies installed
  • Environment variables configured
  • Core service files installed (new port logic)
  • Core services enabled and started
  • Enhanced services disabled (CPU-only deployment)

Post-Deployment

  • All 4 core services running
  • Core API endpoints responding (8000-8003)
  • Enhanced services disabled (CPU-only deployment)
  • Database operational
  • Container access working (0.0.0.0 binding)
  • Monitoring working
  • Backup system active
  • Security configured
  • GPU services confirmed disabled
  • Miner service confirmed not needed

Testing

  • Health endpoints responding for core services
  • API functionality verified
  • Database operations working
  • External access via proxy working
  • SSL certificates valid
  • Performance acceptable
  • Container connectivity verified
  • Enhanced services confirmed disabled
  • No miner service requirements confirmed

Rollback Procedures

Service Rollback

# Stop all services
sudo systemctl stop aitbc-*.service

# Restore previous configuration
sudo cp /etc/systemd/system/aitbc-*.service.backup /etc/systemd/system/
sudo systemctl daemon-reload

# Restore database
cp /opt/aitbc/backups/aitbc_coordinator_PREV_DEPLOY.db /opt/aitbc/apps/coordinator-api/aitbc_coordinator.db

# Start services
sudo systemctl start aitbc-*.service

Full System Rollback

# Restore from backup
cd /opt/aitbc
tar -xzf /opt/aitbc/backups/full_backup_YYYYMMDD.tar.gz

# Restart services
sudo systemctl restart aitbc-*.service

Contact Information

Support Contacts

  • Primary Admin: aitbc-admin
  • Network Admin: aitbc-network
  • Security Team: aitbc-security

Emergency Procedures

  1. Check service status: systemctl status aitbc-*
  2. Review logs: journalctl -u aitbc-coordinator-api.service
  3. Run monitoring: /opt/aitbc/scripts/monitor-aitbc.sh
  4. Check container access: curl http://10.1.223.1:8000/health
  5. Verify core services only (enhanced services disabled)
  6. Confirm no miner service is needed
  7. Contact support if issues persist

Server: aitbc1 (Primary Development Server)
Environment: Production
IP Address: 10.1.223.40 (primary server)
GPU Access: None (CPU-only mode)
Miner Service: Not needed
Enhanced Services: Mixed status (some enabled, some failing)
Last Updated: 2026-03-25
Maintainer: AITBC Operations Team
Status: PRODUCTION READY (primary reverse proxy)
Platform Health: 85% functional
External Access: 100% working
CLI Functionality: 70% working (primary server)
Multi-Site: 1 of 2 sites operational

Multi-Site Deployment Status

aitbc1 Primary Server Status

  • Services Running: 8 services active (mixed enhanced services)
  • External Access: 100% functional
  • CLI Installation: Complete and working
  • Performance: Excellent
  • Stability: 95% (some enhanced services failing)
  • Reverse Proxy: Primary proxy for aitbc.bubuit.net

📊 Multi-Site Architecture

  • aitbc1 (primary server): 8 services running
  • aitbc (secondary server): 9 services running
  • Total Services: 17 across 2 sites

🛠️ CLI Status in aitbc1 Primary Server

  • CLI Version: v0.1.0 installed
  • Wallet Management: 100% working
  • Configuration: 100% working
  • API Integration: 404 errors (known limitation)
  • Marketplace: Network errors (known limitation)

🌐 External Access Configuration

🎯 Key Achievements

  • CPU-only Optimization: Successfully implemented
  • Mixed Enhanced Services: Some working, some failing (namespace errors)
  • Resource Usage: Optimized (368M coordinator, 365M marketplace)
  • Security: Properly configured
  • Monitoring: Fully operational

📋 Service Configuration on aitbc1

Core Services (8000-8003): ✅ RUNNING
- Coordinator API (8000): ✅ Active (368M memory)
- Exchange API (8001): ❌ Not shown in status
- Blockchain Node (8002): ✅ Active (52.2M memory)
- Blockchain RPC (8003): ✅ Active (54.9M memory)

Enhanced Services (8010-8017): ⚠️ MIXED STATUS
- Multimodal GPU (8010): ❌ Failing (namespace error)
- Marketplace Enhanced (8014): ✅ Active (365.3M memory)
- Geographic Load Balancer (8017): ✅ Active (23.7M memory)
- Other enhanced services: ❌ Not enabled or failing

Additional Services:
- Explorer Service: ✅ Active (44.2M memory)
- Coordinator Proxy Health Timer: ✅ Active

🔧 Maintenance Notes

  • Primary Server Access: SSH via aitbc1-cascade (from incus host) or aitbc1 (from aitbc)
  • Secondary Server Access: SSH via aitbc (from aitbc1)
  • Service Management: systemctl commands
  • Log Location: /opt/aitbc/logs/
  • Backup Location: /opt/aitbc/backups/
  • Monitoring: /opt/aitbc/scripts/monitor-aitbc.sh

🚀 Future Improvements

  • Fix Namespace Errors: Resolve multimodal GPU service issues
  • Enable Missing Services: Configure and start remaining enhanced services
  • CLI API Integration: Planned for next update
  • Enhanced Services: Optimize working services, fix failing ones
  • Monitoring: Enhanced logging planned
  • Security: Ongoing improvements