wx hosts

Show hosts in the farm. The hosts are also called taskers or vovtaskers.


wx: Usage Message

WX HOSTS
    Show taskers that are currently in the cluster along with tasker metadata.

    The default output includes:
    NAME LOAD STATUS RUN/SUSP SLOTS HEARTBEAT RESERVATIONS MESSAGE

    Each tasker takes on the name of its host by default.

    The "RUN/SUSP" column shows running jobs and suspended jobs,
    respectively.

    The "SLOTS" column shows total job slots.

    The heartbeat is the age of the most recent heartbeat received by the
    vovserver for that specific tasker.

    The reservations column shows shorthand representations for who or what
    the tasker is reserved and the time remaining for the reservation. The
    shorthand format is TYPE:NAME, where TYPE is one of:
    G (group), I (ID), B (bucket), C (jobclass), P (project), or U (user).

USAGE:
    % wx hosts [OPTIONS]

OPTIONS:
    -h              -- This help
    -c              -- Show consumable resources (e.g. RAM and CPUs)
    -f              -- Show list of tasker fields
    -r              -- Show status and resources for each tasker
    -rl             -- Show resources (legacy: pre-2013.03 format)
    -m              -- Show machine parameters (RAM, CPUfreq, ...)
    -a              -- Show all known hosts (used with -m)
    -hw <HW>        -- Show only taskers that match HW constraints.
    -rule <SELRULE> -- Show only taskers that match the given selection rule.
                       Use "vovselect fieldname from taskers" for the complete
                       list of fields that can be used in the rule.
                       Example rules:
                            "status==READY"
                            "status!=OVRLD slots>8"
                       Can accept multiple constraints.
    -O <fmt>        -- Specify output format. The format string can contain
                       elements like @FIELDNAME@ or @FIELDNAME:WIDTH@ where
                       a negative width means left-align and a positive width
                       means right-align.
    -RAM            -- Same as -O "@NAME@ RAM/@RAM@ RAMFREE#@RAMFREE@
                                   RAMTOTAL#@RAMTOTAL@"
    -SLOTS          -- Same as -O "@NAME@ SLOTS/@SLOTS@ SLOTSTOTAL#@SLOTSTOTAL@
                                   CORES/@CORES@ CORESTOTAL#@CORESTOTAL@"
    -LOAD           -- Same as -O ...selection of fields about load...
    -INFO           -- Same as -O ...fields about host, arch, model, ...
    -ALL            -- Show resources for each tasker
    -slowdown       -- Used only for testing

EXAMPLES:
    % wx hosts
    % wx hosts -m
    % wx hosts -a -m
    % wx hosts -hw 'RAMTOTAL>18000'
    % wx hosts -f
    % wx hosts -O "RAMFREE#@RAMFREE@ SWAP/@SWAP@ M=@MODEL@"
    % wx hosts -O "@I:4@ @NAME:-14@ @STATUS:-8@ @HOST@ "
    % wx hosts -RAM
    % wx hosts -hw 'RAMTOTAL>18000' -RAM
    % wx hosts -ALL | grep -A8 ^lnx001
    % wx hosts -rule "cores>4 ramtotal<20000" -O "@name@ @corestotal@"