$Id: README.xml,v 1.1.1.1 2006/08/02 08:01:40 badino Exp $
Table of Contents
Abstract
This document contains the information concerning the libraries provided by the module gLite Data Transfer ProxyRenewal.
The purpose of that package is to provide and agent for the gLite Data Transger Service that is able to renew the clients' delegated credentials that are going to expire. These libraries are:
iUses the library provided by org.security.proxyrenewal and retrive the informatiopn on the credentials that are going to expire from the database, using the libraries provided by org.glite.data.transfer-agents.
Provides the File Transfer Agent responsible to renew credentials, using the above library.
The gLite Data Transfer ProxyRenewal modules use the gLite Data Config Service module for retrieving initialization and configuration parameters. For a detailed explanation how that library works please have a look at the gLite Data Config Service User's Guide.
The purpose of this section is to illustrate the initialization and configuration parameters required by the gLite Transfer ProxyRenewal modules.
Represents the mmodule that provide the logic to renew the clients' delegated credentials. It uses the org.glite.security.proxyrenewal library
libglite_data_transfer_proxyrenewal.so
The host name of the MyProxy Server. If that parameter is not set or is empty, the Myproxy Server is looked up using the Service Discovery and then, if not found, the myproxy default will apply (MYPROXY_SERVER environment variable)
Type: string; Default value: ''
The port of the MyProxy Server. If that parameter is not set or is 0, the myproxy default will applies
Type: integer; Default value: '0'
The lifetime in seconds of the proxy certificates that will be created
Type: integer; Default value: '86400'
The minimum validity time (in seconds) an already existing credentials should have. In case the certificate couldn't satisfy that requirement, a new certificate will be renewed from the MyProxy Server
Type: integer; Default value: '3600'
<No configuration parameters>
This module represents the agent that should run the FTS action in order to renew clients' delegated credential. The ProxyRenewal Agent requires to run the follwing action: <Renew> : Renew the delegated credentials for clients that have Pending or Active jobs This module provides a default value for that type, however it would be possible to provide different action types and use them, by specifying the type of the action on the related <action_type>_Type initialization parameter. By default, the actions are executed periodically with an interval provided by the "DefaultInterval" configuration parameter. In order to modify the scheduling interval based on the action type, you can provide a <action_type>_Interval configuration parameter with the value you want to assign. In addition to the actions described above, the ProxyRenewal Agent also execute other two internal actions: <Heartbeat> : Periodically refresh the status of agent in teh Database <CleanSDCache>: Clean the ServiceDiscovery Cache For what concern the scheduling interval of these actions, the values are specified by the parameters <Heartbeat_Interval> and <CleanSDCache_Interval>
libglite_data_transfer_proxyrenewal_agent.so
The contact information of the Administrator responsible for that agent
Type: string; Default value: ''
The name of the action type that provides the logic to renew clients' credentialsl.
Type: string; Default value: 'glite:Renew'
The default interval, in seconds, for scheduling the VO actions
Type: integer; Default value: '3'
The interval, in seconds, to be used for scheduling the Heartbeat action. The purpose of this action is to periodically update the lastActive timestamp in the t_agent table, in order to demonstrate that agent is up and running. If this value is 0, the Heartbeat action will be disabled
Type: integer; Default value: '60'
The interval, in seconds, to be used for purging obsolete entries from the ServiceDiscovery cache in order to evaluate changes in the information system. If the SD Cache is disabled, this action doesn't do anything
Type: integer; Default value: '300'
The interval, in seconds, to be used for scheduling the Renew action. If this parameter is not set or is empty, the Renew action will be scheduled using the value provided by the "DefaultInterval" parameter. If this value is 0, the Renew action will be disabled (useful only for debugging purposes)
Type: integer; Default value: ''
The folder config contains the configuration templates for each component provided by the gLite Transfer ProxyRenewal module. These files are then exported in $(GLITE_LOCATION)/share/config/glite-data-transfer-proxyrenewal/config-templates. The gLite Data Transfer and Scheduler Agents would the use these component configuration template files and combine them in order to provide the Agent's service configuration template that can be used to generate the configuration file as explained in the gLite Data Config Service Users' Guide and in the Agent related Install Guide documents.