Versions Compared

    Key

    • This line was added.
    • This line was removed.
    • Formatting was changed.
    Comment: Published by Scroll Versions from this space and version 7.5-0
    Info

    If both of the following conditions are true, you will need to take the extra steps outlined in Transferring data from MySQL to PostgreSQL when upgrading the supervisor:

    • You are upgrading the supervisor from pre-7.0 to Qube 7 (for example from 6.10-0a to 7.0-0)

    • You wish to bring your Qube 6 job data forward into Qube 7

     

    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, it is usually required to login you will need to log in as an Administrator account (Windows), log in as root , or use " sudo ", (Linux) or know the Administrator password (for OSX dialog popupmacOS).

    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.

    Contents

    Table of Contents-zone

    Qube Core Installation

    Linux:

    1. Install the Core RPM (where linux is the type of Linux platform (e.g.. RHEL_WS-3.i386) and ver is the version of Qube):
    2. rpm ivh qubever-linux.rpm

    Windows: 

    locationtop

    Prerequisites

    Linux

    Linux requires the following be installed on the Supervisor and Worker machines

    The supervisor requires the following packages to be present:

    • python3
    • xinetd

    We suggest installing all the required packages with 'yum' on CentOS/RHEL Linux systems, and 'apt' on Ubuntu.

    Windows / macOS

    Anchor
    python
    python
    Python

    New in 7.5, Python3 (3.6, 3.7, or 3.8) is required for the installation process, as well as for the supervisor. For the workers, it isalso required if running jobtypes that are python controlled.
    Linux and macOS may not come installed with python3 (CentOS/RHEL 7.x, macOS). If not, for RHEL/CentOS, 'sudo yum install python3' should do the trick. For Windows, free Python distributions can be downloaded from www.python.org.

    On a new macOS 10.15 system, you will need to open a terminal, and type "python3" and hit enter. That will run a "stub" script and allow you to download and install python3.

    Anchor
    perl
    perl
    Perl

    Perl 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 macOS come with Perl already installed. If not, yum should be able to install it. On Windows, free Perl distributions can be downloaded from www.perl.org. We recommend Strawberry Perl. On Windows, Qube! is compatible with Perl 5.26.

    Download the Components

    Linux

    Installing the Supervisor

    1. Disable selinux and firewall using "setup" or available initial boot setup utility

    2. [optional] Mount required network locations using /etc/fstab

    3. Use package installation manager such as yum or apt-get to install "python3" and "xinetd"

    4. Download the required packages for your distribution qube-core, qube-supervisor.  Optionally download QubeUI. 

    5. Install qube-core package with the command: $ rpm –ivh qube-core-*.rpm

    6. Install qube-supervisor package with the command: $ rpm –ivh qube-supervisor-*.rpm

    7. [optional] Using your favorite editor, edit /etc/bashrc to contain the lines :

    Code Block
    export QBDIR=/usr/local/pfx/qube
 
    export PATH=$PATH:$QBDIR/bin:$QBDIR/sbin

    Installing the Worker

    1. Ensure that the worker has all necessary rendering software installed and licensed.
    2. Disable selinux and firewall using "setup" or available initial boot setup utility.
    3. Mount required network locations using /etc/fstab.
    4. Use package installation manager such as yum or apt-get to ensure "xinetd" and "python3" is installed.
    5. Download required packages for your distribution: qube-core, qube-worker. Optionally download QubeUI and any pertinent jobtypes.
    6. Install qube-core package with the command: $ rpm -ivh qube-core-*
    7. Install qube-worker package with the command: $ rpm -ivh qube-worker-*

    Installing the Client(s)

    There are two clients, and you can install both of them on any user machine. The QubeUI (new in 7.5) is the unified GUI, and intended to soon replace WV. As of 7.5-0, some of the WV features are yet to be ported to QubeUI, such as the administration features.

    1. Install the QubeUI package with the command: $ rpm -ivh QubeUI*
    2. Optionally install WranglerView: rpm -ivh qubegui-*
    3. Make sure that /usr/local/pfx/qube/bin is in the user's PATH variable

    Windows

    Installing the Supervisor 

    1. 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,

    ...

    1. click Cancel

    ...

    Supervisor Installation

    ...

    1.  at any time.

    ...

    OSX:

    ...

    1. 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:
    2. Once the MSI finishes, there's a script that must be run one time by hand. From an Administrator command prompt, run "C:\Program Files\pfx\qube\utils\supe_postinstall.bat"
    3. Once the script finishes running, the Supervisor daemon starts up, and the system will be configured to automatically start up the Supervisor anytime the host is rebooted.

    ...

    1. The installer will also install and start up the

    ...

    1. PostgreSQL service, followed by the installation and start up of the

    ...

    1. qubesupervisor service.

    Linux:

    1. Install the Supervisor RPM:
    2. rpm ivh qube-supervisorver-linux.rpm

    ...

    Installing the Worker

    1. Install the aube Worker MSI by double-clicking the icon. A short message describing the installation will be displayed. If you need to stop the installation,

    ...

    1. click Cancel

    ...

    1.  at any time

    ...

    1. .

    Installing the Client(s)

    There are two clients, and you can install both of them on any user machine. The QubeUI (new in 7.5) is the unified GUI, and intended to soon replace WV. As of 7.5-0, some of the WV features are yet to be ported to QubeUI, such as the administration features.

    1. Double–click the QubeUI.msi file to install the QubeUI.
    2. Optionally use the qubegui.msi file to install the WranglerView GUI.
    3. Follow the step–by–step instructions in the MSI installer application.
    4. From the Start Menu, select PipelinefxQubeUI to launch the QubeUI, or PipelinefxWranglerView to launch the WV GUI, or double click on the respective desktop icon.

    macOS

    Installing the Supervisor

    1. Double-click the downloaded .dmg file in order to mount

    ...

    1. the image containing the .pkg file. Open the disk image. Double-click the qube-

    ...

    1. core .pkg file to launch the Installer..
    2. The Installer will present a series of screens.

    ...

    1. Click Continue

    ...

    1.  to proceed. If you need to abort the installation,

    ...

    1. select Quit

    ...

    1.  from the File

    ...

    1.  menu:

    ...

    1. Installation of the Qube software requires authentication by an Administrative user. If not running as root,

    ...

    1. type in the user name and password of a user with Administrator privileges and

    ...

    1. click OK

    ...

    1.  to continue with the installation:

    ...

     Worker Installation

    Linux:

    1. Install the Worker daemon RPM:
    2. rpm ivh qube-workerver--linux.rpm

    Where linux is the type of Linux platform (e.g.. RHEL_WS-3.i386) and ver is the version of Qube.

    Windows:

    1. 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.
      Image Removed

    ...

    1.  
    2. 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.
    3. 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:
    4. 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
    5. Once installed, the Supervisor daemon starts up, and the system will be configured to automatically start up the Supervisor anytime the host is rebooted.
    6. The installer will also install and start up the PostgreSQL service, followed by the installation and start up of the supervisor service.

    Installing the Worker

    1. 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.
    2. The Installer will present a series of screens.

    ...

    1. Click Continue

    ...

    1.  to proceed. If you need to abort the installation,

    ...

    1. select Quit

    ...

    1.  from the File

    ...

    1.  menu

    ...

    1. 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

    ...

    1. click OK

    ...

    1.  to continue with the installation

    ...

    QubeGUI Installation

    The QubeGUI 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.
    Linux:

    1. Install the QubeGUI RPM:
    2. rpm ivh qubeguiversionreleaseos.platform.rpm
    3. Launch it from /usr/local/pfx/qube/bin/qube

    ...

    1. Double–click the .MSI file to install the GUI.
    2. Follow the step–by–step instructions in the MSI installer application.
    3. From the Start Menu, select PipelinefxQube to launch the GUI

    ...

    Installing the Client(s)

    1. 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.
    2. Follow the step–by–step instructions in the Installer application.

    ...

    1. In /Applications/pfx/qube

    ...

     

    1. /bin, double–click the QubeUI icon to launch the QubeUI, or the Qube Icon to launch WranglerView.

    Installing Multiple Workers using Apple Remote


    Apple Remote desktop Client can also push the pkg files out to your farm. Here is a brief description of the process

    1. Select qube-core, qube-worker, and qubegui and right/ctrl click > open to mount the packages
    2. Open Remote Desktop application
    3. Select required machines for installation
    4. Click Install in the top menu
    5. Drag qube-core into the install Packages window
    6. Click Install
    7. Repeat steps 4 to 6 for qube-worker.
    8. Repeat steps 4 to 6 for QubeUI

    Anchor
    jobtype
    jobtype
    JobType Installation

    Some of the application interfaces construct a

    ...

    command line that is then run directly on the Workers and do not require any additional installation. Other application interfaces (like Maya, and 3dsMax

    ...

    ) 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.

    Tip
    titleNote
    One

    You can

    centrally

    install these jobtypes centrally on a network fileserver. See the configuration parameter worker_template_path for the search path used by the Workers for their jobtypes.

    Perl Installation

    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 Installation

    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  .