Manage Models

A model is a collection of devices that share most common attributes. Some examples of models are:

• Model 3000 Digital Mammography System
• Model 3000 Digital Breast Tomosynthesis System
• Model 6000 Digital Breast Tomosynthesis System

The first two may share some common features, but have other differentiating features that would make the manufacturer want to keep track of them separately. Please think carefully when defining models to ensure you don’t have to change models going forward.

Add a Model

Note: To add a model you must have the Owner or Fleet Manager role assigned to you.

Adding a model takes a few steps:

1. Create a model.
2. Create a device.
3. Configure telemetry charts.

** Note that you cannot define telemetry charts until you have device defined of that model type.

Create a Model

1. Navigate to Models in the maiLink UI top bar.
2. Click the Create button to begin defining the new model.
   • Enter the Name for the model.
   • Select the Connection Types that the devices of this model will support.
   • Next to the Tags label, click (+) to add a tag. Repeat as necessary.
3. Click Save to store the model.

Note: You can’t define telemetry charts yet. First you must create a device.

Create a Device

Create a device of the model you defined above.

Configure Telemetry Charts

1. Navigate to Models in the maiLink UI top bar.
2. Hover over the model for which you will configure telemetry charts.
3. Click on the Edit button edit the model.
4. Under the Telemetry Charts section, pull down Example Device ID and select a device of this model.
5. Next to Telemetry Charts click (+) to add a new telemetry chart.
   • Click in the New Chart and it will expand.
   • Type in a Name for the new chart.
   • Select the Period.
   • Select the Interval.
   • Click Add Query and:
     • If the device is connected and sending metrics:
       • Select a metric that is to be plotted on the chart, or
       • Type a query by hand into one of the Query boxes.
       • Examples:
         • md_memory_used_percent{device="$device.id"}
         • pump_pressure_mmHg{device="$device.id"}
         • disk_partition_free_bytes{device="$device.id",partition="/dev/sda1"}
     • If the device is not yet sending metrics:
       • Type a query by hand into one of the Query boxes.
   • Click Update.
   • When a dialog box appears, type update into the box and click update.

The charts you configure this way will appear in the About page for each device of this model. If you create a new device, it will inherit the telemetry charts defined for its model.

Edit a Model

1. Navigate to Models in the maiLink UI top bar.
2. Hover over the model for which you will configure telemetry charts.
3. Click on the Edit button edit the model.
4. Make the desired changes.
5. Click Update.
   • When a dialog box appears, type update into the box and click update.

Delete a Model

Note: Deleting a model is a serious business because it will affect ALL devices that are of that model type. If you delete a model, all devices of that model type are set to “default” model type. There is no way to undo that change except for manually changing all those devices back, should you choose to undelete the model later on.

1. Navigate to Models in the maiLink UI top bar.
2. Hover over the model for which you will configure telemetry charts.
3. Click on the Delete button to delete the model.
   • When a dialog box appears, type delete into the box and click delete.