3.3 Uninstalling ZENworks from a Linux Satellite Server

To uninstall ZENworks from a managed device functioning as a Satellite Server, you need to demote the Satellite Server and then uninstall the ZENworks Agent. The following two sections provide instructions:

3.3.1 Demoting the Satellite Server

There are two methods you can use to demote a Satellite Server.

The first method is to use ZENworks Control Center. Instructions for using this method are provided in Removing Satellites from the Server Hierarchy in the ZENworks Primary Server and Satellite Reference.

The second method is to run the ZENworks uninstall program on the Satellite Server. To do so:

  1. At the console prompt, launch the uninstallation program by entering the following command:

    /opt/novell/zenworks/bin/novell-zenworks-xplat-uninstall

  2. Choose the locale (language) in which you prefer to run the uninstallation program by entering the locale number or pressing Enter to accept the default locale (English).

    HINT:Press Enter at any prompt to accept the default value.

  3. Read the introductory text, then press Enter.

  4. On the Uninstallation Type screen, press Enter to accept the default option (Demote Satellite Server):

  5. On the ZENworks Management Zone Information scree, provide the information required to connect to the ZENworks Management Zone to demote the Satellite Server to a standard managed device:

    1. Specify the IP address or DNS of a ZENworks Primary Server, then press Enter.

      You only need to specify the port number if the Primary Server is not using the default (443).

    2. Specify the port number of the Primary Server, then press Enter. To use the default port (443), simply press Enter.

    3. Specify the username for a ZENworks administrator account that has rights to unregister devices, then press Enter. To use the Administrator account, simply press Enter.

    4. Specify the password for the ZENworks administrator account, then press Enter.

  6. On the Summary screen, review the details, then press Enter to begin the uninstall process.

  7. When demotion of the Satellite Server is complete, press Enter to exist the uninstallation program.

  8. To verify that the managed device is no longer a Satellite Server, double-click the ZENworks icon icon in the notification area. The Satellite links should no longer be available in the left-navigation pane.

3.3.2 Uninstalling the ZENworks Agent

NOTE:To uninstall the ZENworks Agent, ensure that the configured admin port (the default 7443 port or any port assigned when upgrading ZENworks) is open in the server firewall and it is accessible from the agent device.

  1. At the console prompt, launch the uninstallation program by entering the following command:

    /opt/novell/zenworks/bin/novell-zenworks-xplat-uninstall

  2. Choose the locale (language) in which you prefer to run the uninstallation program by entering the locale number or pressing Enter to accept the default locale (English).

    HINT:Press Enter at any prompt to accept the default value.

  3. Read the introductory text, then press Enter.

  4. On the Uninstallation Type screen, select the type of uninstall you want to perform, then press Enter:

    • Unregister and Uninstall from zone: Select this option to uninstall the ZENworks software and unregister the device in the ZENworks Management Zone. Unregistering the device removes the device object and all references to the object in the zone.

    • Local Uninstallation only: Select this option to uninstall the ZENworks software but leave the device registered in the zone.

      In order to perform a local uninstall of the agent software, the Allow Users to Uninstall the ZENworks Agent option must be enabled for the device in ZENworks Control Center. Otherwise, the local uninstallation fails.

      The option is set at either the zone level (Configuration > Management Zone Settings > Device Management > ZENworks Agent > Agent Security), folder level (Devices > Managed > folder Details > Settings > Device Management > ZENworks Agent > Agent Security), or device level (Devices > device > Settings > Device Management > ZENworks Agent > Agent Security).

  5. If you selected Local Uninstallation only, skip to Step 6. Otherwise, you must provide the information required to connect to the ZENworks Management Zone to unregister the device after the ZENworks software is uninstalled:

    1. Specify the IP address or DNS of a ZENworks Primary Server, then press Enter.

      You only need to specify the port number if the Primary Server is not using the default (443).

    2. Specify the port number of the Primary Server, then press Enter. To use the default port (443), simply press Enter.

    3. Specify the username for a ZENworks administrator account that has rights to unregister devices, then press Enter. To use the Administrator account, simply press Enter.

    4. Specify the password for the ZENworks administrator account, then press Enter.

  6. On the Summary screen, review the details, then press Enter to begin the uninstall process or enter Back to change uninstall options on previous screens.

  7. When the uninstall is complete, press Enter to exit the uninstallation program.

    If the uninstallation was successful, the following occurred:

    • The ZENworks Agent software was uninstalled.

    • All ZENworks-related RPMs were removed from the device.

    • If the Unregister and Uninstall from zone option was used, the device object was removed from the ZENworks Management Zone. You can verify this in ZENworks Control Center (Devices tab > Managed tab > Servers folder).

    If the uninstallation failed, see the following log files:

    • /var/opt/novell/log/zenworks/ZENworks_XPlat_Agent_Uninstall_<date>.log.xml

    • /tmp/err.log