Category: Enclosure#

The Enclosure category is the central category for documenting 19-inch racks and server cabinets in i-doit. It defines the physical structure of the rack -- specifically the vertical installation slots on the front and rear sides as well as the counting direction of the rack units. Each object of the type Enclosure receives its fundamental rack configuration through this category.

Usage#

Typical use cases:

• Building rack documentation: Create one i-doit object of the type Enclosure per physical server cabinet and configure the slot count and rack unit sorting through this category. The graphical rack view in i-doit is based on these settings.
• Planning front and rear sides separately: Servers, switches, and patch panels can be installed in a rack from both the front and the rear. The separate slot fields for front and rear sides enable a realistic representation.
• Setting rack unit counting: Depending on convention, data centers count rack units from bottom to top or from top to bottom. The Height unit sorting field controls the display in the rack visualization accordingly.
• Capacity planning in the data center: Using reports, you can evaluate how many slots per rack are occupied and where free capacity still exists. Together with the Form Factor and Location categories, this creates a complete picture of the physical infrastructure.

Fields#

Vertical installation slots (Front side)#

The number of vertical installation slots on the front side of the rack. default 19-inch racks typically have 42, 47, or 48 rack units. This value determines how many rack units are displayed in the rack visualization on the front side.

Vertical installation slots (Rear side)#

The number of vertical installation slots on the rear side. In most cases identical to the front side, but may differ in special rack configurations.

Rack unit sorting#

Determines whether rack units are counted from bottom to top (ascending, industry standard) or from top to bottom (descending). This setting influences the display in the graphical rack view and should match the physical labeling in the data center.

Description#

Free text for additional details: rack manufacturer and model, depth in mm, maximum load capacity, special features (e.g. side panels, cable management, integrated PDUs), or cooling notes.

Technical Reference#

Fields (API Reference)#

API Examples#

Create Entry#

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16

{
    "jsonrpc": "2.0",
    "method": "cmdb.category.save",
    "params": {
        "apikey": "your-api-key",
        "object": 123,
        "category": "C__CATS__ENCLOSURE",
        "data": {
            "vertical_slots_front": 42,
            "vertical_slots_rear": 42,
            "slot_sorting": "ascending",
            "description": "APC NetShelter SX 42U, 600mm breit, 1070mm tief, max. 1364 kg"
        }
    },
    "id": 1
}

Read Entries#

 1
 2
 3
 4
 5
 6
 7
 8
 9
10

{
    "jsonrpc": "2.0",
    "method": "cmdb.category.read",
    "params": {
        "apikey": "your-api-key",
        "object": 123,
        "category": "C__CATS__ENCLOSURE"
    },
    "id": 2
}

Update Entry#

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16

{
    "jsonrpc": "2.0",
    "method": "cmdb.category.save",
    "params": {
        "apikey": "your-api-key",
        "object": 123,
        "category": "C__CATS__ENCLOSURE",
        "entry": 1,
        "data": {
            "vertical_slots_front": 47,
            "vertical_slots_rear": 47,
            "description": "Rack-Erweiterung auf 47 HE nach Umbau 2026-Q1"
        }
    },
    "id": 3
}