Difference between revisions of "GGUS:OSG Topology Interface FAQ"
Latest revision as of 12:50, 28 March 2019
FAQ for the Interface between GGUS and OIM
This document describes the OSG–GGUS interface. The OSG–GGUS interface is used for synchronizing the GGUS database for site data with the OSG topology data .
Tools, Applications, Systems
The interface is based on a PHP script “CheckSiteData_OIM”.This script retrieves the data from OSG Topology Interface. The GGUS site data database is a BMC Remedy form called “Grid:RespUnitData”.
For retrieving data from OSG Topology Interface the certificate of the calling host has to be registered. OSG Topology Interface stores a list of DNs who can access GOC services. For example, OSG Topology Interface has the following record for GGUS: "GGUS Contacts Reader" /C=DE/O=GermanGrid/OU=FZK/CN=prod-ars.ggus.eu In case of changing the host or the certificate the OSG Topology Interface administrators have to be informed for updating the registration accordingly.
The CheckSiteData script is triggered by a cron job. It is executed every night. The script retrieves the complete dataset from OSG Topology Interface. The dump from OSG Topology Interface is checked for not being empty and having the typical “result” string inside. In case of failure the execution of the script is stopped and the data from the previous update is kept. Additionally GGUS keeps a local copy of the data on GGUS server for a quick restore in case of loosing data. OSG Topology data is imported into local GGUS site data database. New sites in OSG Topology are added to the GGUS database automatically. Updates on OSG Topology site data are pushed to the GGUS site data database by modifying existing data sets. Removed sites are flagged and deleted by a cron job from GGUS database. The OSG Topology site ID is used as primary key for the synchronization process. Attributes covered by the synchronization process are:
- Contact Email,
- Alarm Email,
- Tier Level,
- ROC and
- Certification Status.
All updates in GGUS form “Grid:RespUnitData” are done using SOAP web services.
What if I have questions which are not dealt with by this FAQ?
Open a GGUS ticket
indicating that it should be directed at the GGUS team.
- Please use this