oib/aitbc
1
0
Fork 0
Code Issues Pull Requests Actions 21 Packages Projects Releases Wiki Activity
Files
dcc08e7569818886d907bb7b16f8326d3095269d
aitbc/docs/deployment/2_service-naming-convention.md
aitbc 7321242b75 docs: update port 8000 references to 8011 in deployment and blockchain docs 
- Update deployment/2_service-naming-convention.md: coordinator URL 8000 → 8011
- Update blockchain/adding_gitea_runner_as_third_node.md: API port 8000 → 8011
- More documentation files still need port 8000 → 8011 updates
2026-05-08 21:49:17 +02:00

2.9 KiB
Raw Blame History

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

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