You can configure Agent Update behavior on the Endpoint Agent that resides on managed devices.
In Endpoint Management Console, click the Configuration tab.
In the Management Zone Settings panel, click Device Management, then click Agent Update Agent.
Fill in the fields:
Show Permission Prompt: Select On to display a dialog box on the managed device when a Agent Update is ready to begin. If this setting is set to On, the user can cancel, postpone, or allow the update to begin.
By default, this setting is set to Off, which does not give the user the ability to cancel or postpone the update, and the update begins immediately without the user being prompted.
Permission Prompt Max Postpone This setting specifies how many times the user can postpone the update. If you select On for the Show Permission Prompt setting, the user is prompted before a Agent Update begins. The user can then postpone the update. Select Unlimited to let the user postpone the update an unlimited number of times. Or, Select Limit, then specify a number to let the user postpone the update the specified number of times. By default, the user can postpone the update five times.
Permission Prompt Timeout When the user is prompted for permission to apply the update, you can specify how long you want to wait for an answer before the update begins. To display the permission prompt until the user responds, select No Timeout. Or, select Timeout after _ mins and specify the number of minutes you want an unanswered prompt to remain on the user’s screen before the update starts. By default, the user has five minutes to respond to the prompt.
Specify this value in minutes.
Permission Prompt Nag Time When the user chooses to postpone the start of the update, this setting specifies how often the prompt appears to let the user know that an update is waiting to start. By default, this prompt displays every 15 minutes.
Specify this value in minutes.
Permission Prompt Max Wait Time To prevent the user from continuing to postpone the update without any feedback being given to the system, this setting specifies the maximum number of minutes that an Agent update waits for permission before giving up and reporting the agent update as canceled by the user.
Specify this value in minutes. The default is 120 minutes.
Reboot Prompt Nag Dialog If this setting is set to On, a dialog box is displayed on the managed device to remind the user that a reboot is required to complete the agent update. By default, the setting is set to On, and the dialog box displays every 15 minutes.
Reboot Prompt Max Postpone This setting specifies how many times the user can postpone the reboot if one is required for the update. If you select On for the Reboot Prompt Nag Dialog setting, the user is prompted before a reboot occurs. The user can then postpone the reboot. Select Unlimited to let the user postpone the reboot an unlimited number of times. Or, select Limit, then specify a number to let the user postpone the reboot the specified number of times. To postpone a reboot n times, you need to specify the Limit as n-1. For example, if you want to postpone the reboot 3 times, then you need to specify the Limit as 2. By default, the user can postpone the reboot five times.
Reboot Prompt Timeout When an update is assigned with the Prompt User for Reboot option, the default behavior is to wait five minutes for a response from the user and, in the absence of a response, automatically initiate the reboot. Select No Timeout to display the dialog box until the user responds, without initiating the reboot. Or, select Timeout after _ mins, then specify the number of minutes to wait for the reboot response before initiating the reboot.
Reboot Prompt Nag Time When an update assigned with the Suppress Reboot option, or if a user chooses to cancel a required reboot, a dialog box displays to remind the user that a reboot is required to complete the update. By default, the dialog box displays every 15 minutes. This setting lets the administrator define how often the prompt is presented to users.
Specify this value in minutes.
Show Agent Update Progress Select On, to enable the user to view the Agent Update progress. A notification message is displayed in the Windows system tray.
By default, this setting is set to On. If this setting is set to Off, user will not see the Agent Update progress.
Update Watcher Icon You can specify a different icon that displays on the managed device’s notification area of the system tray. The path to the file must resolve on the managed device. If the file does not exist, or if the file in not a valid .ico file, the default icon displays.
Agent Message Overrides You can provide custom text for Agent Update messages that display in dialog boxes during the update. Click Add to display the Edit Agent Update Message dialog box. Select a Message Key from the drop-down list, type the desired text, then click OK.
You can also remove and edit custom messages that you have created.
The following table lists the available message keys with their description:
|
Message Key |
Description |
|---|---|
|
AWAITING_PERMISSION |
An update is available. |
|
AWAITING_REBOOT |
A system reboot is required to complete the agent update. |
|
DEBUG |
DEBUG: {0} |
|
ERROR_CHECKING_PREREQUISITE |
The agent update was canceled because one or more prerequisites were not met. |
|
ERROR_DELETING_FILE |
{0} could not be deleted. Try deleting the file or directory manually and restarting the agent update. |
|
ERROR_DURING_INSTALL |
An unknown error occurred during the agent update. Please see the Agent Update log for details. |
|
ERROR_MOVING_FILE |
{0} could not be renamed. Try renaming the specified file to {0}.bak and restarting the agent update. |
|
ERROR_MSI_UNAVAILABLE |
It appears that another installation is taking place. When it is complete, restart the Update. |
|
ERROR_STARTING_PROCESS |
{0} could not be started. Try starting the process manually and restarting the Update. |
|
ERROR_STARTING_SERVICE |
The {0} service could not be started. Try manually starting the service manually and restarting the agent update. |
|
ERROR_STOPPING_PROCESS |
The {0} process could not be stopped. Try exiting all instances of the process and restarting the Update. |
|
ERROR_STOPPING_SERVICE |
The {0} service could not be stopped. Try stopping the service manually and restarting the Update. |
|
ERROR_ZENWORKS_HOME_NOT_DEFINED |
The ENDPOINT_HOME variable is not set on the device. This can result in an undesired behavior. Set the environment variable on this device and retry the update. |
|
EXIT |
Exit |
|
FINISHED |
The Update has completed successfully. |
|
FINISHED_WITH_ERROR |
The Update has completed; however, some errors were encountered during the update. Contact your Epdpoint Management Administrator to resolve this issue. |
|
INSTALLING_PERCENTAGE |
{0}% Complete |
|
MSI_INSTALL_ERROR |
An error occurred while installing {0}. msiexec returned {1}. |
|
NO_STATUS_REPORTED |
No status has been reported. |
|
PERMISSION_MSG |
Select OK to allow the update to start; select Cancel to postpone the update. Note: If no selection is made, the update will begin automatically in {1} minutes. |
|
PERMISSION_MSG_NO_POSTPONES_REMAINING |
Select OK to allow the update to start. Note: If no selection is made, the update will begin automatically in {1} minutes. |
|
PERMISSION_MSG_NO_POSTPONES_REMAINING_NO_TIMEOUT |
Select OK to allow the update to start. |
|
PERMISSION_MSG_NO_TIMEOUT |
Select OK to allow the update to start, or select Cancel to postpone the update. |
|
PERMISSION_MSG_POSTPONES_ONE_REMAINING |
You will be allowed {0} more opportunities to postpone the update, then the update will be started. |
|
PERMISSION_TITLE |
Agent update Available |
|
REBOOT_CANCELLED |
One or more logged on users have canceled the needed reboot. To complete the agent update, manually restart your system. |
|
REBOOT_MSG |
Select OK to allow the reboot now, or select Cancel to abort the reboot. Note: If no selection is made, the reboot will occur automatically in {1} minutes. |
|
REBOOT_MSG_NO_POSTPONES_REMAINING |
Select OK to allow the reboot to start. Note: If no selection is made, the update will begin automatically in {1} minutes. |
|
REBOOT_MSG_NO_POSTPONES_REMAINING_NO_TIMEOUT |
Select OK to allow the reboot to start. |
|
REBOOT_MSG_NO_TIMEOUT |
Select OK to allow the reboot now, or select Cancel to abort the reboot. |
|
REBOOT_MSG_POSTPONES_ONE_REMAINING |
You will be allowed {0} more opportunities to postpone the reboot, then the reboot will be started automatically. |
|
REBOOT_MSG_POSTPONES_REMAINING |
You will be allowed {0} more opportunities to postpone the reboot, then the reboot will be started automatically. |
|
REBOOT_TITLE |
Restart Required |
|
RESUME_UPDATE_LATER |
If an update is postponed, the update might resume later from the Tray icon.. |
|
SHOW_STATUS |
Show Status |
|
SHUTDOWN_ADJUST_FAILED |
Unable to get permission to initiate a reboot (error code {0}). Manually restart your system. |
|
SHUTDOWN_INIT_FAILED |
A reboot could not be initiated (error code {0}). Restart your system manually. |
|
SHUTDOWN_LUID_FAILED |
Unable to get permission to initiate a reboot (error code {0}). Restart your system manually. |
|
SHUTDOWN_MSG |
A reboot has been initiated to complete the agent update. |
|
SHUTDOWN_TOKEN_FAILED |
Unable to get permission to initiate a reboot (error code {0}). Restart your system manually. |
|
STATUS_TITLE |
agent update |
|
UNKNOWN |
An unknown error occurred during the agent update. See the Agent Update log for details. |
|
UNKNOWN_STATUS |
An unknown status was reported '{0}' |
|
UPDATE_NOT_RUNNING |
The agent update is not running. Contact your Endpoint Management Administrator to resolve this issue. |
|
WATCHER_ICON_TOOLTIP |
Agent update Status |
Click OK.