It is generally easier and quicker to use the new Qube! Installer for all installs and upgrades. However, if you have a requirement for manual installs, you can follow these steps. For all of the software components, you will need to log in as an Administrator account (Windows), log in as root or use sudo (Linux) or know the Administrator password (OS X).
You should install the Supervisor first, and then any Workers and/or Clients. It is better to have the Supervisor waiting for Workers to show up, than the other way around.
Prerequisites
Linux
Linux requires the following be installed on the Supervisor and Worker machines
The supervisor requires the following packages to be present:
- mysql
- mysql-server
- xinetd
We suggest installing all the required packages with 'yum', as we test against the MySQL versions that ship with that distro.
Windows / OS X
Perl
This is required only for the Workers running the Jobtypes as most are controlled by Perl (with the exception of the cmdline and cmdrange).
Typically, Linux and Mac OS X come with Perl already installed. If not, RPMs should be available on the distribution CD or by download from the Internet. For Windows, free Perl distributions can be downloaded from ActiveState at www.activestate.com. On Windows, Qube! is compatible with Perl 5.6 to Perl 5.14.
Python
This is required only for the Workers running the Jobtypes that are python controlled. If there are none that are used, then this is an optional install.
Typically, Linux and Mac OS X come with Python already installed. If not, RPMs should be available on the distribution CD or by download from the Internet. For Windows, free Python distributions can be downloaded from ActiveState at www.activestate.com. On Windows, Qube! is compatible with Python versions 2.3 through 2.7 .
Download the Components
The components are available from the PipelineFX downloads site, via http.
- Core/Supervisor/Worker: http://pipelinefx.com/downloads/pub/qube/current/
- WranglerView: http://pipelinefx.com/downloads/pub/qubegui/current/
- ArtistView: http://pipelinefx.com/downloads/pub/qubeArtistView/current/
- Jobtypes: http://pipelinefx.com/downloads/pub/jobtypes/current/
Linux
Installing the Supervisor
Disable selinux and firewall using "setup" or available initial boot setup utility
[optional] Mount required network locations using /etc/fstab
Use package installation manager such as yum or apt-get to install "xinetd" & "mysql-server"
Download the required packages for your distribution qube-core, qube-supervisor. Optionally download qubegui.
Install qube-core package with the command: $
rpm –ivh qube-core-*.rpm
Install qube-supervisor package with the command: $
rpm –ivh qube-supervisor-*.rpm
[optional] Using your favorite editor, edit /etc/bashrc to contain the lines :
Installing the Worker
- Ensure that the worker has all necessary rendering software installed and licensed.
- Disable selinux and firewall using "setup" or available initial boot setup utility.
- Mount required network locations using /etc/fstab.
- Use package installation manager such as yum or apt-get to ensure "xinetd" is installed.
- Download required packages for your distribution: qube-core, qube-worker. Optionally download qubegui and any pertinent jobtypes.
- Install qube-core package with the command: $
rpm -ivh qube-core-*
- Install qube-worker package with the command: $
rpm -ivh qube-worker-*
- The WranglerView UI is a set of python scripts that use the qb python module and wxPython. It is compiled for each platform so it can run independently and not require installation of python, wxPython, or any other libraries. Install the qube-gui package with the command: $
rpm -ivh qubegui*
Installing the Client
- Install the ArtistView UI with the command:
rpm -ivh qubeArtistView-<ver>.<linux>.rpm
- Make sure that /usr/local/pfx/qube/bin is in the user's PATH variable
Windows
Installing the Supervisor:
- Install the qube Core MSI by double-clicking the icon. A short message describing the installation will be displayed. If you need to stop the installation, click Cancel at any time.
- Install the Qube Supervisor MSI by double-clicking the icon. A short message describing the installation will be displayed. If you need to stop the installation, click Cancel at any time:
- Once installed, the Supervisor daemon starts up, and the system will be configured to automatically start up the Supervisor anytime the host is rebooted.
- On Windows, the installer will also install and start up the MySQL service, followed by the installation and start up of the supervisor or qubesupervisor service.
Installing the Worker:
- Install the Qube Worker MSI by double-clicking the icon. A short message describing the installation will be displayed. If you need to stop the installation, click Cancel at any time.
Installing the WranglerView UI
- Double–click the .MSI file to install the GUI.
- Follow the step–by–step instructions in the MSI installer application.
- From the Start Menu, select Pipelinefx➡Qube to launch the GUI
OS X
Installing the Supervisor
- Double-click the downloaded .dmg file in order to mount the image containing the .pkg file. Open the disk image. Double-click the qube-core .pkg file to launch the Installer..
- The Installer will present a series of screens. Click Continue to proceed. If you need to abort the installation, select Quit from the File menu:
- Installation of the Qube software requires authentication by an Administrative user. If not running as root,tType in the user name and password of a user with Administrator privileges and click OK to continue with the installation:
- Double-click the downloaded .dmg file in order to mount tie image containing the .pkg file. Open the disk image. Double-click the qube-supervisor .pkg file to launch the Installer.
- The Installer will present a series of screens. Click Continue to proceed. If you need to abort the installation, select Quit from the File menu:
- Installation of the Qube software requires authentication by an Administrative user. If not running as root,tType in the user name and password of a user with Administrator privileges and click OK to continue with the installation
- Once installed, the Supervisor daemon starts up, and the system will be configured to automatically start up the Supervisor anytime the host is rebooted.
- On OS X, the installer will also install and start up the MySQL service, followed by the installation and start up of the supervisor or qubesupervisor service.
Installing the Worker
- Double-click the downloaded .dmg file in order to mount tie image containing the .pkg file. Open the disk image. Double-click the qube-worker .pkg file to launch the Installer.
- The Installer will present a series of screens. Click Continue to proceed. If you need to abort the installation, select Quit from the File menu:
- Installation of the Qube software requires authentication by an Administrative user. If not running as root, Type in the user name and password of a user with Administrator privileges and click OK to continue with the installation
Installing the WranglerView UI
- Double–click on the .dmg file to mount the disk image file. Open the disk image, and double–click the .pkg file to begin the GUI installation.
- Follow the step–by–step instructions in the Installer application.
- Double–click the qube icon to launch the GUI under /Applications/pfx/qube.
JobType Installation
Some of the application interfaces construct a commandline that is then run directly on the Workers and do not require any additional installation. Other application interfaces (like Maya, 3dsMax, and XSI) are controlled via (perl or python) scripts. These scripts are installed on the Worker by installing the desired jobtypes.
The application interfaces with these back-end scripts need to be installed on the Workers. Similarly, there are a few jobtypes that also have front-end scripts to provide in-application submission that should be installed on the Client machines.
See http://www.pipelinefx.com/products/supported-applications and http://www.pipelinefx.com/docs for details on the specific application interfaces that you are using.