Assignments can only be used, if an Empirum API connection is configured and available.
Further information about the distribution options for servers and desktop devices can be found here.
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 group
- Description - description of Assignment group
- Status - current status of Assignment group (Active/Inactive)
- Rollout Progress - shows percentage of devices which have installed all assigned objects (software) from 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
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:
In this tab you can see all general information like name, status, description and Rollout Information.
- 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.
This tab shows the list of devices that are added to the selected assignment.
- 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.
This tab shows the list of objects (software packages) that are added to the selected assignment.
- 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:
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 Distribution Commands correspond to the distribution commands of the Empirum Management Console (EMC).
Install / Update
One or more software assigned to the group will be installed and already installed software will be updated.
One or more software assigned to the group will be installed.
One or more software assigned to the group will be updated.
One or more software assigned to the group will be uninstalled.
By the option "User can postpone" you can save how often and until when a client can postpone the distribution on his device.
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).
Known issues with device data:
Silverback devices receive a status (e.g. "Active") only during the initial sync. If the status is changed on Silverback, this change is not transferred to Solutionbuilder.
Silverback last seen data is handled incorrectly. If all systems are on the same time zone: Silverback displays 2h too early and Solutionbuilder displays 2h too late (+4h compared to Silverback).
Displayed times for the same event:
24.07.2018 17:04 iPhone (e.g. lock device executed)
24.07.2018 15:04 Silverback: Last Updated
24.07.2018 19:04 UEM Console: Last Seen
If systems are on different time zones the time offset is different once again.
Empirum clients transfer their last seen timestamp value to Empirum in client-local time without time zone information.
The Empirum Connector does not transfer the last seen field to Solutionbuilder. For Empirum devices the last seen field displays the Last Scan value.
Rollout End allows you to set a time for the rollout end. You can either choose between None or Planned (specific end date).
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%.
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.
Here you can see all of the objects (software packages) 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 available in the Empirum Management System. Note that in this list only software packages that are NOT already part of the assignment are listed.
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.
Important information for the functionality of Assignments:
This is a known issue which will be fixed in the future.
To fully synchronize the rollout progress of assignments in the UEM Console, the following configurations have to be set for objects (software packages) in Empirum:
- When selecting a software package in Empirum, a window with the title "Package Properties" will open up
- The default tab "View" contains a field "Text" that should follow the following Syntax:
- The tab "Version" contains a field called "Revision"
- If the value of this field is greater than "0", this value should be added to the version number in the field "Text"
- If the value is "0", no further steps are needed
- The following picture shows this as an example for the case: Revision = 6:
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.