Intel® VCA2 AVC Benchmark Script README

Description:
==========================================================================
AVC Benchmark is a automated script  which runs sample multi transcode in parallel on each node to test the density(number of streams) that can be run at 30fps.It collects temp data saved as avc_benchmark_sorted_temp.txt in logs folder , for user to analyse cpu temperature.

To collect temperature data for a long run, we recommend to use a persistent image and copy file "big_buck_bunny_1080p_long.264" from home directory to "../vvvalidation/tools/h264/input" and rename file to "big_buck_bunny_1080p.264"

It provides best benchmarking target results supported by your server configuration.
Before running the script, Kindly make sure that all nodes of Intel® VCA2 are up and running with state "NET_DEVICE_READY".
To get the state of each node, run command : vcactl status

Note: The Benchmark Script is validated only on CentOS 7.2 and above.
And to run this benchmark , you need to make sure the Operating systems on each node has Intel Media Server Studio installed (PV3 or PV4 version).
Make sure that vainfo is present at location /usr/bin on each node.


Getting Started:
==========================================================================
This project requires that the user has root priviliges and make sure the VCA2 card is setup with all the nodes are up and running.
On the Host : To run the benchmark, navigate to vvvalidation\tools\scripts folder to run the avc_benchmark file.
Please run below command to make avc_benchmark executable, if not already done so. 
#	chmod +x keygen avc_benchmark
#	yum install sshpass 

Steps to run the benchmark are as below:-

1) ./avc_benchmark


The following directory structure reflects how the project is setup:

    +---tools
        +---h264
        ¦   +---bin
        ¦   +---input
        ¦   +---logs
        ¦   +---scripts
        +---scripts
            +---bridging


Licensing:
==========================================================================

- AVC Benchmark Script is provided to developers under the Intel Code Samples License.
- The Sample_multi-Transcode is  under the BSD 3-clause "New" or "Revised" License.
- For the purposes of AVC benchmark the a sample clip Big Buck Bunny was downloaded from https://peach.blender.org/download/.
  Peach open movie project has been licensed under the Creative Commons Attribution 3.0 license.”

 
Development Environment Requirements:
==========================================================================
Development environment requirements for AVC Benchmark Script include the following file , tools, software development kits, and os support: 
1. Setting up the Intel® VCA Card2
2. Refer to the SW Guide
3. Making sure sshpass is installed using command yum install sshpass

Attribution and Thanks:
==========================================================================
The AVC Benchmark Script leverages Big Buck Buny test clip downloaded from https://peach.blender.org/about/.
The only modification made to this clip is , We have reduced the duration of the clip to 10 seconds using ffmpeg. Special thanks to the (c) copyright 2008, Blender Foundation / www.bigbuckbunny.org for this very useful test content.
Please note that this content is provided under the under the Creative Commons Attribution 3.0 license.”
Full license text may be found within the license folder and at the following online link: https://creativecommons.org/licenses/by/3.0/legalcode


Version 1.0 , Date Modified 06/05/2018