Houdini 19.0 HQueue

Uninstalling

How to uninstall the HQueue server or client software.

On this page

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

This page provides instructions on how to uninstall the HQueue Client and HQueue Server.

Uninstalling the HQueue Client

macOS

Uninstall the HQueue Client:
- Use the Houdini Launcher to uninstall HQueue Clients installed by the Launcher.
- To uninstall an HQueue Client installed by an old Houdini installer, open a Terminal app and run the following commands:
```
sudo launchctl unload /Library/LaunchDaemons/com.sidefx.hqclient.plist
sudo rm -f /Library/LaunchDaemons/com.sidefx.hqclient.plist
sudo rm -rf /Library/HQClient
```
(optional) Unmount the network folder
- This only applies if the option to mount the network folder was chosen at install time.
- 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
```
(optional) Delete the hquser user account
- This only applies if the option to create an hquser account was chosen 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
```

Windows

Uninstall the HQueue Client:
- Use the Houdini Launcher to uninstall HQueue Clients installed by the Launcher.
- To uninstall an HQueue Client installed by an old Houdini installer:
  - Open Windows 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.

Linux

Uninstall the HQueue Client:
- Use the Houdini Launcher to uninstall HQueue Clients installed by the Launcher.
- To uninstall an HQueue Client installed by an old Houdini installer, open a Terminal app 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 the option to mount the network folder was chosen at install time.
- 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 the option to create an hquser account was chosen 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
```

Uninstalling the HQueue Server

Note

Uninstall all HQueue Clients before uninstalling the HQueue Server.

macOS

Uninstall the HQueue Server:
- Use the Houdini Launcher to uninstall HQueue Server installed by the Launcher.
- To uninstall an HQueue Server installed by an old Houdini installer, open a Terminal app and run the following commands:
```
sudo launchctl -F unload /Library/LaunchDaemons/com.sidefx.hqserver.plist
sudo rm -f /Library/LaunchDaemons/com.sidefx.hqserver.plist
sudo rm -rf /Library/HQServer
```

Windows

Uninstall the HQueue Server:
- Use the Houdini Launcher to uninstall HQueue Server installed by the Launcher.
- To uninstall an HQueue Server installed by an old Houdini installer:
  - Open Windows 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.

Linux

Uninstall the HQueue Server:
- Use the Houdini Launcher to uninstall HQueue Server installed by the Launcher.
- To uninstall an HQueue Server installed by an old Houdini installer, open a terminal and run the following commands:
```
cd /opt/hqueue
sudo ./scripts/hqserverd stop
cd -
sudo rm -rf /opt/hqueue
```

HQueue

Getting started

About HQueue

HQueue is a general-purpose job management system. You can use it to distribute renders, simulations, and other work to remote clients.
Installation

How to set up a basic HQueue farm.
Configuration

How to set configuration options for the HQueue server and clients.
How to submit jobs

How to put work on the farm.

Managing the farm

Managing clients

How to use the web interface or local logins to add, remove, restart, and manage client machines.
Managing jobs

How to view and manage jobs on the farm.
Managing client groups

How to use the web interface or local logins to create and manage groups of client machines.
Notes

Each client and job can have informational notes attached.
Resources

You can specify what resources (such as licenses) are available on each client, so jobs can be scheduled on clients where they can run.
Network Folders

How to use the Network Folder management page.

Next steps

Logging

Hqueue stores separate logs for errors and scheduling events, and each client also generates a log.
Uninstalling

How to uninstall the HQueue server or client software.
FAQs

Answers to frequently asked questions.

Guru level

Remote API

You can connect to the HQueue server over the network and call functions to manipulate and query jobs and other information.
Jobs specification details

More detail on the internals of a job specification for users who want to submit custom jobs.
Switching to MySQL (Linux only)

You can optionally configure HQueue to use MySQL instead of SQLite on Linux.