INSTALL GUIDE FOR glueman-provider

1. Introduction
   1. glueman-provider overview
   2. how to use this manual
2. Installation instructions
   1. Prerequisites
      1. Software
      2. Licence
      3. Other requirements
   2. Installation Steps
      1. Prerequisites Satisfied
      2. Downloading glueman-provider
      3. Installing glueman-provider
   3. Configurations
      1. Configuration step 1: access.conf
      2. Configuration step 2: enable http connection
      3. Configuration step 3: providers.conf
      4. Configuration step 4: information providers configuration
      5. Configuration step 5: logger configuration
3. Quick Start
4. Fuctionalities Description
   1. the cimconfig command
   2. the cimcli command
   3. the cimprovider command
   4. How to enable/disable providers Modules
5. Examples of GLUEMan providers usage scenarios
   1. Creating Associations
6. Troubleshooting
   1. Installation Problems
   2. Usage Problems

• glueman-provider library installed: /usr/lib/Pegasus/providers/libGLUE2.so
• configuration files copied into proper folders: /etc/glue/providers/conf
• cache files and log file copied into /var/log/glue/cache and /var/log/glue/log
• GLUE2Module registered

• Section 2 contains the instructions for the installation of software prerequisites and of the glueman-provider. Moreover it explains how you can determine glueman-provider's behaviour modifying configuration files
• Section 3 concerns the instructions necessary to execute glueman-provider

Copyright 2008 Istituto Nazionale di Fisica Nucleare http://www.infn.it

 Authors: Sergio Andreozzi, Michele Carpene', Marco Canaparo

    Licensed under the Apache License, Version 2.0 (the "License");
   you may not use this file except in compliance with the License.
   You may obtain a copy of the License at
       http://www.apache.org/licenses/LICENSE-2.0
   Unless required by applicable law or agreed to in writing, software
   distributed under the License is distributed on an "AS IS" BASIS,
   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
   See the License for the specific language governing permissions and
   limitations under the License.

rpm -qa tog-pegasus

rpm -qa cimple

wget http://downloads.sourceforge.net/glueman/glueman-provider-1.0-1.i386.rpm

rpm -i glueman-provider-1.0-1.i386.rpm

vi /etc/Pegasus/access.conf

-: ALL EXCEPT pegasus root:wbemNetwork

cimconfig -p -s enableHttpConnection=true

service tog-pegasus restart

• the alarm parameter which enables the timeout in the case your script provider is blocked, the thread executing your script will be killed, if you don't set this parameter the default timeout value is 10 seconds
• The log-cache-dirs parameter which sets the path for the logfile
• the logger priority level

[configuration]
log-cache-dirs = /var/log/glue/;
prioritylevel = DEBUG;
ALRM = 4;

• gluerotate: a bash script executed everyday by the cron deamon and copied by the rpm installer into the daily.cron folder
• gluelogger: a configuration file for the logrotate unix command which sets options like the number of rotation files and the maximum size of the log file

[n1]
ID = urn:admindomain:t1.infn.it
Name = INFN-T1
Description = This is the italian T1 of EGEE Grid
WWW = http://www.cnaf.infn.it
OtherInfo = Part-of-INFN-GRID
Distributed = true
Owner = INFN

• the script path
• the TimeToLive for the cache (a file containing the Information Providers output), the TimeToLive is simply a parameter which sets the time for the cache file to be refreshed if you don't query the providers for a certain amount of time
• the InstanceClass name (e.g. AdminDomain)

[configuration]
namespace = glue2
classname = AdminDomain
TTL = 10
scriptfpath = /opt/glueman/providers/AdminDomain.pl

[ComputingService_1]
ID = urn:infn:cnaf:computing;
Name = INFN-T1 computing service;
Capability = executionmanagement.jobexecution;
Type = org.glite.ce.lcg;
QualityLevel = production;
StatusPage = http://...;
Complexity = endpointType=1, share=2, resource=1;

[ComputingEndpoint_1]
ID = urn:infn:cnaf:computing:endpoint:1;
Name = INFN-T1 computing endpoint;
URL = gram://grid011f.cnaf.infn.it:2119;
Capability = executionmanagement.jobexecution;
Technology = legacy;
InterfaceName = GRAM;
InterfaceVersion = 1.6;
Implementor = globus+cern;
ImplementationName = lcg-pbs;
ImplementationVersion = x.y;
QualityLevel = production;
HealthState = ok;
ServingState = production;

[ExecutionEnvironment_1]
LocalID = urn:acme:xeon1\n;
OSFamily = Linux;
PlatformType = i386;

regmod -n GLUE2 -c -i /usr/lib/Pegasus/providers/libGLUE2.so

cimcli -n GLUE2 ei GLUE_AdminDomain

instance of GLUE_AdminDomain
{
ID = "urn:admindomain:t1.infn.it";
Name = "INFN-T1";
Description = "This is the italian T1 of EGEE Grid";
WWW = {"http://www.cnaf.infn.it"};
OtherInfo = {"Part-of-INFN-GRID"};
Distributed = TRUE;
Owner = {"INFN"};
};

cimconfig -p -s enableHttpConnection=true

service tog-pegasus restart

cimconfig -g enableHttpConnection

• - u User. Defines user name for authentication
• - p password. Defines password for authentication
• - n namespace. Specifies namespace to use for operation

cimcli -h

cimcli -n GLUE2 ei GLUE_AdminDomain
...

regmod -n GLUE2 -c -i /usr/lib/Pegasus/providers/libGLUE2.so

cimprovider -l -s

regmod -n GLUE2 -c -i /usr/lib/Pegasus/providers/libGLUE2.so GLUE_AdminDomain

regmod -n GLUE2 -u -c -i /usr/lib/Pegasus/providers/libGLUE2.so

regmod -n GLUE2 -u -c -i /usr/lib/Pegasus/providers/libGLUE2.so GLUE_AdminDomain

regmod -n GLUE2 -u -c -i /usr/lib/libGLUE2.so

• stop cimcli execution with CTRL-C command
• type "ps -e" In order to see if there are more than one cimserver process running.
• If there are more than one cimserver process running please execute the following command

service tog-pegasus restart

cimconfig -p -s enableHttpConnection=true

> [root@omiitest07 local]# cimcli ei GLUE_AdminDomain
>
> cimcli CIMException: Cmd= ei Object= GLUE_AdminDomain
>
> CIM_ERR_INVALID_CLASS: GLUE_AdminDomain