Uninstalling

How to uninstall the HQueue server or client software.

On this page

Uninstalling the HQueue Client
- Linux
- macOS
- Windows
Uninstalling the HQueue Server
- Linux
- macOS
- Windows

This page provides instructions on how to uninstall the HQueue clients and HQueue server.

Uninstalling the HQueue Client ¶

Linux ¶

Use the Houdini Launcher to uninstall the HQueue client.

If the HQueue client was installed with the old Houdini installer, then instead follow the steps in the Old Houdini Installer tab to uninstall the client.

Houdini Launcher

Old Houdini Installer

In the Houdini Launcher, select HQueue in the product list.
Select the for the HQueue Client component and select Uninstall.
Select Yes in the confirmation dialog to proceed with the uninstall.

Note

The Launcher may leave behind the HQueue client configuration file, hqnode.ini, and log files, hqnode.log and errors.log, in /path/to/hqclient. You can safely remove the /path/to/hqclient directory if you no longer require the configuration and log files.

Note

If the hquser user account was created during installation, then the user account is removed by the Launcher during uninstallation.

On a machine that uses systemd, open a terminal and run the following commands:

sudo systemctl stop hqueue-client
sudo systemctl disable hqueue-client
sudo rm /etc/systemd/system/hqueue-client.service
sudo systemctl daemon-reload
sudo rm -rf /home/hquser/hqclient

If the machine does not use systemd, open a terminal and run the following commands:

sudo /home/hquser/hqclient/hqclientd stop
sudo rm -rf /home/hquser/hqclient

Replace /home/hquser/hqclient with the location of the HQueue Client installation.

(optional) Unmount the network folder
- This only applies if you chose the option to mount the network folder at install time for an old HQueue client installation.
- Open /etc/fstab in a text editor and remove the line that contains the network folder mount point. Save the changes to the file.
- Then in a terminal run this command:
```
sudo umount -l /mnt/myShare
```
  Replace /mnt/myShare with the actual mount point path.
(optional) Delete the hquser user account
- This only applies if you chose the option to create an hquser account at install time.
- Open a terminal and run these commands:
```
sudo /usr/sbin/userdel hquser
sudo rm -rf /home/hqclient
sudo /usr/sbin/groupdel hqgroup
```

macOS ¶

Use the Houdini Launcher to uninstall the HQueue client.

If the HQueue client was installed with the old Houdini installer, then instead follow the steps in the Old Houdini Installer tab to uninstall the client.

Houdini Launcher

Old Houdini Installer

In the Houdini Launcher, select HQueue in the product list.
Select the for the HQueue Client component and select Uninstall.
Select Yes in the confirmation dialog to proceed with the uninstall.

Note

The Launcher may leave behind the HQueue client configuration file, /Library/HQueueClient/hqnode.ini. You can safely remove the /Library/HQueueClient directory if you no longer require the configuration file.

Note

If the hquser user account was created during installation, then the user account is removed by the Launcher during uninstallation.

Delete the hquser user account (if one was created during installation)
- This only applies if you chose the option to create an hquser account at install time.
- Open a Terminal app and run these commands:
```
sudo dscl . delete /Groups/hqgroup
sudo dscl . delete /Users/hquser
rm -rf /Users/hquser
```
  The hquser account must be deleted before uninstalling the HQueue client. Otherwise, on macOS 14.0+ versions, the uninstall will fail to remove some files in /Library/HQueueClient.
Uninstall the HQueue client:
- Open a Terminal app and run the following commands:
```
cd /Library/HQueueClient
sudo ./uninstall.sh
```
(optional) Unmount the network folder
- This only applies if you chose the option to mount the network folder at install time for an old HQueue client installation.
- Open /etc/auto_master in a text editor and remove the line that contains the text auto_hqshared. Save the changes to the file.
- Then in a Terminal app run these commands:
```
sudo rm -f /etc/auto_hqshared*
sudo automount -vc
```

Windows ¶

Use the Houdini Launcher to uninstall the HQueue client.

If the HQueue client was installed with the old Houdini installer, then instead follow the steps in the Old Houdini Installer tab to uninstall the client.

Houdini Launcher

Old Houdini Installer

In the Houdini Launcher, select HQueue in the product list.
Select the for the HQueue Client component and select Uninstall.
Select Yes in the confirmation dialog to proceed with the uninstall.

Note

The Launcher may leave behind the HQueue client configuration file, C:/HQueueClient/hqnode.ini. You can safely remove the C:/HQueueClient directory if you no longer require the configuration file.

Open Windows File Explorer and navigate to C:\HQueueClient.
In the folder locate and double-click Uninstall HQueue Client.exe to launch the uninstaller.
Follow the instructions in the uninstaller to uninstall the HQueue client.

Uninstalling the HQueue Server ¶

Note

Uninstall all HQueue clients before uninstalling the HQueue server.

Linux ¶

Use the Houdini Launcher to uninstall the HQueue server.

If the HQueue server was installed with the old Houdini installer, then instead follow the steps in the Old Houdini Installer tab to uninstall the server.

Houdini Launcher

Old Houdini Installer

In the Houdini Launcher, select HQueue in the product list.
Select the for the HQueue Server component and select Uninstall.
Select Yes in the confirmation dialog to proceed with the uninstall.

Note

The Launcher may leave behind the HQueue server configuration files, hqserver.ini and network_folders.ini in the /opt/hqueue directory. The Launcher may also leave behind backup copies of the HQueue Server database. You can safely remove the /opt/hqueue directory if you no longer require these files.

On a machine that uses systemd, open a terminal and run the following commands:

sudo systemctl stop hqueue-server
sudo systemctl disable hqueue-server
sudo rm /etc/systemd/system/hqueue-server.service
sudo systemctl daemon-reload
sudo rm -rf /opt/hqueue

If the machine does not use systemd, open a terminal and run the following commands:

cd /opt/hqueue
sudo ./scripts/hqserverd stop
cd -
sudo rm -rf /opt/hqueue

macOS ¶

Use the Houdini Launcher to uninstall the HQueue server.

If the HQueue server was installed with the old Houdini installer, then instead follow the steps in the Old Houdini Installer tab to uninstall the server.

Houdini Launcher

Old Houdini Installer

In the Houdini Launcher, select HQueue in the product list.
Select the for the HQueue Server component and select Uninstall.
Select Yes in the confirmation dialog to proceed with the uninstall.

Note

The Launcher may leave behind the HQueue server configuration files, hqserver.ini and network_folders.ini in the /Library/HQueueServer directory. The Launcher may also leave behind backup copies of the HQueue Server database. You can safely remove the /Library/HQueueServer directory if you no longer require these files.

Open a Terminal app and run the following commands:

cd /Library/HQueueServer
sudo ./uninstall.sh

Windows ¶

Use the Houdini Launcher to uninstall the HQueue server.

If the HQueue server was installed with the old Houdini installer, then instead follow the steps in the Old Houdini Installer tab to uninstall the server.

Houdini Launcher

Old Houdini Installer

In the Houdini Launcher, select HQueue in the product list.
Select the for HQueue Server component and select Uninstall.
Select Yes in the confirmation dialog to proceed with the uninstall.

Note

The Launcher may leave behind the HQueue server configuration files, hqserver.ini and network_folders.ini in the C:/HQueueServer directory. The Launcher may also leave behind backup copies of the HQueue Server database. You can safely remove the C:/HQueueServer directory if you no longer require these files.

Open Windows File Explorer and navigate to C:\HQueueServer.
In the folder locate and double-click Uninstall HQueue Server.exe to launch the uninstaller.
Follow the instructions in the uninstaller to uninstall the HQueue server.

Uninstalling

Uninstalling the HQueue Client ¶

Linux ¶

macOS ¶

Windows ¶

Uninstalling the HQueue Server ¶

Linux ¶

macOS ¶

Windows ¶

HQueue

Getting started ¶

Managing the farm ¶

Next steps ¶

Guru level ¶