From ad6e3ed60fea5ac060aa9066678d119ba47f9a2b Mon Sep 17 00:00:00 2001 From: Yujun Zhang Date: Sat, 5 Nov 2016 19:02:34 +0800 Subject: Update README - archived the old README as release note of Brahmaputra - updated the project description Change-Id: Iad582aee45170701ec5df7c6dad5aa4a0935d95f JIRA: QTIP-144 Signed-off-by: Yujun Zhang --- README | 73 ++---------------------------------- docs/releasenotes/brahmaputra.rst | 78 +++++++++++++++++++++++++++++++++++++++ docs/releasenotes/index.rst | 14 +++++++ 3 files changed, 96 insertions(+), 69 deletions(-) create mode 100644 docs/releasenotes/brahmaputra.rst create mode 100644 docs/releasenotes/index.rst diff --git a/README b/README index 4f5759bc..083b1ad6 100644 --- a/README +++ b/README @@ -1,71 +1,6 @@ -QTIP Benchmark Suite ---------------------- +QTIP is a performance benchmark service for OPNFV platform -QTIP is a benchmarking suite intended to benchmark the following components of the OPNFV Platform: +QTIP aims to benchmark OPNFV platforms through a "Bottom up" approach. Emphasis +on platform performance through quantitative benchmarks rather than validation. -1. Computing components -2. Networking components -3. Storage components - -The efforts in QTIP are mostly focused on identifying - -1. Benchmarks to run -2. Test cases in which these benchmarks to run -3. Automation of suite to run benchmarks within different test cases -4. Collection of test results - -QTIP Framework can now be called: (qtip.py). - -The Framework can run 5 computing benchmarks: - -1. Dhrystone -2. Whetstone -3. RamBandwidth -4. SSL -5. nDPI - -These benchmarks can be run in 2 test cases: - -1. VM vs Baremetal -2. Baremetal vs Baremetal - -Instructions to run the script: - -1. Download and source the OpenStack `adminrc` file for the deployment on which you want to create the VM for benchmarking -2. run `python qtip.py -s {SUITE} -b {BENCHMARK}` -3. run `python qtip.py -h` for more help -4. list of benchmarks can be found in the `qtip/test_cases` directory -5. SUITE refers to compute, network or storage - -Requirements: - -1. Ansible 1.9.2 -2. Python 2.7 -3. PyYAML - -Configuring Test Cases: - -Test cases can be found within the `test_cases` directory. -For each Test case, a Config.yaml file contains the details for the machines upon which the benchmarks would run. -Edit the IP and the Password fields within the files for the machines on which the benchmark is to run. -A robust framework that would allow to include more tests would be included within the future. - -Jump Host requirements: - -The following packages should be installed on the server from which you intend to run QTIP. - -1: Heat Client -2: Glance Client -3: Nova Client -4: Neutron Client -5: wget -6: PyYaml - -Networking - -1: The Host Machines/compute nodes to be benchmarked should have public/access network -2: The Host Machines/compute nodes should allow Password Login - -QTIP support for Foreman - -{TBA} +See [project wiki](https://wiki.opnfv.org/display/qtip) for more information. diff --git a/docs/releasenotes/brahmaputra.rst b/docs/releasenotes/brahmaputra.rst new file mode 100644 index 00000000..92fafd80 --- /dev/null +++ b/docs/releasenotes/brahmaputra.rst @@ -0,0 +1,78 @@ +*********** +Brahmaputra +*********** + +NOTE: The release note for OPNFV Brahmaputra is missing. This is a copy of the +README. + +QTIP Benchmark Suite +==================== + +QTIP is a benchmarking suite intended to benchmark the following components of the OPNFV Platform: + +1. Computing components +2. Networking components +3. Storage components + +The efforts in QTIP are mostly focused on identifying + +1. Benchmarks to run +2. Test cases in which these benchmarks to run +3. Automation of suite to run benchmarks within different test cases +4. Collection of test results + +QTIP Framework can now be called: (qtip.py). + +The Framework can run 5 computing benchmarks: + +1. Dhrystone +2. Whetstone +3. RamBandwidth +4. SSL +5. nDPI + +These benchmarks can be run in 2 test cases: + +1. VM vs Baremetal +2. Baremetal vs Baremetal + +Instructions to run the script: + +1. Download and source the OpenStack `adminrc` file for the deployment on which you want to create the VM for benchmarking +2. run `python qtip.py -s {SUITE} -b {BENCHMARK}` +3. run `python qtip.py -h` for more help +4. list of benchmarks can be found in the `qtip/test_cases` directory +5. SUITE refers to compute, network or storage + +Requirements: + +1. Ansible 1.9.2 +2. Python 2.7 +3. PyYAML + +Configuring Test Cases: + +Test cases can be found within the `test_cases` directory. +For each Test case, a Config.yaml file contains the details for the machines upon which the benchmarks would run. +Edit the IP and the Password fields within the files for the machines on which the benchmark is to run. +A robust framework that would allow to include more tests would be included within the future. + +Jump Host requirements: + +The following packages should be installed on the server from which you intend to run QTIP. + +1: Heat Client +2: Glance Client +3: Nova Client +4: Neutron Client +5: wget +6: PyYaml + +Networking + +1: The Host Machines/compute nodes to be benchmarked should have public/access network +2: The Host Machines/compute nodes should allow Password Login + +QTIP support for Foreman + +{TBA} diff --git a/docs/releasenotes/index.rst b/docs/releasenotes/index.rst new file mode 100644 index 00000000..5d045388 --- /dev/null +++ b/docs/releasenotes/index.rst @@ -0,0 +1,14 @@ +.. This work is licensed under a Creative Commons Attribution 4.0 International License. +.. http://creativecommons.org/licenses/by/4.0 +.. (c) 2015 Dell Inc. +.. (c) 2016 ZTE Corp. + + +################## +QTIP Release Notes +################## + +.. toctree:: + :maxdepth: 2 + + brahmaputra.rst -- cgit 1.2.3-korg