Issue

There are several different ways for a ZENworks Configuration Management zone to be updated with newer files from Micro Focus.

This TID will detail what needs to be done to apply the different types of updates and to ensure that your ENGL Deployment solution continues to work.

This TID will cover:

Requirements

  • ENGL Imaging Toolkit

  • ZENworks Configuration Management Zone


Solution - System Updates

Apply ZENworks System Update to ZENworks zone then check / reapply ENGL files.

NOTE:Review the ZENworks system update documentation prior to applying any system updates to your system.
See the appropriate ZENworks documentation for more details:



Procedures

DoneTask
 
1.Configure Deployment stages
 
2.Download / import System Update files
 
3.Apply updates to primary servers
 
4.Configure ENGL TFTP files
 
5.Apply correct Tuxera driver
 
6.Configure ENGL Ztoolkit files
 
7.Recreate Agent package and update NovComp add-on image
 
8.Test


1. Configure Deployment stages.

It is recommended that deployment stages are used to deploy the ZCM system updates. This gives more control over which machines get the update and when.

See ZENworks 11.4 Configuration Management documentation or ZENworks 2017 Configuration Management documentation for more details.


2. Download / import System Update files.

There are two ways to apply the system update.

Once the updates have been downloaded they can then be applied to the deployment stages.


3. Apply updates to primary servers.

The primary servers must be updated first.

NOTE:To ensure that information is not lost please make a backup copy of the server's TFTP folder prior to running the system update.


4. Configure ENGL TFTP files.


Once the primary servers have been updated, the TFTP folder structure will need to be modified to ensure that the Imaging Toolkit hook has been integrated.

  1. Boot to PXE, confirm that your PC can connect (you should end up at the bash ("#") prompt, with the basic Micro Focus splashscreen before).
  2. Take a copy of the server's tftp directory, store it locally - do not copy this to the integration folder
  3. Run the Integration Wizard:
    a) Select the version of ZCM that you are using, and click next (note that this is the main version of ZCM, it does not show Imaging Updates here)
    b) select Update Imaging Files, then click next
    c) select "Download initrd containing Zim integration hook", and select the ZENworks Imaging version - be very careful to match this with the version of ZENworks, including any Imaging Update
    d) select "Update imaging files": navigate to the copy of the tftp folder you made earlier
    e) complete the wizard
  4. Copy the tftp folder from the integration folder back to the server - if you're using WinSCP, choose "copy if newer", to save time
  5. PXE boot a workstation against the primary server to ensure that the updates have been applied successfully.

5. Apply correct Tuxera driver

  1. Go to ZCC > Configuration > Device Management > Preboot Services
  2. Go down to Tuxera High Performance NTFS Driver Integration Settings
  3. Click on the link in "go here if..." and save the tntfs.zip (make sure it doesn't get renamed to tntfs(1).zip or anything like that)
  4. Click on the magnifying glass icon, browse to the location where you saved the tntfs.zip, select it and click OK.
  5. Most Important At this stage scroll right to the bottom of the page and select "OK", or "Apply" - it won't work without this.
  6. Go back to the same place as 4, and check "status" - this should be "Not available" immediately afterwards, and change shortly to "available"

You should see entries such as[DEBUG] [06/08/2016 11:45:44.928] [4107] [ZENLoader] [168] [] [Loader.QueueRunner] [] [Passing the action ID: 587639, Type:replicate.ntfs.driver to Handler: com.novell.zenworks.preboot.loader.modules.queue.handlers.ReplicateNTFSDriverHandler] [] [] [] [ZENServer]

in loader-messages.log


If your server is running Linux, and the status does not change to "Available" after some minutes (depends on the speed of the server and how busy it is, but if it's not happened for 30 minutes you can be pretty sure it's not going to happen) and you don't see the messages in the log, then it's possible that at some point ZENworks has lost the rights it needs (for example if you deleted the tftp directory then copied a new version, it won't have the correct rights). Start a terminal window, either as the root user, or use SU to give yourself rights, then run

permissions.sh


This is a Micro Focus-provided script which gets run during ZENworks upgrade, and will restore the correct rights. It can be run at any time, and as often as required.


6. Configure ENGL Ztoolkit files

The Ztoolkit image contents may need to be updated depending on the ZENworks version.

Information on supported ZENworks versions can be found here.

For information on steps to upgrade your build process (ztoolkit) image review Upgrading From a Previous Version in the ENGL online documentation.

7. Recreate Agent package / novcomp add-on image. 

The ZENworks Adaptive agent needs to be recreated to ensure that future deployments install the latest version without the System Update process applying to each workstation.

  • For information on steps to (re)create the ZENworks agent package and import it into the file library review the ZENworks Agent page in the ENGL online documentation.
  • Update project files:

    1. Open Build Console and run Help > Check for updates to obtain the latest supported version information
    2. Open the project file in Build Console
    3. Change the ZENworks version:

      • Select Expert View > Desktop Management Solution > Version and choose the correct version from the drop down list in the Property View
    4. Select Expert view > ZENworks > Configuration
    5. In the Property view select ZENworks Configuration Section then select the updated version from the drop down list
    6. Select the appropriate ZENworks Agent Version from the drop down list
    7. Save the changes to the project file
    8. From the Tools menu, select Validate Project Settings, if any errors are reported resolve those errors and save the project
  • Run the Deployment Wizard to recreate image files:

    For information on steps to (re)create the build process images (ztoolkit and novcomp) review the build process page in the ENGL online documentation.

8. Test updated files.

All files should now be updated. Run a test build to confirm everything is now working and that the updated Agent is being installed during the build process.

Solution - Imaging Updates.

Micro Focus release occasional updates for ZENworks Imaging Drivers.
These updates need to be integrated into the tftp folder structure on the imaging server.

Requirements

  • ZENworks imaging server (with ENGL Zim integrated).
  • Latest ZENworks imaging update files from Micro Focus.

Solution

The following steps will detail how to apply these imaging update files to your imaging server.

Procedures


DoneTask
 
1.Download and test imaging update files
 
2.Configure ENGL TFTP files
 
3.Apply correct Tuxera driver


  1. Download and test imaging update files.

    • Download the latest imaging update zip from Micro Focus.
    • Follow the instruction given in the readme associated with the Patch.
    • PXE boot a workstation to confirm that this imaging update is working. If there is a workstation that was having issues PXE booting prior to applying the imaging updates ensure that this workstation is tested.

      NOTE:Applying the imaging update will let the machine boot to the bash prompt at this point.
      Zim integration will be added by the next step.

  2. Configure ENGL TFTP files.
    Once the primary servers have been updated, the TFTP folder structure will need to be modified to ensure that the Imaging Toolkit hook has been integrated.

    1. Boot to PXE, confirm that your PC can connect (you should end up at the bash ("#") prompt, with the basic Micro Focus/Micro Focus splashscreen before).
    2. Take a copy of the server's tftp directory, store it locally - do not copy this to the integration folder
    3. Run the Integration Wizard:
      a) Select the version of ZCM that you are using, and click next (note that this is the main version of ZCM, it does not show Imaging Updates here)
      b) select Update Imaging Files, then click next
      c) select "Download initrd containing Zim integration hook", and select the ZENworks Imaging version - be very careful to match this with the version of ZENworks, including any Imaging Update
      d) select "Update imaging files": navigate to the copy of the tftp folder you made earlier
      e) complete the wizard
    4. Copy the tftp folder from the integration folder back to the server - if you're using WinSCP, choose "copy if newer", to save time
    5. PXE boot a workstation against the primary server to ensure that the updates have been applied successfully.

  3. Apply correct Tuxera driver

    1. Go to ZCC > Configuration > Device Management > Preboot Services
    2. Go down to Tuxera High Performance NTFS Driver Integration Settings
    3. Click on the link in "go here if..." and save the tntfs.zip (make sure it doesn't get renamed to tntfs(1).zip or anything like that)
    4. Click on the magnifying glass icon, browse to the location where you saved the tntfs.zip, select it and click OK.
    5. Most Important At this stage scroll right to the bottom of the page and select "OK", or "Apply" - it won't work without this.
    6. Go back to the same place as 4, and check "status" - this should be "Not available" immediately afterwards, and change shortly to "available"

      You should see entries such as
      [DEBUG] [06/08/2016 11:45:44.928] [4107] [ZENLoader] [168] [] [Loader.QueueRunner] [] [Passing the action ID: 587639, Type:replicate.ntfs.driver to Handler: com.novell.zenworks.preboot.loader.modules.queue.handlers.ReplicateNTFSDriverHandler] [] [] [] [ZENServer]
      in loader-messages.log

If your server is running Linux, and the status does not change to "Available" after some minutes (depends on the speed of the server and how busy it is, but if it's not happened for 30 minutes you can be pretty sure it's not going to happen) and you don't see the messages in the log, then it's possible that at some point ZENworks has lost the rights it needs (for example if you deleted the tftp directory then copied a new version, it won't have the correct rights). Start a terminal window, either as the root user, or use SU to give yourself rights, then run

     permissions.sh


This is a Micro Focus-provided script which gets run during ZENworks upgrade, and will restore the correct rights. It can be run at any time, and as often as required.