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


Ignore:
Timestamp:
05/23/14 12:41:48 (5 years ago)
Author:
lnevers@bbn.com
Comment:

--

Legend:

Unmodified
Added
Removed
Modified
  • GENIRacksHome/OpenGENIRacks/AcceptanceTestStatusApr2014/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/AcceptanceTestStatusApr2014 Acceptance Test Status - April 2014] 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/AcceptanceTestStatusApr2014 Acceptance Test Status - April 2014] page overall status, or the [wiki:GENIRacksHome/AcceptanceTests/OpenGENIAcceptanceTestsPlan OpenGENI Acceptance Test Plan] for details about the planned evaluation.
    55
    66
     
    1010
    1111|| '''Documentation'''                                                        ||'''State'''                                      || ''' Tickets ''' || '''Notes''' ||
    12 ||1. GRAM Rack Installation Documentation                                     ||[[span(Pass: most criteria, style=background-color: #98FB98)]]||74                 ||             ||
    13 ||2. GRAM Rack Part List Documentation                                        ||[[span(Pass: most criteria, style=background-color: #98FB98)]]||75                 ||             ||
    14 ||3. GRAM Software Components Identification Documentation                    ||[[span(Pass, style=background-color: green )]]                ||~~76~~                 ||             ||
    15 ||4. GRAM and OS Upgrade Plans                                                ||[[span(Pass, style=background-color: green )]]                ||~~77~~                 ||             ||
    16 ||5. GRAM Software Components Functional Description and Access to Source code||[[span(Pass, style=background-color: green )]]                ||~~78~~             ||
    17 ||6. GRAM Rack Resources Usage and Policy Documentation                       ||[[span(In Progress, style=background-color: #63B8FF)]]        ||79                 ||            ||
    18 ||7. GRAM Rack Resources Administration                                       ||[[span(Pass: most criteria, style=background-color: #98FB98)]]||80                 ||            ||
    19 ||8. GRAM Rack Administrative procedure for user accounts                     ||[[span(Pass, style=background-color: green )]]                ||~~81~~                 ||            ||
    20 ||9. GRAM Rack Administrative procedure for rack operations                   ||[[span(Pass, style=background-color: green )]]                ||~~82~~                 ||            ||
    21 ||10. GRAM Rack Administrative procedure for rack scheduled shutdown          ||[[span(Pass, style=background-color: green )]]                ||~~83~~              ||            ||
    22 ||11. GRAM Rack Administrative procedure for Emergency Stop.                  ||[[span(In Progress, style=background-color: #63B8FF)]]        ||84              ||            ||
    23 ||12. GRAM Rack Administrative procedure for health status                    ||[[span(Pass, style=background-color: green )]]                ||~~85~~              ||            ||
    24 ||13. GRAM Rack Site Operations documentation                                 ||[[span(Fail, style=background-color: red)]]                   ||86              ||            ||
    25 ||14. Site Specific GRAM Deployment Data                                      ||[[span(Pass, style=background-color: green )]]       ||~~87~~              ||            ||
     12||1. OpenGENI Rack Installation Documentation                                     ||[[span(Pass: most criteria, style=background-color: #98FB98)]]||74                 ||             ||
     13||2. OpenGENI Rack Part List Documentation                                        ||[[span(Pass: most criteria, style=background-color: #98FB98)]]||75                 ||             ||
     14||3. OpenGENI Software Components Identification Documentation                    ||[[span(Pass, style=background-color: green )]]                ||~~76~~                 ||             ||
     15||4. OpenGENI and OS Upgrade Plans                                                ||[[span(Pass, style=background-color: green )]]                ||~~77~~                 ||             ||
     16||5. OpenGENI Software Components Functional Description and Access to Source code||[[span(Pass, style=background-color: green )]]                ||~~78~~             ||
     17||6. OpenGENI Rack Resources Usage and Policy Documentation                       ||[[span(In Progress, style=background-color: #63B8FF)]]        ||79                 ||            ||
     18||7. OpenGENI Rack Resources Administration                                       ||[[span(Pass: most criteria, style=background-color: #98FB98)]]||80                 ||            ||
     19||8. OpenGENI Rack Administrative procedure for user accounts                     ||[[span(Pass, style=background-color: green )]]                ||~~81~~                 ||            ||
     20||9. OpenGENI Rack Administrative procedure for rack operations                   ||[[span(Pass, style=background-color: green )]]                ||~~82~~                 ||            ||
     21||10. OpenGENI Rack Administrative procedure for rack scheduled shutdown          ||[[span(Pass, style=background-color: green )]]                ||~~83~~              ||            ||
     22||11. OpenGENI Rack Administrative procedure for Emergency Stop.                  ||[[span(In Progress, style=background-color: #63B8FF)]]        ||84              ||            ||
     23||12. OpenGENI Rack Administrative procedure for health status                    ||[[span(Pass, style=background-color: green )]]                ||~~85~~              ||            ||
     24||13. OpenGENI Rack Site Operations documentation                                 ||[[span(Fail, style=background-color: red)]]                   ||86              ||            ||
     25||14. Site Specific OpenGENI Deployment Data                                      ||[[span(Pass, style=background-color: green )]]       ||~~87~~              ||            ||
    2626
    2727
     
    3737[[BR]]
    3838
    39 = GRAM Documentation Tests =
    40 
    41 The GRAM Documentation Tests focus on documentation review, and apply the following criteria for each document:
     39= OpenGENI Documentation Tests =
     40
     41The OpenGENI Documentation Tests focus on documentation review, and apply the following criteria for each document:
    4242 * The document has been provided in a public location. This criteria failed to be met, all documentation is internal for initial evaluation.
    4343 * The document contains the required information.
     
    4545
    4646Rack documentation available and reviewed to find required information includes:
    47  * [https://superior.bbn.com/trac/bbn-rack/wiki/AdministrationGuide GRAM Administration Guide] - No changes were made to this page in since the last evaluation.
    48  * [https://superior.bbn.com/trac/bbn-rack/wiki/InstallationGuideGrizzly GRAM Installation Guide with Grizzly !OpenStack] Significant changes where made to this guide.
    49  * [https://superior.bbn.com/trac/bbn-rack/wiki/ArchitectureDescription GRAM Network and Software Architecture Description]  - Minimal changes were made to this document since last evaluation.
    50  * [https://superior.bbn.com/trac/bbn-rack/wiki/TestGuide GRAM Testing Guide] - No changes were made to this page in since the last evaluation.
    51  * [https://superior.bbn.com/trac/bbn-rack/wiki/UserGuide  GRAM Users Guide] - Changes have been made to this guide to capture new features.
    52  * [https://superior.bbn.com/trac/bbn-rack/wiki/DellRackDetails Details on BBN-CAM GRAM Rack Installation and Configuration] details pages.
    53 
    54 
    55 == 1. GRAM Rack Installation Documentation ==   
     47 * [https://superior.bbn.com/trac/bbn-rack/wiki/AdministrationGuide OpenGENI Administration Guide] - No changes were made to this page in since the last evaluation.
     48 * [https://superior.bbn.com/trac/bbn-rack/wiki/InstallationGuideGrizzly OpenGENI Installation Guide with Grizzly !OpenStack] Significant changes where made to this guide.
     49 * [https://superior.bbn.com/trac/bbn-rack/wiki/ArchitectureDescription OpenGENI Network and Software Architecture Description]  - Minimal changes were made to this document since last evaluation.
     50 * [https://superior.bbn.com/trac/bbn-rack/wiki/TestGuide OpenGENI Testing Guide] - No changes were made to this page in since the last evaluation.
     51 * [https://superior.bbn.com/trac/bbn-rack/wiki/UserGuide  OpenGENI Users Guide] - Changes have been made to this guide to capture new features.
     52 * [https://superior.bbn.com/trac/bbn-rack/wiki/DellRackDetails Details on BBN-CAM OpenGENI Rack Installation and Configuration] details pages.
     53
     54
     55== 1. OpenGENI Rack Installation Documentation ==   
    5656
    5757'''The goal of this evaluation:'''
     
    6161'''Evaluation Results''': [[span(Pass: most criteria, style=background-color: #98FB98)]]
    6262
    63 The page [https://superior.bbn.com/trac/bbn-rack/wiki/DellRackDetails Details on BBN-CAM GRAM Rack Installation and Configuration] and found:
     63The page [https://superior.bbn.com/trac/bbn-rack/wiki/DellRackDetails Details on BBN-CAM OpenGENI Rack Installation and Configuration] and found:
    6464 - Rack space requirements
    6565 - Power requirements 
     
    7171 - Core backbone connectivity requirements (layer2).
    7272
    73 == 2. GRAM Rack Part List Documentation ==     
    74 
    75 
    76 '''The goal of this evaluation:'''
    77 
    78 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.
     73== 2. OpenGENI Rack Part List Documentation ==     
     74
     75
     76'''The goal of this evaluation:'''
     77
     78To 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.
    7979
    8080'''Evaluation Results''': [[span(Pass: most criteria, style=background-color: #98FB98)]]
     
    8383 - Document that indicates approximately how much headroom, if any, remains in the standard rack PDUs' power budget to support additional equipment added by site to the rack.
    8484
    85 == 3. GRAM Software Components Identification Documentation  ==       
     85== 3. OpenGENI Software Components Identification Documentation  ==       
    8686
    8787'''The goal of this evaluation:'''
     
    9292
    9393Found:
    94  - Clearly defined components in [https://superior.bbn.com/trac/bbn-rack/wiki/ArchitectureDescription GRAM Network and Software Architecture Description].
    95  - Information for system configurations used in GRAM rack in the  [https://superior.bbn.com/trac/bbn-rack/wiki/InstallationGuideRevised  GRAM Installation Guide - Revised].
     94 - Clearly defined components in [https://superior.bbn.com/trac/bbn-rack/wiki/ArchitectureDescription OpenGENI Network and Software Architecture Description].
     95 - Information for system configurations used in OpenGENI rack in the  [https://superior.bbn.com/trac/bbn-rack/wiki/InstallationGuideRevised  OpenGENI Installation Guide - Revised].
    9696 - Software Configuration versioning for components installed on the   [https://superior.bbn.com/trac/bbn-rack/wiki/DellRackDetails#SoftwareConfiguration BBN-CAM] rack.
    9797 - [https://superior.bbn.com/trac/bbn-rack/wiki/SoftwareRepository Software Repository] page provides a pointer to gram-dev@bbn.com for software help and for access to git repository, where recent configuration and software changes are captured.
    9898
    99 == 4. GRAM and OS Upgrade Plans   ==                     
    100 
    101 '''The goal of this evaluation:'''
    102 
    103 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.
     99== 4. OpenGENI and OS Upgrade Plans   ==                     
     100
     101'''The goal of this evaluation:'''
     102
     103Find 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.
    104104
    105105'''Evaluation Results:''' [[span(Pass, style=background-color: green )]]
    106106
    107107Found software update information in:
    108  - [https://superior.bbn.com/trac/bbn-rack/wiki/InstallationGuideGrizzly GRAM Installation Guide with OpenStack Grizzly] includes:
     108 - [https://superior.bbn.com/trac/bbn-rack/wiki/InstallationGuideGrizzly OpenGENI Installation Guide with OpenStack Grizzly] includes:
    109109    * Configuration Overview
    110110    * Network Configuration for !OpenFlow Switch for the Data Network and for Management Switch
    111     * GRAM and OpenStack Installation and Configuration
    112     * Testing GRAM installation
     111    * OpenGENI and OpenStack Installation and Configuration
     112    * Testing OpenGENI installation
    113113    * Debugging Notes
    114  - [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.
     114 - [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.
    115115 - Was able to verify package update instructions.
    116116
     
    121121Documentation is to be moved to external wiki.
    122122
    123 == 5. GRAM Software Components Functional Description and Access to Source code ==   
     123== 5. OpenGENI Software Components Functional Description and Access to Source code ==   
    124124   
    125125'''The goal of this evaluation:'''
    126126
    127 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.
     127Find 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.
    128128
    129129'''Evaluation Results:''' [[span(Pass, style=background-color: green )]]
    130130
    131131Found:
    132  - Clearly defined components in [https://superior.bbn.com/trac/bbn-rack/wiki/ArchitectureDescription GRAM Network and Software Architecture Description].
    133  - [https://superior.bbn.com/trac/bbn-rack/wiki/InstallationGuideGrizzly Installation Instructions] for OpenStack Grizzly package and GRAM installation.
     132 - Clearly defined components in [https://superior.bbn.com/trac/bbn-rack/wiki/ArchitectureDescription OpenGENI Network and Software Architecture Description].
     133 - [https://superior.bbn.com/trac/bbn-rack/wiki/InstallationGuideGrizzly Installation Instructions] for OpenStack Grizzly package and OpenGENI installation.
    134134 - [https://superior.bbn.com/trac/bbn-rack/wiki/SoftwareRepository Software Repository] page with instructions for getting account.
    135135
    136136Need to be moved to external wiki.
    137137 
    138 == 6. GRAM Rack Resources Usage and Policy Documentation ==   
     138== 6. OpenGENI Rack Resources Usage and Policy Documentation ==   
    139139 
    140140'''The goal of this evaluation:'''
     
    147147
    148148
    149 == 7. GRAM Rack Resources Administration ==               
     149== 7. OpenGENI Rack Resources Administration ==               
    150150
    151151'''The goal of this evaluation:'''
     
    156156
    157157Found:
    158  - [https://superior.bbn.com/trac/bbn-rack/wiki/InstallationGuideGrizzly Installation Instructions] for OpenStack Grizzly package and GRAM installation.
    159  - [https://superior.bbn.com/trac/bbn-rack/wiki/UserGuide  GRAM Users Guide] give minimal insight into node roles in GRAM
    160  - [https://superior.bbn.com/trac/bbn-rack/wiki/BOSRackDetails BBN GRAM Rack Details] which defines the actual node settings for the GRAM Rack.
     158 - [https://superior.bbn.com/trac/bbn-rack/wiki/InstallationGuideGrizzly Installation Instructions] for OpenStack Grizzly package and OpenGENI installation.
     159 - [https://superior.bbn.com/trac/bbn-rack/wiki/UserGuide  OpenGENI Users Guide] give minimal insight into node roles in OpenGENI
     160 - [https://superior.bbn.com/trac/bbn-rack/wiki/BOSRackDetails BBN OpenGENI Rack Details] which defines the actual node settings for the OpenGENI Rack.
    161161
    162162Did not find:
     
    165165All the above need to be moved to external location.
    166166
    167 == 8. GRAM Rack Administrative procedure for user accounts ==         
     167== 8. OpenGENI Rack Administrative procedure for user accounts ==         
    168168
    169169'''The goal of this evaluation:'''
     
    174174
    175175Found:
    176  - The [http://groups.geni.net/geni/wiki/GENIRacksAdministration/GRAMRacksAdminAccounts GRAM Administrative Accounts] instructions were verified by having Local Site Admin add and remove administrative access to all rack components.
    177 
    178 
    179 == 9.  GRAM Rack Administrative procedure for rack operations ==   
     176 - The [http://groups.geni.net/geni/wiki/GENIRacksAdministration/OpenGENIRacksAdminAccounts OpenGENI Administrative Accounts] instructions were verified by having Local Site Admin add and remove administrative access to all rack components.
     177
     178
     179== 9.  OpenGENI Rack Administrative procedure for rack operations ==   
    180180
    181181'''The goal of this evaluation:'''
     
    187187Procedure verified.
    188188
    189 == 10. GRAM Rack Administrative procedure for rack scheduled shutdown == 
     189== 10. OpenGENI Rack Administrative procedure for rack scheduled shutdown == 
    190190
    191191'''The goal of this evaluation:'''
     
    197197Found:
    198198
    199 Was able to execute [https://superior.bbn.com/trac/bbn-rack/wiki/AcceptanceTestStatusApr2014/GR-ADM-3 GR-ADM-3: Full Rack Reboot Test] and verify the procedure.   
     199Was able to execute [https://superior.bbn.com/trac/bbn-rack/wiki/AcceptanceTestStatusApr2014/OG-ADM-3 OG-ADM-3: Full Rack Reboot Test] and verify the procedure.   
    200200
    201201     
    202 == 11. GRAM Rack Administrative procedure for Emergency Stop. ==     
     202== 11. OpenGENI Rack Administrative procedure for Emergency Stop. ==     
    203203 
    204204'''The goal of this evaluation:'''
     
    211211 - Skeleton outline for [https://superior.bbn.com/trac/bbn-rack/wiki/EmergencyStop Emergency Stop Procedure].
    212212
    213 Was unable to verify, expect to execute [https://superior.bbn.com/trac/bbn-rack/wiki/AcceptanceTestStatusDec2013/GR-ADM-4 GR-ADM-4: Emergency Stop Test] in order to verify content of procedure.
    214 
    215 == 12. GRAM Rack Administrative procedure for health status ==   
     213Was unable to verify, expect to execute [https://superior.bbn.com/trac/bbn-rack/wiki/AcceptanceTestStatusDec2013/OG-ADM-4 OG-ADM-4: Emergency Stop Test] in order to verify content of procedure.
     214
     215== 12. OpenGENI Rack Administrative procedure for health status ==   
    216216     
    217217'''The goal of this evaluation:'''
     
    221221'''Evaluation Results:''' [[span(Pass, style=background-color: green )]]
    222222
    223 No documentation exist that defines how to monitor GRAM component health.  Found healthcheck.py but there is no documentation for it.????
     223No documentation exist that defines how to monitor OpenGENI component health.  Found healthcheck.py but there is no documentation for it.????
    224224 
    225 == 13. GRAM Rack Site Operations documentation ==     
     225== 13. OpenGENI Rack Site Operations documentation ==     
    226226 
    227227'''The goal of this evaluation:'''
     
    234234No documentation found.
    235235
    236 == 14. Site Specific GRAM Deployment Data ==               
     236== 14. Site Specific OpenGENI Deployment Data ==               
    237237   
    238238'''The goal of this evaluation:'''
     
    254254Additionally, there are new operator and experimenter pages that are being worked on at this time at:
    255255
    256     ​http://groups.geni.net/geni/wiki/GeniAggregate/ClemsonGRAM
    257 
    258     ​http://groups.geni.net/geni/wiki/GENIRacksHome/GRAMRacks/Operators
     256    ​http://groups.geni.net/geni/wiki/GeniAggregate/ClemsonOpenGENI
     257
     258    ​http://groups.geni.net/geni/wiki/GENIRacksHome/OpenGENIRacks/Operators