wiki:GENIRacksHome/ExogeniRacks/AcceptanceTestStatus/EG-ADM-7

Version 1 (modified by lnevers@bbn.com, 12 years ago) (diff)

--

EG-ADM-7: Documentation Review Test

This page captures status for the test case EG-ADM-7, which verifies the availability of Documentation for the ExoGENI rack. For overall status see the ExoGENI Acceptance Test Status page.

Test Status

This section captures the status for each step in the acceptance test plan.

Step State Ticket Comments


State Legend Description
Color(green,Pass)? Test completed and met all criteria
Color(#98FB98,Pass: most criteria)? Test completed and met most criteria. Exceptions documented
Color(red,Fail)? Test completed and failed to meet criteria.
Color(yellow,Complete)? Test completed but will require re-execution due to expected changes
Color(orange,Blocked)? Blocked by ticketed issue(s).
Color(#63B8FF,In Progress)? Currently under test.


Test Plan Steps

Documentation review criteria applied to each required document includes:

  • The document has been provided in a public location
  • The document contains the required information.
  • The documented information appears to be accurate.

Documents to be reviewed include:

  1. ExoGENI Rack Installation Documentation
  • Pre-installation document that lists specific minimum requirements for all site-provided services for potential rack sites (e.g. space, number and type of power plugs, number and type of power circuits, cooling load, public addresses, NLR or Internet2 layer2 connections, etc.). This document should also list all standard expected rack interfaces (e.g. 10GBE links to at least one research network).
  1. ExoGENI Rack Part List Documentation
  • Summary GENI 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.
  1. ExoGENI Software Components Identification Documentation
  • Procedure for identifying the software versions and system file configurations running on a rack, and how to get information about recent changes to the rack software and configuration.

4.ExoGENI and OS Upgrade Plans

  • Explanation of how and when 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.
  1. ExoGENI Software Components Functional Description and Access to Source code.
  • Description of the GENI software running on a standard rack, and explanation of how to get access to the source code of each piece of standard GENI software.
  1. ExoGENI Rack Resources Usage and Policy Documentation
  • Description of all the GENI experimental resources within the rack, and what policy options exist for each, including: how to configure rack nodes as bare metal vs. VM server, what options exist for configuring automated approval of compute and network resource requests and how to set them, how to configure rack aggregates to trust additional GENI slice authorities, and whether it is possible to trust local users within the rack.
  1. ExoGENI Rack Resources Administration
  • Description of the expected state of all the GENI experimental resources in the rack, including how to determine the state of an experimental resource and what state is expected for an unallocated bare metal node.
  1. ExoGENI Rack Administrative procedure for user accounts
  • Procedure for creating new site administrator and operator accounts.
  1. ExoGENI Rack Administrative procedure for rack operations
  • Procedure for changing IP addresses for all rack components.
  1. ExoGENI Rack Administrative procedure for rack scheduled shutdown
  • Procedure for cleanly shutting down an entire rack in case of a scheduled site outage.
  1. ExoGENI Rack Administrative procedure for Emergency Stop.
  • Procedure for performing a shutdown operation on any type of sliver on a rack, in support of an Emergency Stop request.
  1. ExoGENI Rack Administrative procedure for health status
  • Procedure for performing comprehensive health checks for a rack (or, if those health checks are being run automatically, how to view the current/recent results).
  1. ExoGENI Rack Site Operations documentation
  • Technical plan for handing off primary rack operations to site operators at all sites.
  1. Site Specific ExoGENI Deployment Details Data should include:
  • Per-site documentation. This documentation should be prepared before sites are installed and kept updated after installation to reflect any changes or upgrades after delivery. Text, network diagrams, wiring diagrams and labeled photos are all acceptable for site documents. Per-site documentation should include the following items for each site:
    1. Part numbers and quantities of PDUs, with NEMA input power connector types, and an inventory of which equipment connects to which PDU.
    2. Physical network interfaces for each control and data plane port that connects to the site's existing network(s), including type, part numbers, maximum speed etc. (eg. 10-GB-SR fiber)
    3. Public IP addresses allocated to the rack, including: number of distinct IP ranges and size of each range, hostname to IP mappings which should be placed in site DNS, whether the last-hop routers for public IP ranges subnets sit within the rack or elsewhere on the site, and what firewall configuration is desired for the control network.
    4. Data plane network connectivity and procedures for each rack, including core backbone connectivity and documentation, switch configuration options to set for compatibility with the L2 core, and the site and rack procedures for connecting non-rack-controlled VLANs and resources to the rack data plane. A network diagram is highly recommended (See existing OpenFlow meso-scale network diagrams on the GENI wiki for examples.)