The following are the official release notes for the MWA ASVO. Changes/fixes are tagged with:
- This item relates to the front end web site of the MWA ASVO and the associated VO TAP service.
- This item relates to the python API and command line client of the MWA ASVO (MWA ASVO: Command Line Client (manta-ray-client)).
- This item relates to the server back-end of the MWA ASVO system, which includes the dispatch service, processor service and cotter.
Status |
---|
subtle | true |
---|
colour | Red |
---|
title | Breaking |
---|
|
This represents a breaking change to existing functionality
19th July 2023
- Changed
copyq
partition to asvo-copyq
partition, Updating the Slurm output logs, and adding birli_manifest to check for better astro filesystem debugging.
4th July 2023
- New feature: If you are the PI of an MWA project/proposal (or an MWA ASVO superuser), you will see a new icon on the "Observations" page called "Request Deletion". If, as a PI, you want to nominate one or many observations from your project for deletion, click on the button and provide a name for the request and the reason for nominating for deletion. At a future date, the details of observations in this (and other) delete requests will be emailed to the MWA collaboration for a 4 week consultation process. If no objection is received in writing by the Director, the request will be approved, and then the data will be deleted. You can view existing Delete Requests by clicking on your profile (name) in the top right and selecting "Delete Requests". You can then view or cancel your delete requests. There are also filters available to manage the list if it becomes too large (useful for superusers especially).
- The 2 new ARDC Collections have been added to the About→Data Collections menu & search options.
24th January 2023
Status |
---|
subtle | true |
---|
colour | Red |
---|
title | Breaking |
---|
|
Following a discussion at the 2022A MWA project meeting, Cotter has been removed from the MWA ASVO entirely. Birli will now be used for all conversion jobs.- Following user feedback, metafits files are now included with the output products of conversion jobs.
Status |
---|
subtle | true |
---|
colour | Red |
---|
title | Breaking |
---|
|
The names of parameters that are passed to conversion jobs have changed.- Users can still use the web frontend to submit jobs
- Users will not need to update the manta-ray-client
- Users will need to update the CSV that they use to submit jobs with the manta-ray-client.
- See here for details MWA ASVO: Command Line Client (manta-ray-client)
27th January 2022
Regarding the deployment itself:
- The manta ray client requires a few changes to make it compatible with the new system. After the deployment, your client will no longer work until it’s updated.
- I have tried to make things backwards compatible as much as possible. However, You may need to make changes to your own scripts and programs to make them compatible with the new client.
- However, we will be updating the client and Docker image on Garrawarla so you don’t have to.
- In order to perform the upgrade, I need to drain the old system of jobs. This means that I will have to clear out the database table on deploy day. Any jobs that are queued up before then will be lost. Any jobs that have been completed before then will still work, but the download link will not be accessible from ASVO itself. If that data is critical for your work, please save a copy of your download links yourself.
Here are some of the new features that will be released:
- Jobs will now be processed on Garrawarla
- Pawsey users will have the option to leave data directly on /astro. These will be left in /astro/[group]/asvo/[job_id]. This means that Pawsey users won't have to download and unzip data before using it.
- If you do not choose this option, you will be given a URL to access your data, much in the same way as the new system. This will be served out from AWS S3, and will eventually be replaced by Pawsey’s new Acacia system once it comes online.
- MWA members can now download data that was processed with the shiny new MWAX correlator.
- You can also process this data using Birli, a Cotter replacement that works with both the legacy and MWAX correlator. However, you can choose whether to use Cotter or Birli when working with legacy data.
- VCS downloads are now supported. However you’ll need to get in touch with an admin or the VCS team if you’re interested in getting access to VCS data.
- You can now batch submit jobs straight from the web frontend, instead of having to download a CSV and submit using the CLI.
Regarding the new /astro data delivery option:
- This option only applies to people who have an account with Pawsey and are in one of the existing MWA groups (mwasci, mwaeor, mwavcs, mwaops)
- Those groups are still responsible for managing their own quota on /astro. If you choose the /astro option and your group doesn’t have enough space, the job will fail. So make sure that you have sufficient quota on /astro before submitting the job.
- To use this option, your ASVO account will need to be configured with your Pawsey group. This needs to be done by an admin, so you’ll need to let me know which group you would like to be attached to this account.
- It might be an idea for each group PI to compile a list of users that should have access to this feature.
A few notes about the new Birli preprocessing software:
- Birli is not quite at feature parity with Cotter, so you may be a little limited in terms of your options for processing MWAX data.
- While Birli does support writing CASA Measurement Sets, this functionality is still experimental and is therefore disabled in ASVO for now, but you can still download the raw files and run Birli yourself if needed. We're hoping to have this fully supported with ASVO within the next few weeks.
- There are a number of other features that are still in development. I suggest that you take a look at the repository here to familiarise yourself with the feature set and interface for using Birli https://github.com/mwatelescope/birli
- Otherwise, Birli is an incredible effort by Derwent and is a stable and performant preprocessor for MWAX and legacy correlator data.
26th November 2020
- Enhancements:
- When submitting jobs from the command line client, it will no longer fail subsequent jobs if one of them has no available files.
24th November 2020
...
The following are the official, recent release notes for the MWA ASVO. For older release notes, see MWA ASVO Past Release Notes.
Changes/fixes are tagged with:
This item relates to the front end web site of the MWA ASVO and the associated VO TAP service. This item relates to the python API and command line clients of the MWA ASVO (MWA ASVO: Command Line Clients). This item relates to the server back-end of the MWA ASVO system, which includes the dispatch service, processor service and cotter. Status |
---|
subtle | true |
---|
colour | Red |
---|
title | Breaking |
---|
|
This represents a breaking change to existing functionality
03 Dec 2024
- update processor to use either native Birli or the singularity version of Birli through the configuration.
05 Nov 2024
- Migrating the processor from Garrawarla to Setonix.
14 Aug 2024
- TAP service is now accessible via https (http will still work though). It is recommended to use https://vo.mwatelescope.org/mwa_asvo/tap instead of http as sometime in the future the http endpoint will be deprecated.
9 Aug 2024
- Allow scratch delivery to deliver as a tar file. User can choose the delivery format as tar when delivery is selected as scratch.
- Fixed bug where birli manifest hash verification was failing.
- vis Allow MWAX_meta jobs are no longer included in the limit of how many concurrent jobs you can have on the queueVCS jobs to specify a range of coarse channels. User can select a range of channels they want to download instead of all the channels.
- Yellow
backend | There is now the option to specify the expiry time of the jobs you would like to download (in days). You may want to do this if you can download jobs as they are completed, which will allow you to download a larger amount of data without having to wait for old jobs to expire before beginning new downloads. - Added a new 'affiliation' field to the signup process.
3rd November 2020
- Enhancements:
RFI Flagging: Users now have more options for how RFI Flagging is handled when submitting new jobs to the ASVO. (Giant-squid): Submitting jobs should be able to continue after the failure of a single job. When multiple jobs are submitted through Giant-squid, a failure in a single job caused it to quit, which is now fixed. Giant-squid now will proceed to the next job if a job fails.
2 Jul 2024
- Fix SQL bug in db.py
- Custom phase centre: Users can how specify a custom phase centre for conversion jobs submitted to the ASVO. Jobs page data fetching logic has been updated
- Fixed blank login page
- Each processing Node will now only take a maximum of 75 jobs from the job queue when booting up. This helps an existing issue where a processor node will grab all jobs on startup (i.e. during Pawsey Maintenance). Migrating Dev environment onto Setonix(on going)
14 May 2024
- Yellow
backend | Users can now only have a maximum of 2000 jobs on the queue at any given time. This was to ensure that we do not exceed our disk limits at Pawsey. Greenweb | The new groupid column has been added to both the MWA ASVO user interface, and our TAP service. Details of this column can be found here TAP mwa.observation Schema and Examples
18 September 2020
- Enhancements: Admin setting: This is an admin feature enables the admin to schedule maintenance , post maintenance message , partially outage some of the jobs. for example, blocking only the jobs that delivers to acacia when acacia is down. This will allow us to keep working parts of the system operational when only one Pawsey component is offline or not working.
- Added visual effects to the observations search page to indicate whether a particular observation is embargoed and unavailable for download. Green
web | Added stronger client-side validation on the web to give the user feedback before submitting a job, instead of having it fail when it becomes added to the processing queue Added ORCID field to the registration and my profile, this is an optional field. Existing users can go to their profile and update their ORCID. We capture ORCIDs from users to better understand how MWA data is used by researchers. web | Users can now update their profile information (username, email address, name) as well as generate a new API key. Modified the MWA Metadata file query, which should reduce the number of "file number mismatch" errors when submitting jobs Allow users to unsubscribe from email status updates from MWA ASVO team. The user can go to their profile and uncheck the option to opt out. We will only send status emails when there is a major issue or disruption to users.- Yellow
backend | Changed the options passed to cotter in order to make it use a defined amount of memory and number of CPUs.
12 August 2020
- Enhancements:
- BUG Fix: when submitting conversion jobs from the web client, the flags were not working correctly, this has been resolved now.
4 August 2020
- Enhancements: Green
web | The MWA ASVO web frontend has been re-built in ReactJS. Much of the frontend looks similar (with some minor UI improvements), however the major change comes with the Observations Search page. Users can now search for observations using many more additional fields, which more closely resemble the data contained in our TAP service.
7 July 2020
- Enhancements:
- Users may now register / login to the MWA ASVO using their Data Central account.
28 May 2019
- Fixes:
- The default cone search now correctly confines search results to the search radius provided. It previously was including many more results than it should.
23 January 2019
- Enhancements:
- Minor change- moved the "Acknowledging MWA Data and Tools in Publications" section from the "Support" page to the "About" page to make it easier to find.
22 January 2019
- Enhancements: Allow resubmission / retry of completed or errored or cancelled jobs.
- Retry feature: For failed or cancelled voltage jobs, "retry" allows a partially completed voltage job to be resumed from where it left off. (via web front end only).
- Resubmit: All type of jobs that are failed or cancelled or completed can be resubmitted using the same parameters.
- Use -ar, --allow-resubmit to resubmit the jobs through the manta-ray-client CLI
- Use -r, --allow-resubmit to resubmit the jobs through the giant-squid CLI
- giant-squid CLI now has a new download command line argument
--download-dir
. This allows the user to specify which directory to download data to. If omitted, it will default to the current working directory ('.') which was the behaviour prior to this release. - The actual data transfer when downloading via the manta-ray-client or via wget / web browser is now unencrypted http traffic. NOTE: the URL you use still contains "https" however, the server will redirect you to a http URL of the server the files reside on. This should prevent firewalls from dropping encrypted traffic and also provide a modest efficiency/throughput increase.
12 December 2018
- Enhancements:
- New registration / login option:
- You may now log in with your own institution account via a federated identity system.
- Existing users with MWA ASVO accounts may continue to log in with them, as normal.
- Existing MWA ASVO account users may also log in via their own institution. This utilises the MWA identity management framework that allows users to log on via thousands of different institutions via the Australian Access Federation (AAF) and the international federation: eduGAIN.
- If you log in with a federated identity for the first time, you will be asked to go through a short one-time enrolment process to confirm your details and confirm your email address.
- If you are a current Phase 2 member of the MWA Collaboration and you have already enrolled with a particular login provider / institution as part of that process, then you will not need to enrol again, just log in.
- Phase 2 MWA Collaboration members will also automatically have access to data as per the MWA Data Access Policy.
- Calibration:
- Conversion jobs now have the option of finding and applying a calibration solution so it returns a calibrated measurement set or uvfits file. This output can then be used in standard radio astronomy tools for analysis / imaging (e.g. CASA, WSClean, etc)
- From the website, just tick the "calibrate" check box; or via the mwa_client / API add "calibrate=true" to your conversion job options.
- If an appropriate calibration solution exists for the observation, the MWA ASVO will provide you with a measurement set or uvfits file which has the calibration solution applied.
- If an appropriate calibration solution cannot be found for the observation then the job will fail. However, the system will add that observation to the top of the queue for calibration. Try the job again in 24-48 hours and the calibration solution is likely to be available.
- NOTE: not all observations have calibration solutions, yet- this is something the MWA ASVO team are working on completing in the next few weeks.
- For more information about the calibration feature please see: Data Access > MWA ASVO Calibration Option.
Status |
---|
subtle | true |
---|
colour | Red |
---|
title | Breaking |
---|
|
manta-ray-client now uses an API key for authentication:- You will need to obtain the newest version of the manta-ray-client (mwa_client and API).
- API key now replaces username/password for the API and mwa_client.
- ASVO_USER and ASVO_PASS environment variables are no longer used and should be removed from your .profile or .bashrc.
- MWA_ASVO_API_KEY environment variable is now used to authenticate with the API / mwa_client.
- Find your API key from your "Profile" on the MWA ASVO website- it has been auto-generated for you already and then set your MWA_ASVO_API_KEY environment variable to it.
- The mwa_client and API now checks the API version on the server and if your client is out of date you will receive an error message asking you to get the latest version.
- UI improvements:
- Verification and welcome emails now have html formatting for email clients that support it.
- All help and documentation for the MWA ASVO has been moved to this wiki.
- Minor look and feel improvements to the underlying web page template.
- Fixes: Cosmetic changes: Date formatting; redirect to home after password reset; error message handling; removed some deprecated code; removed a column an internal table data_files that was no longer needed.
- Distinguish between different job types in SLURM queue.
- Visibility Download jobs are named
{MWA ASVO jobid}vis
- Voltage Download jobs are named
{MWA ASVO jobid}volt
- Conversion jobs have several steps:
- Download data step jobs are named
{MWA ASVO jobid}convdload
- Birli step jobs are named
{MWA ASVO jobid}convbirli
- Delivery of data step jobs are named
{MWA ASVO jobid}convdelivery
- Cleanup/Error step jobs are named
{MWA ASVO jobid}converror
05 March 2024
- Refining the way we choose different VSS server when attempt fails downloading from Banksia
- staging only required files from Banksia for VCS and Visibility meta jobs - to decrease the waiting time of a job in the queue.
- Add download and upload throughput measurements to processor logs to find the speed of download.
- Fixing sorting issue in admin interface.
18 January 2024
- Package updates: Python packages are updated from 3.8 to 3.11 except processor.
- Package updates: React is updated to v18 except axios.
- Removal of /astro as a delivery option and processing. Please be aware that the /astro option will be removed from ASVO after the January 18th release. If any jobs with the delivery option as /astro were submitted just before the release, they might encounter issues after Pawsey removes the /astro filesystem on the 22nd. Also, any job data that is left in astro will be lost.
- UI / UX changes: fixed in search button observation page , filtering issue in jobs page.
- log in locally using email address.
- fixing permission issues with readme.
13 December 2023
- Fix delete request filter issues
- Remove column "Flags" from search results grid
- Priority penalty for ASVO jobs according to the Env
29 November 2023
- Fix to download VCS data directly into the delivery location.
22 November 2023
- Clicking the link in the email verification email sent during the registration process now correctly informs you that your verification was successful. Removal of SSO Login
title | web |
When user submits data in a form e.g. registration, errors are more clearly highlighted in the browser.
5 September 2018
- Enhancements: New login page
- The cone search now has a checkbox. When unchecked, it will perform a strict cone search against the observation pointing. When checked (this used to be the default behaviour), the cone search will show any results where the cone is anywhere within the primary beam. This will mean you get a lot more results than the strict cone search. Scratch Delivery option
- Restrict SSO Login from ASVO CLI clients
- Binding Scratch to SLURM
- manta-ray-client and giant-squid will support scratch delivery option
07 November 2023
- Added new wiki URLs.
- Blue
client | Conversion jobs now have the option to apply a unity bandpass correction. This is equivalent to the cotter “-sbpassband” option. Ticking the box will effectively cause the MWA ASVO to not apply the corrections by passing all 1’s to cotter.
24 July 2018
- Enhancements: Internal admin page, user activation and security fixes.
- Blue
client | new command line option: -e <error_file> | --error-file=<error_file> | --errfile=<error_file>. This allows users to specify a file which all job-related errors are written to in a machine-readable format (JSON). This is to make it easier for users to write batch processes to submit, download and track MWA ASVO jobs. New MWAX voltage download validations. - Hash Manifest of files created by Birli.
- Restricting Jobs from SSO users.
03 October 2023
- Blue process command line arguments
client | mwa_client now uses the argparse module instead of the deprecated optparse module to Frontend / REACT refactor. - Blue
client | Command line option -w | --download-only= now accepts "all" as well as a job id of 0 to mean- download any jobs which are available for download.
26 June 2018
- Fixes
Registration of new account via single sign on (SSO) has been removed. See: Removal of Single Sign on for MWA Services for more info. - changed the way internal worker processes communicate, in order to prevent the stdout errors such as "Invalid file object..." when running jobs.Enhancements: v1 of Admin interface merged into main website for superusers.
- Greenweb all new Conversion job products will now have their sha1 hash calculated (you can see it under the "Download" button). To verify the integrity of your download, use an sha1 tool (for example sha1sum <filename>) to compare the expected versus the actual checksumnow ship a manifest file containing the filenames and sha1 checksum before the files are delivered to /astro or Acacia so filesystem errors can be more easily detected by users.
- Blue mwa_client when a download completes.
client | the sha1 hash is now displayed in the Backend logs now contain more information about the Banksia endpoint used to download data from tape in order to allow easier debugging when there are issues.
05 September 2023
- Blue
client | the mwa_client will now display the file size (in bytes) of completed jobs along side the other job information when using the -l (--list-only) option
24 June 2018
- Enhancements: Many minor text changes, fixes and updates to the static pages of the MWA ASVO website.
- Updated calibration option text and tooltip.
- Blue
client | new command line options for mwa_client, allows you to submit jobs and exit (-s); list your jobs and exit (-l); download a job (-w JOBID); download all your jobs (-w 0). It still supports submitting, monitoring and blocking until all downloads are complete as it did before. See manta-ray-client github for the new options and examples Removed twitter widget from front page and replaced with text and a link to our outages page, as there is still no fix from X. - Blue
client | added an "example.csv" template to make it easier for new users to craft a csv file Profile page: Added list of projects that user is a PI of to profile page. These are the projects where you are able to submit delete requests. - Blue
client | minor updates to the output text, including a new option (-v) to show verbose output.
20 June 2018
- Fixes: Profile page: Show user ID, superuser status and MWA Member status.
- Profile page: Show list of projects the user has special permissions for.
- Accessing a web page which requires the user to be logged in will now take them to a login page Observations (search) page: MWAX_BUFFER has been added to the "Correlator Mode" dropdown (and corresponding "ANY VCS" option.
- On query page, "project" drop down is now sorted correctly and includes a short description (which is also searchable Observations (search) page: New search criteria: "Archived Data Files"- a range allowing you to restrict results to only those observations with that many data files (note: Metafits files or flags are NOT included in that number).
- Fixed an issue where the "Jobs" page and the manta-ray-client did not allow the use of a non-integer time resolution setting. e.g. 0.5 would result in an error: "Time resolution not of type integer" Observations (search) page: New search criteria: "Archived Data Size"- a range allowing you to restrict results to only those observations with that total size of data (note: Metafits files or flags are NOT included in that number). Choose units (B, KB, MB, GB, TB). NOTE units are SI/metric prefix not binary prefix.
- Fixed an issue where the query form is not showing all observations when performing a search. Fixed an issue where rerunning the manta-ray-client with the same csv file produces multiple jobs (which are all the same except for the order of the parameters), instead of 'reconnecting' to the existing job(s) Observations (search) page: "Total archived data bytes" now provides a human readable value instead of a huge unformatted number of bytes. E.g 1234567890 bytes will be shown as 1.2 GB. NOTE units are SI/metric prefix not binary prefix.
- Yellow
backend | Fixed several issues when closing down processes Observations (search) page: issues with the search table's pagination have now been fixed. - The processor will explicitly ignore files in the archive which are not required for the data job. This will prevent errors like this: "MWA: 50 and NGAS: 51 file number mismatch; ignoring: 1066572736" from occurring.Enhancements: New user registration info will now also include the Institution/affiliation, allowing admins to more easily approve new users.
01 August 2023
- Green Updated look and feel.
web | Various OS patches - Green Changed font to be much more readable for numbers.
web | SSL certificates updated Green | title | web |
We've added a twitter feed (@mwa_asvo) to the front page which will be used to update users of any service status changes or issues to the MWA ASVO If an internal server error occurs with status code 500. It will try an alternative webserver before giving an error.- Greenweb Dates are now displayed in ISO 8601 format Logging messages are updated with descriptive messages and provide absolute paths for jobs.
- Green Added Change Password feature
web | Added MWA_ASVO_README.md to downloaded files. Now, users will have a new file in their downloads that gives information about MWA ASVO. - Green
web | On query page, "from date" can be searched without "to date" and vice-versa. Upon registering, users will now be shown a message box telling them their registration is successful and that they will need to verify their email address. This should prevent users from clicking register multiple times giant-squid client now supports voltage jobs (note: usual restrictions apply- please Contact Support if you need to be able to download voltages) - ASVO is added with filters in the "My Jobs" page for Job type and status.
- Added information about compliance with privacy policy.
30 May 2018
- Fixes: Total Archieved Bytes(Size of observation) in the Observations page is formatted.
- Blue
client | Added keyboard interrupt handler to the mwa_client to prevent nuisance error messages when sending Ctrl-C key sequence.Enhancements: Blueclient | Made white text in mwa_client brighter. Pre-submission validations are added in both web-UI and the backend to capture pre-processor errors in advance.
26 July 2023
- Blue
client | mwa_client now ignores lines beginning with # so you can now comment your csv files.
23 May 2018
- Fixes:
- Modified prerequisites so it includes a minimum version number of the "requests" package. Users reported that using "requests" package below version 2.18.3 was causing errors.
26 February 2018
- Fixes: Birli version bumped to v0.9.2 which resolves an issue where CASA measurement sets created by Birli may contain files which have a last access time in 2021. This was causing issues for users who are on filesystems with a purge policy which deletes those files as they are too old. Now Birli writes the files with up to date timestamps.
21 July 2023
- Green
web | VO TAP service returns correct output for availability and capabilities; also is now MWA branded.
12 February 2018
- Fixes: manta-ray-client now prints the line/job number with submission issues in order to make finding and fixing issues in the csv file easier.
19th July 2023
- Processor now ignores directory structure of flag file when unzipping which was causing issues for some older observations.
9 February 2018
- Enhancements: Changed
copyq
partition to asvo-copyq
partition, Updating the Slurm output logs, and adding birli_manifest to check for better astro filesystem debugging.
4th July 2023
- Yellow
backend | The processor now uses a round robin user queue for processing jobs. This means if user A submits 100 jobs and, a few minutes later, user B submits 2 jobs, then it will alternate between processing A's and B's jobs such that user B is not waiting for user A's jobs to finish before user B's jobs start. Instead it would process them: A, B, A, B, A, A, A... and so on. This will result in a much more fair allocation of jobs for users. - If the processor is shutdown, it will now re-queue the job.
7 February 2018
- Enhancements:
- Added buttons on the query results page to allow export of the results to csv format so they can be used as inputs to the manta-ray-client.
- Jump out of mwa_client earlier and report error, if there are no jobs specified in the csv file.
mwa_client will ignore empty rows in csv file New feature: If you are the PI of an MWA project/proposal (or an MWA ASVO superuser), you will see a new icon on the "Observations" page called "Request Deletion". If, as a PI, you want to nominate one or many observations from your project for deletion, click on the button and provide a name for the request and the reason for nominating for deletion. At a future date, the details of observations in this (and other) delete requests will be emailed to the MWA collaboration for a 4 week consultation process. If no objection is received in writing by the Director, the request will be approved, and then the data will be deleted. You can view existing Delete Requests by clicking on your profile (name) in the top right and selecting "Delete Requests". You can then view or cancel your delete requests. There are also filters available to manage the list if it becomes too large (useful for superusers especially).- The 2 new ARDC Collections have been added to the About→Data Collections menu & search options.
24th January 2023
Status |
---|
subtle | true |
---|
colour | Red |
---|
title | Breaking |
---|
|
Following a discussion at the 2022A MWA project meeting, Cotter has been removed from the MWA ASVO entirely. Birli will now be used for all conversion jobs.- The generated metafits file passed to the cotter process is now included in the output zip file for Following user feedback, metafits files are now included with the output products of conversion jobs.
18 January 2018
- Enhancements:statusGreen
web | Change from displaying channel number to channel frequency in search results.
27 December 2017
- Initial release The names of parameters that are passed to conversion jobs have changed.
- Users can still use the web frontend to submit jobs
- Users will not need to update the manta-ray-client
- Users will need to update the CSV that they use to submit jobs with the manta-ray-client.
- See here for details MWA ASVO: Command Line Client (manta-ray-client)