1. Operational Documentation Vera Hansper, CSC/NDGF

2. EGI-InSPIRE – ROD Teams Workshop
What is it?
Operational Documentation is
EGI Global Task O-E-13: documentation and training and best current practices
Interoperation relies on the definition of best practices and of general operational procedures for daily monitoring activity for sites and federations. EGI.org is responsible of the coordination of these activities.
( )
1st & 2nd June, 2010
EGI-InSPIRE – ROD Teams Workshop

3. EGI-InSPIRE – ROD Teams Workshop
Responsibilities
Operational Documentation (OD) falls into the EGI-InSpire TSA1.7 task package
Close collaboration with Operations (O-E-5)
This package falls into 3 distinct parts
Operations Manuals
Best Practices
Training and Training guides
Relevant to Operations only!
1st & 2nd June, 2010
EGI-InSPIRE – ROD Teams Workshop

4. EGI-InSPIRE – ROD Teams Workshop
A brief history
EGEE operations
Original documentation released Sept by Helene Cordier & Piotr Nyczyk
Many iterations and revisions during EGEE projects
Significant changes made to the structure of Operations during this period
A host of people contributed
1st & 2nd June, 2010
EGI-InSPIRE – ROD Teams Workshop

5. EGI-InSPIRE – ROD Teams Workshop
1st & 2nd June, 2010
EGI-InSPIRE – ROD Teams Workshop

6. EGI-InSPIRE – ROD Teams Workshop
Recent Past
Documents that were released before the end of EGEE
Based on the then most recent tools available
Included new monitoring using Nagios
Comprised of three manuals:
ROCs and Sites
ROD
C-COD
Best Current Practices
Training guides
1st & 2nd June, 2010
EGI-InSPIRE – ROD Teams Workshop

7. EGI-InSPIRE – ROD Teams Workshop
Ops Docs now:
Not much has changed ... YET
Will still be comprised of three manuals:
NGIs and Sites
ROD
COD
Best Practices Wiki
Training guides, HowTos etc.
EGI Wiki:
1st & 2nd June, 2010
EGI-InSPIRE – ROD Teams Workshop

8. EGI-InSPIRE – ROD Teams Workshop
VACANCIES
Brave, daring, enthusiastic, creative?
You can handle the written word?
Have the skills to describe complex tools?
Willing to meet deadlines – no matter what?
Then we have a great free job for you!
Personnel are now being sought to join the efforts in Operational Documentation. Hours are flexible, and the rewards are …
Send an to:
operational-documentation-
1st & 2nd June, 2010
EGI-InSPIRE – ROD Teams Workshop

9. EGI-InSPIRE – ROD Teams Workshop
Operations Manuals
Current situation
Copies of the old EGEE documents, where the documents are divided in 4 parts, and only slightly renamed
Common section
NGI and Sites
ROD
COD
Copies at the EGI wiki
Copies at the EGI documentation server
1st & 2nd June, 2010
EGI-InSPIRE – ROD Teams Workshop

10. EGI-InSPIRE – ROD Teams Workshop
Operations Manuals
Challenges
ALL documentation needs to be revised to fit the new project
Links need to be updated
Acronyms will need to be renamed
Adjusting to new wiki format
MediaWiki instead of Twiki
...
1st & 2nd June, 2010
EGI-InSPIRE – ROD Teams Workshop

11. EGI-InSPIRE – ROD Teams Workshop
Operations Manuals
Original EGEE Manual
After move to media wiki
1st & 2nd June, 2010
EGI-InSPIRE – ROD Teams Workshop

12. EGI-InSPIRE – ROD Teams Workshop
Operations Manuals
From “Common Section”
After move to wiki
1st & 2nd June, 2010
EGI-InSPIRE – ROD Teams Workshop

13. EGI-InSPIRE – ROD Teams Workshop
Operations Manuals
What should the NGIs do with these manuals?
The Operations Manuals ARE A GUIDE!
We have roughly 40 NGIs/ROCs, and no one has exactly the same operational model
NGIs are free to take copies of the manual and modify them according to their model
There are some limitations – and these can be discussed.
Read them!
1st & 2nd June, 2010
EGI-InSPIRE – ROD Teams Workshop

14. EGI-InSPIRE – ROD Teams Workshop
Operations Manuals
Operational Documentation needs volunteers from NGIs to keep these up to date!
WE NEED YOUR INPUT – talk with the Task leader or send to:
There is also a contact list for the documentation manuals:
1st & 2nd June, 2010
EGI-InSPIRE – ROD Teams Workshop

15. EGI-InSPIRE – ROD Teams Workshop
Best Practices
Best practices are a collection of operations procedures that are useful.
Sometimes it might be a better way of handling a procedure
Sometimes a Best Practice might be a memo about some aspect of operations
Best practices can also be part of the general documentation
1st & 2nd June, 2010
EGI-InSPIRE – ROD Teams Workshop

16. EGI-InSPIRE – ROD Teams Workshop
Best Practices
The Best Practices is a direct copy from the OLD EGEE Best Current Practices wiki
The Best Practices wiki is found at es
Needs
Link revision
Acronym updates
Revision of the BP – are these still relevant?
1st & 2nd June, 2010
EGI-InSPIRE – ROD Teams Workshop

17. EGI-InSPIRE – ROD Teams Workshop
Best Practices
1st & 2nd June, 2010
EGI-InSPIRE – ROD Teams Workshop

18. EGI-InSPIRE – ROD Teams Workshop
Best Practices
Best Practices needs dissemination!
Your operations teams and your admins need to know about it
They are the ultimate contributors
The Best Practices wiki will be moderated
All contributions will be considered!
1st & 2nd June, 2010
EGI-InSPIRE – ROD Teams Workshop

19. EGI-InSPIRE – ROD Teams Workshop
Best Practices
Best Practices needs volunteers from NGIs to keep these up to date!
WE NEED YOUR INPUT – talk with the Task leader or send to:
There is also a contact/contribution list for Best Practices:
1st & 2nd June, 2010
EGI-InSPIRE – ROD Teams Workshop

20. EGI-InSPIRE – ROD Teams Workshop
Training and Guides
In the EGEE era
Operations training was based on one document
You could get training at a COD meeting
Some training sessions available on request at IN2P3
Simple system – but the Operations was also centralised
Evolution of training model started in EGEEIII with the move to Regional Operations
1st & 2nd June, 2010
EGI-InSPIRE – ROD Teams Workshop

21. EGI-InSPIRE – ROD Teams Workshop
Training and Guides
Current available guides:
Dashboard HowTo and Training Guide
Contains both documents
HowTo includes screenshots of the Operations Dashboard Portal
Training guide is based on *need to know* training from the last COD meeting held in January
1st & 2nd June, 2010
EGI-InSPIRE – ROD Teams Workshop

22. EGI-InSPIRE – ROD Teams Workshop
Training and Guides
Dashboard How To
Provides more in depth information on how to best use the dashboard
Includes screen shots of the dashboard at each point
Requires constant maintenance as the Dashboard goes through revisions
Hopefully these will lessen even further now
1st & 2nd June, 2010
EGI-InSPIRE – ROD Teams Workshop

23. EGI-InSPIRE – ROD Teams Workshop
Training and Guides
Training Guide
Intended for self training
Can be used and be modified by NGIs for internal training of their operators and admins
Should be self explanatory
1st & 2nd June, 2010
EGI-InSPIRE – ROD Teams Workshop

24. EGI-InSPIRE – ROD Teams Workshop
Training and Guides
Things to think about ...
ROD cheat sheet
New concept
A one or two page quick guide to get people started
Other cheat sheets/quick guides
This will be a matter for discussion
1st & 2nd June, 2010
EGI-InSPIRE – ROD Teams Workshop

25. EGI-InSPIRE – ROD Teams Workshop
Training and Guides
Training in Operations needs volunteers from NGIs to keep these up to date!
WE NEED YOUR INPUT – talk with the Task leader or send to:
There is also a contact list for this task:
1st & 2nd June, 2010
EGI-InSPIRE – ROD Teams Workshop

26. EGI-InSPIRE – ROD Teams Workshop
Training and Guides
Who does the training?
Those involved in the managing and updating the Operations manuals
Closest relationship with material
Train the NGI trainers for dissemination
NGIs
Train their own operators and site admins
Can use the model specific to their NGI to further educate
1st & 2nd June, 2010
EGI-InSPIRE – ROD Teams Workshop

27. EGI-InSPIRE – ROD Teams Workshop
Note to NGIs
It should be emphasised that these manuals and guides are viewed as a guide for NGI operators, and that they should also be used as the base for each NGI to write their own specific Operations Manuals.
Because no 2 NGIs/ROCs have exactly the same operational model ...
1st & 2nd June, 2010
EGI-InSPIRE – ROD Teams Workshop

28. EGI-InSPIRE – ROD Teams Workshop
Final comments
Nearly final comments
Team needs to be gathered NOW
There is an URGENT need to update the documentation to make it relevant
Release schedule will be organised when team is put together
Similarly a meetings schedule will also be created
Regular phone conferences, some face to face.
1st & 2nd June, 2010
EGI-InSPIRE – ROD Teams Workshop

29. EGI-InSPIRE – ROD Teams Workshop
VACANCIES
Brave, daring, enthusiastic, creative?
You can handle the written word?
Have the skills to describe complex tools?
Willing to meet deadlines – no matter what?
Then we have a great free job for you!
Personnel are now being sought to join the efforts in Operational Documentation. Hours are flexible, and the rewards are …
Send an to:
operational-documentation-
1st & 2nd June, 2010
EGI-InSPIRE – ROD Teams Workshop

30. EGI-InSPIRE – ROD Teams Workshop
Useful Links
EGI wiki
EGI Document Server
contact lists
Task Leaders
operational-documentation-
Contributing to manuals
Contributing to Best Practices
Contributing to Training Guides
1st & 2nd June, 2010
EGI-InSPIRE – ROD Teams Workshop