Apply Composer changes: comprehensive API updates, migrations, middleware, and infrastructure improvements
- Add comprehensive database migrations (001-024) for schema evolution - Enhance API schema with expanded type definitions and resolvers - Add new middleware: audit logging, rate limiting, MFA enforcement, security, tenant auth - Implement new services: AI optimization, billing, blockchain, compliance, marketplace - Add adapter layer for cloud integrations (Cloudflare, Kubernetes, Proxmox, storage) - Update Crossplane provider with enhanced VM management capabilities - Add comprehensive test suite for API endpoints and services - Update frontend components with improved GraphQL subscriptions and real-time updates - Enhance security configurations and headers (CSP, CORS, etc.) - Update documentation and configuration files - Add new CI/CD workflows and validation scripts - Implement design system improvements and UI enhancements
This commit is contained in:
120
docs/proxmox/CLUSTER_CONFIGURATION.md
Normal file
120
docs/proxmox/CLUSTER_CONFIGURATION.md
Normal file
@@ -0,0 +1,120 @@
|
||||
# Proxmox Cluster Configuration: sankofa-sfv-01
|
||||
|
||||
**Last Updated**: 2024-12-19
|
||||
**Cluster Name**: sankofa-sfv-01
|
||||
|
||||
## Cluster Overview
|
||||
|
||||
- **Cluster Name**: sankofa-sfv-01
|
||||
- **Node Count**: 2
|
||||
- **Status**: Active (verified via node visibility)
|
||||
|
||||
## Cluster Nodes
|
||||
|
||||
### Node 1: ML110-01
|
||||
- **IP**: 192.168.11.10
|
||||
- **FQDN**: ml110-01.sankofa.nexus
|
||||
- **Site**: us-sfvalley
|
||||
- **Status**: Online
|
||||
- **Cluster Role**: Primary/First Node
|
||||
|
||||
### Node 2: R630-01
|
||||
- **IP**: 192.168.11.11
|
||||
- **FQDN**: r630-01.sankofa.nexus
|
||||
- **Site**: us-sfvalley-2
|
||||
- **Status**: Online
|
||||
- **Cluster Role**: Secondary/Second Node
|
||||
|
||||
## Cluster Verification
|
||||
|
||||
### Evidence of Cluster Existence
|
||||
|
||||
✅ **Node Visibility**:
|
||||
- ML110-01 can see both nodes (r630-01 and ml110-01) in nodes list
|
||||
- This indicates cluster membership (standalone nodes only see themselves)
|
||||
|
||||
### Verification Methods
|
||||
|
||||
1. **Proxmox Web UI**:
|
||||
- Log in to either node
|
||||
- Navigate to: Datacenter → Cluster
|
||||
- Verify cluster name: sankofa-sfv-01
|
||||
- Verify both nodes listed
|
||||
|
||||
2. **SSH Commands**:
|
||||
```bash
|
||||
pvecm status
|
||||
pvecm nodes
|
||||
```
|
||||
|
||||
3. **Corosync Configuration**:
|
||||
```bash
|
||||
cat /etc/pve/corosync.conf
|
||||
```
|
||||
|
||||
## Quorum Configuration
|
||||
|
||||
For a 2-node cluster, quorum must be explicitly configured:
|
||||
|
||||
```bash
|
||||
# On both nodes
|
||||
pvecm expected 2
|
||||
pvecm status
|
||||
```
|
||||
|
||||
**Important**: Without quorum configuration, a 2-node cluster may have issues if one node goes offline.
|
||||
|
||||
## Cluster Features
|
||||
|
||||
Once cluster is verified, you can:
|
||||
- ✅ Create VMs on either node
|
||||
- ✅ Migrate VMs between nodes
|
||||
- ✅ Manage storage across cluster
|
||||
- ✅ Use cluster-level operations
|
||||
|
||||
## Network Configuration
|
||||
|
||||
- **Cluster Network**: 192.168.11.0/24
|
||||
- **Corosync Ports**: 5404-5405 (should be open between nodes)
|
||||
- **API Port**: 8006 (HTTPS)
|
||||
|
||||
## Storage Considerations
|
||||
|
||||
- Each node has local storage
|
||||
- For shared storage, consider:
|
||||
- NFS shares
|
||||
- Ceph storage
|
||||
- Shared LVM volumes
|
||||
|
||||
## Monitoring
|
||||
|
||||
- Cluster status: Check via Web UI or `pvecm status`
|
||||
- Node status: Check via Web UI or API
|
||||
- Quorum status: Check via `pvecm status`
|
||||
|
||||
## Troubleshooting
|
||||
|
||||
### Cluster Split-Brain
|
||||
|
||||
If cluster splits:
|
||||
```bash
|
||||
# On majority node
|
||||
pvecm expected 2
|
||||
|
||||
# On minority node (if needed)
|
||||
pvecm expected 1
|
||||
```
|
||||
|
||||
### Node Cannot Join
|
||||
|
||||
1. Check network connectivity
|
||||
2. Verify firewall rules
|
||||
3. Check corosync service: `systemctl status corosync`
|
||||
4. Review logs: `journalctl -u corosync`
|
||||
|
||||
## Related Documentation
|
||||
|
||||
- [Cluster Setup Guide](./CLUSTER_SETUP.md)
|
||||
- [Cluster Status Check](./CLUSTER_STATUS_CHECK.md)
|
||||
- [Task List](./TASK_LIST.md)
|
||||
|
||||
Reference in New Issue
Block a user