Changes between Version 1 and Version 2 of GENIRacksHome/OpenGENIRacks/AcceptanceTestStatusMay2013/OG-ADM-7


Ignore:
Timestamp:
05/23/14 13:40:44 (10 years ago)
Author:
lnevers@bbn.com
Comment:

--

Legend:

Unmodified
Added
Removed
Modified
  • GENIRacksHome/OpenGENIRacks/AcceptanceTestStatusMay2013/OG-ADM-7

    v1 v2  
    1 = GR-ADM-7: Documentation Review Test =
    2 
    3 
    4 This page captures status for the test case GR-ADM-7. For additional information see the [wiki:GENIRacksHome/GRAMRacks/AcceptanceTestStatusMay2013 Acceptance Test Status - May 2013] page overall status, or the [wiki:GENIRacksHome/AcceptanceTests/GRAMAcceptanceTestsPlan GRAM Acceptance Test Plan] for details about the planned evaluation.
     1= OG-ADM-7: Documentation Review Test =
     2
     3
     4This page captures status for the test case OG-ADM-7. For additional information see the [wiki:GENIRacksHome/OpenGENIRacks/AcceptanceTestStatusMay2013 Acceptance Test Status - May 2013] page overall status, or the [wiki:GENIRacksHome/AcceptanceTests/OpenGENIAcceptanceTestsPlan OpenGENI Acceptance Test Plan] for details about the planned evaluation.
    55
    66
     
    1313
    1414|| '''Documentation'''                                                        ||'''State'''                                      || ''' Tickets ''' || '''Notes''' ||
    15 ||1. GRAM Rack Installation Documentation                                     ||[[span(Partial, style=background-color: orange)]]||#74                 ||             ||
    16 ||2. GRAM Rack Part List Documentation                                        ||[[span(Fail, style=background-color: red)]]      ||#75                 ||             ||
    17 ||3. GRAM Software Components Identification Documentation                    ||[[span(Pass: most criteria, style=background-color: #98FB98)]]||#76                 ||             ||
    18 ||4. GRAM and OS Upgrade Plans                                                ||[[span(Fail, style=background-color: red)]]      ||#77                 ||             ||
    19 ||5. GRAM Software Components Functional Description and Access to Source code||[[span(Partial, style=background-color: orange)]]||#78             ||
    20 ||6. GRAM Rack Resources Usage and Policy Documentation                       ||[[span(Fail, style=background-color: red)]]      ||#79                 ||            ||
    21 ||7. GRAM Rack Resources Administration                                       ||[[span(Fail, style=background-color: red)]]      ||#80                 ||            ||
    22 ||8. GRAM Rack Administrative procedure for user accounts                     ||[[span(Fail, style=background-color: red)]]      ||#81                 ||            ||
    23 ||9. GRAM Rack Administrative procedure for rack operations                   ||[[span(Fail, style=background-color: red)]]      ||#82                 ||            ||
    24 ||10. GRAM Rack Administrative procedure for rack scheduled shutdown          ||[[span(Fail, style=background-color: red)]]      ||#83              ||            ||
    25 ||11. GRAM Rack Administrative procedure for Emergency Stop.                  ||[[span(Fail, style=background-color: red)]]      ||#84              ||            ||
    26 ||12. GRAM Rack Administrative procedure for health status                    ||[[span(Fail, style=background-color: red)]]      ||#85              ||            ||
    27 ||13. GRAM Rack Site Operations documentation                                 ||[[span(Fail, style=background-color: red)]]      ||#86              ||            ||
    28 ||14. Site Specific GRAM Deployment Data                                      ||[[span(Fail, style=background-color: red)]]      ||#87              ||            ||
     15||1. OpenGENI Rack Installation Documentation                                     ||[[span(Partial, style=background-color: orange)]]||#74                 ||             ||
     16||2. OpenGENI Rack Part List Documentation                                        ||[[span(Fail, style=background-color: red)]]      ||#75                 ||             ||
     17||3. OpenGENI Software Components Identification Documentation                    ||[[span(Pass: most criteria, style=background-color: #98FB98)]]||#76                 ||             ||
     18||4. OpenGENI and OS Upgrade Plans                                                ||[[span(Fail, style=background-color: red)]]      ||#77                 ||             ||
     19||5. OpenGENI Software Components Functional Description and Access to Source code||[[span(Partial, style=background-color: orange)]]||#78             ||
     20||6. OpenGENI Rack Resources Usage and Policy Documentation                       ||[[span(Fail, style=background-color: red)]]      ||#79                 ||            ||
     21||7. OpenGENI Rack Resources Administration                                       ||[[span(Fail, style=background-color: red)]]      ||#80                 ||            ||
     22||8. OpenGENI Rack Administrative procedure for user accounts                     ||[[span(Fail, style=background-color: red)]]      ||#81                 ||            ||
     23||9. OpenGENI Rack Administrative procedure for rack operations                   ||[[span(Fail, style=background-color: red)]]      ||#82                 ||            ||
     24||10. OpenGENI Rack Administrative procedure for rack scheduled shutdown          ||[[span(Fail, style=background-color: red)]]      ||#83              ||            ||
     25||11. OpenGENI Rack Administrative procedure for Emergency Stop.                  ||[[span(Fail, style=background-color: red)]]      ||#84              ||            ||
     26||12. OpenGENI Rack Administrative procedure for health status                    ||[[span(Fail, style=background-color: red)]]      ||#85              ||            ||
     27||13. OpenGENI Rack Site Operations documentation                                 ||[[span(Fail, style=background-color: red)]]      ||#86              ||            ||
     28||14. Site Specific OpenGENI Deployment Data                                      ||[[span(Fail, style=background-color: red)]]      ||#87              ||            ||
    2929
    3030
     
    4040[[BR]]
    4141
    42 = GRAM Documentation Tests =
    43 
    44 The GRAM Documentation Tests focus on documentation review, and apply the following criteria for each document:
     42= OpenGENI Documentation Tests =
     43
     44The OpenGENI Documentation Tests focus on documentation review, and apply the following criteria for each document:
    4545 * The document has been provided in a public location. This criteria failed to be met, all documentation is internal for initial evaluation.
    4646 * The document contains the required information.
     
    4848
    4949Rack documentation available and reviewed to find required information includes:
    50  * [https://superior.bbn.com/trac/bbn-rack/wiki/AdministrationGuide GRAM Administration Guide]
    51  * [https://superior.bbn.com/trac/bbn-rack/wiki/InstallationGuideRevised  GRAM Installation Guide - Revised]
    52  * [https://superior.bbn.com/trac/bbn-rack/wiki/ArchitectureDescription GRAM Network and Software Architecture Description]
    53  * [https://superior.bbn.com/trac/bbn-rack/wiki/TestGuide GRAM Testing Guide]
    54  * [https://superior.bbn.com/trac/bbn-rack/wiki/UserGuide  GRAM Users Guide]
    55  * [https://superior.bbn.com/trac/bbn-rack/wiki/BOSRackDetails BBN GRAM Rack Details]
    56 
    57 
    58 
    59 == 1. GRAM Rack Installation Documentation ==   
     50 * [https://superior.bbn.com/trac/bbn-rack/wiki/AdministrationGuide OpenGENI Administration Guide]
     51 * [https://superior.bbn.com/trac/bbn-rack/wiki/InstallationGuideRevised  OpenGENI Installation Guide - Revised]
     52 * [https://superior.bbn.com/trac/bbn-rack/wiki/ArchitectureDescription OpenGENI Network and Software Architecture Description]
     53 * [https://superior.bbn.com/trac/bbn-rack/wiki/TestGuide OpenGENI Testing Guide]
     54 * [https://superior.bbn.com/trac/bbn-rack/wiki/UserGuide  OpenGENI Users Guide]
     55 * [https://superior.bbn.com/trac/bbn-rack/wiki/BOSRackDetails BBN OpenGENI Rack Details]
     56
     57
     58
     59== 1. OpenGENI Rack Installation Documentation ==   
    6060
    6161'''The goal of this evaluation:'''
     
    6666'''Evaluation Results:''' [[span(Partial, style=background-color: orange)]]
    6767
    68 Found:  The page [https://superior.bbn.com/trac/bbn-rack/wiki/BOSRackDetails BBN GRAM Rack Details] has:
     68Found:  The page [https://superior.bbn.com/trac/bbn-rack/wiki/BOSRackDetails BBN OpenGENI Rack Details] has:
    6969 - mentions of Power Control Units, but no information was found about any power requirements, power plugs circuits, cooling requirements.
    7070 - points the reader to the [http://groups.geni.net/geni/wiki/GENIRacksHome#GENIStarterRacks Starter Rack] information, where device type information is found. 
     
    7575
    7676 
    77 == 2. GRAM Rack Part List Documentation ==     
    78 
    79 
    80 '''The goal of this evaluation:'''
    81 
    82 To find a summary GRAM Rack parts list, including vendor part numbers for "standard" equipment intended for all sites (e.g. a VM server) and per-site equipment options (e.g. transceivers, PDUs etc.), if any.  This document should also indicate approximately how much headroom, if any, remains in the standard rack PDUs' power budget to support other equipment that sites may add to the rack.
     77== 2. OpenGENI Rack Part List Documentation ==     
     78
     79
     80'''The goal of this evaluation:'''
     81
     82To find a summary OpenGENI Rack parts list, including vendor part numbers for "standard" equipment intended for all sites (e.g. a VM server) and per-site equipment options (e.g. transceivers, PDUs etc.), if any.  This document should also indicate approximately how much headroom, if any, remains in the standard rack PDUs' power budget to support other equipment that sites may add to the rack.
    8383
    8484
     
    8686
    8787Found:
    88  - [https://superior.bbn.com/trac/bbn-rack/wiki/BOSRackDetails BBN GRAM Rack Details] points to [http://groups.geni.net/geni/wiki/GENIRacksHome#GENIStarterRacks Starter Rack] which give a list of major rack components
     88 - [https://superior.bbn.com/trac/bbn-rack/wiki/BOSRackDetails BBN OpenGENI Rack Details] points to [http://groups.geni.net/geni/wiki/GENIRacksHome#GENIStarterRacks Starter Rack] which give a list of major rack components
    8989
    9090Did not find:
     
    9494
    9595 
    96 == 3. GRAM Software Components Identification Documentation  ==       
     96== 3. OpenGENI Software Components Identification Documentation  ==       
    9797
    9898'''The goal of this evaluation:'''
     
    103103
    104104Found:
    105  - Clearly defined components in [https://superior.bbn.com/trac/bbn-rack/wiki/ArchitectureDescription GRAM Network and Software Architecture Description].
    106  - Information for system configurations used in GRAM rack in the  [https://superior.bbn.com/trac/bbn-rack/wiki/InstallationGuideRevised  GRAM Installation Guide - Revised].
     105 - Clearly defined components in [https://superior.bbn.com/trac/bbn-rack/wiki/ArchitectureDescription OpenGENI Network and Software Architecture Description].
     106 - Information for system configurations used in OpenGENI rack in the  [https://superior.bbn.com/trac/bbn-rack/wiki/InstallationGuideRevised  OpenGENI Installation Guide - Revised].
    107107 - Pointer to gram-dev@bbn.com for software help.
    108108
     
    112112 
    113113
    114 == 4. GRAM and OS Upgrade Plans   ==                     
    115 
    116 '''The goal of this evaluation:'''
    117 
    118 Find documentation that explains how and when GRAM software and OS updates can be performed on a rack, including plans for notification and update if important security vulnerabilities in rack software are discovered.
     114== 4. OpenGENI and OS Upgrade Plans   ==                     
     115
     116'''The goal of this evaluation:'''
     117
     118Find documentation that explains how and when OpenGENI software and OS updates can be performed on a rack, including plans for notification and update if important security vulnerabilities in rack software are discovered.
    119119
    120120'''Evaluation Results:''' [[span(Fail, style=background-color: red)]]
    121121
    122122Found software update information in:
    123  - [https://superior.bbn.com/trac/bbn-rack/wiki/InstallationGuideRevised  GRAM Installation Guide - Revised] includes instructions for installing !OpenStack and GRAM on the control and compute nodes.
     123 - [https://superior.bbn.com/trac/bbn-rack/wiki/InstallationGuideRevised  OpenGENI Installation Guide - Revised] includes instructions for installing !OpenStack and OpenGENI on the control and compute nodes.
    124124
    125125Did not find:
     
    128128 - Security updates plans
    129129 
    130 == 5. GRAM Software Components Functional Description and Access to Source code ==   
     130== 5. OpenGENI Software Components Functional Description and Access to Source code ==   
    131131   
    132132'''The goal of this evaluation:'''
    133133
    134 Find documentation that provides a description of the GRAM software running on a standard rack, and explanation of how to get access to the source code of each piece of standard GENI software.
     134Find documentation that provides a description of the OpenGENI software running on a standard rack, and explanation of how to get access to the source code of each piece of standard GENI software.
    135135
    136136'''Evaluation Results:''' [[span(Partial, style=background-color: orange)]]
    137137
    138138Found:
    139  - Clearly defined components in [https://superior.bbn.com/trac/bbn-rack/wiki/ArchitectureDescription GRAM Network and Software Architecture Description].
     139 - Clearly defined components in [https://superior.bbn.com/trac/bbn-rack/wiki/ArchitectureDescription OpenGENI Network and Software Architecture Description].
    140140 - [https://superior.bbn.com/trac/bbn-rack/wiki/SoftwareRepository Software Repository] page, but no instructions for getting account.
    141141
     
    146146
    147147 
    148 == 6. GRAM Rack Resources Usage and Policy Documentation ==   
     148== 6. OpenGENI Rack Resources Usage and Policy Documentation ==   
    149149 
    150150'''The goal of this evaluation:''' [[span(Fail, style=background-color: red)]]
     
    157157
    158158   
    159 == 7. GRAM Rack Resources Administration ==               
     159== 7. OpenGENI Rack Resources Administration ==               
    160160
    161161'''The goal of this evaluation:'''
     
    166166
    167167Found:
    168  - [https://superior.bbn.com/trac/bbn-rack/wiki/UserGuide  GRAM Users Guide] give minimal insight into node roles in GRAM
    169  - [https://superior.bbn.com/trac/bbn-rack/wiki/BOSRackDetails BBN GRAM Rack Details] which defines the actual node settings for the GRAM Rack.
     168 - [https://superior.bbn.com/trac/bbn-rack/wiki/UserGuide  OpenGENI Users Guide] give minimal insight into node roles in OpenGENI
     169 - [https://superior.bbn.com/trac/bbn-rack/wiki/BOSRackDetails BBN OpenGENI Rack Details] which defines the actual node settings for the OpenGENI Rack.
    170170
    171171
     
    174174 
    175175
    176 == 8. GRAM Rack Administrative procedure for user accounts ==         
     176== 8. OpenGENI Rack Administrative procedure for user accounts ==         
    177177
    178178'''The goal of this evaluation:'''
     
    184184No document exists that defines how rack administrative and operator accounts are created.
    185185
    186 == 9.  GRAM Rack Administrative procedure for rack operations ==   
     186== 9.  OpenGENI Rack Administrative procedure for rack operations ==   
    187187
    188188'''The goal of this evaluation:'''
     
    194194No document exists that defines how to change IP addresses for all rack components
    195195
    196 == 10. GRAM Rack Administrative procedure for rack scheduled shutdown == 
     196== 10. OpenGENI Rack Administrative procedure for rack scheduled shutdown == 
    197197
    198198'''The goal of this evaluation:'''
     
    205205
    206206     
    207 == 11. GRAM Rack Administrative procedure for Emergency Stop. ==     
     207== 11. OpenGENI Rack Administrative procedure for Emergency Stop. ==     
    208208 
    209209'''The goal of this evaluation:'''
     
    216216No document exists that defines Emergency Stop
    217217
    218 == 12. GRAM Rack Administrative procedure for health status ==   
     218== 12. OpenGENI Rack Administrative procedure for health status ==   
    219219     
    220220'''The goal of this evaluation:'''
     
    226226No document exists that defines health check procedures.
    227227 
    228 == 13. GRAM Rack Site Operations documentation ==     
     228== 13. OpenGENI Rack Site Operations documentation ==     
    229229 
    230230'''The goal of this evaluation:'''
     
    234234'''Evaluation Results:''' [[span(Fail, style=background-color: red)]]
    235235
    236 No hand-off procedures are defined for GRAM
    237 
    238 == 14. Site Specific GRAM Deployment Data ==               
     236No hand-off procedures are defined for OpenGENI
     237
     238== 14. Site Specific OpenGENI Deployment Data ==               
    239239   
    240240'''The goal of this evaluation:'''
     
    250250'''Evaluation Results:''' [[span(Fail, style=background-color: red)]]
    251251
    252 No document exists that defined deployments details described above. 
    253 
     252No document exists that defined deployments details described above