===== Project Name: PolicyTest =====

  * Proposed name for the project: ''PolicyTest''
  * Proposed name for the repository: ''policytest''
  * Project Category: Integration & Testing

==== Project description ====

PolicyTest adds network policy testing to the existing suite of OPNFV functional tests. Testing focuses on network configuration policy testing following the principles of "group based policy". "Group based policy" allows users to express network configuration in a declarative way, i.e. describe policy in terms of "what you want", rather than "how you'd do it". Further details on "group based policy" can be found on the following wiki: [[https://wiki.opendaylight.org/view/Group_Based_Policy_(GBP)|wiki.opendaylight.org/view/Group_Based_Policy_(GBP)]]
PolicyTest defines and implements system-level policy tests and integrates them into OPNFV CI/CD pipeline.
PolicyTest closely liases with OPNFV projects (Copper, Octopus, Releng, etc.) as well as network policy related upstream projects (Opendaylight GBP).

==== Scope ====
  * Functional testing of policy test cases on the OPNFV platform
    * Define system-level test cases for group based policy
    * Scripts to allow for automatic creation and execution of test cases
    * Integration with test-automation framework (e.g. Robot, Yardstick)
    * Integrate with OPNFV CI/CD pipeline
  * Example test cases considered for PolicyTest include:
    * Define policy  contracts (symmetric as well as asymmetric) and control communication between two groups of simple VNFs.
    * Define policy  contracts and control communication between two groups of simple VNFs.
    * Policy contract (symmetric as well as asymmetric) between a series of VNFs that are sequenced/chained.
    * Policy contract between a set of virtual (VNF) and physical endpoints for different logical topologies (any-to-any, hub-and-spoke).

==== Dependencies ====
PolicyTest will augment the existing functional tests. It'll work in close interlock with the following projects.
  * Virtualized Infrastructure Deployment Policies (Copper)
  * Functional and System Testing (FuncTest, Yardstick)
  * OpenDaylight Group Based Policy project (https://wiki.opendaylight.org/view/Group_Based_Policy_(GBP)
  * ONOSFW /Jury :  Intent Based Policy (IBP)for ONOSFW
==== Committers and Contributors ====

  * Committers:
    * Keith Burns (krb@cisco.com)
    * Bryan Sullivan (bs3131@att.com)
    * Brady Allen Johnson (brady.allen.johnson@ericsson.com)
    * Peter Bandzi (pbandzi@cisco.com)
    * Prakash Ramchandran (prakash.ramchandran@huawei.com)
    * Reinaldo Penno (rapenno@gmail.com

  * Additional contributors:
    * Frank Brockners (fbrockne@cisco.com)

==== Planned deliverables ====

  * Definition and associated description of system-level test cases for group based policy
  * Scripts to allow for automatic creation and execution of test cases
  * Integration with test-automation framework (Robot, Yardstick)
  * Integration into OPNFV CI/CD pipeline
  * User-guide / documentation
==== Proposed Release Schedule ====

Initial set of system-level network policy test cases are expected to be available as part of OPNFV Brahmaputra release.

===== Key Project Facts =====

** Project Name: ** policytest \\
** Repo name: ** policytest \\
** Project Category: integration and testing ** \\
** Lifecycle State: ** Incubation\\
** Primary Contact: ** Keith Burns\\
** Project Lead: ** Keith Burns\\
** Jira Project Name: ** PolicyTest \\
** Jira Project Prefix: ** [POLICYTEST] \\
** mailing list tag ** [policytest] \\
** Committers: ** \\
Keith Burns (krb@cisco.com)\\
Bryan Sullivan (bs3131@att.com)\\
Brady Allen Johnson (brady.allen.johnson@ericsson.com)\\
Peter Bandzi (pbandzi@cisco.com)\\
Reinaldo Penno (rapenno@gmail.com) \\

 \\
** Link to TSC approval: ** http://ircbot.wl.linuxfoundation.org/meetings/opnfv-meeting/2015/opnfv-meeting.2015-08-25-14.00.html \\ 
** Link to approval of additional submitters: ** TBD \\