Package org.eurogrid.broker.server

This package contains all the classes for the NJS part of the University of Manchester resource broker.

See:
Description

Interface Summary

ExpertBroker	Application-specific brokering module.
LocalResourceChecker	Local resource checking module.
NamedPlugin	A named plug-in component to the UoM Resource Broker which will get a suitably customized logging interface.
ResourceBroker.TSIRunEngine	Passed to LocalResourceCheckers that wish to run scripts on the local TSI.

Class Summary

AbstractBroker	Abstract broker that handles the identity delegation parts of brokering.
DiskQuota	Quota information about one location in a directory hierarchy.
ResourceBroker	University of Manchester Resource Broker NJS V4 Plugin.
TicketManager	Persistent ticket management engine.
UnicoreResourceChecker	Local resource checking module for UNICORE.

Exception Summary

BadEnvironmentException	Exception thrown to indicate that some assumption about the hosting environment was invalid.
IllegalDelegationException	Exception thrown to indicate attempts to delegate by entities not authorized to do so.
TicketManagerException	Exception thrown by the ticket manager when something goes wrong there.
UninitialisedException	Exception thrown to indicate that the broker has been asked to broker something before it was initialised or some other initialisation failure.
UserMappingException	Exception thrown to indicate that something unexpected has gone wrong when mapping from users to their incarnations.

Package org.eurogrid.broker.server Description

This package contains all the classes for the NJS part of the University of Manchester resource broker. These classes are a plugin for the UNICORE NJS V4. The package was developed for the EUROGRID project, Workpackage 5.2. Note the following difference from version 1.3: you now need to use the XML namespaces outlined below.

To use, place these classes (in their JAR) on your NJS's classpath and insert the following section (a BROKER section, configured by a simple XML document) in the IDB:

BROKER org.eurogrid.broker.server.ResourceBroker [
  <broker xmlns="http://www.eurogrid.org/broker/"
          gateway="ssl://mds2.cfs.ac.uk:4433" brokerSelf="yes">

    <!-- *** OTHER VSITES CONTACTED BY BROKER *** -->

    <!-- These next examples extracted from Manchester -->
    <vsite name="O300_wren" gateway="ssl://mds2.cfs.ac.uk:4433" />
    <!-- gateway attr defaults to that used in the main broker element -->
    <vsite name="O2000_fermat" />
    <vsite name="O3000_green" />

    <!-- *** HOW TO CHECK RESOURCES AND LOADING LOCALLY *** -->

    <local class="org.eurogrid.broker.server.UnicoreResourceChecker">
      <!-- Note that scripts have surrounding whitespace trimmed -->
      <turnaroundTimeScript>
        /home/unicore/queuecheck
      </turnaroundTimeScript>
    </local>

    <!-- *** WHETHER AND HOW WE ADVERTISE TO UNKNOWN USERS *** -->

    <advertise passOnRequests="true" useLocalXlogin="unicore">
       This is a string that is passed back to the user that might tell
       them how to get an account on this Vsite.
    </advertise>

    <!-- *** EXPERT BROKERING MODULE - DWD Local Weather Model *** -->

    <expert class="org.eurogrid.broker.server.dwdlm_example.DWDLMExpert"
            xmlns:dwdlm="http://www.eurogrid.org/broker/expert/dwdlm-demo/">
      <dwdlm:config gamma="1.3998" r="287.05" epsilon="0.1" nboundlines="2" />
      <dwdlm:vsite name="O300_wren" gateway="ssl://mds2.cfs.ac.uk:4433"
             procsPerNode="16" mflops="1000" xyPairs="2x2 4x4" />
      <!-- the gateway attr can be read from the master broker -->
      <dwdlm:vsite name="O3000_green"
             procsPerNode="512" mflops="800" xyPairs="8x8 16x16 16x32" />
    </expert>
  </broker>
]

Please note that it is not expected that most brokers will have both a local resource checker and do passing on of requests to other brokers. Because contacting other brokers requires a higher level of capability (i.e. permission to consign a job) it is best if brokers that do such delegation do not execute jobs themselves.