7.4 Uninstalling ZENworks 10 Asset Management SP3 Linux Satellite

You can perform the following types of uninstallation on a Linux Satellite:

7.4.1 Zone-Level Uninstallation

In the zone-level uninstallation, you demote the Linux Satellite and remove the Satellite roles assigned to it. Subsequently, you can remove the device from the Management Zone and uninstall the ZENworks Adaptive Agent from it.

Demoting a Linux Satellite

If a Linux device has satellite roles assigned to it, you demote the Satellite by removing the Satellite roles (Authentication, Imaging, Content, and Collection).

  1. At the Linux Satellite console prompt, launch the uninstallation program by entering /opt/novell/zenworks/bin/uninstall.

  2. Choose the locale (language) in which you prefer to run the uninstallation program by entering the locale number.

    To select the default locale (English), enter 2 or press Enter.

    HINT:Pressing Enter at any prompt causes the uninstallation program to accept the default, which is the value shown in parentheses.

  3. Read the introductory text, then press Enter.

  4. On the Uninstallation Type screen, select the Demote Satellite Server option by pressing Enter.

  5. On the ZENworks Management Zone Information screen, enter the IP address of the Primary Server to which the Linux Satellite is registered.

  6. Enter the port number on which the Primary Server is listening.

    To select the default port 443, press Enter.

  7. Enter the username of the zone administrator.

    To use the default username (Administrator), press Enter.

  8. Enter the zone administrator’s password.

  9. (Conditional) If the Linux Satellite has the Imaging role configured, you are prompted to retain the images after the uninstallation. To retain the images, press Enter.

  10. Review the summary, then press Enter to begin the uninstallation.

    The ZENworks uninstallation program perform the following actions:

    • Removes all the Satellite roles from the device.

    • Removes the entry for the device from ZENworks Control Center (Configuration tab > Server Hierarchy panel).

  11. Ensure that the Satellite roles have been removed from the device by running the zac satr command.

  12. (Conditional) If you want to uninstall the agent and unregister the device from the zone, continue with Uninstalling the ZENworks Adaptive Agent and Unregistering the Device from the Zone.

Uninstalling the ZENworks Adaptive Agent and Unregistering the Device from the Zone

After demoting a Linux Satellite and removing the Satellite roles from it, perform the following steps to remove the device from the Management Zone and uninstall the ZENworks Adaptive Agent.

  1. At the Linux Satellite console prompt, relaunch the uninstallation program by entering /opt/novell/zenworks/bin/uninstall.

  2. Choose the locale (language) in which you prefer to run the uninstallation program by entering the locale number.

    To select the default locale (English), enter 2 or press Enter.

    HINT:Pressing Enter at any prompt causes the uninstallation program to accept the default, which is the value shown in parentheses.

  3. Read the introductory text, then press Enter.

  4. On the Uninstallation Type screen, select the Unregister and Uninstall From Zone option by pressing Enter.

  5. On the ZENworks Management Zone Information screen, enter the IP address of the Primary Server to which the Linux Satellite is registered.

  6. Enter the port number on which the Primary Server is listening.

    To select the default port 443, press Enter.

  7. Enter the username of the zone administrator.

    To use the default username (Administrator), press Enter.

  8. Enter the zone administrator’s password.

  9. Review the summary, then press Enter to begin the uninstallation.

    ZENworks uninstallation program performs the following actions:

    • Uninstalls ZENworks Adaptive Agent.

    • Removes all the RPMs related to ZENworks 10 Asset Management SP3 from the device.

    • Removes the device object from ZENworks Control Center (Devices tab > Managed tab > Servers folder).

NOTE:If the uninstallation fails, see the following log files:

  • /var/opt/novell/log/zenworks/ZENworks_Satellite_Server_Uninstall_<timestamp>.xml

  • /tmp/err.log

7.4.2 Local Uninstallation

The Local Uninstallation option uninstalls only the ZENworks Adaptive Agent.

  1. Ensure that you have the permission to uninstall the Linux Satellite.

    The Allow Users to Uninstall Agent option must be selected by the zone administrator in ZENworks Control Center (Configuration tab > Management Zone Settings > Device Management > ZENworks Agent > General).

  2. At the Linux Satellite console prompt, launch the uninstallation program by entering /opt/novell/zenworks/bin/uninstall.

  3. Choose the locale (language) in which you prefer to run the uninstallation program by entering the locale number.

    To select the default locale (English), enter 2 or press Enter.

    HINT:Pressing Enter at any prompt causes the uninstallation program to accept the default, which is the value shown in parentheses.

  4. Read the introductory text, then press Enter.

  5. On the Uninstallation Type screen, select the Local Uninstallation option by entering 2, then pressing Enter again to finalize the selection.

  6. (Conditional) If the Linux Satellite has the Imaging role configured, you are prompted to retain the images after the uninstallation. To retain the images, press Enter.

  7. Review the summary, then press Enter to begin the uninstallation.

    The ZENworks uninstallation program uninstalls the ZENworks Adaptive Agent by removing all the RPMs related to the Linux Satellite.

  8. (Conditional) If the uninstallation fails, see the following log files:

    • /var/opt/novell/log/zenworks/ZENworks_Satellite_Server_Uninstall_<timestamp>.xml

    • /tmp/err.log

After the uninstallation of ZENworks Adaptive Agent, the Linux device object is still displayed in ZENworks Control Center (Configuration tab > Server Hierarchy panel) as having all the Satellite roles even though all the packages and RPMs related to the roles are removed from the device. If you want to delete the object, do the following in ZENworks Control Center:

  1. Remove the roles assigned to the Satellite.

    For more information on how to remove the roles, see Removing Satellites from the Server Hierarchy in the ZENworks 10 Asset Management System Administration Reference.

  2. Click the Devices tab > Servers folder.

  3. Select the check box next to the Linux server, then click Delete.