B2G/QA/Test Automation/mozcingi: Difference between revisions

update all steps
(→‎Getting Started: update steps)
(update all steps)
Line 24: Line 24:
* MozITP - mullet - phone
* MozITP - mullet - phone


<big><big>Current Environment & Setup</big></big>
== Current Environment & Setup ==


Fuzzing testing tests are run by automation; the test suite collects specific test cases on certain target for example:audio play, etc., mutate the testing data and inject to those test cases. Right now we have one 1 fuzzer which is focus on audio file header mutation.  
Fuzzing testing tests are run by automation; the test suite collects specific test cases on certain target for example:audio play, etc., mutate the testing data and inject to those test cases. Right now we have one 1 fuzzer which is focus on audio file header mutation.  
Line 48: Line 48:
If you are on Ubuntu, you need to check that it is configured to support the USB connection to the device. To verify this, connect the device to your computer via USB, open a terminal and enter the adb logcat command to see if it connects. If not, you may need to set up a udev rule for the device.
If you are on Ubuntu, you need to check that it is configured to support the USB connection to the device. To verify this, connect the device to your computer via USB, open a terminal and enter the adb logcat command to see if it connects. If not, you may need to set up a udev rule for the device.


== Download and Install ==
<big>Step 1: Clone the mozCingi repository </big>


Clone the mozcingi repository in a folder you will remember:
Clone the mozcingi repository in a folder you will remember:


  git clone https://github.com/ShakoHo/mozCingi
  git clone https://github.com/ShakoHo/mozCingi
<big>Step 2: Run the setup </big>


Install all requirements including mozITP and FuzzManager
Install all requirements including mozITP and FuzzManager
Line 58: Line 60:
  make mutagen-install
  make mutagen-install


== How to Run ==
<big>Step 3: Set configuration variable</big>
 
You can leverage the sample configuration under conf/, copy the sample configuration and modify it
 
cp conf/mutagenFuzzer.json.bak conf/mutagenFuzzer.json
 
vi conf/mutagenFuzzer.json
 
<big>Step 4: Switch to python virtual environment</big>


switch to python virtual environment, just created by make mutagen-install
switch to python virtual environment, just created by make mutagen-install
   
   
  source ./env/bin/activate
  source ./env/bin/activate
<big>Step 5: Run the tests</big>


use cingi command to start the whole framework, you could add --dirpath to specify configuration folder
use cingi command to start the whole framework, you could add --dirpath to specify configuration folder


  cingi --dirpath conf
  cingi --dirpath conf
71

edits