You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 6 Next »

NOTE: This an updated version of the original page for the upcoming WS 2.5 version. The new features mentioned here are currently on WS-Dev and WS-Test but not production.

This guide is intended for DAs and AODs using the workspaces capabilities for VLA calibration and imaging, initially for the pilot. For the pilot, we will be selecting EBs from specified projects (TBD) to be run through (and warn the PIs!). Auto-calibration is not yet running (question).

Step-by-step guide for pilot (WS 2.0)

  1. Go to https://ws.nrao.edu/workspaces/active-requests (do NOT log in, this is not required and will break your session) and enter the EB to be processed in the "SDM ID" box at the top, hit the "Calibrate" button. Make sure Auto-calibration button at the top right is set to run (this has nothing yet to do with the automatic start of jobs, which is controlled by the CAPO profile*).
  2. The job should appear in the job list with a status of "executing". Select the job by clicking the request on the left-hand column, this should open a request page.
  3. You should be able to see the working directory in lustre for the request in the Version Parameters section of the request page. You can click on the text to copy it.
  4. At any point prior to QA you should set the SRDP status to T/F with the checkbox and assign a DA (yourself) and an AOD to the job. 
  5. When complete, the status will change to "Awaiting QA". Click the link to the request page in the "Request" column, or the link the email to Workapsaces-Analysts, which will take you to the request page.
  6. Follow the link to the weblog and perform QA (if you need to you can go to the working directory on spool using the directory name from step 4).
  7. On the bottom right is a button to edit the DA notes, these notes persist between versions and are not seen by the user.
  8. If you need to add flags, click "Create new version" on the bottom right of the page, and upload a flagtemplate.txt file. You can either submit one with the commands in, or submit a blank file (touch <FSID>.flagtemplate.txt) and edit in the editor.
  9. If you need to edit the PPR, this is also accessible to edit at this stage.
  10. Select the latest version on the drop-down menu under "Versions", then click "Submit new version". The old version remains and you can toggle between them using the dropdown menu. 
  11. When you are satisfied, edit the QA notes and inform the AOD e.g. via mattermost  that a job is ready for QA. 
  12. AOD role: check the calibration, the QA notes and that the SRDP status is set correctly. If satisfied, hit QAPass. QAPass will pass the current selected version and fail all the others. If not, you can return to the DA after adding comments in the DA notes. The execution state should change to "Ingesting", then "Complete".
  13. AOD role: if the data are SRDP wait for the calibration ingest to complete, then hit the "Create Image request" button. Go back to the active-requests page, select std_cms_imaging from the top-left menu. Set the DA and AOD to the same people as the calibration request, and status to SRDP.
  14. AOD role: Submit the image request  (bottom right button on the image request page).
  15. Once the imaging is complete, the state will change to "Awaiting QA". The DA should watch the image queue for their datasets to check for new job completions.
  16. Weblog review can be carried out in the same way as for calibration. Note the "Launch CARTA session" capability that can be used to inspect the image data.
  17. Once satisfied, edit the QA notes and let the AOD know that the image is ready for review via Mattermost.
  18. AOD role:  If satisfied, check the QA notes and click "QA Pass" and an email will be sent to Workspaces-Analysts to say that the data were ingested.

*need to set edu.nrao.workspaces.StandardCalibrationSettings.runState = PAUSE, not STOP in /home/casa/capo/dsoc-prod.properties))



Command line tools 

There are several command line utilities that SSA have written to help with e.g. diagnosing issues. They are described on https://ssa.gitlab-pages.nrao.edu/workspaces/source/tools.html

They are located in /lustre/aoc/cluster/pipeline/dsoc-prod/workspaces/sbin and need to be run as vlapipe on mcilroy in the dsoc-prod environment (activate_profile dsoc-prod)

wf_inspector <req number> -v <version number> will log into the running job.

  • No labels