Access Grid Workshop – APAC ‘05 Introduction to Access Grid Development

Access Grid Workshop – APAC ‘05 Agenda Architecture AG Application Basics AccessGrid module overview Example application Exercises

Access Grid Workshop – APAC ‘05 Architecture

Access Grid Workshop – APAC ‘05 Technologies Python wxPython pyGlobus SOAP (SOAPpy) pyOpenSSL

Access Grid Workshop – APAC ‘05 AG Application Basics An Access Grid client application will perform (at least) these steps: Create an application instance Initialize application Create an interface wrapper Call methods on the interface wrapper

Access Grid Workshop – APAC ‘05 AG Application Basics The core of an AG application is an instance of AccessGrid.Toolkit.Application AppBase Application CmdlineApplicationWXGUIApplication Service

Access Grid Workshop – APAC ‘05 AG Application Basics Distinguished between GUI and non-GUI applications to generalize user interactions (for example, prompt for passphrase, error reporting) –CmdlineApplication Examples: BridgeServer, VenueServer, AGNodeService –WXGUIApplication Examples: VenueClient, VenueManagement, NodeManagement

Access Grid Workshop – APAC ‘05 Application Initialization Create AG application instance Initialize application –Verify certificate repository –Load default certificate –Create proxy certificate –Configure Globus environment app = CmdlineApplication.instance() app.Initialize(appName) appName is used in logfile name

Access Grid Workshop – APAC ‘05 Argument Processing Standard Python module optparse is integrated into toolkit Add option to application before initialization Access options post-initialization app.AddCmdLineOption( optparse.Option( ‘ -u ’, ’— url ’, dest= ‘ url ’ )) app.Initialize( ‘ SampleApp ’ ) url = app.GetOption( ‘ url ’ )

Access Grid Workshop – APAC ‘05 Standard Toolkit Arguments The toolkit adds some options to all applications Available options can be viewed with ‘-h’ or – help Examples -d (turn on debug) -l --logfilesize --numlogfiles (rollover log files)

Access Grid Workshop – APAC ‘05 Logging Standard Python module logging is integrated into AccessGrid toolkit Multiple logging levels are defined (see logging module documentation) –CRITICAL, ERROR, WARNING, INFO, DEBUG Logging levels can be controlled for individual components in an application Application will create appName.log (appName is from app.Initialize) in Log directory: –Windows: %APPDATA%\AccessGrid\Logs –Linux/OSX: $HOME/.AccessGrid/Logs Logging calls in code will appear in logfile, according to call and current logging level –log.debug(‘this is debug logging text’)

Access Grid Workshop – APAC ‘05 AccessGrid Module Overview AccessGrid –Core toolkit code AccessGrid.Security –CertificateManager, CertificateRepository, etc. –AuthorizationManager, Role, Action, etc. AccessGrid.Platform –Platform-specific code Config.{SystemConfig,UserConfig,etc.} ProcessManager AccessGrid.hosting –SOAP implementation adapters

Access Grid Workshop – APAC ‘05 AccessGrid Module API Documentation

Access Grid Workshop – APAC ‘05 Interfaces and InterfaceWrappers Described in online API documentation Interface wrappers are defined in individual modules –For example, AccessGrid.Venue.VenueIW IW (and I) class methods handle serialization/deserialization of data types from SOAP implementation domain to AG application domain

Access Grid Workshop – APAC ‘05 Available InterfaceWrappers VenueIW VenueServerIW VenueClientIW AGNodeServiceIW AGServiceManagerIW AGServiceIW AuthorizationManagerIW SharedApplicationIW NetworkServiceIW

Access Grid Workshop – APAC ‘05 VenueIW

Access Grid Workshop – APAC ‘05 Types Many types are found in Descriptions.py –StreamDescription –ApplicationDescription Others are found in their own modules –ClientProfile –AGParameter –Capability

Access Grid Workshop – APAC ‘05 AG Applications An Access Grid client application will perform (at least) these steps: Create an application instance Initialize application Create an interface wrapper Call methods on the interface wrapper

Access Grid Workshop – APAC ‘05 Example: GetClients.py #!/usr/bin/python2 import sys from AccessGrid.Toolkit import CmdlineApplication from AccessGrid.Venue import VenueIW url = sys.argv[1] # Create and initialize application app = CmdlineApplication() app.Initialize('qwe') # Create venue interface wrapper venue = VenueIW(url) # Get clients from venue and process clientList = venue.GetClients() for client in clientList: print client

Access Grid Workshop – APAC ‘05 Example: GetClients.py python GetClients.py Profile Type: user Name: Tom Uram Phone Number: Location: Chicago, IL Venue Client URL: Public ID: e c00dd d Home Venue:

Access Grid Workshop – APAC ‘05 Example: GetClients.py Check logfile GetClients.log

Access Grid Workshop – APAC ‘05 Notes Online workshop materials: Online developer documentation (including API reference): OSX users will need to source an environment file to run code in a terminal –/Applications/AccessGridToolkit.app/Contents/Resources/ setupenv.sh

Access Grid Workshop – APAC ‘05 Exercise: GetStreams.py Modify GetClients.py to call GetStreams instead of GetClients Return value is a list of Descriptions.StreamDescription

Access Grid Workshop – APAC ‘05 Exercise: GetUsers.py Modify GetClients.py to call VenueClientIW.GetUsers Return value is a list of ClientProfile

Access Grid Workshop – APAC ‘05