Proxmox VE — Cluster Management
Basic Information
| Field | Value |
|---|---|
| Category | Infrastructure |
| Owner | Artem Ryzhkov |
| Deputy | Filip Kohák |
| SLA | 24x7 |
| Deployment | On-prem (2× Fujitsu server + QDevice) |
Description
Proxmox VE is an open-source hypervisor (KVM + LXC) running on two Fujitsu physical servers in an HA cluster. A third node serves as QDevice for quorum maintenance. The cluster hosts all Etnetera on-prem virtualization.
Virtual machines in the cluster:
| VM | Purpose |
|---|---|
| Windows Server (Srv01/Srv02) | Active Directory DC, DNS, DHCP |
| FortiNAC | NAC — network access control |
| SnipeIT | IT asset management |
| Webserver | Internal web services |
| FortiEMS | FortiClient Endpoint Management Server |
| Passbolt | IT team password manager |
Access and Login
- URL:
https://[proxmox-node-ip]:8006(internal network or VPN only) - Realm: PAM (system accounts on the host)
- Credentials stored in Passbolt
Warning
Proxmox console is accessible from VPN or office only. Never share root credentials via email.
Procedure — VM Management
Start / Shut down a VM
- Log in to the Proxmox web interface
- Select the desired VM in the left tree
- Use Start / Shutdown / Stop buttons in the top right
- Always prefer graceful Shutdown over Stop (force kill)
Migrate VM to another node
- Right-click on the VM → Migrate
- Select the target node
- Check Online Migration if the VM cannot have downtime
- Monitor progress in Tasks (Datacenter → Tasks)
Take a snapshot
- Select VM → Snapshots tab
- Click Take Snapshot, enter a name (e.g.
pre-update-2025-06) - Optionally include RAM state (slower but more accurate)
Tip
Take a snapshot before any major system change. Snapshots don't require VM downtime (QEMU guest agent must be installed).
Check cluster status
- Go to Datacenter → Cluster
- Verify all nodes are
onlineand quorum is1 - QDevice status:
pvecm statusvia SSH on any node
Procedure — Network & VLANs
- On a node, go to System → Network
- Existing Linux Bridge
vmbr0carries tagged VLANs - For a new VLAN, edit
/etc/network/interfaceson both nodes - Reload network interface:
ifreload -a(no VM downtime)
Troubleshooting
| Problem | Solution |
|---|---|
| VM won't start | Check RAM and storage on the node: Datacenter → node → Summary |
| Cluster quorum lost | Verify network connectivity between nodes; check QDevice (pvecm status) |
| Snapshot fails | Free up storage space; verify QEMU guest agent is running inside the VM |
| Migration hangs | Check network throughput between nodes (recommended: dedicated 1 Gb/s link) |
| Cannot log in via web | Verify PAM login via SSH: ssh root@proxmox-node |
Related Guides
- Active Directory — VM on Proxmox
- FortiNAC — VM on Proxmox
- SnipeIT — VM on Proxmox
- Network Monitor — monitors Proxmox hosts
Contact
- Owner: Artem Ryzhkov — Slack
@artem/ artem.ryzhkov@etnetera.cz - Deputy: Filip Kohák — Slack
@filip - Urgent incidents: Slack
#it-alerts