Alert.png The wiki is deprecated and due to be decommissioned by the end of September 2022.
The content is being migrated to other supports, new updates will be ignored and lost.
If needed you can get in touch with EGI SDIS team using operations @ egi.eu.

Difference between revisions of "Documentation"

From EGIWiki
Jump to navigation Jump to search
m (Remove useless coma)
(44 intermediate revisions by 4 users not shown)
Line 1: Line 1:
{{Template:Op menubar}}
{{Template:Op menubar}} {{Template:Doc_menubar}}  
{{Template:Doc_menubar}}
{{TOC_right}}
Welcome to the EGI Operational Documentation pages, whose purpose is to guide EGI operations at different levels: site management, NGI operations management (regional Operator on Duty - ROD) and EGI operations (Central Opeartor on Duty - COD).


= Documents =
{| width="100%" style="background: none repeat scroll 0% 0% rgb(249, 249, 249); margin: 1.2em 0px 6px; border: 1px solid rgb(221, 221, 221);"
|-
| style="width:61%; color:#000;" |
{| style="width:280px; border:none; background:none;"
|-
| style="width:280px; text-align:center; white-space:nowrap; color:#000;" | <div style="font-size:162%; border:none; margin:0; padding:.1em; color:#000;">Welcome to EGI Operational Documentation</div>
|}
 
<br>
 
|}
 
= Documents =


{|
{|
|- style="background-color: darkgray;"
|- style="background-color: lightgray;"
| '''[[Operations Manuals|Manuals, Troubleshooting Guides, How-TOs]]'''  
| '''[[Operations Manuals|Manuals]]'''  
| The EGI [[Operations Manuals]] are technical prescriptive documents that provide guidelines on how to accomplish a given task. These documents are periodically reviewed, and need to be followed by all partners (as opposed to a best-practice documents that provide optional guidelines).  
| The EGI [[Operations Manuals]] are technical prescriptive documents that provide guidelines on how to accomplish a given task. These documents are periodically reviewed, and need to be followed by all partners (as opposed to a best-practice documents that provide optional guidelines).  
 
*Manuals
|- style="background: none repeat scroll 0% 0% lightgray;"
*Troubleshooting Guides
| '''[[Operations Best Practices|Best Practices]]'''
*How-TOs
| The EGI [[Operations Best Practices]] are technical documents providing reference information on how technical operational tasks can be addressed. A best practice can be optionally adopted by a partner if deemed suitable, the guidelines provided are '''optional'''. Nevertheless a best practice is periodically reviewed, and if relevant to grid middleware deployment it is preliminary approved by the relevant Technology Provider.
*FAQs
A Best Practice is contributed on a voluntary basis by EGI partners to share knowledge and experience.


|- style="background-color: darkgray;"
|- style="background-color: darkgray;"
| '''[[Operational Procedures|Procedures]]'''  
| '''[[Operations Procedures|Procedures and Policies]]'''  
| EGI [[Operations Procedures]] are prescriptive documents that describe a step-by-step process requiring action from two or more partners. The purpose of a procedure is to define the related workflow. Procedures are approved by the OMB and are periodically reviewed. The intructions providewd by a procedure are mandatory. Applicable areas:  
| EGI [[Operations Procedures]] are prescriptive documents that describe a step-by-step process requiring action from two or more partners. The purpose of a procedure is to define the related workflow. Procedures are approved by the OMB and are periodically reviewed. The intructions providewd by a procedure are mandatory. Applicable areas:  
*Ticket management  
*Ticket management  
Line 26: Line 34:
*Vulnerability Issue Handling
*Vulnerability Issue Handling


|- style="background: none repeat scroll 0% 0% lightgray;"
| '''[[Training Guides|Training Guides]]'''
| A collection of Training Guides relevant to Operations.
|- style="background-color: darkgray;"
| [[Performance|'''<div id="OLA">OLA/SLA</div>''']]
| A collection of Operations Level Agreements and Service Level Agreements concerning Operations
|- style="background-color: lightgray;"
|- style="background-color: lightgray;"
| '''[[Operations FAQ|FAQs]]'''  
| [[Other Operations Documentation|'''Other''']]  
| [[Operational FAQ|Frequently Asked Questions]] are question/answer documents providing information on specific technical areas. The FAQ provides a high-level overview of the issue and collection of links for futher investigation.
|  
|- style="background: none repeat scroll 0% 0% darkgray;"
*Information about DTEAM and OPS VOs, standards relevant to operations  
| '''[[TrainingGuides|Training Guides]]'''
*[[EGI Operations Start Guide|EGI Operations Start Guide]]
| A collection of HowTos and Training Guides relevant to Operations.
 
|-
| '''OLAs'''
| [https://documents.egi.eu/document/31 Resource Centre (RC) Operational Level Agreement] ([[Resource_Centre_OLA:_Release_Notes|release notes]])
[https://documents.egi.eu/document/463 Resource infrastructure Provider (RP) Operational Level Agreement] ([[Resource_infrastructure_Provider_OLA:_Release_Notes|release notes]])
|- style="background-color: lightgray;"
| [[Other_Operations_Documentation|'''Other''']]
| Information about DTEAM and OPS VOs, standards relevant to operations
|- style="background-color: darkgray;"
|- style="background-color: darkgray;"
| '''Security Advisories'''
| '''Security Advisories'''  
|  
|  
*Grid middleware [[SVG:Advisories|advisories]] (SVG)
*Grid middleware [[SVG:Advisories|advisories]] (SVG)  
* Security [[EGI_CSIRT:Alerts|alerts/advisories]] (EGI CSIRT)
*Security [[EGI CSIRT:Alerts|alerts/advisories]] (EGI CSIRT)
|}


= Resources =
* [[Glossary|Glossary]]
* [https://wiki.egi.eu/wiki/PDT:Procedure_Template Procedure template]
* EGI [https://documents.egi.eu/document/169 Policy Development Process]
* EGI [https://documents.egi.eu/public/DocumentDatabase Document Database]
= Contacts =
{|
|'''Coordinator''':
| Ulf Tigerstedt (CSC)
|-
|'''Contact information''':
|operational-documentation (at) mailman.egi.eu
|}
|}


== Mailing lists ==
= Resources  =
 
{| border="1"
|-
! Name !! E-mail !! Purpose/members
|-
| [mailto:operational-documentation@mailman.egi.eu Catch-all list] || operational-documentation[at]mailman.egi.eu || All people working in the documentation tasks, BP general communication list.
|-
| Management || operational-documentation-management[at]mailman.egi.eu || Lead of the Documentation task
|-
| Best practices || operational-documentation-best-practices[at]mailman.egi.eu || Contribution list for BP, also for BP internal communication if needed.
|-
|}


= Internal area =
*[[Glossary|Glossary]]
* [[Operations_Drafts|Operations documentation Current drafts]]
*EGI [https://documents.egi.eu/document/169 Policy Development Process]
*EGI [https://documents.egi.eu/public/DocumentDatabase Document Server]


<!-- '''Notice Board''': [[Operations:Noticeboard|Mailing lists and other miscellaneous info.]] <br> -->
[[Category:Operations_Documentation|*]]
==Documentation Team==
[[Documentation_Contacts/Team|Current members of the project, with tasks.]] Includes observers.

Revision as of 14:18, 31 July 2019

Main EGI.eu operations services Support Documentation Tools Activities Performance Technology Catch-all Services Resource Allocation Security


Documentation menu: Home Manuals Procedures Training Other Contact For: VO managers Administrators


Welcome to EGI Operational Documentation


Documents

Manuals The EGI Operations Manuals are technical prescriptive documents that provide guidelines on how to accomplish a given task. These documents are periodically reviewed, and need to be followed by all partners (as opposed to a best-practice documents that provide optional guidelines).
  • Manuals
  • Troubleshooting Guides
  • How-TOs
  • FAQs
Procedures and Policies EGI Operations Procedures are prescriptive documents that describe a step-by-step process requiring action from two or more partners. The purpose of a procedure is to define the related workflow. Procedures are approved by the OMB and are periodically reviewed. The intructions providewd by a procedure are mandatory. Applicable areas:
  • Ticket management
  • Operations Center Management
  • Resource Centre Management
  • Availability and monitoring
  • Security Incident Handling
  • Vulnerability Issue Handling
Training Guides A collection of Training Guides relevant to Operations.
OLA/SLA
A collection of Operations Level Agreements and Service Level Agreements concerning Operations
Other
Security Advisories

Resources