4.2 Migrating from a Physical 11 SP3 ZENworks Primary Server to 11 SP4 ZENworks Appliance

ZENworks 11 SP4 Appliance stores ZENworks data in an external virtual disk. ZENworks 11 SP3 data needs to be copied onto a new virtual disk and later the same disk should be attached to the ZENworks 11 SP4 Appliance.

To copy ZENworks 11 SP3 data to the new virtual disk, temporarily mount the disk onto a Linux device that is in the same hypervisor as the ZENworks 11 SP4 Appliance. You need to do this because the appliance cannot be powered on before copying the data.

IMPORTANT:No changes will be made to the Linux device on which the disk is mounted.

Prerequisites

Prior to performing the migration from a ZENworks Server to ZENworks Appliance, you need to ensure that the following prerequisites are met:

  • The hypervisor where the ZENworks 11 SP4 Appliance will be deployed should have a Linux device that is available to temporarily mount the hard disk drive.

  • Passwordless SSH should be enabled from the ZENworks 11 SP3 Server to the temporary Linux device. For more information, refer the Linux website.

Procedure

  1. Deploy the ZENworks 11 SP4 Appliance. Do not power on.

  2. Add a new virtual hard disk to the ZENworks 11 SP4 Appliance.

  3. Calculate the size of the new hard disk based on the following directories:

    • database (/var/opt/novell/zenworks/database) if the appliance hosts the embedded Sybase database.

    • content-repo (/var/opt/novell/zenworks/content-repo)

    • downloads (/opt/novell/zenworks/install/downloads)

    • collection (/var/opt/novell/zenworks/collection)

    Additionally, allocate another 20 GB of extra space.

    If any of the directories are a part of the mounted-disk partition, then its size can be ignored while calculating the new disk size.

  4. Detach the newly added virtual disk from the ZENworks 11 SP4 Appliance and attach it to a Linux device in the hypervisor.

  5. Check the health of the Primary Server by using ZENworks Diagnostic Center:

    1. Download ZENworks 11 SP3 Diagnostic Center to the appliance. You can download the ZENworksDiagnosticCenter.zip file from the ZENworks 11 SP3 download site.

    2. Extract the ZENworksDiagnosticCenter.zip file to the appliance.

    3. Run ZENworks Diagnostic Center.

      For information on how to run ZENworks Diagnostic Center, see Running ZDC in the ZENworks 11 SP4 Command Line Utilities Reference.

  6. Back up the ZENworks databases and stop the ZENworks services on all the other Primary Servers in the zone to ensure that files that need to be copied are not in use by any of the services. You do not have to shut down the ZENworks services on the appliance that you are migrating as the LinuxToApplianceMigration script does that automatically. For information on how to shut down the services, see Stopping the ZENworks Services in the ZENworks 11 SP4 Primary Server and Satellite Reference.

  7. Enable Passwordless SSH from the ZENworks 11 SP3 Server to the Linux device to which the virtual hard disk is attached.

  8. Copy and unzip the contents of the LinuxToApplianceMigration.zip file (using the unzip LinuxToApplianceMigration.zip command) onto ZENworks 11 SP3 Server. The contents of the LinuxToApplianceMigration.zip file will be extracted to the LinuxToApplianceMigration folder. In a terminal window, change to the LinuxToApplianceMigration directory.

  9. Edit the NvlVAinit file in the LinuxToApplianceMigration folder with the following variables:

    • CONFIG_VAINIT_HOSTNAME=""(FQDN)

    • CONFIG_VAINIT_IPADDRESS="dhcp" or "ipaddress"

      IMPORTANT:If you have used the DHCP option to obtain the IP address, you need to type dhcp, and if you have used a static IP address, you need to specify the IP address in the 0.0.0.0 format

    • CONFIG_VAINIT_TIMEZONE=" " (ex: Asia/Kolkata)

    • CONFIG_VAINIT_GATEWAY="0.0.0.0"

    • CONFIG_VAINIT_NETWORK_MASK="0.0.0.0

    • CONFIG_VAINIT_SEARCH_DOMAINS="domain"

    • CONFIG_VAINIT_DNS_SERVER="0.0.0.0"

    • CONFIG_VAINIT_DNS_SERVER_2="0.0.0.0"

    • CONFIG_VAINIT_DNS_SERVER_3="0.0.0.0

    The ZENworks 11 SP3 device details should be provided for the above fields to ensure that the network identity is also migrated.

  10. Run the LinuxToApplianceMigration.sh command with the following command line arguments:

    • ip: IP address of the Linux device on which the virtual hard disk is mounted.

    • username: User name of the Linux device on which the virtual hard disk is mounted. The user should have administrator privileges.

    • device: The name of the virtual disk that was attached to the temporary Linux device. Example: /dev/sdb, /dev/sdc etc.

      IMPORTANT:In a terminal window, change to the LinuxToApplianceMigration directory and run LinuxToApplianceMigration.sh. Check the LinuxToApplianceMigration.log for any errors.

  11. Shutdown the ZENworks 11 SP3 Server.

  12. Remove the added virtual hard drive from the temporary Linux device, attach it to the ZENworks 11 SP4 Appliance server, and then power on the appliance.

  13. Continue by following step 4 onwards from the Deploying and Configuring the ZENworks 11 SP4 Appliance.

After you complete these steps, the ZENworks Server is migrated from Linux to ZENworks 11 SP4 Appliance and the appliance is up and running.

If any failure occurs during the data copy process, you can power on the ZENworks 11 SP3 Server machine. The ZENworks 11 SP3 Server will be up and running.