A.0 Troubleshooting ZENworks Appliance

The following sections provides solutions to the problems you might encounter while deploying ZENworks Virtual Appliance 11 (ZENworks Appliance):

An error occurs while downloading the ZENworks Appliance image

Source: ZENworks 11; ZENworks Appliance.
Possible Cause: The image of ZENworks Appliance has been downloaded by using the FAT file system, which does not support files greater than 4 GB.
Action: Use file systems that support files greater than 4 GB, such as NTFS on Windows and ext3 or ReiserFS on Linux.

Unable to configure ZENworks Reporting Server after upgrading ZENworks 10 Configuration Management SP3 Appliance to ZENworks 11 SP2 Appliance

Source: ZENworks 11; ZENworks Reporting Server.
Action: Reboot the device, which is upgraded to ZENworks 11 .

ZENworks Reporting Server Wizard fails to launch on a ZENworks Appliance

Source: ZENworks 11; ZENworks Reporting Server.
Explanation: ZENworks Reporting Server Wizard is not automatically launched on a ZENworks Appliance after you configure ZENworks 11 SP2.
Action: Do the following:
  1. Reboot the device after installing ZENworks 11 SP2.

  2. Login to ZENworks Appliance.

  3. Open a terminal and run the following command:

    /usr/share/ZRSConfiguration/setup.sh --zrs-config-only

Unable to configure ZENworks Reporting Server after upgrading ZENworks 10 Configuration Management SP3 Appliance to ZENworks 11 SP2 Appliance

Source: ZENworks 11; ZENworks Reporting Server.
Explanation: You cannot configure ZENworks Reporting Server after upgrading ZENworks 10 Configuration Management SP3 Appliance to ZENworks 11 SP2 Appliance.

VMware tools package installed on ZENworks 11 SP2 Appliance is corrupted.

Source: ZENworks 11; ZENworks Appliance.
Action: If the VMware tools package that is installed on the ZENworks 11 SP2 Appliance is corrupted, perform the following actions:
  1. Uninstall the VMware tools package by running the following commands appropriately:

    • On ESX 4.5 Update 1, run the following command:

      rpm -e vmware-open-am-tools vmware-open-vm-tools-common vmware-open-vm-tools-kmod vmware-open-vm-tools-nox vmware-open-vm-tools-xorg-drv-display vmware-open-vm-tools-xorg-drv-mouse vmware-open-vm-tools-xorg-utilities vmware-tools vmware-tools-common vmware-tools-nox

    • On ESX 5, run the following command:

      rpm -e vmware-tools-core vmware-tools-esx vmware-tools-esx-kmods-default vmware-tools-esx-nox vmware-tools-foundation vmware-tools-guestlib vmware-tools-guestsdk vmware-tools-help vmware-tools-hgfs vmware-tools-libraries-nox vmware-tools-libraries-x vmware-tools-plugins-autoUpgrade vmware-tools-plugins-deployPkg vmware-tools-plugins-desktopEvents vmware-tools-plugins-dndcp vmware-tools-plugins-guestInfo vmware-tools-plugins-hgfsServer vmware-tools-plugins-powerOps vmware-tools-plugins-resolutionSet vmware-tools-plugins-timeSync vmware-tools-plugins-unity vmware-tools-plugins-vix vmware-tools-plugins-vmbackup vmware-tools-pvscsi-common vmware-tools-pvscsi-kmp-default vmware-tools-services vmware-tools-user vmware-tools-vmblock-common vmware-tools-vmblock-kmp-default vmware-tools-vmci-common vmware-tools-vmci-kmp-default vmware-tools-vmhgfs-common vmware-tools-vmhgfs-kmp-default vmware-tools-vmmemctl-common vmware-tools-vmmemctl-kmp-default vmware-tools-vmsync-common vmware-tools-vmsync-kmp-default vmware-tools-vmxnet3-common vmware-tools-vmxnet3-kmp-default vmware-tools-vmxnet-common vmware-tools-vmxnet-kmp-default vmware-tools-vsock-common vmware-tools-vsock-kmp-default vmware-tools-xorg-drv-display vmware-tools-xorg-drv-mouse

  2. Re-install the VMware tools package by running the /var/adm/zenworks/installVMTools.sh command.

Deployment fails with the error message ‘Unable to load zlib1.dll’

Source: ZENworks 11; ZENworks Appliance.
Explanation: When you deploy the Appliance server on the ESX 5.0 client, the deployment fails with the Unable to load zlib1.dll error.
Action: To deploy the Appliance successfully, copy the zlib1.dll file from the previous installation location to the <VMware Client install directory>\Infrastructure\Virtual Infrastructure Client\5.0 and then start ZENworks Appliance deployment.

Appliance migration from 10.3.x to 11.x fails due to temporary network outage

Source: ZENworks 11; ZENworks Appliance.
Explanation: If you retry Appliance migration after it fails because of a temporary network outage, the following message is displayed:
device is already upgraded. 
Action: To complete the migration process, perform the following steps on the 11.x machine:
  1. Run the following command:

    /var/zenworks/migrate.sh <APP_IP> <ZONE_NAME>

    Replace APP_IP with the IP address of 10.3.x server and ZONE_NAME with the zone name.

  2. Run the command:

    /var/adm/zenworks/copyNetwork.sh <APP_IP>

    Replace APP_IP with the IP address of 10.3.x server.

  3. Create a new file called servicehandler and add the following text to it:

    #!/bin/bash
    
    if [ $# != 4 ] ; then
      echo "Usage: servicehandler <servicename> <Operation (1 for install, 2 for uninstall)> <Start ID> <Kill ID>"
      exit 1
    fi
    
    
    if [ `id -u` -ne 0 ] ; then
      echo "Run this file as root."
      exit 1
    fi
    
    INSTALL=1
    UNINSTALL=2
    
    SERVICE_NAME=$1
    OPERATION=$2
    START_ID=$3
    KILL_ID=$4
    
    if [ $OPERATION -eq $INSTALL ] ; then
      #Install service
    
      if [ -x /usr/lib/lsb/install_initd ]; then
            /usr/lib/lsb/install_initd /etc/init.d/$SERVICE_NAME
        elif [ -x /sbin/chkconfig ]; then
            /sbin/chkconfig --add $SERVICE_NAME
        else
            for i in 2 3 4 5; do
                ln -s /etc/init.d/$SERVICE_NAME /etc/rc.d/rc$i.d/S$START_ID$SERVICE_NAME
            done
            for i in 1 6; do
                ln -s /etc/init.d/$SERVICE_NAME /etc/rc.d/rc$i.d/K$KILL_ID$SERVICE_NAME
            done
        fi
    elif [ $OPERATION -eq $UNINSTALL ] ; then
      #Uninstall service
    
      if [ -x /usr/lib/lsb/remove_initd ]; then
            /usr/lib/lsb/remove_initd /etc/init.d/$SERVICE_NAME
        elif [ -x /sbin/chkconfig ]; then
            /sbin/chkconfig --del $SERVICE_NAME
        else
            for i in 2 3 4 5; do
                rm /etc/rc.d/rc$i.d/S$START_ID$SERVICE_NAME
            done
            for i in 1 6; do
                rm /etc/rc.d/rc$i.d/K$KILL_ID$SERVICE_NAME
            done
        fi
    else
      echo "Invalid operation specified";
    fi
    
  4. To give executable permissions to the servicehandler file, run the chmod +x servicehandler command.

  5. Place the service handler file in your root directory and run the following commands:

    ./servicehandler novell-zenmntr 1 90 10
    ./servicehandler novell-zenworks-xplatzmd 1 90 10
    ./servicehandler novell-xplat-RunLevelChange3 1 90 10
    ./servicehandler novell-zenloader 1 90 10
    ./servicehandler novell-zenserver 1 90 10
    ./servicehandler novell-pbserv 1 90 10
    ./servicehandler novell-proxydhcp 1 90 10
    ./servicehandler novell-tftp 1 90 10
    ./servicehandler novell-zmgprebootpolicy 1 90 10
    
  6. If you are using an embedded Sybase database, run the following commands:

    ./servicehandler novell sybase-asa 1 90 10
    ./servicehandler novell casa_atsd 1 90 10
    
  7. To complete the process, run the /opt/novell/zenworks/bin/permissions.sh command.