User Guide

28
Command-Line Usage in Apple Qmaster
If you are accustomed to doing your work from Terminal shells, and need or prefer to
run Apple Qmaster from the command line with minimal use of application interfaces,
this section is for you.
Installing Apple Qmaster from the Command Line
Follow these steps to install Apple Qmaster software on each computer you want to
use for distributed processing. (All computers must be on the same subnet.)
1 Copy the standalone installer package (AppleQmasterNode.mpkg) to the remote system.
Note: Do not alter the file hierarchy of the packages.
2 Log into the remote system.
3 Enter the following command:
sudo installer -pkg AppleQmasterNode.mpkg -target /
Apple Qmaster processes start automatically after installation.
4 Optionally, do one of the following to start the Apple Qmaster processes:
 Enter this command:
sudo SystemStarter start Qmaster
 Restart the remote computer.
5 Repeat these steps for each computer in your distributed processing network.
∏ Tip: You can also install Apple Qmaster using Apple Remote Desktop. Just select
a node, click Install Package, and select the standalone installer package
(AppleQmasterNode.mpkg). The copy and installation process is done automatically.
Shell Commands for Configuring Service Nodes and Cluster Controllers
As an alternative to using the Apple Qmaster pane in System Preferences, you can use
the command qmasterprefs, with command-line options for enabling and disabling
service node and cluster-controlling services.
In the command-line descriptions below, angle brackets < > indicate a mandatory
argument in a command and brackets [ ] indicate an optional argument.
Synopsis
Below is a synopsis of the command for enabling and disabling cluster-controlling
services on a computer. The qmasterprefs command is located in /usr/sbin.
qmasterprefs -cluster <on | off> [-timeout <minutes>] [-servername <name>]
[-list] [-help]
Below is a synopsis of the command for enabling and disabling service-node
processing on a computer.
qmasterprefs -service “Unix Processing” <on | off> [-instances <n>]
[-timeout <minutes>] [-servername <name>] [-list] [-help]