Skip to content

Device

Purpose

In Clarity Transform, Device is a CI type on the CMDB screen, with its own card. Each record is one device. Its columns hold configuration data (for example Operating System, Cpu Cores, Memory Gb and Private Ip Addresses) and migration data (for example Move Group, Migration Plan and Migration Status).

The owner field is Device Owner. A device is linked to an application through its Application column, which takes the name of an Application record. Other links between records are held as records of the Relationship CI type, not on the device.

Normalised values are held in the columns Hardware Model Normalised, Hardware Vendor Normalised, Hardware Version Normalised and Operating System Normalised. There is no normalise action on the grid.

Where to find it

Go to Discover → CMDB, then select the Device card in the card strip. Clarity loads the Device grid on the same page. There is no separate menu item or page for devices.

What you see

Columns

Shown by default:

  • Name
  • Ci Class
  • Ci Type
  • Managed By
  • Integration
  • Description
  • Application
  • Business Unit
  • Rejection Reason
  • Cluster
  • Cpu Cores
  • Cpu Sockets
  • Cpu Speed
  • Environment
  • Memory Gb
  • Networks
  • Operating System
  • Planned Migration Date
  • Power State
  • Private Ip Addresses
  • Scope
  • Storage
  • Storage Used Gb
  • Tenant
  • Workload Group
  • Snapshot Count
  • Snapshot Oldest Days
  • Tags
  • Clarity Tags
  • Last Seen
  • Last Updated

Hidden by default, and shown with Toggle columns: App Shutdown Contact · App Shutdown Required · App Smoke Test Required · Sequence Smoke Test Required · Device Smoke Testing Required · Application Info · Device Smoke Testing By · Approval Status · Comms Sent Date · Communication Date · Communication Status · Cpu Type · Criticality · Datacentre · Device Owner · Dns Name · Host · Execution Notes · Folder · Hardware End Of Service Life · Hardware Model · Hardware Model Normalised · Hardware Serial · Hardware Vendor · Hardware Vendor Normalised · Hardware Version · Hardware Version Normalised · Hypervisor Tools Status · Interview Lead · Is Standalone · Mac Addresses · Maintenance Window End · Maintenance Window Start · Migrated Date · Migration Contact · Migration Date · Migration Execution Notes · Migration Failure Reason · Migration Plan · Migration Planning Notes · Migration Readiness · Migration Sequence · Migration Sequence Required · Migration Status · Migration Testing By · Migration Testing Required · Move Group · Number Of Disks · Number Of Nics · Operating System Edition · Operating System End Of Extended Support · Operating System End Of Mainstream Support · Operating System Normalised · PeriodEnd · PeriodStart · Platform Created On · Public Ip Address · Region · Replica · Runbook · Replication Status · Role · Role Apps · Role Discovery Confidence · Role Discovery Details · Storage Gb · Target Cluster · Target Managed By · Target Migration Appliance · Target Network · Target Storage · Created On · Created By · Last Updated By · Rightsizing Recommendation · Rightsizing Saving Pct · Integration Priority

The grid also has an Event column, whose help text reads "The migration event of this device's move group. Change the move group to change it.", and a Test Device column.

Some columns carry help text in the form:

  • Tenant: "Owning tenant boundary - vCD Org, Nutanix NCM Project, cloud account or subscription."
  • Workload Group: "Unit of co-deployment - a vCD vApp or an NCM Self-Service application. Distinct from the inference-derived business application."
  • Comms Sent Date: "Date the latest approval communication was sent"

The Id, Provider Id, Is Deleted and Deleted On columns are not offered in Toggle columns; Export All Fields includes them.

Custom fields added under Settings → Field Management → Custom Fields appear as extra columns. The Device grid loads its rows from the server, one page at a time, so searching and filtering are done by the server.

Values

The form's lists for Device are under Form, below. App Smoke Test Required is a hidden column with no field on the form. Its dropdown list under Settings → Field Management → Dropdown Lists is Yes, No.

Values seen in the grid data:

  • Power State: Reachable
  • Role: for example Web Server, or File Services, Web Server
  • Role Discovery Confidence: Low, High

Filters

Every column has a filter row, and the grid has a Search: box and a page-size selector (10, 25, 50 or All entries per page).

The grid does not keep its Search: text, column filters, sort order or page size: each time you select the card, it opens sorted by Name (A to Z), 25 rows per page, with no search or filters. If the grid shows fewer rows than you expect, clear the Search: box and the filter row.

By default the Device grid lists only devices whose Scope is In scope. Devices that are Out of scope, or that have no Scope yet (for example a device that discovery has just added), are not listed until you select Display all scopes... in the toolbar. The filter is on again each time you open the grid.

Actions

The Device grid toolbar has:

  • Create New, Edit, Remove selected, Clear selection and Reload table data. Create New opens the Create new entry form. Edit opens the Edit entry form for the row you have selected.
  • Enable spreadsheet editing: turns on editing in the grid itself, one cell at a time. Each change is saved as soon as you press Enter or leave the cell. See Edit records in the grid. There is no bulk-edit button.
  • Download menu: Export Visible Fields or Export All Fields. Exports are CSV.
  • Display all scopes...: lists devices of every scope, not only In scope devices. The button then reads Display in scope only..., which turns the filter back on.
  • Save columns: saves which columns are shown, under a name you choose. It does not save the search, filters or sort order. See Save and reload a column layout.
  • Load columns: shows a saved set of columns again, or the default set (Default (as configured)).
  • Toggle columns: shows or hides columns, with a Search columns box.
  • Validations: turns highlighting of the Mandatory and Suggested fields (set under Field Validations) on or off.
  • Row height: changes the height of the grid's rows.

The toolbar differs between CI types: the CMDB page lists the differences. The Device grid has no Import CSV button. To load devices from a file, use the CSV Import integration, whose Ci Class offers Device.

Each row has a View Details action. It opens a read-only side panel titled Device Details that lists the record's populated fields (only those whose columns are shown by default), followed by Created By, Created On, Last Updated By and Last Updated. Select the action again, or the panel's close button, to close it. If listening ports have been discovered on the device, the panel ends with a Discovered Listening Ports section, listing each port as protocol and port number (for example TCP/443), with the suggested service and the source where known. See Discovered Listening Ports.

Form

The Create new entry form and the Edit entry form have the same fields; the edit form opens filled in. A Search... box at the top of the form finds a field. The fields are grouped in section cards, in this order. Fields are text unless a type or a list is given.

  • Device Details:
    • Name
    • Dns Name
    • Description: a multi-line text box.
    • Power State
    • Criticality: High, Medium or Low.
    • Application: a list of the Application records.
    • Environment: Production, Pre-Production, UAT, Test, Development or DR.
    • Region
    • Datacentre
    • Cluster
    • Folder
    • Scope: In scope or Out of scope.
    • Role
    • Tags
    • Clarity Tags
  • Ownership: Business Unit, Device Owner.
  • Operating System: Operating System, Operating System Edition, Operating System End Of Mainstream Support (a date), Operating System End Of Extended Support (a date).
  • Hardware: Hardware Vendor, Hardware Model, Hardware Version, Hardware Serial, Hardware End Of Service Life (a date).
  • Performance: Cpu Type, Cpu Speed, Cpu Sockets, Cpu Cores, Memory Gb.
  • Storage: Storage Gb, Storage Used Gb, Number Of Disks.
  • Network: Private Ip Addresses, Public Ip Address, Mac Addresses, Networks, Number Of Nics.
  • Migration Planning:
    • Move Group: a list of the move groups. Some move groups can be greyed out and cannot be selected:
      • "(guard rails)" after the name, on the Edit entry form of an existing device only: the device breaks one or more of that move group's guard-rail rules. Hover over the option to see the reason: "This device breaks this move group’s guard rails:" followed by the fields concerned.
      • "(event locked)" after the name, on both forms: the move group belongs to a locked event. Hover over it to see "This move group belongs to a locked event and cannot be assigned."
      • If you select a greyed-out move group, it is removed again and the reason appears as a message.
      • The device's current move group is never greyed out, so you can still save other changes to a device that already sits in such a move group.
    • Approval Status: Approved or Rejected.
    • Rejection Reason: Decomm, Unknown VM, Unknown Owner, Yes - Future Event or Request Planning Meeting. Help: "Reason for rejection from approval workflow".
    • Interview Lead
    • Migration Contact
    • Planned Migration Date: a date.
    • Migration Date: a date.
    • Maintenance Window Start: a date.
    • Maintenance Window End: a date.
    • Migration Plan: Rehost, Replatform, Refactor, Retain, Retire or Replace.
    • Migration Readiness
    • Migration Testing Required: Yes or No.
    • Migration Testing By
    • Migration Sequence Required: Yes or No.
    • Migration Sequence: 1 to 9.
    • App Shutdown Required: Yes or No.
    • App Shutdown Contact
    • Communication Status: Interview being scheduled, Interview scheduled, Interview conducted with actions, Interview complete or Communications complete.
    • Migration Planning Notes: a multi-line text box.
  • Migration Execution:
    • Migration Status: Not Started, Pre Seeding, Cutover, Testing, Migrated, On Hold, Blocked, Cancelled or Rolled Back.
    • Migrated Date: a date.
    • Migration Failure Reason: SSP task failed - OS failure, SSP task failed - Network Failure, Failed cutover - Move Appliance issues, Failed pre-seeding - Move Appliance issues or Problem with SSP servers.
    • Migration Execution Notes: a multi-line text box.
  • Source to Target Mapping:
    • Target Cluster: a list of the target clusters.
    • Target Storage: a list that is empty until you choose a Target Cluster, then fills from it.
    • Target Network: a list that is empty until you choose a Target Cluster, then fills from it.
    • Target Managed By: a list of the Prism Central and vCenter endpoints.
    • Target Migration Appliance: a list of the Move appliances.
    • Replication Status
    • Runbook
  • Target Recommendation: no fields of its own. On a new device it reads "Target recommendations will appear after the first rightsizing or recommendation run for this device." On an existing device it shows "Loading target recommendation..." and then the recommendation; if that fails it reads "Target recommendation could not be loaded."
  • Custom Fields: the custom fields defined for devices, if any.

The footer has Cancel and Save.

How to

Add a device

  1. Go to Discover → CMDB and select the Device card.
  2. In the toolbar, select Create New. The Create new entry form opens.
  3. Enter a Name, and fill in the other fields you need, for example Application, Environment and Operating System.
  4. Select Save, or select Cancel to close the form without saving.

Set a device's migration target

  1. On the Device grid, select the device's row. Select any cell except Name: selecting the Name opens that record's edit form at once.
  2. In the toolbar, select Edit. The Edit entry form opens with the device's values.
  3. In Source to Target Mapping, choose a Target Cluster. The Target Storage and Target Network lists fill from the cluster.
  4. Choose Target Storage, Target Network, Target Managed By and Target Migration Appliance, then select Save.

Place a device in a move group

  1. On the Device grid, select the device's row. Select any cell except Name: selecting the Name opens that record's edit form at once.
  2. In the toolbar, select Edit. The Edit entry form opens with the device's values.
  3. In the Migration Planning section, select the move group in Move Group.
    • A move group marked "(guard rails)" cannot be selected because the device breaks one of its guard-rail rules. Hover over it to see the reason, correct the device's fields (for example its Scope), save, and edit the device again.
    • A move group marked "(event locked)" belongs to a locked event and cannot be selected.
  4. Select Save. If Clarity finds that the assignment breaks the move group's guard rails, it shows the reason and asks "Guard rails are advisory. Override and assign to this move group anyway?" Select OK to assign the device anyway, or Cancel to leave the form open so that you can correct the device first. A locked event cannot be overridden.

The device's Event follows from its move group: to change the event, change the move group.

Find a device

  1. Go to Discover → CMDB.
  2. Select the Device card.
  3. Type in the Search: box, or enter a value in the filter row of a column such as Name or Operating System.
  4. If the device is not listed, select Display all scopes.... The grid lists only In scope devices until you do. A device that discovery has just added may have no Scope yet, so it is hidden until you do this or set its Scope to In scope.

List the devices of an application

  1. Go to Discover → CMDB and select the Device card.
  2. In the filter row of the Application column, enter the application's name.
  3. The grid shows only the devices with that value in Application. Select Display all scopes... to include devices that are not In scope.

List the devices in a move group

  1. On the Device grid, select Toggle columns and show the Move Group column.
  2. In the filter row of the Move Group column, enter the move group's name.
  3. The grid shows only the devices with that value in Move Group. Select Display all scopes... to include devices that are not In scope.

View a device's details

  1. On the Device grid, select View Details on the row.
  2. The Device Details side panel opens and lists the record's populated fields, followed by Discovered Listening Ports if any ports have been discovered on the device.

Show a hidden column

  1. On the Device grid, select Toggle columns in the toolbar.
  2. Find the column, for example Device Owner or Migration Status, with the Search columns box, and select it.
  3. To keep the layout, select Save columns.

Export devices

  1. On the Device grid, open the download menu.
  2. Select Export Visible Fields or Export All Fields.