Device Labeling - How To

Introduction

Labels are assigned to devices during installation, allowing you to group devices for easier identification and management. Once a label is assigned, you can quickly locate and manage all devices associated with that label.

Minimum GYTPOL Sensor versions required for Device Labeling:

  • Windows: 2.36.X

  • Linux and macOS: 1.29.X.Y

  • Backend version: 2.16.6

GYTPOL Sensor Location

  1. Navigate to “System Health” screen located in the “Settings” section.

image-20241017-091708.png
  1. Download the GYTPOL Sensor for your respective operating system using the download icon.

  2. After downloading, you can deploy the sensor using any deployment tool available. To assign labels to devices, follow these guidelines:

    • Labels must be 2-32 characters long.

    • Labels can only include letters, numbers, underscores, or hyphens.

    • Only one label can be assigned per device.

For additional reference, please see the UI2 - Sensor Deployment and Management Guide document.

Deployment examples and arguments

Windows

Label: accounting

Path to the MSI installation file (including the file name): c:\GYTPOL\gytpolClient_x64.msi

Installation command with the accounting label: msiexec /i c:\GYTPOL\gytpolClient_x64.msi LABEL=accounting

Linux (DEB)

Label: engineering

Path to the DEB installation file (including the file name): /opt/gytpol/gytpol-client_1.30.1.21-113_amd64.deb

Installation command with the engineering label: sudo dpkg -i /opt/gytpol/gytpol-client_1.30.1.21-113_amd64.deb && sudo /opt/gytpol/gytlnx -set-labels engineering

Linux (RPM)

Label: healthcare

Path to the RPM / DEB installation file (including the file name): /opt/gytpol/gytpol-client_1.30.1.21-113_amd64.rpm

Installation command with the healthcare label: sudo rpm -ivh /opt/gytpol/gytpol-client_1.30.1.21-113_amd64.deb && sudo /opt/gytpol/gytlnx -set-labels healthcare

macOS

Label: devops

Path to the RPM / DEB installation file (including the file name): /opt/gytpol/1.30.1.22_126/gytpol-client-1.30.1.22-126_arm64.pkg

Installation command with the devops label: sudo /usr/sbin/installer -pkg /opt/gytpol/1.30.1.22_126/gytpol-client-1.30.1.22-126_arm64.pkg -target / && sudo /opt/gytpol/gytmac -set-labels devops

Where to find the labels

  • After updating the labels, they will be visible in the UI only after a full scan has been completed.

  • You can locate the labels in the UI under: System-Health > Device Manifest > Device Information

Screenshot 2024-11-19 124527.png

How to Manage Devices Using Labels

Adding Devices to Groups

Use the "Labels" filter to group devices.

This will display all devices associated with the selected label, enabling effective organization and management.

For additional reference, please see the UI2 - Creating Computer Groups document.

Filtering Devices in the Device Manifest:

In the Device Manifest, apply the label filter to display all devices associated with a specific label.

This simplifies viewing and managing devices linked to a particular label.