ENGL Support

Issue

ZCM registration may fail when deploying a clone image

This is caused by a bug in the ZCM agent. The agent settings are not correctly cleared when the agent is un-registered during the Zclonewiz process.

Solution

Add a delay to the phase2-before.vbs script. This results in the ZCM registration process being delayed slightly. The delay gives the ZCM Agent enough time to clean up the appropriate cached information prior to workstation registration.

Procedures

1. Modify the project that will be cloned

   • Launch Build Console.
     
     
   • Open project file.
     
     
   • Select Expert view -> Customisation -> Custom Files.
     
     
   • Update the phase2-before.vbs with the following lines:
     
     

      
     if (Utils.GetSystemEnvironmentVariable("ENGLCLONE") = "1") then
        Utils.delay 400
     end if
     
     

   • Save changes to project
     

2. Deploy new build process image

   
   
   • Select Tools ->Deployment Wizard then click Next.
     
   • Select Build process Creation from the list of deployment tasks then click Next.
     
   • Select Build process (ztoolkit.zmg) from the Image Selection options. Deselect the other options then click Next.
     
   • click Next.
     
   • click Yes if prompted to continue.
     
   • click OK to dialog reporting The deployment has been created successfully..
     
   • Open the images folder and copy/update the <project directory>/ztoolkit.zmg file to the /images/<project directory> folder on the server.
     

3. Test updated files

   
   
   • PXE Boot a machine to the ZENworks imaging Environment.
     
   • Select and restore the project.
     
   • When the deployment process has completed, login as an administrator and run C:\Ztoolkit\Zclonewiz.exe to start the clone process.
     
   • Once Zclonewiz has completed, reboot the machine into ZENworks imaging and start a multicast master session.
     
   • Check that machines receiving the multicast image register with ZCM as expected.
     
     

     NOTE: Refer to the Imaging Toolkit documentation for more details on the Imaging Toolkit cloning process

     
     

4. Modify the Clone image

   
   
   • Launch ZENworks Image Explorer.
     
   • Extract the C:\Ztoolkit\phase2-before.vbs file from the image.
     
   • Update the phase2-before.vbs script with the line:
     
     

      
     if (Utils.GetSystemEnvironmentVariable("ENGLCLONE") = "1") then
        Utils.delay 400
     end if
     
     

     
     
   • Add the modified phase2-before.vbs file to the C:\Ztoolkit folder in the image replacing the existing file.
     
   • Save the image file.

5. Test updated files

   
   
   • PXE Boot a machine to the ZENworks imaging Environment.
     
   • Select and restore the clone image.
     
   • The ENGL deployment process will run.
     
   • Check that the machine has registered correctly with the ZCM zone.