README.md 1.92 KB
Newer Older
1 2 3 4 5 6 7 8 9 10
CoAP Testing Tool:
------------------

This repo conaints all necessary software (and their dependencies) for running a 
CoAP interoperability test session.

This can be run as standalone software and also integrated to f-interop 
architecture.

### TODO
Federico Sismondi's avatar
Federico Sismondi committed
11
- add coap client automated IUT
12
- add feat for handling step by step analysis
Federico Sismondi's avatar
Federico Sismondi committed
13
- add more unit testing of coordinator component
14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31
- document isntallation of requirements and dependencies

### CoAP Testing tools components

The CoAP testing tool handles the coordination, sniffing, dissection and analysis of CoAP test suite.
It's based on the test scenarios and test cases described in 
[ETSI CoAP test description](http://www.etsi.org/plugtests/CoAP/Document/CoAP_TestDescriptions_v015.pdf)

For description of components please visit: [f-interop doc](doc.f-interop.eu)


### Running it as standalone software

for debian based OS & macos:


- installation 

Federico Sismondi's avatar
Federico Sismondi committed
32 33
  - install locally RMQ broker on local machine
    - create RMQ vhost, user, pass on local machine
Federico Sismondi's avatar
Federico Sismondi committed
34
    
35
  - install supervisor (for spawning and monitoring processes)
Federico Sismondi's avatar
Federico Sismondi committed
36 37
  
(this last two on a non standalone execution are provided by f-interop)
38

Federico Sismondi's avatar
Federico Sismondi committed
39
- install testing tool requirements:
Federico Sismondi's avatar
Federico Sismondi committed
40 41
	change in anible/main.yml the variable unix_user from f-interop to your
	local unix user, then run ansible script:
Federico Sismondi's avatar
Federico Sismondi committed
42 43 44 45 46
    
    ```
    cd coap_testing_tool
    ansible-playbook -i "localhost," -c local ansible/main.yml --ask-become-pass
    ```
47

Federico Sismondi's avatar
Federico Sismondi committed
48 49
- export credentials, server, and vhost for local RMQ connection: 
    
50
    ```
Federico Sismondi's avatar
Federico Sismondi committed
51 52 53 54 55
    export AMQP_VHOST='/'
    export AMQP_EXCHANGE='default'
    export AMQP_USER='walrus'
    export AMQP_PASS='somePassword’
    export AMQP_SERVER='f-interop.rennes.inria.fr'
56 57 58
    ```

- run CoAP testing tool and monitor processes
Federico Sismondi's avatar
Federico Sismondi committed
59
    
60 61
    ```
    cd coap_testing_tool
62
    sudo -E supervisord -c supervisor.conf 
63 64 65
    sudo supervisorctl -c supervisor.conf  

    ```
66
	note the -E when launching supervisor process, it preserves the env vars
67 68 69