7.0 Configuring the System Update Behavior of the ZENworks Agent

You can configure System Update behavior on the ZENworks Agent that resides on managed devices.

  1. In ZENworks Control Center, click the Configuration tab.

  2. In the Management Zone Settings panel, click Device Management, then click System Update Agent.

  3. Fill in the fields:

    Show Permission Prompt: Select On to display a dialog box on the managed device when a System 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 System 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 ZENworks system, this setting specifies the maximum number of minutes that an update waits for permission before giving up and reporting the 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 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 System Update Progress Select On, to enable the user to view the system 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 system 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 System Update messages that display in dialog boxes during the update. Click Add to display the Edit Agent System 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 mesage keys with their description:

    Message Key

    Description

    AWAITING_PERMISSION

    A ZENworks update is available.

    AWAITING_REBOOT

    A system reboot is required to complete the ZENworks Update.

    DEBUG

    DEBUG: {0}

    ERROR_CHECKING_PREREQUISITE

    The 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 ZENworks Update.

    ERROR_DURING_INSTALL

    An unknown error occurred during the ZENworks Update. Please see the system update log for details.

    ERROR_MOVING_FILE

    {0} could not be renamed. Try renaming the specified file to {0}.bak and restarting the ZENworks Update.

    ERROR_MSI_UNAVAILABLE

    It appears that another installation is taking place. When it is complete, restart the ZENworks Update.

    ERROR_STARTING_PROCESS

    {0} could not be started. Try starting the process manually and restarting the ZENworks Update.

    ERROR_STARTING_SERVICE

    The {0} service could not be started. Try manually starting the service manually and restarting the ZENworks Update.

    ERROR_STOPPING_PROCESS

    The {0} process could not be stopped. Try exiting all instances of the process and restarting the ZENworks Update.

    ERROR_STOPPING_SERVICE

    The {0} service could not be stopped. Try stopping the service manually and restarting the ZENworks Update.

    ERROR_ZENWORKS_HOME_NOT_DEFINED

    The ZENWORKS_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 ZENworks Update has completed successfully.

    FINISHED_WITH_ERROR

    The ZENworks Update has completed; however, some errors were encountered during the update. Contact your ZENworks 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

    ZENworks Update Available

    REBOOT_CANCELLED

    One or more logged on users have canceled the needed reboot. To complete the ZENworks 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 ZENworks Update.

    SHUTDOWN_TOKEN_FAILED

    Unable to get permission to initiate a reboot (error code {0}). Restart your system manually.

    STATUS_TITLE

    ZENworks Update

    UNKNOWN

    An unknown error occurred during the ZENworks Update. See the system update log for details.

    UNKNOWN_STATUS

    An unknown status was reported '{0}'

    UPDATE_NOT_RUNNING

    The ZENworks Update is not running. Contact your ZENworks Administrator to resolve this issue.

    WATCHER_ICON_TOOLTIP

    ZENworks Update Status

  4. Click OK.