Creating Clusters with Apple Qadministrator

Once you configure managed service nodes or cluster controllers, they are visible in Apple Qadministrator, which you use to create and modify Apple Qmaster clusters.

There are two basic steps to creating a managed cluster with Apple Qadministrator. First, you create a new cluster and choose the cluster controller. Then, you add service nodes to the cluster.

Stage 1: Creating a New Cluster

Use the following steps to create a cluster with Apple Qadministrator.

To create a new cluster
  1. Open Apple Qadministrator, then do the following:

    1. Click the Add (+) button.

    2. Select Untitled Cluster and rename it. (The cluster name you create will also appear in the cluster pop-up menus in Batch Monitor and Apple Qmaster.)

      Figure. New, untitled cluster in Cluster section of Apple Qadministrator window.
  2. From the Controller pop-up menu, choose a cluster controller from those available on the network.

    Figure. Controller pop-up menu.

    Note: If a password was created for the cluster controller in System Preferences, a password authentication dialog appears.

  3. Optionally, create cluster passwords by clicking the Security tab and selecting and entering the passwords you want.

    • Administrator Password: If you create this password, administrators will need to know it in order to modify this cluster and to view this cluster’s batches in Batch Monitor.
    • User Password: If you create this password, users will need to know it in order to submit batches to this cluster and to view those batches in Batch Monitor.

Stage 2: Assigning Service Nodes

Use the following steps to assign service nodes to a cluster.

To add a service node to a cluster
  1. If the Qmaster Service Browser is not already displayed, click the disclosure triangle to see it.

    Figure. Qmaster Service Browser disclosure triangle.
  2. Add service nodes to the new cluster by dragging them from the Qmaster Service Browser list at the bottom of the window to the cluster’s service nodes list.

    If there is a closed lock icon next to a computer name, click the lock and enter the password that was assigned to it in the Apple Qmaster pane of System Preferences. Otherwise, you won’t be able to drag that service node to the cluster.

    Service nodes that are already assigned to another cluster are not shown.

    Figure. Diagram of Apple Qadministrator window, showing how to drag nodes from the Service Browser list to the current cluster.

    Note: The computer names you see at the top level of the Name columns may appear in one of three formats, depending on your configuration: the computer name (for example, Lemur node), the Apple networking name (for example, Lemur-node.local), or the network address for the computer (for example,

  3. When you have finished adding service nodes, click Apply.

    Your cluster is now ready to process batches.

Note: Although Apple Qadministrator currently allows you to create a cluster with unmanaged services, valid clusters require at least one managed service for the cluster to be viewable in Apple Qmaster, Compressor, and Batch Monitor.