1.1 System Update Settings

1.1.1 System Update Entitlement

In ZENworks 2017 or later, you need to activate the System Update entitlement to obtain updates to the ZENworks 2017 software on a timely basis. Before activating the entitlement, ensure that the Primary Server you want to use to activate the entitlement can communicate with the NCC server.

The System Update Entitlement panel displays the System Update entitlement status and allows you to activate the System Update entitlement for the ZENworks 2017 in the Management Zone to receive the latest version of ZENworks System Updates and Product Recognition Updates (PRUs) from the Novell Customer Center (NCC) server.

To activate the entitlement:

  1. In ZENworks Control Center (ZCC), click Configuration, in the left pane.

  2. In the Configuration page, click Infrastructure Management > System Update Settings.

  3. Configure the following settings:

    • Email Address: Specify a valid email address to be used for communication from Micro Focus. We recommended that you specify the email address used to purchase the System Update Maintenance Entitlement.

    • Activation Code: Specify the System Update entitlement activation code. You can access the System Update entitlement activation code by visiting the Micro Focus Customer Center. The activation code to activate the Entitlement is available below the Software tab. For the current version of ZENworks, use the related valid activation code that has ZENworks Configuration Management Activation Code in the description.

    To purchase the System Update Maintenance Entitlement, contact an authorized Micro Focus Sales representative or a Certified Micro Focus Partner.

  4. Click Activate.

    The specified information is validated with the NCC server, and subsequently the entitlement is created for the Management Zone in the NCC server.

Retry System Update Entitlement

During Step 4 in Section 1.1.1, System Update Entitlement, if validation with the NCC server fails due to connectivity issues, you will be prompted to retry the system update activation process in the background. If you click Yes, the system update activation will be initiated in the background.

The SUEntitlementConf.properties file has the following settings, which are used for the System Update Entitlement configuration. The values for these settings are initiated based on the values you enter in the SUEntitlementConf.properties file:

  • connection-timeout: This is the connection timeout value in seconds for establishing a connection with the NCC server.

  • retryCount-Activation: This is the maximum number of retries allowed in the background when configuring the System Update entitlement.

  • sleepInterval-Activation: This is the sleep interval allowed between retries for the system update activation in the background.

To change the default value of these settings in the SUEntitlementConf.properties file, go to the following path:

Linux: /etc/opt/novell/zenworks/SUEntitlementConf.properties

Windows: %zenworks_home%/conf/SUEntitlementConf.properties

If you click the Configure link when the SU-Entitlement activation is in progress in the background, the system displays a warning message.

1.1.2 Check for Updates Schedule

The default is to not schedule update checking (No Schedule is displayed in the Schedule Type field). With this scheduling option selected, the only way you can check for software updates is to do so manually in the Available System Updates panel on the System Updates tab.

You can specify how often you want to check for updates. When you specify the schedule, information on available updates is automatically downloaded from Micro Focus to the Available System Updates panel on the System Updates tab when the schedule starts. This does not download the update content itself. Downloading can be scheduled in the Download Schedule panel (see Download Schedule).

To schedule checking for the ZENworks software updates:

  1. In ZENworks Control Center, click Configuration in the left pane, then click the Configuration tab.

  2. Click Management Zone Settings to expand its options, click Infrastructure Management to expand its options, and then select System Update Settings.

    In the Check for Updates panel, there are two scheduling options for updates:

    • No Schedule: The default is to not schedule update checking. With this scheduling option selected, the only way you can check for software updates is to do so manually in the Available System Updates panel on the System Updates tab. To specify the No Schedule option, continue with Step 3.

    • Recurring: Lets you specify how often you want to check for updates. When you set this option, information on available updates is automatically downloaded from Micro Focus to the Available System Updates panel on the System Updates tab when the schedule starts. This does not download the update content itself. To set a recurring schedule, skip to Step 4.

  3. (Conditional) To exclude scheduled checking for software updates (the default), click the down-arrow in the Schedule Type field, select No Schedule, click Apply to save the schedule change, then skip to Step 6.

    With this option selected, you must check for updates manually. For more information, see Manually Downloading Updates.

  4. (Conditional) To set a recurring schedule for checking for updates to your ZENworks software, click the down-arrow in the Schedule Type field, then select Recurring.

  5. Fill in the fields:

    1. Select one or more check boxes for the days of the week.

    2. To set the time of day for checking to occur, use the Start Time box to specify the time.

    3. (Optional) For additional scheduling options, click More Options, then select the following options as necessary:

      • Process Immediately if Device Unable to Execute on Schedule: Checks for updates to occur as soon as possible, if the checking cannot be done according to schedule. For example, if a server is down at the scheduled time, checking for updates occurs immediately after the server is available.

      • Use Coordinated Universal Time: Schedules to interpret the times you specify as UTC instead of local time.

      • Start at a Random Time Between Start and End Times: Allows checking for updates to occur at a random time between the specified time and the time specified in Step 5.b. Fill in the End Time fields.

      • Restrict Schedule Execution to the Following Date Range: In addition to the other options, you can specify a date range when the checking should occur.

    4. When you have finished configuring the recurring schedule, click Apply to save the schedule change.

  6. To exit this page, click OK when you are finished configuring the schedule.

    Click OK to save and apply your changes. Click Cancel to close the page, but your unapplied changes will be discarded.

1.1.3 Download Schedule

The default is to not schedule downloading of updates (No Schedule is displayed in the Schedule Type field). With this scheduling option selected, the only way you can download updates is to do so manually in the Available System Updates panel on the System Updates tab.

If you do specify how often you want to download updates, you should set this schedule in conjunction with the schedule to check for updates (see Check for Updates Schedule).

After an update has been checked, the information is displayed in the Available System Updates panel on the System Updates tab, you can schedule the download from Micro Focus to automatically occur when the schedule starts.

To schedule ZENworks software updates:

  1. In ZENworks Control Center, click Configuration in the left pane, and then click the Configuration tab.

  2. Click Management Zone Settings to expand its options, click Infrastructure Management to expand its options, and then select System Update Settings.

    In the Download Schedule panel, there are two scheduling options for downloading updates:

    • No Schedule: By default, No Schedule is displayed in the Scheduled Type field. When schedule is not set, then you have to download the updates manually in the Available System Updates panel on the System Updates tab. To specify the No Schedule option, continue with Step 3.

    • Recurring: You can specify how often you want to download updates. After an update is checked, the information displayed in the Available System Updates panel on the System Updates tab, you can schedule the download from Micro Focus to automatically occur when the schedule starts. To set a recurring schedule, skip to Step 4.

  3. (Conditional) To exclude scheduled downloading of software updates, click the down-arrow in the Schedule Type field, select No Schedule, click Apply to save the schedule change, and then skip to Step 6.

    If you select this option, then you must download updates manually. For more information, see Section 2.2, Downloading Updates.

  4. (Conditional) To set a recurring schedule for downloading updates to your ZENworks software, click the down-arrow in the Schedule Type field, and then select Recurring.

  5. Fill in the fields:

    1. Select one or more check boxes for the days of the week.

    2. To set the time of day for downloading to occur, use the Start Time field to specify the time.

    3. (Optional) For additional scheduling options, click More Options, then select the following options as necessary:

      • Process Immediately if Device Unable to Execute on Schedule: Checks for updates to occur as soon as possible if the checking cannot be done according to schedule. For example, if a server is down at the scheduled time, checking for updates occurs immediately after the server comes back online.

      • Use Coordinated Universal Time: Schedules to interpret the times you specify as UTC instead of local time.

      • Start at a Random Time Between Start and End Times: Allows downloading of updates to occur at a random time between the time you specify here and the time you specified in Step 5.b. Fill in the End Time fields.

      • Restrict Schedule Execution to the Following Date Range: In addition to the other options, you can specify the days when downloading should occur.

    4. When you have finished configuring the recurring schedule, click Apply to save the schedule change.

  6. To exit this page, click OK when you are finished configuring the schedule.

    Click OK to save and apply your changes. Click Cancel to close the page, but your unapplied changes will be discarded.

1.1.4 Email Notification

In conjunction with using stages, you can set up email notifications to indicate when each stage has completed. When you deploy an update, you can specify to use the e‑mail notifications.

  1. In ZENworks Control Center, click Configuration in the left pane, and then click the Configuration tab.

  2. Click Management Zone Settings to expand its options, click Event and Messaging, then select Notification Servers to display the E‑mail Notification panel.

    Staging must be used to receive notifications, and the stage behavior must be set to one of the following:

    • Advance Through Stage Automatically With Notification

    • Advance To Next Stage and Notify When Complete

    SMTP must be configured in order for the staging email configuration to work.

  3. (Conditional) If you do not have SMTP configured:

    1. To access the SMTP Settings page, click Configuration in the left pane, click the arrows in the Management Zone Settings heading to expand its options, click Event and Messaging, and then select Notification Servers.

    2. In the email Notification section, fill in the fields:

      SMTP Server Address: Specify the DNS name or IP address of the SMTP server.

      SMTP Port: Specify the SMTP server’s communication port.

      SMTP Server Requires Authentication: If authentication is required, select this check box, then specify the User and Password.

    3. Click OK to save the changes.

    4. Click Management Zone Settings to expand its options, click Infrastructure Management, and then select System Update Settings to display the Email Notification panel.

  4. Fill in the fields:

    From: Either specify your administrator e‑mail address, or type something descriptive, such as System-Update-Stage-Notice. Do not use spaces between words.

    To: Specify your administrator’s email address. You can specify multiple email addresses separated by a comma (,).

    This is the person you want to be notified when the stage ends.

  5. Click Apply to make the changes effective.

  6. Either click OK to close the page, or continue with another configuration task.

    Click OK to save and apply your changes. Click Cancel to close the page, but your unapplied changes will be discarded.

1.1.5 Proxy Server Settings

This option is useful for restrictive environments where you do not want all of your production servers to have Internet access. This is used in conjunction with the Dedicated Server Settings panel.

To specify a proxy server:

  1. In ZENworks Control Center, click Configuration in the left pane.

  2. On the Configuration tab, expand the Management Zone Settings section (if necessary), click Infrastructure Management, then click System Update Settings to display the Proxy Server Settings panel.

  3. Fill in the fields:

    Proxy Server Address: Specify the DNS name or IP address of the proxy server.

    Proxy Server Port: Specify the proxy server’s communication port.

    Proxy Server Requires Authentication: When you select this check box, the User and Password fields become editable. If authentication is required, select this check box and specify the username and password for accessing the proxy server.

  4. Click Apply to make the changes effective.

  5. Either click OK to close the page, or continue with another configuration task.

    Click OK to save and apply your changes. Click Cancel to close the page, but your unapplied changes will be discarded.

1.1.6 Dedicated Server Settings

By default, any available Primary Server in the Management Zone can be used randomly to download the updates. However, you can specify one ZENworks Server to be dedicated to handling your update downloads. The server that you select should have access to the Internet, directly or through a proxy server. The zone-wide pre-install actions will run on the dedicated system update server.

The following sections contain more information:

Specifying a Dedicated Update Server

  1. In ZENworks Control Center, click Configuration in the left pane.

  2. On the Configuration tab, expand the Management Zone Settings section (if necessary), click Infrastructure Management, then click System Update Settings to display the Dedicated Server Settings panel.

  3. Browse for and select a ZENworks Primary Server.

    The server’s identification is displayed in the Dedicated System Update Server field.

    This ZENworks Server must be a member of the Management Zone.

  4. Click Apply to make the changes effective.

  5. Either click OK to close the page, or continue with another configuration task.

    If you did not click Apply to make your changes effective, clicking OK does so. Clicking Cancel also closes the page, but loses your unapplied changes.

Clearing a Dedicated Update Server

Clearing a dedicated update server causes your updates to be retrieved randomly from any Primary Server in the Management Zone.

  1. In ZENworks Control Center, click Configuration in the left pane.

  2. On the Configuration tab, expand the Management Zone Settings section (if necessary), click Infrastructure Management, then click System Update Settings to display the Dedicated Server Settings panel.

  3. Click to remove the dedicated server from the Dedicated System Update Server field.

  4. (Conditional) If you need to revert to the last saved dedicated server setting, click Reset.

    This resets the dedicated server to the last saved setting, such as when you last clicked Apply or OK.

  5. Click Apply to make the change effective.

    IMPORTANT:Previous settings cannot be restored after you click Apply.

1.1.7 Stage Timeout Settings

Deployment stages are optional; however, stages allow you to deploy an update one step at a time, such as to a test group first, then to your managed devices. If a failure occurs during the update process, the process is halted. E‑mail notifications can let you know when each stage has completed.

The global default timeout setting is 3 days. This provides the same timeout length for each stage. For information about setting the timeout for individual stages, see Modifying the Stage Timeout.

Set this value to be long enough to accommodate updating all of the devices you plan to update.

When the timeout value is reached, the stage’s deployment stops and an email message is sent, if email notification is configured. You can cancel the deployment, or you can clear the error to restart the stage and reset the timeout. Or, you can ignore all pending devices to trigger a stage progression (either automatic, or wait for administrator action based on the setting).

You can use email notification to know when a stage has completed.

To configure global stage timeout settings:

  1. In ZENworks Control Center, click Configuration in the left pane.

  2. On the Configuration tab, expand the Management Zone Settings panel (if necessary), click Infrastructure Management, then click System Update Settings to display the Stage Timeout Settings panel.

  3. Select the Stage Timeout check box, then specify the days, hours, and minutes desired.

  4. Click Apply to make the changes effective.

  5. Either click OK to close the page, or continue with another configuration task.

    If you did not click Apply to make your changes effective, clicking OK does so. Clicking Cancel also closes the page, but loses your unapplied changes.

1.1.8 Reboot Behavior

Some updates do not require a device to be rebooted after they have been deployed to a device. However, if a reboot is required to complete the update process, the deployment is not completed until the device is rebooted.

To configure the reboot behavior:

  1. In ZENworks Control Center, click Configuration in the left pane.

  2. On the Configuration tab, expand the Management Zone Settings panel (if necessary), click Infrastructure Management, then click System Update Settings to display the Reboot Behavior panel:

  3. Select one of the following options:

    • Prompt User to Reboot When Update Finishes Applying: After the update has been applied, a request to reboot is immediately displayed. If the user initially rejects rebooting, the user is periodically requested to reboot the device, until the device is rebooted.

      • Reboot device when no user is logged into the system: Select this option to reboot the device even if no user has logged into the system.

      • Reboot device when the device is locked (only on Windows 8.1 and earlier): Select this option to reboot the device if the device is locked. Prompt will not be displayed before rebooting the device.

      The above options are applicable on agents only when they are upgraded to ZENworks Update 2 or later version.

    • Do Not Reboot Device: The device does not reboot; however, the user is periodically requested to reboot the device, until the device is rebooted.

    • Force Device to Reboot: After the update has been applied, the device is automatically rebooted without user intervention if a reboot is required by the update.

  4. Click Apply to make the changes effective.

  5. Either click OK to close the page, or continue with another configuration task.

    If you did not click Apply to make some of your changes effective, clicking OK does so. Clicking Cancel also closes the page, but loses your unapplied changes.