PipelineFX Forum

Qube! => Installation and Configuration => Typical Installation Scenarios => Topic started by: jburk on March 15, 2011, 11:06:07 PM

Title: All Macs, using only desktop machines (all workers in Deskop User mode)
Post by: jburk on March 15, 2011, 11:06:07 PM
This is perhaps the most straight-forward installation, and very common with small shops that don't have dedicated render nodes, but want to use Qube! to queue up jobs during the day, and then run them on the workers at night.

In this configuration, the desktop machines are only workers when logged in as a particular user, for example, the "render" user.

It's recommended that the supervisor be installed on a machine that is not a desktop, is seldom if ever rebooted, and does not function as a worker also.  It doesn't have to be a high-powered machine, but it should be reliable.  Mac mini's function well as supervisors in the scenario.


Install and configure the supervisor:
* Install the qube-core, qubegui, and the qube-supervisor packages.  

* Install the license file, verify that the licenses are correctly installed with QubeGUI->Admin->Ping Supervisor.  You should see the license count be something other than 0/2.

You should be done with the supervisor at this point


Install and configure the desktops:
* Install the qube-core and QubeGUI packages.

* Start up the qubeGUI with /Applications/pfx/qube/qube.  The first time it starts up, it may take some time to initially find the supervisor.

* Specify the supervisor in the local configuration with QubeGUI->Admin->Configure (Local), set the qb_supervisor to the hostname or IP address of the supervisor.

* Verify that you can contact the supervisor with QubeGUI->Admin->Ping Supervisor.


Install and configure the desktops as Qube submission clients:
* Log in as the user who will be the user the worker runs as, the 'render' user.  This user needs to be configured as an administrator to be able to easily make changes to the running configuration.  You can change this user back to a normal non-admin after the installation is complete if your security policies dictate.

* Ensure that this user mounts all network volumes necessary to be able to run render jobs when they log in.  

** Mount the network volumes.

** In Finder->Prefs, check the box for "Connected Servers" so that an icon for the mounted volume(s) appears on the desktop.

** Go to SystemPrefs->Users->render user.  Select the 'Login Items' for the render user, and drag the icons for the mounted volumes into the user's "Login Items".

** Log out and back in to check that these volumes get mounted automatically.


Now install and configure the desktops as workers in Desktop User mode:
* Install the qube-worker package on top of the core package.

* Stop the worker that was automatically started during the installation with QubeGUI->Worker (Service Started)->Stop.

* Disable the worker starting up as a service on bootup: QubeGUI->Admin->Autostart Worker->Disabled

* Enable the worker to start up in Desktop User Mode, with QubeGUI->Admin->Autostart Worker->Enable Desktop User (on user login)

* Start the worker in Desktop User mode with QubeGUI->Admin->Worker->Start as the Desktop User.

* Verify that the worker is running with QubeGUI->Admin->Ping Local Worker.

* Verify that the worker is running in Desktop User mode by going to the "Farm" or "Workers" pane in the QubeGUI, selecting the worker, and checking the Properties pane on the right.  The 2 values you're interested in are:

host.worker_mode    : desktop
host.proxy_mode     : interactive