Alert.png The wiki is deprecated and due to be decommissioned by the end of September 2022.
The content is being migrated to other supports, new updates will be ignored and lost.
If needed you can get in touch with EGI SDIS team using operations @

GGUS:OSG Topology Interface FAQ

From EGIWiki
Revision as of 12:49, 28 March 2019 by Ggrein (talk | contribs)
Jump to navigation Jump to search

GGUS wiki / GGUS FAQ / GGUS Documentation / GGUS Helpdesk

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/ In case of changing the host or the certificate the OSG Topology Interface administrators have to be informed for updating the registration accordingly.

Work flows

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.