Version 26 (modified by bartek, 7 years ago) (diff)

--

QCG-BDII

The guide describes the process of integration of QCG services with the EGI Information System - Resource BDII.

The integration results in publishing information about the service in a GLUE2 complaint format through the BDII service.

The basics of EGI Information Service are described at  link.

In general, information about a grid service is produced by a service provider and transfered into the closest BDII (LDAP) instance (typically co-allocated with the service).This procedure is significantly simplified with the help of tools offered by EMI Resource Information Service (emi-resource-information-service). Consequently, the integration of new services was limited to the provisioning of a few script and configuration files.

IMPORTANT: The documentation is common for all QCG services: QCG-Broker, QCG-Computing and QCG-Notifications and varies only in some points from one service to another.

Software repositories

To install QCG-BDII (BDII for one of QCG services) please configure the system with:

  • one of QCG repositories, containing QCG specific extensions to the EGI information system. The RPMs are availeble for SL5 and SL6.
  • EMI3 (Monte Bianco) repository, which is needed for the emi-resource-information-service metapackage, providing the EGI information system base framework.

To configure aforementioned repositories please follow the instruction:   QCG Software Repositories.

Installation

In a typical YUM repositories configuration the installation of the providers comes down to the following commands:

  • for QCG-Broker service:
    yum install qcg-broker-egi-is-provider
    
  • for QCG-Computing service
    yum install qcg-comp-egi-is-provider
    
  • for QCG-Notification service
    yum install qcg-ntf-egi-is-provider
    

Repository configuration issues

It may happen that due to the fact that the newest packages of the QCG software are included in UMD repositories with a delay, the presented procedure may fail in case of specific YUM repositories configuration. If so, it may be required to divide the installation into two steps:

  • In the first step the emi-resource-information-service metapackage should be installed from the UMD repository.
  • In the second step a certain QCG provider should be installed from the QCG repository.

An example procedure may then look as follows:

yum install emi-resource-information-service 
yum --disablerepo=UMD\* install qcg-comp-egi-is-provider

Configuration

All the QCG-BDII packages need to be configured by providing the name of the BDII site, to which they intend to publish service information.

Run the command

qcg-info-site-config -s <site-ID>

to set appropriate data.

The list of available site-IDs can be found at  https://goc.egi.eu/portal/index.php?Page_Type=Sites

Currently configured site-ID may be displayed as follows:

qcg-info-site-config -d
site-ID=PSNC

SL5 specific configuration

The BDII service requires a newer version of OpenLDAP than is available in a Scientific Linux 5 system by default. The newer version of OpenLDAP is installed as a dependecy from the UMD repository. However, the installation of a newer package entails necessity of selecting the proper OpenLDAP daemon (SLAPD) within the BDII service configuration file ('/etc/sysconfig/bdii'), eg.:

SLAPD=/usr/sbin/slapd2.4

Starting service

IMPORTANT: Before starting the QCG-BDII please ensure that the QCG services are properly configured and started.

The autostart of the BDII service may be configured with the following commands (invoked as root):

  • the commands required only on SL5:
    chkconfig ldap off
    chkconfig ldap2.4 off
    
  • required on SL5 and SL6:
    chkconfig bdii on
    

The service itself may be run from the command line as follows:

service bdii start

By default the BDII works on port 2170.

Verification

To validate correctness of the published data the glue-validator tool can be used:

glue-validator -H localhost -p 2170 -b o=glue

Release Notes

QCG-BDII release notes