Data model for Proxmox
- name:
- Data model for Proxmox
- description:
- Advanced modelization of Proxmox CIs in iTop
- version:
- 1.1.0
- release:
- 2026-01-14
- itop-version-min:
- 3.2
- code:
- combodo-proxmox-datamodel
- state:
- Stable
- php-version-max:
- PHP 8.4
This extension is dedicated to Proxmox, the server virtualization platform that automates the management of virtual machines. It enhances iTop's CMDB by modelizing Proxmox elements that are not part of iTop's default CIs (Clusters, Storage, Containers…) and by adding attributes to some of the existing devices (Servers, Virtual Machines). Combined with the Data collector for Proxmox, it allows Proxmox administrators to fetch in iTop the key elements of their Proxmox infrastructure.
Features
When installed on iTop, the extension creates or enhances a set of classes dedicated to or related to Proxmox virtualization environments:
-
Creations
-
Proxmox clusters
-
Proxmox High Availability groups
-
Proxmox containers
-
Proxmox disks
-
Proxmox storage
-
Proxmox storage type
-
Link High Availability groups / servers
-
-
Enhancements
-
Servers
-
Virtual Machines
-
Revision History
| Version | Release Date | Comments |
|---|---|---|
| 1.1.0 | 2026-01-14 | First version |
Limitations
None
Requirements
The extension can only be installed on iTop 3.2.0 and above, where Virtualization Management has been activated.
Installation
Use the Standard installation process for this extension.
Configuration
No specific configuration is required.
Usage
Proxmox Cluster
A Proxmox cluster is a group
of physical servers that are pooled together and share resources to
provide an overall fault tolerant system for hosting virtual
machines and containers.
Cluster Properties
| Name | Type | Description | Mandatory? |
|---|---|---|---|
| General information | |||
| Name | Alphanumeric string | Name of the CI | Yes |
| Organization | Foreign key to a(n) Organization | Organization to which the CI belongs | Yes |
| Status | Possible values: Implementation, Production, Obsolete | No | |
| Business criticality | Possible values: high, low, medium | No | |
| More information | |||
| Version | Alphanumeric string | Software version of the cluster | No |
| Node count | Integer | Number of nodes hosted by the cluster | Yes |
| Total RAM | Alphanumeric string | No | |
| Total CPU | Integer | Total number of CPUs | Yes |
| Total Disk | Alphanumeric string | No | |
| Quorum status | Possible values: OK, Not OK | Is the quorum reached ? | No |
| Dates | |||
| Move to production date | Date (year-month-day) | No | |
| Other information | |||
| Description | Multiline character string | No | |
| Notes | Multiline character string | Notes as defined on Proxmox | No |
Tabs
| Tab | Description |
|---|---|
| Overview | Quick overview on virtualized elements |
| Contacts | All the contacts for this configuration item |
| Documents | All the documents linked to this configuration item |
| Application solutions | All the application solutions depending on this configuration item |
| Servers | All the servers connected to the cluster |
| HA Groups | All HA groups that host servers that belong to the cluster |
| Storages | All the storages used by the cluster |
| Disks | All the disks used by the cluster |
| Tickets | All the tickets for this configuration item |
| Virtual machines | All the virtual machines hosted by this cluster |
| Containers | All the containers hosted by this cluster |
Creating a new Proxmox cluster
Enter the Class name in the Quick create area
to create a new object, then fill out the form and press the
Create button.
Overview tab
Relations
-
Impacts: A Proxmox cluster impacts the nodes that belong to it.
-
Depends on: N/A
Server / Proxmox Node
The class Server is used in iTop to
document Proxmox nodes. The Proxmox datamodel extension enriches
the server attributes, brought by iTop standard datamodel, with a
few meaningful attributes that are documented in a Proxmox
environment. These can of course be reused for non-Proxmox
servers.
Proxmox Node additional Properties
| Name | Type | Description | Mandatory? |
|---|---|---|---|
| General information | |||
| Uptime | Delay (days, hours, minutes, seconds) | No | |
| Proxmox cluster | Alphanumeric string | Name of the CI | Yes |
| More information | |||
| CPU Model | Alphanumeric string | No | |
| Proxmox information | |||
| PVE Version | Alphanumeric string | No | |
| Version | Alphanumeric string | No | |
| Kernel | Alphanumeric string | Version of the kernel | No |
| Note | Multiline character string | Notes as defined on Proxmox | No |
New Tabs
| Tab | Description |
|---|---|
| Overview | Quick overview on virtualized elements |
| HA groups | List of all HA Groups that the server belongs to |
| Storages | List of all Proxmox storage used by the node |
| Proxmox disks | List of all Proxmox disks used by the node |
| Virtual machines | List of all virtual machines hosted on the node |
| Proxomox containers | List of all Proxmox containers hosted on the node |
Overview tab
Relations
-
Impacts: A Proxmox node impacts the HA groups to which it belongs, depending to the redundancy parameters that have been defined for each of the groups.
-
Depends on: It simply depends on its Proxmox cluster.
HA Group
A HA Group is a subset
of nodes linked together in order to provide a high-availability
environment for resources hosted on the nodes, including virtual
machines and containers.
Proxmox HA Group Properties
| Name | Type | Description | Mandatory? |
|---|---|---|---|
| Name | Alphanumeric string | Name of the CI | Yes |
| Organization | Foreign key to a(n) Organization | Organization to which the CI belongs | Yes |
| Proxmox cluster | Foreign key to a(n) Proxmox Cluster | Cluster to which the storage belongs | Yes |
| Description | Multiline character string | No |
Tabs
| Tab | Description |
|---|---|
| Servers | List of the Proxmox nodes that make up the group |
| Virtual machines | List of all virtual machines hosted on the nodes belonging to the group |
| Containers | List of all Proxmox containers hosted on the nodes belonging to the group |
Relations
-
Impacts: A Proxmox HA Group impacts the virtual machines and the containers it hosts.
-
Depends on: It depends on the different nodes that look after it, thus offering redundancy.
Virtual Machine
A Virtual
Machine is the virtual equivalent of a Server. It is hosted
either on an Hypervisor, on a Farm in the vSphere world or on a
Node in the Proxmox world. The Proxmox datamodel extension enriches
the virtual machine attributes, brought by iTop standard datamodel,
with a few meaningful attributes that are documented in a Proxmox
environment. These can of course be reused for non-Proxmox VMs.
Virtual Machine additional Properties
| Name | Type | Description | Mandatory? |
|---|---|---|---|
| General information | |||
| UUID | Alphanumeric string | Universal Unique IDentifier | No |
| Power state | Possible values: On, Off, Suspended, Template | No | |
| Virtual host | Foreign key to a(n) Virtual Host | No * | |
| Physical host | Foreign key to a(n) Node | No | |
| HA Group | Foreign key to a(n) Proxmox HA Group | No | |
| CPU information | |||
| Socket count | Integer | No | |
| Cores per socket | Integer | No | |
| CPU model | Alphanumeric string | No | |
| Numa | Alphanumeric string | Version of the kernel | No |
* The extension is making the virtual host NOT mandatory.
Relations
-
Impacts: a Virtual Machine impacts the software intances running on it, the Application Solutions which this VM is part of and all the contacts (Persons, Teams) directly linked to the VM.
-
Depends on: from a Proxmox standpoint, a Virtual Machine depends on the HA Group to which it belongs.
Proxmox Container
A Proxmox container is a
lightweight virtualisation solution based on LXC (Linux Containers)
technology. It allows you to create and manage isolated
environments that share the host system's Linux kernel, unlike
traditional virtual machines that emulate hardware and require
their own operating system.
Proxmox Container Properties
| Name | Type | Description | Mandatory? |
|---|---|---|---|
| General information | |||
| Name | Alphanumeric string | Yes | |
| UUID | Alphanumeric string | Universal Unique IDentifier | No |
| Organization | Foreign key to a(n) Organization | Organization to which the CI belongs | Yes |
| Status | Possible values: implementation, obsolete, production, stock | No | |
| Business criticality | Possible values: high, low, medium | No | |
| Physical host | Foreign key to a(n) Node | No | |
| HA Group | Foreign key to a(n) Proxmox HA Group | No | |
| More information | |||
| OS family | Foreign key to a(n) OS Family | No | |
| OS version | Foreign key to a(n) OS Version | No | |
| IP | Alphanumeric string | No | |
| OS licence | Foreign key to a(n) OS Licence | No | |
| RAM | Alphanumeric string | No | |
| Other information | |||
| Move to production date | Date (year-month-day) | No | |
| Description | Multiline character string | No | |
| CPU information | |||
| Socket count | Integer | No | |
| Cores per socket | Integer | No | |
| CPU model | Alphanumeric string | No | |
| CPU | Alphanumeric string | No | |
| Numa | Alphanumeric string | Version of the kernel | No |
Tabs
| Tab | Description |
|---|---|
| Softwares | All the softwares installed on this configuration item |
| Contacts | All the contracts for this configuration item |
| Documents | All the documents linked to this configuration item |
| Application solutions | All the application solutions depending on this configuration item |
| Network Interfaces | All the logical network interfaces |
| Logical volumes | All the logical volumes used by this device |
| Active Tickets | All the tickets for this configuration item |
Relations
-
Impacts: a Proxmox container impacts the software intances running on it, the Application Solutions which this container is part of and all the contacts (Persons, Teams) directly linked to the container.
-
Depends on: from a Proxmox standpoint, a container depends on the HA Group to which it belongs.
Proxmox Storage Type
This typology class enables administrators to type the Proxmox Storages in alignment with Proxmox pre-defined types.
Proxmox Storage
Proxmox storage refers to
the spaces in which Proxmox will store backups, virtual disks,
bootable ISOs, etc. A wide range of storage types are supported,
the simplest being an regular directory, while the most complex
uses redundant systems such as Ceph.
Proxmox Storage Properties
| Name | Type | Description | Mandatory? |
|---|---|---|---|
| General information | |||
| Name | Alphanumeric string | Name of the CI | Yes |
| Organization | Foreign key to a(n) Organization | Organization to which the CI belongs | Yes |
| Parent storage | Foreign key to a(n) Proxmox Storage | Storage, usually defined at the cluster level, that the storage belongs to | No |
| Proxmox cluster | Foreign key to a(n) Proxmox Cluster | Cluster to which the storage belongs | Yes |
| Node | Foreign key to a(n) Proxmox Node | Node hosting the storage | No |
| More information | |||
| Type | Foreign key to a(n) Proxmox storage type | Storage type | yes |
| Size | Integer | Number of nodes hosted by the cluster | No |
| Used | Alphanumeric string | No | |
| Enabled | Integer | Total number of CPUs | No |
| Shared | Alphanumeric string | No | |
| Other information | |||
| Content | Alphanumeric string | Content type: VMs, ISO, backup, … | No |
| Description | Multiline character string | No | |
Tabs
Proxmox Disk
Proxmox Disk Properties
| Name | Type | Description | Mandatory? |
|---|---|---|---|
| General information | |||
| Organization | Foreign key to a(n) Organization | Organization to which the CI belongs | Yes |
| Proxmox cluster | Foreign key to a(n) Proxmox Cluster | Cluster to which the disk belongs | Yes |
| Node | Foreign key to a(n) Proxmox Node | Node hosting the disk | No |
| More information | |||
| Serial | Alphanumeric string | Yes | |
| Type | Foreign key to a(n) Proxmox storage type | Storage type | yes |
| Size | Integer | Number of nodes hosted by the cluster | No |
| Other information | |||
| Description | Multiline character string | No | |










