IPP Software Navigation Tools IPP Links Communication Pan-STARRS Links

Changes between Version 1 and Version 2 of Pantasks_FAQ


Ignore:
Timestamp:
May 14, 2009, 1:46:33 AM (17 years ago)
Author:
Sebastian Jester
Comment:

reformat for trac

Legend:

Unmodified
Added
Removed
Modified
  • Pantasks_FAQ

    v1 v2  
    44==== How do I start pantasks? ====
    55start up pantasks from a terminal window
     6{{{
    67 > pantasks
    78 
     
    1011load some pantasks commands
    1112 pantasks: module pantasks.pro
    12 
     13}}}
    1314or, if you have a modified pantasks.pro file
     15{{{
    1416 pantasks: input /home/username/pantasks/pantasks.pro
    15 
     17}}}
    1618After loading the pantasks.pro file, you can add a database easily:
     19{{{
    1720 pantasks: add.database mydatabase
    18 
     21}}}
    1922If you don't add a database, pantasks will use the one declared in your .ipprc file.
    2023
     
    2730
    2831Connect to a controller host
     32{{{
    2933 pantasks: controller host add myhost
    30 
     34}}}
    3135Check the controller host status (NOTE: This will sometimes return no info, even when there are active hosts):
     36{{{
    3237 pantasks: controller status
    33 
     38}}}
    3439Check the processing status:
     40{{{
    3541 pantasks: status
    36 
     42}}}
    3743For additional timing details:
     44{{{
    3845 pantasks: status -taskstats
    3946 
    4047Start processing:
    4148 pantasks: run
    42 
     49}}}
    4350Stop adding new processes, but finish out the queue :
     51{{{
    4452 pantasks: stop
    45 
     53}}}
    4654Stop processes right now :
     55{{{
    4756 pantasks: halt
    48 
     57}}}
    4958Exit pantasks :
     59{{{
    5060 pantasks: exit
    51 
     61}}}
    5262
    5363==== How do I get more verbose output from pantasks? ====
    5464
     65{{{
    5566 pantasks: $VERBOSE = 1
    56 
     67}}}
    5768Raise the number above 1 for more and more verbosity.
    5869
     
    6475In your .ipprc file, you may have defined the path to your configuration directory with something like this:
    6576
     77{{{
    6678 PATH            STR     /path/to/my/system/level/ippconfig
    67 
     79}}}
    6880So in your system.config file you can define the directory for your GPC1 camera.config file with this line:
    6981
     82{{{
    7083 CAMERAS                METADATA
    7184        GPC1                    STR     gpc1/camera.config
     
    7386 
    7487so when you run any script that needs to reference the GPC1 camera it will look
    75  * first in the current directory for ./gpc1/camera.config
     88}}} * first in the current directory for ./gpc1/camera.config
    7689 * next in the directory defined by your .ipprc PATH variable (in this case /path/to/my/system/level/ippconfig/gpc1/camera.config)
    7790
     
    8396
    8497 * First, check that you can ssh from the machine on which you are running pantasks to the node without being prompted for a password and without errors reading your shell startup file (.bashrc, .cshrc, .profile, .login and the like):
     98{{{
    8599  * Try "ssh myhost"
    86100  * If you're prompted for a password, then you need to set up ssh keys, and/or check your ssh configuration.
    87  * Second, check that you can start up 'pclient' over an ssh connection. For that to work, you need to run 'psconfig ipp-2.6.1' (or whatever the IPP version is called on your system) in your startup file.
     101}}} * Second, check that you can start up 'pclient' over an ssh connection. For that to work, you need to run 'psconfig ipp-2.6.1' (or whatever the IPP version is called on your system) in your startup file.
     102{{{
    88103  * Try "ssh myhost pclient". If it works, you can exit pclient with "exit" or "quit".
    89104  * If it doesn't work, you need to check your shell configuration (.cshrc or .bashrc) to ensure the IPP environment is being loaded via psconfig. In .cshrc, just make sure that 'psconfig ipp-2.6.1' is executed. In .bashrc, there's a catch: bash doesn't let you use an alias in the same file that defines it, so you need to expand the 'source'  by hand in .bashrc, thus (this fix will be included in the INSTALL instructions in releases post 2.6.1.):
     
    94109    alias psconfig='echo psconfig not available'
    95110 fi
    96  * If there is a long delay between executing the "ssh" command and the shell appearing, there may be a timeout problem.
     111}}} * If there is a long delay between executing the "ssh" command and the shell appearing, there may be a timeout problem.
     112{{{
    97113  * Make sure your shell configuration is not too complex.
    98114  * One bash user had the IPP environment being set up in both .bashrc and .cshrc, so that psconfig was being called first when bash started, and then again on starting psconfig (which is a csh script).  This produced a long delay, causing the command to time out in pantasks.
    99  * Finally, this can also be triggered by the readline bug, whose fix is described below under [wiki:#detrend_resid_imfile.pl_triggers_the_error_message_'Unknown_option:_--erbose' detrend_resid_imfile.pl triggers the error message 'Unknown option: --erbose']
     115}}} * Finally, this can also be triggered by the readline bug, whose fix is described below under [wiki:#detrend_resid_imfile.pl_triggers_the_error_message_'Unknown_option:_--erbose' detrend_resid_imfile.pl triggers the error message 'Unknown option: --erbose']
    100116
    101117==== On startup I get "can't find config file. some functions will be unavailable."  Which config file is missing? ====
     
    105121==== How do I re-run files that have failed at some stage after fixing the bug that caused the failure? ====
    106122
    107 Most of the <code>ippTools</code> binaries (which provide the database interaction) have some version of a <code>-revert</code> command.  For example, if a camera stage failed, try <code>camtool -revertprocessedexp -cam_id 12345</code>.  You can also revert based on an error code using the <code>-code</code> argument.
     123Most of the `ippTools` binaries (which provide the database interaction) have some version of a `-revert` command.  For example, if a camera stage failed, try `camtool -revertprocessedexp -cam_id 12345`.  You can also revert based on an error code using the `-code` argument.
    108124
    109125==== Process X succeeded without fault, but it is not moving on to process Y.  How do I force it to proceed? ====
     
    113129If the process really just stopped without raising a fault and without initiating the next stage, then you can try manually setting its state to 'full' and using the appropriate ippTool to initiate the next process in the sequence.   For a stalled chipRun with chip_id 2591, this would be done like this:
    114130
    115 <pre>
     131{{{
    116132chiptool -dbname myDatabase -updaterun  -label 'myLabel' -chip_id 2591 -state full   
    117133
    118134camtool -dbname myDatabase -definebyquery -chip_id 2591 -set_label 'mylabel'
    119 </pre>
     135}}}
    120136
    121137
     
    124140The dropped character in a long line is a classic symptom of a bad 'readline' library.
    125141To fix it, do:
    126 <pre>
     142{{{
    127143% pschecklibs -build -force libreadline
    128 </pre>
     144}}}
    129145There should be no need to rebuild the IPP (since we're using dynamic libraries)
    130146