Files
aitbc/docs/deployment/2_service-naming-convention.md
aitbc 19d415a235
Some checks failed
Blockchain Synchronization Verification / sync-verification (push) Failing after 3s
CLI Tests / test-cli (push) Failing after 3s
Cross-Chain Functionality Tests / test-cross-chain-sync (push) Successful in 2s
Cross-Chain Functionality Tests / test-cross-chain-transactions (push) Successful in 3s
Cross-Chain Functionality Tests / test-cross-chain-bridge (push) Has been skipped
Cross-Chain Functionality Tests / test-multi-chain-consensus (push) Successful in 2s
Cross-Chain Functionality Tests / aggregate-results (push) Has been skipped
Deploy to Testnet / deploy-testnet (push) Successful in 1m12s
Documentation Validation / validate-docs (push) Failing after 8s
Documentation Validation / validate-policies-strict (push) Successful in 3s
Integration Tests / test-service-integration (push) Successful in 2m6s
Multi-Chain Island Architecture Tests / test-multi-chain-island (push) Successful in 2s
Multi-Node Blockchain Health Monitoring / health-check (push) Failing after 4s
P2P Network Verification / p2p-verification (push) Successful in 4s
Package Tests / Python package - aitbc-agent-sdk (push) Successful in 32s
Package Tests / Python package - aitbc-core (push) Successful in 14s
Package Tests / Python package - aitbc-crypto (push) Successful in 12s
Package Tests / Python package - aitbc-sdk (push) Successful in 9s
Package Tests / JavaScript package - aitbc-sdk-js (push) Successful in 8s
Package Tests / JavaScript package - aitbc-token (push) Successful in 17s
Python Tests / test-python (push) Successful in 15s
Security Scanning / security-scan (push) Successful in 27s
Node Failover Simulation / failover-test (push) Successful in 7s
Multi-Node Stress Testing / stress-test (push) Successful in 6s
Cross-Node Transaction Testing / transaction-test (push) Successful in 4s
feat: add SQLCipher database encryption support and consolidate agent documentation
- Add SQLCipher encryption for ait-mainnet database with configurable flag
- Add db_encryption_enabled and db_encryption_key_path config settings
- Implement encryption key loading and PRAGMA key setup via connection events
- Add shutdown_db function for proper database cleanup
- Export middleware classes in aitbc/__init__.py
- Fix import path in sync.py for settings
- Remove duplicate agent documentation from docs
2026-05-03 12:00:38 +02:00

2.9 KiB

AITBC Service Naming Convention

Updated Service Names (2026-02-13)

All AITBC systemd services now follow the aitbc- prefix convention for consistency and easier management.

Site A (aitbc.bubuit.net) - Production Services

Old Name New Name Port Description
blockchain-node.service aitbc-blockchain-node-1.service 8081 Blockchain Node 1
blockchain-node-2.service aitbc-blockchain-node-2.service 8082 Blockchain Node 2
blockchain-rpc.service aitbc-blockchain-rpc-1.service - RPC API for Node 1
blockchain-rpc-2.service aitbc-blockchain-rpc-2.service - RPC API for Node 2
coordinator-api.service aitbc-coordinator-api.service 8000 Coordinator API
exchange-mock-api.service aitbc-exchange-mock-api.service - Exchange Mock API

Site B (ns3 container) - Remote Node

Old Name New Name Port Description
blockchain-node.service aitbc-blockchain-node-3.service 8082 Blockchain Node 3
blockchain-rpc.service aitbc-blockchain-rpc-3.service - RPC API for Node 3

Already Compliant Services

These services already had the aitbc- prefix:

  • aitbc-exchange-api.service (port 3003)
  • aitbc-exchange.service (port 3002)
  • aitbc-miner-dashboard.service

Removed Services

  • aitbc-blockchain.service (legacy, was on port 9080)

Management Commands

Check Service Status

# Site A (via SSH)
ssh aitbc "systemctl status aitbc-blockchain-node-1.service"

# Site B (via SSH)
ssh ns3-root "incus exec aitbc -- systemctl status aitbc-blockchain-node-3.service"

Restart Services

# Site A
ssh aitbc "systemctl restart aitbc-blockchain-node-1.service"

# Site B
ssh ns3-root "incus exec aitbc -- systemctl restart aitbc-blockchain-node-3.service"

View Logs

# Site A
ssh aitbc "journalctl -u aitbc-blockchain-node-1.service -f"

# Site B
ssh ns3-root "incus exec aitbc -- journalctl -u aitbc-blockchain-node-3.service -f"

Service Dependencies

Blockchain Nodes

  • Node 1: /opt/blockchain-node → port 8081
  • Node 2: /opt/blockchain-node-2 → port 8082
  • Node 3: /opt/blockchain-node → port 8082 (Site B)

RPC Services

  • RPC services are companion services to the main nodes
  • They provide HTTP API endpoints for blockchain operations

Coordinator API

  • Main API for job submission, miner management, and receipts
  • Runs on localhost:8000 inside container
  • Proxied via nginx at https://aitbc.bubuit.net/api/

Benefits of Standardized Naming

  1. Clarity: Easy to identify AITBC services among system services
  2. Management: Simpler to filter and manage with wildcards (systemctl status aitbc-*)
  3. Documentation: Consistent naming across all documentation
  4. Automation: Easier scripting and automation with predictable names
  5. Debugging: Faster identification of service-related issues