Frequently Asked Question

HelpDesk Debug Proxmox
Last Updated 28 days ago

When reporting a Proxmox issue, collecting relevant diagnostic information is crucial for efficient troubleshooting. The following commands provide comprehensive details about the Proxmox host, cluster, and virtual guests.

ALWAYS Capture

These commands provide general system health and configuration details.

System Information:

    hostnamectl
    uname -a

Proxmox Version Information:

    pveversion -v

Cluster Status and Quorum (if applicable):

    pvecm status
    quorum status

System Services Status:

    systemctl list-units --type=service --state=running
    systemctl status pveproxy pvedaemon pvescheduler pvestatd pve-cluster

Disk Usage:

    df -h

Hardware Information:

    lshw -short
    lscpu
    free -h

Network Configuration:

    ip a
    ip route
    cat /etc/network/interfaces

Journal Logs for Key Proxmox Services:

    journalctl -u pveproxy.service -n 50 --no-pager
    journalctl -u pvedaemon.service -n 50 --no-pager
    journalctl -u pve-cluster.service -n 50 --no-pager


For Storage Issues

These commands provide details specific to storage configurations and status.

    pvesm status

LVM/LVM-thin Information (if in use):

    lvs --all
    vgs --all

ZFS Information (if in use):

    zpool status -v
    zfs list

Ceph Information (if in use):

    ceph status
    ceph osd tree
    ceph health detail

IMPORTANT: If this is a CEPH issue, see the ceph requirements in the Ceph session of the knowledge base and use that instead. 

For Guest (VM/Container) Issues

These commands provide details about virtual machine and container configuration and status.

List All Virtual Guests and Their Status:

    qm list
    lxc list

Specific VM/Container Configuration (replace VMID or CTID):

    qm config <VMID>
    lxc config show <CTID>

Specific VM/Container Status (replace VMID or CTID):

    qm status <VMID>
    lxc info <CTID>

Console Logs for a Specific VM (replace VMID):

    journalctl -u qemu-server@<VMID>.service -n 50 --no-pager


For Cluster Issues

These commands provide additional information relevant to multi-node Proxmox clusters.

Corosync Configuration:

    cat /etc/corosync/corosync.conf

Corosync Logs:

    journalctl -u corosync.service -n 50 --no-pager




Proxmox support from the engineers who wrote this article

This article came out of a real case resolved by GEN engineers, not from upstream documentation. GEN have run Proxmox in production in our own UK data centres since 2015, and have been in enterprise IT for 37 years. If this one has not solved your problem, we can.

  • 30 minute response, 24 hours a day, every day of the year on critical production infrastructure.
  • No contracts. Buy hours, use hours. No minimum term and no notice period.
  • Genuinely independent. We hold no software partner status with Proxmox or any other vendor, so nothing we recommend is shaped by a licence margin.
  • UK based, in-house engineers. No outsourced first line.

Proxmox support  ·  VMware to Proxmox migration  ·  Proxmox training  ·  Support rates

Registering a GEN account is free, so the route to an engineer is open before you need it. You only ever pay for the time you use.

This website relies on temporary cookies to function, but no personal data is ever stored in the cookies.
OK
Powered by GEN UK CLEAN GREEN ENERGY

Loading ...