Logo

Server Rack Builder

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.

abstract background

1. Requirements and Installation

Requirements

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

What gets installed

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)

2. Using the Editor

2.1 Creating a Rack

Creating a rack

  1. In the Assets application, open the navigation item Server Racks.
  2. Click New. The dialog has the tabs General, Editor, Comments, Attachments, Journal and Tasks.
  3. On the General tab, enter at least a Name. All other fields (serial number, status, organizational unit, cost center, location, principal user, inventory number, SKU, end-of-life date, workplace, environment, description) are optional.
  4. Switch to the Editor tab and populate the rack.
  5. Save. Each rack automatically receives a number with the prefix RCK, e.g. RCK00001.

2.2 Editor Overview

Editor overview

  1. Categories for quickly adding specific device types. When a device is dragged from a category into the rack, its category is already set. The categories can be extended, see section 3.1.
  2. List of assets in Matrix42. Assets are assigned to a category based on their SKU type; this mapping can be adjusted, see section 3.2. When an asset is dragged into the rack, it is linked and its category is pre-filled.
  3. Undo/redo buttons
  4. Rack view with front and back
  5. Rack height input
  6. Settings of a rack entry: name, linked asset, category, height, position, facing, depth and color. Height and position can also be changed directly in the rack view by drag and drop.
  7. Export of the rack as PNG or SVG

2.3 Placing Devices

  • Drag from the "Categories" palette: creates a 1U device with the selected category.
  • Drag from the "Devices" palette: creates a device linked to the asset. Name and category come from the asset. Assets that are already mounted in a rack do not appear in the palette. The search box searches the assets server-side.
  • Draw on empty slots: press the mouse button on a free rack unit and drag up or down. The marked range becomes a new device.

If the target position is occupied, the drop shadow turns red and the device is not placed.

2.4 Editing Devices

In the rack view

  • Move: grab the device and drag it, also from the front to the back. Full-depth devices keep their facing.
  • Change height: drag the top or bottom edge of the device. The handles are only visible on the side the device faces.
  • Select: click the device. Clicking a free slot clears the selection.

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.").

2.5 Changing the Rack Height

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).

2.6 View, Zoom and Panels

  • Both / Front / Back in the toolbar switches the sides.
  • Zoom from 50% to 150% via the buttons at the bottom right.
  • The width of the palette and the inspector can be dragged at the dividers.
  • On narrow windows the palette collapses behind a menu icon, the inspector opens as an overlay and the view automatically switches to a single side.
  • The utilization in the toolbar refers to the front. The utilization per side is shown above each rack view.

2.7 Undo, Redo and Keyboard Shortcuts

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.

2.8 Export

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.

2.9 Rack Preview

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.

2.10 Language and Theme

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.


3. Customization

3.1 Categories

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.

3.2 Data Query "MTX Server Rack Assets Data Query"

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.

3.3 Navigation and Permissions

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.

Logo

Start your process improvement

Contact us and find out more.

Get started