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.

Appliance migration from 11.2.x to 11.3 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.3 machine:
  1. Run the following command:

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

    Replace APP_IP with the IP address of 11.2.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 11.2.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.

Unable to uninstall ZENworks 11 SP3 from ZENworks Virtual Appliance

Source: ZENworks 11; ZENworks Appliance.
Explanation: Uninstallation of ZENworks 11 SP3 from ZENworks Virtual Appliance is not supported. However, you can remove the ZENworks Virtual Appliance from a zone by removing the appliance machine object from the ZENworks Control Center.

NOTE:Removing an Appliance through ZENworks Control Center is possible only if the Appliance is an additional primary server and not a first primary server in the zone.

Action: To remove the ZENworks Virtual Appliance from a zone, do the following:
  1. Log in to ZENworks Control Center.

  2. Click Configuration > Server Hierarchy.

  3. Select an appliance machine object, which is generally the host name of the device.

  4. Click Action > Delete ZENworks Server.

  5. Click OK.

Appliance migration fails when there are multiple network adapters (NICs)

Source: ZENworks 11; ZENworks Appliance.
Explanation: During appliance migration, there is a one-to-one copy of the network adapters. For example, network adapter eth 0 on a remote machine is mapped to network adapter eth 0 on the local machine. If there is a mis-match in the network adapter number, the appliance migration fails.
Action: During appliance migration, ensure that the network adapter numbers on both machines are the same.

An error message is displayed when you run Upgrade media on a 11.2.x Appliance server

Source: ZENworks 11; ZENworks Appliance
Explanation: When you run Upgrade media on a 11.2.x Appliance server, you will get the Unsupported Operating System message.
Possible Cause: Upgrade media is not supported for upgrading ZENworks Appliance 11.2.x to ZENworks 11 SP3.
Action: Deploy the ZENworks 11 SP3 Appliance and then migrate the ZENworks Appliance 11.2.x to ZENworks 11 SP3.

An error is displayed when you reboot the server after migrating the Appliance successfully

Source: ZENworks 11; ZENworks Appliance
Explanation: After a successful Appliance migration, the following error is displayed when you reboot the server:

Could not create ICE listening socket:

Cannot establish any listening sockets.

Action: Click Logout and provide user credentials to proceed with normal operations.