Changes between Version 12 and Version 13 of pstamp_2015-04-changes

Timestamp:

Apr 17, 2015, 10:24:30 AM (11 years ago)

Author:

bills

Comment:

--

pstamp_2015-04-changes

@@ -1 @@
-= Changes to the postage stamp server interface and implementation to be made in 2015-April =
+= Changes to the postage stamp server interface and implementation to be made in 2015-April-21 =
 
-While the collection of data for the PS1 Science Consortium has ended PS1 continues to take data. This data is only to be available for members of the new PS1 Consortium. (XXX: name?)
+While the collection of data for the PS1 Science Consortium has ended PS1 continues to take data. For now, this new data is only available for members of the new PanStarrs Consortium PSNC.
 
-Some changes to the operation of the postage stamp system are required to support the new consortium. This page describes the changes. For users who use PSI to submit requests
+Some changes to the operation of the postage stamp system are required to support the new consortium. This page describes the changes. For users who use the PanStarrs Science Interface (PSI) 
+to submit requests
 these changes will be mostly transparent. Users who "roll their own" request files will need to insure that they conform to some new requirements.
 
-Some of the details of this may seem somewhat unexpected. When reading this keep in mind that the postage stamp server is implemented in a distributed maner. There is the
-IPP side and the PSI front end. There are some usage patterns that only use the IPP part. These must continue to be supported. The IPP portion does not have accounts. The PSI side does not manage
-permissions for users. In the end, control of the access to the pixels is through the HTTP server's list of hosts.
+== Beginning 2015-May-05 Postage stamp request files that use version 1 of the request format will no longer be accepted. A version 2 file with a valid email address in the request header will be required ==
 
-== Version 1 of the request file is no longer supported. A version 2 file with a valid email address in the request header is required ==
+The email header word was added in version 2. The system needs the value to determine the submitting user's access rights. The email address is required to be of the form user@domain.
+By default, access rights will be determined from the domain.  Members whose email contains the domain of a member of the new consortium will have access level 2.  The system has 
+a provision to extend access rights for individual users whose PSI accounts use email that does  not contain the instition's domain. For support purposes use of this feature is discoruaged. 
 
-The email header word was added in version 2. The system needs the value to determine which data the user is allowed access to. The email address is required to be user@domain.
-Access rights to data is determined primarily from the domain.   The system has provision to support different access rights for individual users. That feature is envisioned to
-be more of an exceptions list and is not encouraged. 
+At this time no checks are made that an email address in a request submitted outside of PSI actually works. It is treated as a token for determining access rights and for directing the results
+to the correct data store product (see next section). The IPP portion of the postage stamp system does not automatically send any email. 
 
-At this time no checks are made that an email address in a request submitted outside of PSI actually works. It is really more of a token. IPP portion of the system does not automatically send any email. 
+If the email address' domain is unknown to the system. Postage stamp results will be given the default access level 1 unless the specific user has been provided with a
+higher access level. 
 
-If the email address' domain is unknown to the system. Postage stamp results will be given the default access level (1) unless the specific user has been flagged with greater access level.
-A user with the default access level may get results from single frame observations made prior to 2015-03-01. Access to stacks 
-is controlled based on a new column in the ippRelease table in the IPP database. 
+A user with level 1 access will be limited to  single frame observations made prior to 2015-03-01. Access to stacks with this data will be handled using the release tables in the IPP databases.
 
 [wiki:pstamp_version_2_conversion] provides some hints for converting software that creates version 1 request files to version 2.
 
-== The postage stamp images and other results may be directed to a different data store location than previously ==
+Requests from version 1 files received between April 21 and May 5 will only be provided with level 1 access. After May 5 version 1 files will be rejected.
+
+== The postage stamp images and other results may be directed to a different data store location based on the email address ==
 
 Currently most postage stamp results are posted to filesets in a single data store product "pstampresults". This product is accessible through HTTP requests from
-a set list of all the identified PS1SC institutions. In the new implementation each institution will get it's own data store product.  For example requests
-from ifa.hawaii.edu users will go to an ifa specific data store product. Results for users from Durham will go to a directory specific to that institution. Each product will have
+a set list of all the identified PS1SC institutions. In the new implementation each PSNC institution will get it's own data store product.  For example requests
+from ifa.hawaii.edu users will go to an ifa specific data store product. Results for users from QUB will go to a directory specific to that institution. Each product will have
 it's own list of allowable IP addresses.  Certain users (for example MOPS) will have their own data store products.
 
 If the system can't figure out a specific product for the user the results will continue to go to pstampresults.
 
-The data store links that PSI uses will automatically resolve to the new locations.
+The data store links that PSI uses will automatically resolve to the new locations. Users who summit their own files will need to look in the new locations.
+
+If a PS1SC institution would like to have their own data store product let Bill Sweeney know.
 
 === Other implementation changes ===