Visit Azul.com Support

Uninstalling Azul Zing System Tools

Table of Contents
Need help?
Schedule a consultation with an Azul performance expert.
Contact Us
Note
The instructions below are applicable only if Azul Zing System Tools (ZST) is installed on the system. These do not apply if an Azul Zing build of OpenJDK (Zing) was installed using a tarball and being used without ZST.

Uninstalling ZST removes all the ZST elements, which includes the following:

  • Zing Memory

  • zing-ps

To uninstall ZST:

  1. Login to your system as root.

  2. Ensure there are no running processes using Zing Memory, type:

     
    zing-ps
  3. Identify the installed Zing packages.

    • For RHEL or SLES:

       
      rpm -qa|grep zing
    • For Ubuntu:

       
      dpkg -l|grep zing

      Sample response:

       
      zng-zst-5e.2.6.32-5.7.2.0.10.el6.x86_64 zing-jdk1.7.0-5.8.0.0-13.x86_64
  4. Uninstall ZST. Run the appropriate remove or delete command.

    • For RHEL:

       
      yum remove zing-zst-<version>
    • For SLES:

       
      zypper remove zing-zst-<version>
    • For Ubuntu:

       
      dpkg -P zing-zst-<version>

      This completes the ZST uninstallation.

Uninstalling the ZST from a ZST Node

Uninstalling ZST removes the ZST elements from the ZST node. To uninstall ZST:

  1. Login to your system as root.

  2. Shutdown all the Zing Java processes.

  3. Ensure there are no running processes using Zing Memory, type:

     
    zing-ps
  4. Run the shutdown script, zing-zst.shutdown, and confirm at the prompt. For example, including the optional -r option.

     
    /azul/zing_node/zst/scripts/zing-zst.shutdown -r

    The system responds:

     
    Uninstalling ZST from the system... Do you want to continue? (yes or no) y Restoring core pattern Removing zing-licensed zing-licensed: INFO: Stopping...26109 zing-licensed: INFO: stop successful Removing zing-memory zing-httpd: INFO: Stopping... zing-httpd: INFO: stop successful zing-certd: INFO: Stopping... zing-certd: INFO: stop successful zing-memory: INFO: Stopping... zing-memory: INFO: stop successful Removing directories Keeping /var/log/zing-httpd, directory is not empty Removing ZST Kernel Object Removing symlinks Removing user and groups created for ZST Removing /etc/zing Uninstallation complete!

    If you had enabled zing-core-pattern, the zing-zst.shutdown command restores your original core pattern. The zing-zst.shutdown command has the following options:

    Command-Line Option Description

    -h

    Displays help text.

    -r, --remove-etc-zing-folder

    Removes the /etc/zing folder.

    --batch-mode

    Uninstalls ZST without user interaction. Use it to avoid any confirmation questions during the uninstall procedure.

  5. Unmount the Zing server read-only directory from the local ZST node.

     
    # umount -l <zst_node_dir>

    For example:

     
    # umount -l /azul/zing_node/zst

    This command unmounts the local ZST node directory.

  6. Optionally, remove the Zing log file directory. The /var/log/zing-httpd directory contains log files. If you want to remove those files as well, remove the directory manually.

Uninstalling the ZST from the Zing Server

Uninstalling ZST removes all the ZST elements, this includes the following:

  • Zing Memory

  • zing-ps

To uninstall ZST:

  1. Uninstall ZST from all the ZST nodes. See the Uninstalling the ZST from a ZST Node section.

  2. Login to your Zing server as root.

  3. Ensure there are no running processes using Zing Memory, type:

     
    zing-ps
  4. Uninstall ZST from the Zing server. Run the remove command.

     
    yum remove zing-zst-<version>

This completes the ZST uninstallation.