Production Deployment: Appendix

Production Deployment: Appendix

Part of: Production Deployment Guide

---

A. Quick Reference Commands

# Start cluster
kubectl apply -k kubernetes/

# Check cluster status
heliosdb-cli cluster status

# Scale compute nodes
kubectl scale deployment heliosdb-compute --replicas=5 -n heliosdb

# Backup database
heliosdb-cli backup create --type full

# Restore from backup
heliosdb-cli restore --backup <backup-id>

# Monitor metrics
kubectl port-forward -n monitoring svc/prometheus 9090:9090

# View logs
kubectl logs -f -n heliosdb deployment/heliosdb-compute

# Execute query
heliosdb-cli query execute "SELECT version()"

B. Configuration Examples

See sections 5.1-5.5 for detailed configuration examples.

C. Port Reference

See section 2.4.1 for complete port reference.

Port	Protocol	Purpose	Access
5432	TCP	PostgreSQL protocol	Client access
7000	TCP	Cluster gossip	Internal only
7001	TCP	Metadata service	Internal only
7002	TCP	Storage service	Internal only
8300	TCP	Raft consensus	Internal only
9090	TCP	Prometheus metrics	Monitoring
9100	TCP	Node exporter	Monitoring
9256	TCP	WASM runtime	Internal only
10000	TCP	GraphQL endpoint	Client access

D. Sizing Calculator

Use the following formula for capacity planning:

Storage Nodes = (Total Data Size * Replication Factor * 1.5) / Node Storage Capacity
Compute Nodes = Max QPS / 10000 (as starting point)
Metadata Nodes = 3, 5, or 7 (odd number for quorum)

Example Calculation:

• Data Size: 1TB
• Replication Factor: 3
• Node Storage Capacity: 500GB

Storage Nodes = (1000GB * 3 * 1.5) / 500GB = 9 nodes

E. Support Resources

• Documentation: https://docs.heliosdb.com
• Community Forum: https://community.heliosdb.com
• GitHub: https://github.com/danimoya/HeliosDB
• Enterprise Support: support@heliosdb.com
• Emergency Hotline: +1-800-HELIOS-DB

F. Glossary

• ACID: Atomicity, Consistency, Isolation, Durability
• HPA: Horizontal Pod Autoscaler
• VPA: Vertical Pod Autoscaler
• WAL: Write-Ahead Logging
• OLTP: Online Transaction Processing
• OLAP: Online Analytical Processing
• CRDT: Conflict-free Replicated Data Type
• Raft: Consensus algorithm used for metadata management
• 2PC/3PC: Two-Phase Commit / Three-Phase Commit
• QPS: Queries Per Second
• RPS: Requests Per Second
• SLA: Service Level Agreement
• RTO: Recovery Time Objective
• RPO: Recovery Point Objective

---

Document Information

Document Version: 1.0 Last Updated: November 2, 2025 Next Review: December 1, 2025

---

Navigation

• Previous: Production Checklist
• Index: Production Deployment Guide