Skip to main content
Matrix42 Self-Service Help Center

Create Assignments

Assignments

Assignments can only be used, if an Empirum API connection is configured and available. Silverback is configured in the Data Provider settings.

Further information about the distribution options for servers and desktop devices can be found here.

Assignments describe the target state for the devices contained in it based on the assigned objects. An assignment can contain different device types (e.g. Windows computers, mobile devices with iOS and Anbroid) and object types (e.g. Silverback tag, Empirum package). It is ensured that the appropriate combination of device and object (management type) is used for distribution/configuration.

In this list, one or more corresponding assignments can be configured for the selected device. Also in this list you could see general information for each assignment like:

  • Name - name of Assignment
  • Description - description of Assignment
  • Status - current status of Assignment (Active/Inactive/Stopped)
  • Rollout Progress - shows percentage of devices which have installed all assigned objects (software) from current Assignment group 
  • Installation Errors - shows number of devices with errors during installation of assigned objects (software) within current Assignment group
  • Rollout Start -  time for Assignment group activation
  • Rollout End - time for the rollout end 
  • Devices - number of assigned devices
  • Objects - number of assigned objects
Quick Filters

By clicking on the icons  entries can be filtered by rollout progress state 

  • Red:  Error. 
  • Green: Fully complete  (All assigned objects are installed on all devices in Assignment group).
  • Yellow:  Partially complete (Assigned objects are partly installed on assigned devices in Assignment group).
  • All grey: Not started (No assigned object is installed on any device in Assignment group).

If an new assignment is to be recreated, click on Add Assignment.Once you click on an existing assignment group, an information window opens on the right with all general data, assigned devices and objects. By clicking on Edit or double-clicking on the corresponding assignment group, they can be edited as in a new creation. In the left column of the editing window, the three different configuration options are now displayed:

Assignments Preview Pane

By selecting an assignment, a Preview Pane will open up to show general information to an assignment like it's name, description, status, but also list-views of already added devices and objects (software).

This view is separated in different tabs:

General

In this tab you can see all general information like name, status, description and Rollout Information.

Rollout Progress:

  • Fully complete: Shows the progress of object installations that are completed on the all devices.
  • Partially complete: Shows the progress of object installations that are not yet completed on all devices.
  • Not started: Shows the progress of object installations that have not yet been started on devices.

Rollout Progress Pie Chart

It shows the rollout progress for the current Assignment.

Each assignment could have up to 3 segments:

  • Fully complete devices - shows number of devices which have installed all assigned objects (software) from the current assignment.
  • Partially complete devices - shows number of devices which have installed one or more assigned objects (software) from the current assignment.
  • Not started devices - shows number of devices which have not started installing any assigned objects (software) from the current assignment. 

Devices

This tab shows the list of devices that are added to the selected assignment.

Columns:

  • Assigned: Shows the number of objects (packages) that are assigned to this device.
  • Installed: Shows the number of assigned objects (packages) that are already installed on the device.
  • Progress: Shows the progress of assigned objects (packages) that are completely installed.
  • Activated: Indicates if a device is activated based on the rollout plan. Only devices with the state "Activated" are synchronized to Empirum or Silverback.

Objects

This tab shows the list of objects (software packages) that are added to the selected assignment.

Columns:

  • Installed: Shows the number of devices which have already installed the object.
  • Progress: Shows the progress (percentage) of devices which have already installed the object.

Adding/Editing an Assignment

You can create a new assignment, by clicking on "Add Assignment" in the Assignments general view.

To edit an assignment, just click on "Edit" in the selected assignments Preview Pane.

In both cases you will get to the same edit dialog.

General

Status is used to set whether the assignment group is activated in the Empirum management system or not.

  • Setting the status to "Active" will result in the activation of all devices of this specific Assignment Group only.
  • Setting the status to "Inactive" will result in the deactivation of all devices of this specific Assignment Group only.

The "Stopped" status is set by the system when the error threshold is exceeded as part of a rollout plan and must be manually changed to "Active" or "Inactive".

The Distribution Commands  correspond to the distribution commands of the Empirum Management Console (EMC) and only valid for software packages of the type classic which are installed by the UEM Agent.

  • Install / Update: One or more software assigned to the group will be installed and already installed software will be updated.
  • Install: One or more software assigned to the group will be installed.
  • Update: One or more software assigned to the group will be updated.
  • Uninstall: One or more software assigned to the group will be uninstalled.

The options for adjusting the end user experience for software deployments include the following UEM Agent features:

  • Hide packages from installation request dialog (the Empirum distribution command Hide) - The packages are not shown in the installation request dialog and will be installed before all other packages. The user cannot postpone or deny the installation.
  • User can postpone (the Empirum distribution option postpone) - The packages can be postponed by the user until either the end date or the number of postponed days is reached (closest time counts). If no number or date is provided the user can postpone infinitely. If another package except of hidden packages will be installed also all packages with open postponements are installed to reduce the number of interruptions for the end user.
  • Packages are optional (the Empirum distribution command Optional Install) - the user has the option to install the package but it will not be installed automatically with other installations. It is possible to provide a end date when this packages are not optional anymore.

Rollout Start allows you to set a time for activation. If the status of the assignment is Active you can specify a scheduled rollout (distribution commands). To do this, select Immediately or Planned from the drop-down menu of the section Rollout Start on the right hand side. If you select Planned  you can set a date and time in the future.

A rollout of the assigned software packages will not start before the set date and time has arrived and it has no end-date. This is part of the Empirum distribution commands (scheduler).

Rollout End allows you to set a time for the rollout end. You can either choose between None or Planned (specific end date).

When using a rollout plan the devices are added and activated in the core system (Empirum/Silverback) according to the plan.

Use Rollout Plan is used to set the properties of a rollout plan.

  • Percentage activated of open installations: Sets the percentage of devices in current assignment group that should get activated at a defined schedule. Default value is 10%.
  • Time between activation recalculation: Sets the time period between activation recalculation in days/hours. The default value is 1 day.
  • Activate all devices when threshold is reached: Sets the threshold percentage of devices that have successfully installed all packages. When the threshold is reached, all remaining devices will be activated at the next recalculation. The default value is 50%.
  • Stop rollout on error threshold: Sets the threshold percentage of devices that have errors during package installation. When this threshold is reached at the next recalculation the assignment group state is set to "Inactive" and the rollout is stopped. The default value 5%.

Use principle users for device selection

Allows to use the assigned principal user for selecting the target devices.

  • Shows only users which have assigned devices.
  • When selecting users their associated devices will automatically added to the list of devices in the Devices page of the wizard.

Devices

Click Add to open a window that displays all devices in the Empirum management system. From this list you can now select all devices to be added to this assignment. Note that in this list only devices that are NOT already part of the assignment are listed. Then click either on SAVE or DONE to apply changes.

To remove one or more devices from the assignment, select the devices you want to remove and click on REMOVE. Then click on SAVE or DONE to apply the changes or CANCEL to discard them.  


Objects

Here you can see all of the objects that have already been added to the selected assignment.

To add one or more objects, click on Add to open a window that displays all objects. Note that in this list only software packages that are NOT already part of the assignment are listed.

Object types which can be assigned multiple:

  • Software (Empirum Package)
  • Tag (Silverback)
  • Patch Management Group (Empirum Patch Management Patch and Service Pack Groups)
  • OS Language Pack (Empirum imported Language Packs)

Objects which can only be assigned once per assignment:

  • Agent Configuration (Empirum agent Template)
  • OS Installation Sources (Empirum Imported Operating Systems)
  • Boot Image (Empirum WinPE or EPE PreBoot Images)

To remove one or more objects from the assignment, select the objects you want to remove and click on Remove. Then click on SAVE or DONE to apply changes or CANCEL to discard them.  

Objects with the Status "Blocked" or "Retired" will not be shown in this list.

If an assignment group with the same name already exists, an error message will appear at the button of the window and the assignment can't be saved.

Summary 

The summary page shows the defined settings, assigned devices and objects. A validation informs if an object type, which can only be assigned once per assignment, was added more than once.

  • Was this article helpful?