The Server Rack Builder brings complete rack planning into Matrix42. Racks are drawn to scale with front and rear view, devices are placed by drag & drop from a palette fed by your Matrix42 assets, and colour-coded categories keep every rack readable at a glance. Finished layouts can be exported as PNG or SVG for your data-centre documentation – no external tools, no duplicate data.
| Matrix42 Enterprise Service Management | version 26.1.0 or later |
| Installation | via the Extension Gallery or the package import |
| During installation | maintenance mode is enabled, the web application and the Matrix42 services are restarted |
| Area | Matrix42 object | Name |
|---|---|---|
| Data model | Type | MTX_ServerRackType ("Server Rack") |
| Data model | Classes | MTX_ServerRackClassBase, MTX_ServerRackEntryClass |
| Data model | Relation | FK_SPSAssetClassBaseMTX_ServerRackEntryClass_MTX_ServerRackAsset |
| Data model | Pickup | MTX_ServerRackEntryCategoryPickup |
| Data | Data Query | "MTX Server Rack Assets Data Query" |
| Data | Data Query | "MTX Server Rack Data Query" |
| UI | Control (Layout Designer) | mx-server-rack-builder ("MTX Server Rack Builder") |
| UI | Dialog | "MTX Server Rack Dialog" |
| UI | Preview | "MTX Server Rack Preview" |
| UI | Dataset view | "MTX Server Racks Dataset View" |
| UI | Navigation item | "Server Racks" |
| UI | Localization string | "Rack View" / "Rack Ansicht" |
| Code | Workspace | MTX_ServerRackBuilder (JavaScript, HTML, CSS) |
RCK, e.g. RCK00001. If the target position is occupied, the drop shadow turns red and the device is not placed.
In the rack view
In the inspector (right column, appears on selection)
| Field | Meaning |
|---|---|
| Name | Display name in the rack and in the export |
| Asset | Linked Matrix42 asset. The picker only shows assets that are not mounted in any rack yet. |
| Category | Determines icon and default color |
| Height (U) | Height in rack units, at least 1 |
| Position (U) | Lowest occupied rack unit, 1 = bottom |
| Facing | Front or Back: the side on which the device is visible |
| Full depth | The device occupies both sides. On the opposite side it is shown hatched. |
| Color | Defaults to the category color. A custom color is stored as an override; Reset to category removes it. |
| Remove device | Deletes the entry from the rack |
Inputs that would cause overlaps are rejected and explained by a message below the fields (e.g. "Doesn't fit: U10–U12 overlaps another device." or "The opposite side is blocked at U5.").
The rack height is shown in the toolbar next to the utilization and can be edited directly (1 to 100U). When shrinking, devices above the new height are moved down into free slots. If a device no longer fits anywhere, the change is rejected and a message shows how many devices are affected. The height is stored with the rack (default when creating: 42U).
Every change in the editor can be undone, up to 50 steps. The shortcuts work while the editor has focus (a click into the rack is enough).
| Shortcut | Action |
|---|---|
| Ctrl + Z | Undo |
| Ctrl + Y or Ctrl + Shift + Z | Redo |
| Delete or Backspace | Remove the selected device |
| Esc | Clear the selection or close the export menu |
On a Mac use Cmd accordingly.
Export in the toolbar offers PNG image and SVG vector. The export always contains both sides, the rack name with height and the front-face utilization. Category icons, colors and hatched rear projections match the on-screen display. The PNG file is generated at double resolution. The file name is the rack name.
In the object preview of a rack, the same editor appears under Rack View in read-only mode: without the palette, but with view selection, zoom and export. Clicking a device shows its details in the inspector. Above it, the panel with the master data lists all assets mounted in this rack.
The editor follows the user's Matrix42 language. Included are English, German, French, Spanish, Italian, Portuguese, Dutch, Polish, Czech and Russian; English is used for all other languages. Category names come from the pickup, where they are maintained per language. Colors and contrasts follow the light or dark Matrix42 theme, including the accent color.
The categories live in the pickup MTX_ServerRackEntryCategoryPickup. They determine the icon and default color of the devices and make up the "Categories" palette. The pickup can be customized like any other: add categories, rename them (per language), change their colors, assign a custom SVG icon or reorder them. The editor picks up changes the next time it is opened.
| Value | English | German | Color | Automatic from SKU type |
|---|---|---|---|---|
| 1 | Server | Server | #3f6d95 | yes |
| 2 | Switch | Switch | #6d5fb0 | yes |
| 3 | Router | Router | #7b6bb5 | yes |
| 4 | Other Network | Sonstiges Netzwerk | #5b6676 | yes |
| 5 | Storage | Storage | #3c8a5b | yes |
| 6 | Firewall | Firewall | #b5453b | no |
| 7 | KVM / Console | KVM / Konsole | #8a6d3b | yes |
| 8 | Power (UPS/PDU) | Strom (USV/PDU) | #b5842f | no |
| 9 | Patch Panel | Patchpanel | #607086 | no |
| 10 | Infrastructure | Infrastruktur | #8a8a4a | yes |
| 11 | Blank Panel | Blindplatte | #465063 | no |
Which SKU types are mapped to a category automatically is defined in the data query, see section 3.2. Categories without a mapping are set manually in the inspector.
This data query on SPSAssetClassBase determines which assets appear in the "Devices" palette and in the asset picker, how they are named and which category they receive when dragged. It only returns assets that are not mounted in any rack. The query can be customized like any data query. Two columns matter:
| Column | Meaning |
|---|---|
AssetName | Device name in the palette and in the rack. Default: computer name for computers, phone number for SIM cards, otherwise the asset name. |
CategoryValue | Category when dragging an asset, as the pickup's Value. Calculated from the SKU type, see below. |
The palette's search box searches the keyword columns of the data query. By default these are name, inventory number, serial number, manufacturer, model, type and principal user.
Mapping SKU type → category (CategoryValue)
CASE
WHEN SKU.Type = 1 THEN 1
WHEN SKU.Type IN (600, 601) THEN 2
WHEN SKU.Type = 602 THEN 3
WHEN SKU.Type = 493 THEN 4
WHEN SKU.Type IN (1001, 1002, 1003, 1004, 1005, 1006) THEN 5
WHEN SKU.Type = 300 THEN 7
WHEN SKU.Type IN (801, 802, 803, 804, 805, 806, 807, 808) THEN 10
ELSE NULL
END | Category | Value | Matrix42 SKU types |
|---|---|---|
| Server | 1 | 1 Server |
| Switch | 2 | 600 Hub, 601 Switch |
| Router | 3 | 602 Router |
| Other Network | 4 | 493 Other Network |
| Storage | 5 | 1001–1006 (Unknown, SDS, Cloud, SAN, NAS, DAS) |
| KVM / Console | 7 | 300 |
| Infrastructure | 10 | 801–808 (Furniture, Equipment, Tool, Vehicle, Infrastructure, Rig, Machine, Misc.) |
All other types return NULL: the asset is placed in the rack without a category and is assigned in the inspector. Add your own or customer-specific SKU types to the CASE expression; the THEN values are the pickup's Value values.
| Navigation item | "Server Racks" in the Assets application, position 10030, icon storage |
| Opens | dataset view "MTX Server Racks Dataset View" |
| Audience | restricted to one role |
During installation, permissions on the type MTX_ServerRackType are set for two standard roles, provided they exist: one role with read, write, create and delete, one role with read only. All other roles receive their permissions as usual through role management.