Novell is now a part of Micro Focus

My Favorites


Please to see your favorites.

ZENworks 2017 Upgrade Cookbook

This document (7018169) is provided subject to the disclaimer at the end of this document.


Novell ZENworks Configuration Management 2017 Migration
Novell ZENworks Configuration Management 2017 System Update
Novell ZENworks Configuration Management 11.4 System Update


This document is assembled, focused to assist in migrating to ZCM v2017 and latest Update.
This example starts at ZCM ZONE version 11.4.x.
common upgrade/update best practices with HTML links, documents and videos.

Note: Be sure to reference the documentation for your specific environment.


What's New in ZENworks 2017

What's New in ZENworks 2017 Update 1

What's New in ZENworks 2017 Update 2

Locate downloads through the Micro Focus Trial download siteMicro Focus download site or patches through Patch Finder.
Do not extract .iso’s (TID 7015386)
– the .iso must be “mounted” to a public location.
Perform MD5 on all downloaded files for data integrity.
Make sure any Downloaded/Imported System Update content replication is 100% on all Primary Servers before starting.

ZENworks Control Center
Browser requirements change depending on the ZENworks version.
ZENworks 2017 ZCC changes;

  • Branding and color scheme
  • Mobile Management added to Navigation pane
  • Mobile Devices, Mobile Policies and iOS Bundles
  • Active Sync to ZCC > Configuration > ActiveSync (Tab)
  • Available System Updates Status displays Downloaded, Prepared, Authorized, Deploying
  • Assignment Optimization
  • Browser Agnostic

ZENworks 2017 Licensing
License key from ZCM 11 doesn't carry over.
Log in to the Micro Focus customer care portal for ZENworks 2017 license keys to activate the environment during upgrade.
Note: During the migration if not licensed for the ZENworks 2017 Suite, then all individual "Active" ZENworks Configuration Management component licenses will need to be entered.
You cannot continue with Evaluation options if your zone has a Product or Suite licensed in an Active state.

Known Issues

  • ZENworks 2017
  • ZENworks 2017 Update1
  • ZENworks 2017 Update2
    • TID 7022612 - Update2 and Update2a are only differentiated by the update script (and so have different GUID's),
      the update end results for the files and database are the same.
      Note:  Aside from the issue described in this TID, ZENworks 2017 Update 2 and ZENworks 2017 Update 2a builds are functionally identical.

Planning and compatibility Guide


  • Plan End User communication and downtime.  During Primary Server upgrade to ZENworks 2017, based on scale of environment, some end users may see disruptions on functionalities like; installing apps, user login, content download, etc.
  • Always take a Backup of ZENworks Servers (or snapshot of Virtual Environment) including databases and other related files (Imaging, TFTP, etc.)
  • Refer to the documentation for the best practices for backing up the ZENworks system and its components (certificates, database, file system, imaging configuration files, etc)
  • Zones must be upgraded to ZCM v11.4.0 minimum before upgrading to ZENworks 2017.
  • Using the ZENworks 2017 installation media, the zone can directly be upgraded to ZENworks 2017 if the zone is currently ZENworks 11 SP4 (11.4.0) or later.
  • Windows Primary Servers must be at Windows 2012 Server OS minimum (Windows Server 2008 R2 is no longer supported in ZENworks 2017).
  • Micro Focus has tested upgrading Windows Server 2008 to 2012 prior to migrating ZENworks from v11.4.x to ZENworks 2017.
    Note: While there were not any ZCM related issues performing an in-place OS upgrade from 2008R2 to 2012, however it does pose a risk and Micro Focus cannot ensure the OS itself will upgrade cleanly.
  • Do not Upgrade to Windows Server 2016 OS prior to ZENworks 2017 migration, since Windows Server 2016 OS is not supported on ZCM v11.4.x.
  • SLES v12 requires libXtst6-32bit-1.2.2-3.60.x86_64.rpm installed prior to ZENworks install.  (This rpm can be found on the corresponding media for the installed OS version)
  • Known issues after in-place upgrade of the Linux OS with ZENworks installed.
  • Make sure there is disk space available to do the migration: 20Gb+ for Appliance, and 20Gb+ for physical/VM.
  • VM RAM should be dedicated and not dynamic.
  • Make sure Upgrade is "Success" on the Primary before moving to the next step.
  • Firewall settings and network TCP and UDP ports reviewed and Anti-Virus exclusions updated TID 7007545
  • ARSO changes in Windows 10 Fall Creators Update (Build 1709) reference TID 7022379

ZENworks 2017 Appliance

ZENworks 2017 Appliance Deployment
ZENworks 2017 Appliance Configuration
ZENworks 2017 Appliance Management Console

Be sure to follow the step by step process in the ZENworks 2017 Appliance Migration documentation.

  1. ZENworks 11 SP4 Appliance - After powering down the 11 SP4 Appliance, detach the virtual disk (VAStorage volume)
  2. Make a copy of the VAStorage volume placing the copy into the ZENworks 2017 VM file location
  3. ZENworks 2017 Appliance - Add the copied VAStorage volume as an additional hard disk onto the ZENworks 2017 Appliance (prior to powering on of the 2017 appliance).
  • Snapshot or backup ZENworks 2017 appliance prior to powering it on.
ZCM Database Requirements
Database Requirements ZENworks 2017
If external database be sure to check requirements necessary for db space, db version and OS versioning.
Check Database Requirement details if planning on using Oracle RAC.
Caution: Oracle Partitioning may be used for ZCM during the upgrade process if this feature is on (even if Oracle Partitioning is not purchased).

ZENworks Diagnostic Center
Locate use of this utility in the ZENworks Command Line Reference Guide.
ZDC should be run on EVERY primary server prior to start of the upgrade to verify system files, database connections (zenworks and audit) and content. 
ZDC for ZENworks 2017 on the .iso Common\tools\zdc or the Novell download portal;
ZDC for v11.4.0ZDC for v11.4.1ZDC for v11.4.2ZDC for v11.4.3
ZDC for v2017
ZDC for v2017 Update1, ZDC for v2017 Update2ZDC for v2017 Update2a 
Running ZDC is a best practice, be sure to select the proper ZDC.
ZDC's are published for every version, Service Pack and subrev found on Micro Focus download site or patch finder site.

If there are ZDC failures like inconsistencies, mismatches or missing files, check the knowledge base (or support for analysis) before upgrading.
Note: Please provide details of the zone version and database type along with the ZDC reports to expedite the request.

ZENworks Adaptive Agents (ZAA)
Managed device requirements for new ZAA installs.
Managed device prerequisites for ZAA updates (including Satellites).
Supported versions for agents/satellites to receive cumulative update.
Read the system requirements carefully for the OS to be upgraded.  (Common OS's like XP, Vista, SLES11 SP2 managed but not supported in ZCM v2017.)
Example: Managed devices with ZAA v11.2.x can be directly upgraded to ZAA v2017, after your system primaries and satellites are at ZCM v2017.
ZAA managed devices can only use the available features that the ZAA version installed supports. 
e.g., Managed devices using v11.2.1 will not be using ZAPP (introduced in ZCM v2017)
Full Disk Encryption is on the Managed device, consult the ZENworks 2017 Update 1 - Full Disk Encryption Update Reference for process of upgrading those agents.
    Old FDE Policy must be removed prior to upgrading to ZENworks 2017 Update 1, decrypting the drive.
    Then upgrade the ZAA and apply a New 2017 Update1 FDE Policy.
Prior to installing or updating the ZENworks Adaptive Agent (ZAA) v2017 ensure;
  • ZAA version 11.x or higher must be installed
  • Microsoft .NET 4.5 Framework version (or higher) is installed and running on the Windows managed device.
    With the ZENworks 2017 new branding, the system tray icon changes  and can be modified in ZCC (ZCC > Configuration > System Update Agent > Update Watcher Icons)
    NOTE: Managed devices with the XP OS, can be managed in 2017 Zone using the older ZAA, however ZENworks 2017 ZAA is not supported on XP OS.
    NOTE: Upgrade the unsupported OS to a supported OS prior to deploying the ZAA.

Start of Migrations

Upgrade process from v11.4.x to ZENworks 2017

ZENworks 2017 Precheck - Example Zone currently at ZCM 11.4.x
  • Run ZENworks Diagnostic Center (ZDC) for current ZONE version to verify integrity of system files, database inconsistencies, mismatches or missing files
  • Verify System Requirements
  • Snapshot or Backup ZCM Server(s), databases, system files, certificates, PXE imaging menu files and TFTP directories
  • Run zman zenserver-backup (zsb) command to save zone critical data.
  • Turn off Anti-virus and Windows Updates services if applicable
  • Verify prerequisites completed (rpms for Appliance and SLES12)
  • Make sure there is disk space available to do the migration: 15Gb+ for Appliance, and 20Gb+ for physical/VM.
  • Make sure Upgrade is "Success" on the Primary before moving to the next step.
  • Start the Upgrade Process
Migrate to ZENworks 2017 Reminders
  • Have the ZENworks 2017 Entitlement License available from customer portal prior to start.
  • Compatibility Check at beginning of Installation wizard may warn if unsupported managed devices are in the ZONE
    (e.g. SLES 11 SP2, XP, Vista, however these can be managed in 2017 zone with their older ZAA.)
  • (Conditional) if migrating an appliance detach the content storage volume (VAStorage) from v11.4.x, add to ZENworks 2017 prior to 2017 VM startup
  • Start the Upgrade Process
Post Upgrade Tasks
  • Verify updated files and database integrity by running ZDC for v2017
  • Verify all services are running
  • Upgrade to ZENworks 2017 Update 1 (and when completed the ZDC for ZENworks 2017 update 1)
  • (Conditional) Add additional external content disks
  • (Conditional) Appliance migration configure NTP settings (NTP is not migrated)
  • (Conditional) Appliance & Patch Management enabled see TID 7018582
  • (Conditional) Appliance & Embedded Audit Database - Port 2639 not open - TID 7022432

Always reference the documentation, knowledgebase and/or call ZENworks Technical Support if experiencing issues.

Documentation References
ZENworks 2017 Documentation
Micro Focus Knowledgebase

Video References
How To Migrate to Micro Focus ZENworks 2017
HowTo Migrate an Appliance with Micro Focus ZENworks 2017
What's New in ZENworks 2017 Update 2 - Mobile Enhancement (Webinar)
Microfocus ZENworks Youtube Channel

Other Versions
ZCM 11 Upgrade Cookbook


This Support Knowledgebase provides a valuable tool for NetIQ/Novell/SUSE customers and parties interested in our products and solutions to acquire information, ideas and learn from one another. Materials are provided for informational, personal or non-commercial use within your organization and are presented "AS IS" WITHOUT WARRANTY OF ANY KIND.

  • Document ID:7018169
  • Creation Date:18-OCT-16
  • Modified Date:15-FEB-18
    • NovellZENworks Configuration Management

Did this document solve your problem? Provide Feedback