3.1 Deploying the Appliance

To deploy ZENworks Appliance, perform the following:

  1. Ensure that the virtual machine to which you want to deploy ZENworks Appliance meet the requirements listed in the ZENworks 23.3 System RequirementsZENworks 2020 Update 3 System Requirements.

  2. Download the ZENworks 2020 Update 2 Appliance file from the Software Licensing and Downloads portal (SLD) or download the multi-part ZENworks Appliance ZIP files and create the open virtualization archive (OVA) file.

    Based on your hypervisor, download the relevant file:

    • VMware ESXi: Download the .ova file.

    • Microsoft Hyper-V: Download the .vhd or .vhdx file.

    • Xen Server on SLES 12: Download the xen.tar.gz file.

    • Citrix Hypervisor (formerly XenServer): Download the xva.tar.gz file.

    NOTE:On a Windows device, use the native support for tar to extract the xva.tar.gz file. To extract the file, on the command prompt, specify the following:

    tar -xjvf <xva.tar.gz file>

  3. Deploy the ZENworks Appliance to the hypervisor by downloading and extracting the file (.ova, .vhd,.vhdx, .xva or .raw).

  4. After deploying ZENworks Appliance, you must add a hard disk with a minimum size of 40 GB for the ZENworks data before you power on the Virtual Machine.

    Depending on your content requirement, you can increase the pre-configured disk space after deploying ZENworks Appliance.

  5. Continue with the next task, Configuring the Appliance Settings.

The following hypervisors are supported for deploying the appliance:

3.1.1 Deploying the Appliance on Microsoft Hyper-V

  1. Log in to the host server either locally or from a remote workstation.

    You can use Windows Remote Desktop to log in to the host server from a remote workstation.

  2. Create a new directory in the location where you want each virtual machine to reside (for example, C:\Users\Public\Documents\Hyper-V\Virtual Hard Disks). In a later step, you will download the software to this directory.

    As a best practice, give this directory the same name as the name that you plan to use for your ZENworks virtual appliance. For example, if you plan to name the ZENworks appliance ZENworks1, the name of this new directory should also be ZENworks1.

  3. Download the ZENworks software (ZENworks<version>_Appliance-x86_64.vhd.zip) to the directory on the host server that you created in Step 2.

    You can access the software from the Micro Focus Customer Center.

  4. Extract the ZENworks<version>_Appliance-x86_64.vhd.zip file to the directory on the host server that you created in Step 2.

  5. Open the Hyper-V Manager.

  6. In Hyper-V Manager, on the left hand side, right-click the machine name. This is the host where you want to create the new virtual machine, then click New > Virtual Machine.

    The New Virtual Machine Wizard is displayed.

  7. Review the Before You Begin page, then click Next.

  8. In the Name field, specify a name for the new virtual machine. For example, ZENworks1.

  9. Click Next.

  10. Select the generation of the virtual machine.

  11. In the Startup memory field, specify the amount of memory (in MB) to allocate to the virtual machine. 16 GB is the recommended minimum for ZENworks.

  12. Click Next.

  13. On the Configure Networking page, select the networking card of your choice, then click Next.

  14. Configure the bootable disk image:

    1. On the Connect Virtual Hard Disk page, select Use an existing virtual hard disk, then browse to the .vhd file that was downloaded.

    2. Click Open to select the file, then click Next.

  15. Click Finish.

  16. If you have not added a second hard disk, then ensure that a second hard disk is added before you power on the virtual machine.

    Perform the following steps to add the second hard disk:

    1. In Hyper-V Manager, right-click the device that you just created, then click Settings.

    2. In the Hardware section, select SCSI Controller, select Hard Drive, then click Add.

    3. Select Virtual hard disk, then click New.

    4. Review the Before You Begin page, then click Next.

    5. Select the required Disk Format and then click Next.

    6. On the Choose Disk Type page, select Fixed size, then click Next.

    7. On the Specify Name and Location page, specify the following information, then click Next:

      Name: Specify a name for the hard disk. For example, ZENDisk2.

      Location: Specify the location where you want the hard drive to be located.

    8. On the Configure Disk page, select Create a new blank virtual hard disk, then specify a size for the hard disk. 80 GB is recommended.

    9. Click Next.

    10. Review the summary information, and then click Finish.

    11. Click Apply > OK.

  17. Right-click the virtual machine, then click Start.

    IMPORTANT:Do not start the appliance until you have created a separate Hyper-V hard disk for the appliance, as described in Step 15.

  18. Right-click the virtual machine, then click Connect.

  19. Continue with Configuring the Appliance Settings.

3.1.2 Deploying the Appliance on Xen

  1. Log in to the host server either locally or from a remote workstation.

    You can use the following command to log in to the host server from a remote workstation on Linux:

    ssh -X root@host_ip_address

    You must use the -X in the command in order to display the GUI installation program. The steps in this section use the GUI installation program to configure the server.

  2. Navigate to the /var/lib/xen/images directory on the host server.

  3. Create a new directory inside the images directory where you can download ZENworks.

    As a best practice, give this directory the same name as the name that you plan to use for your ZENworks virtual appliance. For example, if you plan to name the ZENworks appliance ZENworks1, the name of this new directory should also be ZENworks1.

    You can download the software from the Micro Focus Customer Center.

  4. Change to the directory that you just created.

  5. Download the ZENworks software (ZENworks<version>_Appliance-x86_64.xen.tar.gz) to the current directory on the host server.

  6. Untar the ZENworks<version>_Appliance-x86_64.xen.tar.gz file in the directory where you downloaded it.

    You can use the following command to untar the file:

    tar -Sxvzf ZENworks<version>_Appliance-x86_64.xen.tar.gz

    ZENworks-version directory is created, which contains a .raw file that you will use to run the virtual image. This process can take a few minutes.

  7. From the host server, run the following command to launch the GUI configuration menu:

    vm-install

    The Create a Virtual Machine wizard is displayed.

  8. Click Forward.

  9. Select I have a disk or disk image with an installed operating system, then click Forward.

  10. Select SUSE Linux Enterprise Server <version>, then click Forward.

  11. Rename the virtual machine by clicking Name of Virtual Machine, then specifying a new name in the Name field. Then click Apply.

  12. Configure the amount of memory and number of CPUs that Xen allocates for the ZENworks appliance.

    1. On the Summary page, click Hardware, then specify the following information:

      Available Memory: Displays the amount of available memory that is available on the host server.

      Initial Memory:16 GB is the recommended minimum amount of memory.

      Maximum Memory: Set this to the same value that you set for Initial Memory.

      Available Processors: Displays the number of available processors on the host server.

    2. Click Apply.

  13. Configure the bootable disk image:

    1. On the Summary page, click Disks.

    2. Click Hard disk.

    3. On the Virtual Disk page, specify the following information:

      Source: Click Browse, then browse to the .raw file that you untared in Step 6.

      Protocol/Storage Format: Select file.

      Size (GB): The default size is shown in GB. This cannot be changed.

      Create Sparse Image File: This option is not available.

      Read-Only Access: Do not select this option.

    4. Click OK.

  14. Add a separate Xen hard disk. You must add a hard disk to the virtual machine before you choose this option. If you have not already added a hard disk, click Power Off Virtual Machine, modify the virtual machine settings to add a hard disk, then power on the virtual machine.

    1. On the Disks page, click Hard disk.

    2. On the Virtual Disk page, specify the following information:

      Source: This field should already contain the path to the .raw file that will be created when the virtual machine is created. If desired, you can rename the disk in the source field from disk0 to a name of your choosing.

      Size (GB): Specify the amount of hard disk space that you want to allocate. 80 GB is recommended.

  15. Click OK > Apply.

  16. Click OK to save your changes and to create and power on the virtual machine.

    IMPORTANT:Do not power on the appliance until you have created a separate Xen hard disk for the appliance, as described in Step 14.

  17. Continue with Configuring the Appliance Settings.

3.1.3 Deploying the Appliance on VMware ESXi

The ZENworks Appliance is stored in an open virtualization archive format and you can deploy it to the VMware infrastructure by using the VMware VSphere Client application.

  1. Download the ZENworks software (ZENworks<version>_Appliance-x86_64.ova) to your management workstation.

    You can download the software from the Micro Focus Customer Center.

  2. In the vSphere client, click File > Deploy OVF Template.

    NOTE:If the virtualization software you are using does not support .ovf, you must convert the .ovf file to .vmx using the VMware OVF Tool available on the VMware Website.

  3. Browse to and select the downloaded .ova file (ZENworks2020_Appliance-x86_64.ova).

  4. Click Next.

  5. Click Next again.

  6. In the Name field, rename the ZENworks appliance to a name of your choice, then click Next.

  7. Click Next to accept the default for the disk format.

  8. Click Finish.

  9. Create a separate VMware hard disk for the appliance. This is the location where you will store your ZENworks files.

    1. In the vSphere client, right-click the virtual machine that you just created, and for which you want to create secondary storage, then click Edit Settings.

      The Virtual Machine Properties page is displayed.

    2. On the Hardware tab, click Add.

      The Add Hardware dialog box is displayed.

    3. Select Hard Disk, then click Next.

    4. Select Create a new virtual disk, then click Next.

    5. In the Disk Size field, specify the amount of hard disk space that you want to allocate. 80 GB is recommended.

    6. Select a datastore, then click OK.

    7. Click Next.

    8. Click Finish.

  10. Increase the amount of memory that VMware allocates for the ZENworks appliance.

    1. In the Virtual Machine Properties window, select Memory, then increase the setting to a suitable size for your environment. 16 GB is recommended.

    2. Click OK to exit the Virtual Machine Properties window.

  11. Power on the appliance (virtual machine).

  12. Continue with Configuring the Appliance Settings.

3.1.4 Deploying the Appliance on Citrix Xen

  1. Download the ZENworks software (ZENworks<version>_Appliance-x86_64.xva.tar.gz) to your management workstation.

    You can download the software from the Micro Focus Customer Center.

  2. In the Citrix XENCenter client, right-click the server on which you will install ZENworks Appliance, then click Import.

    NOTE:On a Windows device, use the native support for tar to extract the xva.tar.gz file. To extract the file, on the command prompt, specify the following:

    tar -xjvf <xva.tar.gz file>

  3. Import Source: Browse to ZENworks<version>_Appliance-x86_64.xva.tar.gz extracted folder and select the ZENworks<version>_Appliance-x86_64-<build-no>.xva file.

  4. Location: Click Next to continue with the default settings.

  5. Storage: Select one or more storage repositories (SRs) where the disk images for the imported VMs will be placed, then click Next.

  6. Network: Select network to connect VM. Select the Virtual network interface and then click Next

  7. Review all the import settings and then click Finish to begin the import process and close the wizard.

    The import progress is displayed in the status bar at the bottom of the XenCenter window and also on the Logs tab.

  8. Create a separate hard disk for the appliance. This is the location where you will store your ZENworks files.

    1. In the Citrix XenCenter client, select the virtual machine that you just created, and click on the Storage tab.

      The Virtual Disks page is displayed.

    2. Click Add.

      The Add Virtual Disk dialog box is displayed.

    3. In the Name field, specify the name of the virtual disk.

    4. In the Size field, specify the amount of hard disk space that you want to allocate. 80 GB is recommended.

    5. Click Add.

  9. Power on the appliance (virtual machine).

  10. Continue with Configuring the Appliance Settings.