IPP Software Navigation Tools IPP Links Communication Pan-STARRS Links

Changes between Version 1 and Version 2 of pantasks_controller_interactions


Ignore:
Timestamp:
Oct 4, 2012, 1:09:00 PM (14 years ago)
Author:
eugene
Comment:

--

Legend:

Unmodified
Added
Removed
Modified

  • pantasks_controller_interactions

    v1 v2  
    1010=== Some terminology ===
    1111
    12 * controller : the abstract concept of the software or system which
    13   manages parallel jobs for pantasks.
     12 * controller : the abstract concept of the software or system which
     13   manages parallel jobs for pantasks.
    1414
    15 * pcontrol : the default (Ohana-native) controller implementation
     15 * pcontrol : the default (Ohana-native) controller implementation
    1616
    1717=== Pantasks Controller Commands ===
    … …  
    2222pcontrol shell on its own, these commands are called directly.
    2323
    24 * check job (jobID)
    25 * check host (hostID)
     24 * check job (jobID)
     25 * check host (hostID)
    2626
    2727check on the status of a single job or host.  the jobID or hostID is
    … …  
    3838For 'job', the return is of the form:
    3939
     40{{{
    4041STATUS (status)
    4142EXITST (Nexit)
    … …  
    4344STDERR (Nbytes)
    4445DTIME  (elapsed time)
     46}}}
    4547
    4648where:
    4749
    48 (status) is one of PENDING, BUSY, DONE, EXIT, CRASH
    49 (Nexit) is the exit status of the command (ie, as if it were run on
     50 * (status) is one of PENDING, BUSY, DONE, EXIT, CRASH
     51 * (Nexit) is the exit status of the command (ie, as if it were run on
    5052        the UNIX command line).
    51 (Nbytes) is the size of the standard out and standard error buffers
     53 *(Nbytes) is the size of the standard out and standard error buffers
    5254         from the job
    53 (elapsed time) is the number of seconds it took to run the command;
     55 *(elapsed time) is the number of seconds it took to run the command;
    5456         this is only set on exit.
    5557
    56 * exit
     58 * exit
    5759
    5860Tell the controller to exit.  In pantasks, it is necessary to give this command in
    5961the form 'controller exit TRUE'.
    6062
    61 * host [options] : manipulate hosts managed by the controller.  The
    62 following commands may be given:
    63 
     63 * host [options] : manipulate hosts managed by the controller.  The
     64   following commands may be given:
    6465  * host add (hostname) [-threads N] : add a new connection to the host
    6566    (hostname).  The optional -threads N argument specifies the default
    … …  
    6869    that value replaced by "-threads N" for this machine, were N is the
    6970    value specified in this host add command.
    70  
    7171  * host on (hostname) : tell the controller to activate the specified
    7272    host
    73  
    7473  * host off (hostname) : tell the contoller to de-activate the
    7574    specified host
    76  
    7775  * host check (hostname) : check the status of the given host by
    7876    hostname (returns 'host (hostname) is (status)' where (status) is
    7977    one of the list given above for check host
    80  
    8178  * host retry (hostname) : tell the controller to re-attempt a
    8279    connection to the specified machine NOW (if the connection failed,
    … …  
    8582    they may desire to force a connection attempt sooner rather than
    8683    waiting for the timeout to complete).
    87  
    8884  * host delete (hostname) : remove the named host from the list of
    8985    managed hosts.
    … …  
    9995currently off.
    10096
    101 * hoststack (stack) : list the hosts in the given 'stack'.  A
    102   collection of hosts in a given state is called a 'stack' of hosts.
    103   This command lists all of the hosts in one of the stacks.  Stack
    104   names are case-insensitive and may be one of the following:
    105 
     97 * hoststack (stack) : list the hosts in the given 'stack'.  A
     98   collection of hosts in a given state is called a 'stack' of hosts.
     99   This command lists all of the hosts in one of the stacks.  Stack
     100   names are case-insensitive and may be one of the following:
    106101  * IDLE : machines which are currently unoccupied with processing
    107102  * BUSY : machines which are currently active
    … …  
    117112lines each with ID NAME on a single line).
    118113
    119 * jobstack (stack) : list the jobs in the given 'stack'.  Like the
     114 * jobstack (stack) : list the jobs in the given 'stack'.  Like the
    120115  hosts, a collection of jobs in a given state is called a 'stack' of
    121116  jobs.  This command lists all of the jobs in one of the stacks.
    122117  Stack names are case-insensitive and may be one of the following
    123 
    124118  * PENDING : job is waiting for a host
    125119  * BUSY    : job is running on a host
    … …  
    138132  jobs running on another host which requested the given host.
    139133
    140 * parameters : set several pcontrol internal parameters.  this
    141   function lets the user interact with the pcontrol shell and set some
    142   internal state variables. The 3 currently allowed options are:
    143 
     134 * parameters : set several pcontrol internal parameters.  this
     135   function lets the user interact with the pcontrol shell and set some
     136   internal state variables. The 3 currently allowed options are:
    144137  * parameters connect_time (time) : set the maximum time a pclient is
    145138    kept alive before pcontrol attempts to reset the connection (time