ZENworks Configuration Management - ZCM 11 Upgrade Cookbook

  • 7017201
  • 28-Jan-2016
  • 10-Mar-2021

Environment

Novell ZENworks Configuration Management 11 System Update
Novell ZENworks Configuration Management 11.2 System Update
Novell ZENworks Configuration Management 11.3 System Update
Novell ZENworks Configuration Management 11.4 System Update

Situation

This document is assembled, focused to assist in navigating to ZCM v11.4.3.
This example starts at ZCM ZONE version v11.2.x to v11.3.x, finishing at v11.4.3.
Includes
common upgrade/update best practices with html links, documents and videos.

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

Resolution

Downloads
Locate downloads through the Novell download site or patches through Patch Finder
Do not extract .iso’s (
KB 7015386) – the .iso must be “mounted”
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.
v11.3 - ZCC Administrators moves from left pane to ZCC > Configuration > Administrator (Tab)

ZCM Primary Servers
Primary Server Requirements (v11.4.x)
Zones must be upgraded to ZCM 11 SP3 before upgrading to ZCM 11 SP4
Primary Servers – must be at 64-bit OS (introduced in ZCM 11 SP3)
Linux Primary servers –OES is no longer supported with ZCM 11 SP3
Do not upgrade to SLES 11 SP4 until your ZENworks system is at version ZCM v11.4.1.
Be advised that the base Service packs (11 SP2, 11 SP3, 11 SP4) have patches fixing issues along the way.  No need to apply sub revs if quickly moving to the v11.4.3. 
Always reference the documentation and knowledge base or call ZENworks Technical Support if experiencing issues.

Make sure there is
disk space available to do the migration: 20Gb+ for Appliance, and 20Gb+ for physical/VM.
Migration from ZENworks ZCM 11 SP3 Linux Primary Server to ZCM 11 SP4 Appliance Primary Server, use the LinuxtoApplianceMigration.zip migration utility off the download site.
Migration from ZENworks ZCM 11 SP4 Linux or Windows Primary Server to ZCM 11 SP4 Appliance Primary Server

  • Add a ZCM 11 SP4 Appliance Primary Server in the Zone.
  • Bring Appliance Primary Server to same level as the Zone.
    (Example:Zone=ZCM 11.4.2, bring Aappliance up to ZCM 11.4.2)
  • Allow time for replication to process
  • Use the Disaster Recovery process documented to Replace the First Primary Server with the Second Primary Server.
Moving from ZCM 11.4.x to ZCM 2017 reference the Documentation or ZENworks Configuration Management 2017 Cookbook - TID 7018169

ZCM Appliances
Migrating from 11.3.x to 11.4.x be sure to create a “vastorage” disk used for migration and future use.
During Appliance migration devices should be hosted on the same network.
Backup Appliance, any external content repository (attached disks) and database files.
Be sure to follow the
Appliance Migration documentation.
New in ZENworks 11 SP4 Appliance, is the ZENworks System Management Console

ZCM Database Requirements
Database Requirements (v11.4.x)
If external database be sure to check requirements necessary for db space, db version and OS versioning.
ZCM Audit Database introduced in ZCM v11 SP3.

Caution: Oracle Partitioning may be used for ZCM during the upgrade process if this feature is on (even if Oracle Partioning is not purchased).
External Database Prerequisites and User Schema

ZENworks Diagnostic Center
Locate use of this utility in the ZENworks Command Line Reference Guide.
Running ZDC is a best practice.
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. 
ZDCs are published for every version, Service Pack and subrev
(Novell download patches).
ZDC for v11.3.0ZDC for v11.3.1ZDC for v11.3.2
ZDC for v11.4.0ZDC for v11.4.1ZDC for v11.4.2ZDC for v11.4.3

If there are inconsistencies or missing files, check the knowledge base and/or with support to clear up or confirm moving forward.
A couple TIDs to assist with ZDC inconsistencies and mismatches;
ZDC Report showing inconsistent item in report - TID 7006692
ZDC mismatches that can safely be ignored - TID 7007203
ZDC Showing missing content - TID 7014447
ZDC Showing missing or mismatched Procedures/Views in 11.2.4 - TID 7014762

ZENworks Adaptive Agents (ZAA)
Managed device requirements (v11.4.x)
If the plan is to upgrade through to the latest version, ZAA Managed devices will not need to be upgraded along the way.
Baselined ZAA v10.3.4 can be upgraded to any higher version. 
Example: Managed devices with ZAA v11.2.x can be directly upgraded to ZAA v11.4.3, after your system primaries and satellites are at ZCM v11.4.3.
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 enhanced auditing (introduced in ZCM v11 SP3

Start of Upgrades

Upgrade process from ZCM v11.2.1 to ZCM v11.3.0
v11.3.0 Precheck - Example Zone currently at  ZCM v11.2.1
ZENworks Diagnostic Center - Check for System files and database inconsistencies by running - ZDC for v11.2.1
(If the zone is ZCM v11.2.3, download from Patch finder searching for v11.2.3 ZDC)
Verify System Requirements
Backup ZCM System Primary server, file system, certificates and Database
Run zman zenserver-backup (zsb) command to save zone critical data. 

Upgrade From ZCM v11.2.x to ZCM v11.3.0a - (TID 7014213) Primary Servers then Satellites (Agents not necessary unless they need added features of ZAA v11.3.0a)
Perform Upgrade Process
Note: New in 11 SP3 is the Audit Database, which is another database configured for auditing.
Note: ZCM 11 SP3 does not support 32-bit Primary Server OS - see Server Migration Overview.
Novell ZENworks Configuration Management 11 SP3 Files
If using Appliance: Novell ZCM 11 SP3 Virtual Appliance Upgrade
Post Upgrade Tasks
Verify Updated files and database integrity by running ZDC on v11.3.0a
(If the zone is ZCM v11.3.4, download from Patch finder searching for v11.3.4 ZDC)
Allow the system settle for a couple days.
Make sure Upgrade is "Success" on the Primary before moving to the next step.

Upgrade From ZCM v11.3.x to ZCM 11.4.0 - (TID 7016614) Primary Servers then Satellites (Agents not necessary unless they need added features of ZAA v11.4.0)
Note: See documentation if Migrating a ZENworks 11 SP3 Primary server from Linux to ZENworks 11 SP4 Appliance
Verify System Requirements
Backup ZCM System Primary server, file system, certificates and database
Run zman zenserver-backup (zsb) command to save zone critical data.

Check ZDC against current running ZCM version.
Perform Upgrade Process
Novell ZENworks Configuration Management 11 SP4 Files
If using Appliance: Novell ZCM 11 SP4 Virtual Appliance Upgrade


Post Upgrade Tasks
Verify Updated files and database integrity by running ZDC on v11.4.0
Prerequisites for Updating Satellite Servers or Managed Devices  (to ZCM 11 SP4)
Known Issues ZENworks v11.4.0

Make sure Upgrade is "Success" on the Primary before moving to the next step.

Install Post ZCM v11.4.0 Update Prereq
(Post ZENworks 11 SP4 Update Prereq - TID 7016896 must be applied first)
Verify System Requirements
Backup ZCM System Primary server, Certificates and Database
Check ZDC against current running ZCM version.
Perform Post v11.4.0 Upgrade Process
NOTE: If the server is already upgraded to ZENworks 11.4.1 or higher, the "Post 11 SP4 Update Prereq" has already been applied to those primary servers. Do NOT apply the Post 11 SP4 again.

Upgrade From Post ZCM 11 SP4 Update Prereq to v11.4.3 (TID 7017820)
Backup ZCM System Primary server, file system, certificates and Database
Run zman zenserver-backup (zsb) command to save zone critical data.

Check ZDC against current running ZCM version.
Perform v11.4.3 upgrade process
After the Primaries and Satellites are at ZCM v11.4.3, all ZCM agents (v10.3.4 and above) can be upgraded directly to ZCM v11.4.3 Agent.
Note: ZCM v11.4.x Feature Enhancements: Telemetry, MDT Deployment Bundles, ZENworks Source, Change eDir Password via ZENworks icon, etc.
Make sure Upgrade is "Success" on the Primary before moving to the next step.

Post Upgrade Tasks

Verify Updated files and database integrity by running ZDC on v11.4.3
Known issues for v11.4.3 - (see the readme_zenworks1143.pdf)

Adding additional Primary Server?
Introducing another ZCM 11 SP4 Primary Server Appliance

Documentation References;
Whats New in ZENworks 11 SP4 
ZENworks Configuration Management - Best Practices Guides

ZENworks Appliance 11 SP4 Deployment and Administration Reference Guide
ZENworks 11 SP4 Disaster Recovery Reference Guide
Migrating a ZENworks 11 SP3 Server from Linux to ZENworks 11 SP4 Appliance

Video References
How to Install Micro Focus ZENworks v11.4.3
What's New in ZENworks SP4?  Simplified virtual appliance deployment
ZENworks Primary Server Unsupported Architecture Migration
ZENworks Appliance Server Migration – ZCM 11 SP3 to ZCM 11 SP4
ZCM 11 SP4 - How to Upgrade to ZCM 11 SP4
ZENworks Upgrade to ZCM 11.4.1

Other Versions
ZENworks 2017 Upgrade Cookbook

ZENworks 2020 Upgrade Cookbook TID 7024089