Versions Compared

    Old Version 16

    changes.mady.by.user John Burk

    Saved on

    compared with

    New Version 17

    changes.mady.by.user Scott Morrissey

    Saved on

    Key

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

    You can create a central configuration for all Workers in two ways: via using the WranglerView UI from the supervisor host, or by manually editing the qbwrk.conf file on the supervisor hostSupervisor. This page discusses both methods.

    Configuration file name and location

    The central worker configuration file is optional and may not yet exist on your supervisor.  The default name and location is

    • Linux & OS X:            /etc/qbwrk.conf
    • Windows Vista and above:   C:\ProgramData\pfx\qube\qbwrk.conf 
    • Windows XP:             C:\Program Files\pfx\qube\qbwrk.conf

    An alternate name and/or location can be specified with the supervisor_worker_configfile parameter in the supervisor's qb.conf file.  

    Parameters unsupported in the centralized worker configuration file

    The following parameters are only settable locally on the Worker as they determine where the Qube! installation is located, the hostname of the Supervisor, and the filtering field for network communication. They will not have any effect when used in the qbwrk.conf file.

    Include+
    scrollPageId405BE23F014B092BED9A39737B3041D9
    scrollEditorDisplayTitle_worker_bootstrap_parameter_list
    scrollEditorUrlhttp://docs.pipelinefx.com/display/QUBE/._worker_bootstrap_parameter_list+v6.6-3

    ...

    Using the UI

    Section
    Column
    width60%

    The central Worker configuration can be managed through the WranglerView UI from the Supervisor. Using the Workers tab, select one or more machines, <right-click> to get the menu, and choose "Configure on Supervisor"

     

    Note

    This menu item is only enabled when:

    • running the WranglerView on the supervisor host , and
    • AND the user has the Qube! qube 'admin' privilege
    Column
    width40%

    Image Modified

    Section
    Column
    width60%

    The worker configuration UI will be shown.  Make any desired changes. Any values that you edit will have their labels turn green, as in the worker_description field to the right.

    Clicking OK will save the changes to the central worker configuration, at which time the Supervisor will automatically instruct all workers to re-request their configuration from the Supervisor.  No Supervisor or Worker restart is necessary.  Any Workers not currently running will receive the changes when they next start up.

    Column
    width40%

    Image Modified

    ...

    Manually Editing the File

    An administrator can also edit the qbwrk.conf file manually. Here are the steps:

    1. Create the qbwrk.conf file if it doesn't already exist, on the Supervisor machine in the correct location:
      1. Linux & OS X:

    ...

      1.             /etc/qbwrk.conf
      2. Windows Vista and above:   C:\ProgramData\pfx\qube\qbwrk.conf 
      3. Windows XP:

    ...

      1.              C:\Program Files\pfx\qube\qbwrk.conf
    2. Edit the qbwrk.conf file with a text editor using the

    ...

    1. format described

    ...

    1. below.
    2. Validate the qbwrk.conf file using the

    ...

    1. command. More details on this page.
      $ qbconfigfile <qbwrk file location>

    2. Push the settings to the Workers using the

    ...

    1. command

    ...

    1. $  qbadmin worker --reconfigure

      Note

    ...

    1. it may take a few minutes to perform this action if the farm is large.

    See Also

    qbwrk.conf File Format
    Validating the qbwrk.conf File

    supervisor_worker_configfile