		Next

OGSA-DAI 3.1 Documentation

OGSA-DAI 3.1 OMII-UK

Copyright © 2007-2008 The University of Edinburgh

5th December, 2008

OGSA-DAI 3.1 Documentation

1. User doc conventions

2. Release notes

3. Licence and copyright

4. Information, help and support

I. What is OGSA-DAI?

5. The OGSA-DAI project
6. OGSA-DAI's vision
7. OGSA-DAI workflows and activities
8. An introduction to workflow execution
9. OGSA-DAI resources
10. OGSA-DAI services
11. Resources and activities revisited
12. Workflows and activity pipelines
13. How requests (workflows) are executed
14. About the request execution status
15. About the request status
16. OGSA-DAI client toolkit
17. Ways in which OGSA-DAI can be extended and customised
18. OGSA-DAI component diagram
19. OGSA-DAI server components
20. OGSA-DAI server context
21. Activity classes, IDs and names explained
22. OGSA-DAI case study - SEE-GEO
23. Inter-OGSA-DAI queries
24. Why OGSA-DAI?
A. Publications
B. Acknowledgements

II. Getting Started

25. Get OGSA-DAI
26. Get dependencies
27. Data resource products
28. Build OGSA-DAI binary from OGSA-DAI source distribution
29. Set an OGSADAI_HOME environment variable
30. Set the CLASSPATH
31. Getting started check list
32. How to upgrade to 3.1 for OGSA-DAI 3.0 users

III. OGSA-DAI for deployers

33. 10 minute quick start guide
34. Usage statistics
35. Create test data
36. Deploy OGSA-DAI
37. Set up OGSA-DAI OMII security
38. Check the deployed services
39. What now?
40. How to deploy a relational resource
41. How to deploy an XMLDB resource
42. How to add a database login for a client
43. How to remove a database login for a client
44. How to deploy a file system resource
45. How to deploy a resource group
46. How to deploy a remote resource
47. How to deploy a resource template
48. How to deploy a third-party data resource
49. How to undeploy a resource or resource template
50. How to deploy an activity
51. How to extend a resource's activities
52. How to configure logging
53. How to add JARs to the server
54. How to configure common components
55. How to add objects to the OGSA-DAI context
56. How to use the OGSA-DAI request monitor
57. About the OGSA-DAI servlet
58. How to optimise the server for performance
59. How to specify a login provider
60. How to undeploy OGSA-DAI
61. Important comments on OGSA-DAI scalability, robustness and security
C. Appendix - OGSA-DAI server configuration files
D. Appendix - Activities file
E. Appendix - Common components configuration file
F. Appendix - Logins File
G. Appendix - Resource files and resource template files
H. Appendix - OGSA-DAI context JNDI file
I. Appendix - Persistence and update policies
J. Appendix - Enhanced OGSA-DAI deployment options
K. Appendix - Troubleshooting, hints and tips for deployers

IV. OGSA-DAI for client users

62. Example server client
63. Example relational data resource client
64. Example XMLDB data resource client
65. Example file system data resource client
66. Example relational data resource with asynchronous delivery client
67. Example data source retrieval client
68. How to write request documents
69. Example request document client
L. Appendix - Troubleshooting, hints and tips for client users

V. OGSA-DAI for client developers

70. How to write an OGSA-DAI client
71. Writing effective clients - what you should consider
72. Writing effective clients - using synchronous requests
73. Writing effective clients - using asynchronous requests
74. Writing effective clients - chunking arrays
75. Writing effective clients - using transforms wisely
76. Writing effective clients - using the request status for delivery
77. Writing effective clients - using FTP for delivery
78. Writing effective clients - using data sources for delivery
79. Writing effective clients - using data sinks for delivery
80. Writing effective clients - using the OGSA-DAI servlet for delivery
81. Important comments on security
82. Monitoring client-server communications with Apache Axis TCPMon
M. Appendix - Troubleshooting, hints and tips for client developers

VI. OGSA-DAI for server developers

83. An introduction to writing activities
84. How to write a simple "hello world" activity with one output
85. How to write a "hello name" activity with one input and output
86. How to write a list reduction activity with one input, one list input and one output
87. How to write a list processing activity with one input, one list input and one list output
88. How to write a tuple processing activity with one input, one list input and one list output
89. How to write an activity that uses a resource provided by an activity extension interface
90. How to write a resource factory activity
91. Extending the resource factory activity
92. Activity types and choosing an activity base class
93. Passing information between activities and the activity framework using activity extension interfaces
94. How to handle errors in activities
95. How to declare activity inputs for matched activities
96. Choosing the client toolkit activity proxy base class
97. Client toolkit activity proxies and activity inputs and outputs
98. Client toolkit activity proxies and exposing data for clients
99. An introduction to writing data resources
100. How to write a data resource - case-study
101. How to support persisted resource properties
102. How to implement on-demand resource properties
103. How to implement on-demand resource properties that read their values from files
104. How to debug OGSA-DAI server components
105. How to register message bundles
106. How to log internationalized messages
107. How to log exceptions
108. How to write OGSA-DAI compliant exceptions
109. OGSA-DAI server context
110. How to use the OGSA-DAI context to share components throughout the OGSA-DAI server
111. Security contexts
112. How to use security contexts in your components
113. How to write a login provider
114. How to monitor activity inputs
115. How to transform workflows before they are executed
116. How to write a monitoring framework
117. How to write a presentation layer
N. Appendix - OGSA-DAI server APIs UML
O. Appendix - Activity development guidelines

VII. Appendices

P. Appendix - Default service names and URLs
Q. Appendix - Default resource types, names and resource property names
R. Appendix - Data resources class list
S. Appendix - Core types
T. Appendix - Server APIs list
U. Appendix - Base 64 encoding
V. Appendix - Presentation layer-core type mappings
W. Appendix - JavaDoc
X. Appendix - Third-party products bundled with OGSA-DAI
Y. Appendix - Upgrading from OGSA-DAI 2.2
Z. Glossary

I. OGSA-DAI 3.1 Activities Reference

II. OGSA-DAI 3.1 Scenarios and Client Examples

		Next
		OGSA-DAI 3.1 Documentation