2.1 Uninstalling ZENworks from a Windows Primary Server

When uninstalling a ZENworks Primary Server, please be aware of the following:

  • A ZENworks Primary Server has both the ZENworks Primary Server software and the ZENworks Adaptive Agent software installed. If an Adaptive Agent uninstall password is required (the Require an uninstall password for the ZENworks Adaptive Agent option is enabled), you must know the password and supply it during the uninstall process.

    The Adaptive Agent uninstall password is set in ZENworks Control Center at 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).

  • The first ZENworks Primary Server installed in your system should only be removed after all other Primary Servers. If you are using an embedded ZENworks database, it is on the first Primary Server and is removed when the server is uninstalled. If you are using an external database, the first Primary Server holds the server certificate for the Management Zone; removing it breaks all other Primary Server’s connection to the ZENworks database.

To uninstall ZENworks from a Windows Primary Server:

  1. At a command prompt, run the following command to launch the ZENworks uninstall program:

    zenworks_installation_directory\novell\zenworks\bin\ZENworksUninstall.exe

    To see the list of uninstall options, run ZENworksUninstall.exe --help

  2. Click Next, then follow the prompts to uninstall the ZENworks software. Refer to the information in the following table if you have questions about any of the uninstall options.

    Screen

    Explanation

    Administrator Information

    In order to unregister a device from the ZENworks Management Zone during the uninstall process, you must provide the following information:

    • Primary Server: When uninstalling a ZENworks Primary Server, this address defaults to the server’s localhost address and port. If the Primary Server is not using the standard port, edit the address to include the correct port number.

    • Username: Specify the username for a ZENworks administrator account that has rights to unregister devices. By default, the Administrator account is specified.

    • Password: Specify the password for the ZENworks administrator specified in the Username field.

    Local Uninstallation Only (Retain the Device in the Zone): Select this option if you only want to uninstall ZENworks software from the device. The device continues to be registered in the Management Zone.

    You can perform a local uninstallation only if user uninstall is allowed for the device (the Allow users to uninstall the ZENworks Adaptive Agent option is enabled).

    The Adaptive Agent user uninstall option is set in ZENworks Control Center 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).

    Actions

    This screen is displayed only if you have logged in to the Management Zone in order to unregister the device during uninstallation of the ZENworks software.

    The Uninstall the ZENworks server and unregister the device from the zone option is the only available option. Click Next to confirm the operation.

    Components To Be Retained

    Select any of the following components that you do not want uninstalled:

    • ZENworks Pre-Agent: Leaves the ZENworks Pre-Agent installed on the device, but removes all other ZENworks component. By default, this is not selected.

      Leaving the ZENworks Pre-Agent on the device allows it to respond to Advertised discovery requests and ZENworks Ping requests if an IP-based discovery is performed on the device.

      To remove the ZENworks Pre-Agent from a device after ZENworks has been uninstalled from the device, see Removing the ZENworks Pre-Agent from a Device in the ZENworks 11 SP3 Adaptive Agent Reference.

    • CASA: Leaves the Novell CASA (Common Authentication Services Adaptor) software installed. By default, this is selected because CASA can be used by other software programs.

    • ZENworks Imaging Files: Leaves the image files, located in the novell\zenworks\work\content-repo\images directory, on the server. By default, this is selected.

    • ZENworks Content Files: Leaves the application files, patch files, policy files, system update files, and other content files (located in the novell\zenworks\work\content-repo\contentdirectory) on the server. By default, this is selected.

  3. If the ZENworks Adaptive Agent requires an uninstall password, enter the password when prompted.

    You must enter the password within 5 minutes of the prompt being displayed. Otherwise, the uninstall process times out and you must restart the process.

  4. When the uninstall is finished, the Uninstallation Status dialog box is displayed. Review the status comments, make sure the Restart Now option is selected, then click Finish.

    If desired, you can deselect the Restart Now option and reboot the server at a later time to complete uninstallation of the files and folders that were not able to be removed.

  5. After the server reboots, perform the following tasks to ensure that ZENworks is completely removed:

    • ZENworks Log Files: Log files are purposely left here for your review. You can manually delete the ZENworks_installation_path\Novell\ZENworks directory at any time.

    • ZENworks Control Center Icon: If the ZENworks Control Center icon remains on the desktop, you can manually delete it.

    • ZENworks Imaging Files: If you retained the image files during the uninstallation and want to remove or move them later, they are located in the novell\zenworks\work\content-repo\images directory.

    • ZENworks Content Files: If you retained the content files during the uninstallation and want to remove or move them later, they are located in the novell\zenworks\work\content-repo\contentdirectory.

    • CASA: If you retained CASA during the uninstallation, and want to remove it later, you can do it from Windows Add/Remove Programs. If the c:\program files\novell\casa directory exists even after you select to uninstall CASA, you can manually delete it.

2.1.1 Unattended ZENworks Primary Server from Windows

To uninstall ZENworks from a Windows Primary Server by using Unattended (silent) method:

  1. At a command prompt, run the following command: zenworks_installation_directory\novell\zenworks\bin\ZENworksUninstall.exe <remove_options> [zone_options] [display_options] [other_options]

    IMPORTANT:Use display_option -q to perform unattended ZENworks Primary Server uninstall.

    Table 2-1 Remove Options

    Option

    Description

    -x

    --remove

    Uninstalls the ZENworks software from the server and unregisters the device from the zone. Use of this option or the -c option is required.

    -c

    --local-only

    Uninstalls ZENworks software from the device but does not unregister the device from the zone. Either this option or the -x option is required.

    A ZENworks Primary Server has both the ZENworks server software and the ZENworks Adaptive Agent software installed. In order to perform a local uninstall of the Adaptive Agent software, the Allow Users to Uninstall the ZENworks Adaptive Agent option must be enabled for the server 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).

    -s

    Specifies the IP address or DNS of the Primary Server and the port number on which the server is running. If the Primary Server is running on the default port (80), you do not need to use this option.

    -o

    --oem

    Retains the ZENworks Pre-agent but uninstalls the ZENworks Adaptive Agent packages.

    -i

    --delete-images

    Deletes the ZENworks image files from the server. The image files are stored in the /var/opt/novell/zenworks/content-repo/images directory.

    -j

    --delete-content

    Deletes the ZENworks content files (application files, patch files, system update files, policy files, and so forth) from the server. The content files are stored in the /var/opt/novell/zenworks/content-repo/content directory.

    Table 2-2 Zone Options

    Option

    Description

    -u <username>

    --user <username>

    Specifies the username of a ZENworks administrator that has rights to unregister devices in the Management Zone. This is only required when using the -x Remove option.

    -p <password>

    --password <password>

    Specifies the password of the ZENworks administrator provided by the -u option.

    -z <zonename>

    --zone <zonename>

    Name of the device's current zone.

    -g <guid>

    --guid <guid>

    Device's GUID.

    -l <packages>

    --list <packages>

    An ordered list of packages to uninstall. This list is delimited by semicolons.

    Table 2-3 Display Options

    Option

    Description

    -q

    --quiet

    Performs a silent uninstallation.

    -h

    --help

    Displays the message and exit.

    Table 2-4 Other Options

    Option

    Description

    -L

    --leave-packages

    Retains the third-party packages. You must specify at least the first three characters of the package name to be retained. You can also specify more than one package name by separating each package with a comma ( , ).

    -d

    --remove-log-dir

    Removes the logs directory.