Virtual sites are a mechanism to arbitrarily group service endpoints together. The service endpoints themselves will still belong to (non-virtual) sites. This feature has originally been requested at https://rt.egi.eu/rt/Ticket/Display.html?id=987.
A service endpoint may belong to many virtual sites and a virtual site may have many child service endpoints. The existing cardinality between (non-virtual) sites and service endpoints remains: a service endpoint may only have one parent (non-virtual) site.
Virtual Site Entity
A virtual site is a new GOCDB entity containing the following information:
- Contact E-Mail
- Monitored flag (Y/N)
- Child service endpoints
- Roles held over the virtual site
We will introduce two new PI queries containing virtual site information:
- vsitename - Only return info for a specific virtual site
- scope - Only return virtual sites that are (In)visible to EGI
Example Output: <?xml version="1.0"?> <RESULTS> <VIRTUAL_SITE PRIMARY_KEY="157G0"> <NAME>ALL_OPS_TOOLS</NAME> <DESCRIPTION>All central instances of the EGI operational tools</DESCRIPTION> <EMAIL>John.Casson@stfc.ac.uk</EMAIL> <MONITORED>Y</MONITORED> <GOCDB_PORTAL_URL>https://gocdb4.esc.rl.ac.uk/portal/index.php?Page_Type=View_Object&object_id=21960&grid_id=0</GOCDB_PORTAL_URL> <SERVICE_ENDPOINT> <HOSTNAME>goc.egi.eu</HOSTNAME> <GOCDB_PORTAL_URL>https://gocdb4.esc.rl.ac.uk/portal/index.php?Page_Type=View_Object&object_id=21956&grid_id=0</GOCDB_PORTAL_URL> <SERVICE_TYPE>egi.GOCDB</SERVICE_TYPE> <HOST_IP>126.96.36.199</HOST_IP> <IN_PRODUCTION>Y</IN_PRODUCTION> <NODE_MONITORED>Y</NODE_MONITORED> <GOCDB_PORTAL_URL>https://gocdb4.esc.rl.ac.uk/portal/index.php?Page_Type=View_Object&object_id=21960&grid_id=0</GOCDB_PORTAL_URL> </SERVICE_ENDPOINT> <SERVICE_ENDPOINT> <HOSTNAME>grid-monitoring.egi.eu</HOSTNAME> <GOCDB_PORTAL_URL>https://gocdb4.esc.rl.ac.uk/portal/index.php?Page_Type=View_Object&object_id=21960&grid_id=0</GOCDB_PORTAL_URL> <SERVICE_TYPE>egi.SAM</SERVICE_TYPE> <HOST_IP /> <IN_PRODUCTION>Y</IN_PRODUCTION> <NODE_MONITORED>Y</NODE_MONITORED> <GOCDB_PORTAL_URL>https://gocdb4.esc.rl.ac.uk/portal/index.php?Page_Type=View_Object&object_id=21960&grid_id=0</GOCDB_PORTAL_URL> </SERVICE_ENDPOINT> </VIRTUAL_SITE> </RESULTS>
<?xml version="1.0"?> <results> <SITE ID="1" PRIMARY_KEY="194G0" NAME="RAL-LCG2"> <PRIMARY_KEY>194G0</PRIMARY_KEY> <SHORT_NAME>RAL-LCG2</SHORT_NAME> <GOCDB_PORTAL_URL> https://next.gocdb.eu/portal/index.php?Page_Type=View_Object&object_id=1133&grid_id=0 </GOCDB_PORTAL_URL> <OFFICIAL_NAME>RAL, GridPP Tier-1 Computing, Oxfordshire UK</OFFICIAL_NAME> <SITE_DESCRIPTION>Rutherford Appleton Laboratory - Tier1</SITE_DESCRIPTION> <HOME_URL>http://mywebsite.com</HOME_URL> <CONTACT_EMAIL>email@example.com</CONTACT_EMAIL> <CONTACT_TEL>+44 (0) 1235 446777 </CONTACT_TEL> <ALARM_EMAIL>firstname.lastname@example.org</ALARM_EMAIL> <GIIS_URL> ldap://site-bdii.gridpp.rl.ac.uk:2170/mds-vo-name=RAL-LCG2,o=grid </GIIS_URL> <TIER>2</TIER> <COUNTRY_CODE>GB</COUNTRY_CODE> <COUNTRY>United Kingdom</COUNTRY> <ROC>UKI</ROC> <SUBGRID>Tier1A</SUBGRID> <PRODUCTION_INFRASTRUCTURE>Production</PRODUCTION_INFRASTRUCTURE> <CERTIFICATION_STATUS>Certified</CERTIFICATION_STATUS> <TIMEZONE>Europe/London</TIMEZONE> <LATITUDE>51</LATITUDE> <LONGITUDE>-1</LONGITUDE> <DOMAIN> <DOMAIN_NAME>gridpp.rl.ac.uk</DOMAIN_NAME> </DOMAIN> </SITE> </results>
A virtual site cannot hold a service endpoint that doesn't have a parent site.
There is a requirement to group existing Service Endpoints (currently grouped under their corresponding 'owning' physical Site) under a new 'Virtual Site' entity. See: https://rt.egi.eu/rt/Ticket/Display.html?id=987 and https://wiki.egi.eu/wiki/Logical-site
- At present, the proposed features of a VSite will include (see Media:VirtualSitesDesign.pdf):
- A VSite will be a separate GOCDB entity, and will have users and other attributes much like an existing physical site but with different rules (described below). Importantly, we believe this grouping has to be a new gocdb object in order to clearly define the intended semantics of the grouping (e.g. both a 'VSite' and an imaginary 'VService' could both group many SEs, but a VSite has very different semantics to a VService !).
- A VSite will be used to group existing Service Endpoints only (i.e. SEs that have already been created under their owning physical Site).
- A VSite cannot group new SEs that have no owning physical site.
- A single SE may only have a single parent physical Site (i.e. GOCDB cardinality of 1 between Site and SE)
- A single SE can have many parent VSites (requires GOCDB cardinality of 'many-to-many' between Virtual Site and SE).
- New PI queries are proposed to support querying of VSites and querying of SEs that are grouped under a VSite (much like the existing get_site and get_service_endpoint methods (https://wiki.egi.eu/wiki/GOCDB/PI/get_service_endpoint_method and https://wiki.egi.eu/wiki/GOCDB/PI/get_site_method ). The following XML example is related: https://twiki.cern.ch/twiki/pub/Main/ATPVOFeeds/atp_vo_feed_example.xml
- The permissions model requirements for a VSite are not yet well defined. It is currently proposed that users with a role over the owning physical site should maintain their cascading permissions over their SEs (i.e. no modification to the current site/permissions model). Conversely, users with a VSite role will not gain any cascading permissions over the SEs; this has the following important implications;
- A VSite could not be used to declare a downtime for all its member SEs.
- Similarly, users with a role over the VS will not be able to update/modify a member SE.
- If VSite permissions are required (e.g. for declaring SE downtimes and modifying SEs), then a user may have to request a physical site role. These requirements are currently undefined.