[[PageOutline]] = Detailed test plan for EG-MON-3: GENI Active Experiment Inspection Test = ''This page is GPO's working page for performing EG-MON-3. It is public for informational purposes, but it is not an official status report. See [wiki:GENIRacksHome/ExogeniRacks/AcceptanceTestStatus] for the current status of ExoGENI acceptance tests.'' ''Last substantive edit of this page: 2012-05-03'' == Page format == * The status chart summarizes the state of this test * The high-level description from test plan contains text copied exactly from the public test plan and acceptance criteria pages. * The steps contain things i will actually do/verify: * Steps may be composed of related substeps where i find this useful for clarity * Each step is either a preparatory step (identified by "(prep)") or a verification step (the default): * Preparatory steps are just things we have to do. They're not tests of the rack, but are prerequisites for subsequent verification steps * Verification steps are steps in which we will actually look at rack output and make sure it is as expected. They contain a '''Using:''' block, which lists the steps to run the verification, and an '''Expect:''' block which lists what outcome is expected for the test to pass. == Status of test == Meaning of states: * [[Color(green,okay)]]: Step is completed and passed (for a verification step), or is completed (for a prep step) * [[Color(red,failed)]]: Step is completed and failed, and is not being revisited * in progress: We are currently testing or iterating on this step * [[Color(orange,waiting)]]: Step is blocked by some other step or activity || '''Step''' || '''State''' || '''Date completed''' || '''Comments''' || || 1 || || || || || 2 || || || || || 3 || || || || || 4 || || || || || 5 || || || || == High-level description from test plan == This test inspects the state of the rack data plane and control networks when experiments are running, and verifies that a site administrator can find information about running experiments. ==== Procedure ==== * An experimenter from the GPO starts up experiments to ensure there is data to look at: * An experimenter runs an experiment containing at least one rack VM, and terminates it. * An experimenter runs an experiment containing at least one rack VM, and leaves it running. * A site administrator uses available system and experiment data sources to determine current experimental state, including: * How many VMs are running and which experimenters own them * How many VMs were terminated within the past day, and which experimenters owned them * What !OpenFlow controllers the data plane switch, the rack !FlowVisor, and the rack FOAM are communicating with * A site administrator examines the switches and other rack data sources, and determines: * What MAC addresses are currently visible on the data plane switch and what experiments do they belong to? * For some experiment which was terminated within the past day, what data plane and control MAC and IP addresses did the experiment use? * For some experimental data path which is actively sending traffic on the data plane switch, do changes in interface counters show approximately the expected amount of traffic into and out of the switch? === Criteria to verify as part of this test === * VII.09. A site administrator can determine the MAC addresses of all physical host interfaces, all network device interfaces, all active experimental VMs, and all recently-terminated experimental VMs. (C.3.f) * VII.11. A site administrator can locate current configuration of flowvisor, FOAM, and any other OpenFlow services, and find logs of recent activity and changes. (D.6.a) * VII.18. Given a public IP address and port, an exclusive VLAN, a sliver name, or a piece of user-identifying information such as e-mail address or username, a site administrator or GMOC operator can identify the email address, username, and affiliation of the experimenter who controlled that resource at a particular time. (D.7) == Step 1 (prep): start a local experiment and terminate it == * An experimenter requests an experiment from the local SM containing two rack VMs and a dataplane VLAN * The experimenter logs into a VM, and sends dataplane traffic * The experimenter terminates the experiment == Step 2 (prep): start an ExoSM experiment and terminate it == * An experimenter requests an experiment from the ExoSM containing two rack VMs and a dataplane VLAN * The experimenter logs into a VM, and sends dataplane traffic * The experimenter terminates the experiment == Step 3 (prep): start an experiment and leave it running == * An experimenter requests an experiment from the local SM containing two rack VMs and a dataplane VLAN * The experimenter logs into a VM, and begins sending a continuous stream of dataplane traffic == Step 4: view running VMs == '''Using:''' * On bbn-hn, use SM state, logs, or administrator interfaces to determine: * What experiments are running right now * How many VMs are allocated for those experiments * Which worker node is each VM running on * On bbn worker nodes, use system state, logs, or administrative interfaces to determine what VMs are running right now, and look at any available configuration or logs of each. '''Verify:''' * A site administrator can determine what experiments are running on the local SM * A site administrator can determine the mapping of VMs to active experiments * A site administrator can view some state of running VMs on the VM server == Step 5: get information about terminated VMs == '''Using:''' * On bbn-hn use SM state, logs, or administrator interfaces to find evidence of the two terminated experiments. * Determine how many other experiments were run in the past day. * Determine which GENI user created each of the terminated experiments. * Determine the mapping of experiments to VM servers for each of the terminated experiments. * Determine the control and dataplane MAC addresses assigned to each VM in each terminated experiment. * Determine any IP addresses assigned by ExoGENI to each VM in each terminated experiment. '''Verify:''' * A site administrator can get ownership and resource allocation information for recently-terminated experiments which were created on the local SM. * A site administrator can get ownership and resource allocation information for recently-terminated experiments which were created using ExoSM. * A site administrator can get information about MAC addresses and IP addresses used by recently-terminated experiments. == Step 6: get !OpenFlow state information == '''Using:''' * On the 8264 (dataplane) switch, get a list of controllers, and see if any additional controllers are serving experiments. * On bbn-hn, get a list of active FV slices from the !FlowVisor * On bbn-hn, get a list of active slivers from FOAM * On bbn-hn, use FV or FOAM to get a list of the flowspace of a running !OpenFlow experiment. '''Verify:''' * A site administrator can get information about the !OpenFlow resources used by running experiments. == Step 7: verify MAC addresses on the rack dataplane switch == '''Using:''' * Establish a privileged login to the 8264 (dataplane) switch * Obtain a list of the full MAC address table of the switch * On bbn-hn and the worker nodes, use available data sources to determine which host or VM owns each MAC address. '''Verify:''' * It is possible to identify and classify every MAC address visible on the switch == Step 8: verify active dataplane traffic === '''Using:''' * Establish a privileged login to the 8264 (dataplane) switch * Based on the information from Step 7, determine which interfaces are carrying traffic between the experimental VMs * Collect interface counters for those interfaces over a period of 10 minutes * Estimate the rate at which the experiment is sending traffic '''Verify:''' * The switch reports interface counters, and an administrator can obtain plausible estimates of dataplane traffic quantities by looking at them.