3.1 Uninstalling ZENworks from a Linux Primary Server

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

  • 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 Linux Primary Server:

  1. Enter the following command at the server console prompt to launch the ZENworks uninstall program:

    /opt/novell/zenworks/bin/zenuninstall -x -s http://server_address:port_number -u username -p password -q

    For example:

    /opt/novell/zenworks/bin/zenuninstall -x -s http://zenserver.novell.com:8080 -u Administrator -p novell -q

    -x

    Uninstalls the ZENworks software from the server and unregisters the device from the zone. If you do not want to unregister the software, use the -c option instead.

    -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.

    -u

    Specifies the username of a ZENworks administrator that has rights to unregister devices in the Management Zone. If you do not use this option, you are prompted for the username.

    -p

    Specifies the password of the ZENworks administrator.

    There are additional options you can use with the uninstall. The following syntax applies when using options:

    /opt/novell/zenworks/bin/zenuninstall <remove_options> [zone_options] [display_options] [other_options]

    Table 3-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 Agent software installed. 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 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).

    -o

    --oem

    Retains the ZENworks Pre-agent but uninstalls the ZENworks 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 3-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 3-3 Display Options

    Option

    Description

    -q

    --quiet

    Performs a silent uninstallation.

    -h

    --help

    Displays the message and exit.

    Table 3-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.