README.md 1.99 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
- document isntallation of requirements and dependencies

### CoAP Testing tools components

Federico Sismondi's avatar
Federico Sismondi committed
18 19 20
The CoAP testing tool handles the coordination, sniffing, dissection
and analysis of traces for the tests described in the test description.
The implemented test description is based on:
21 22 23 24
[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)

Federico Sismondi's avatar
doc++  
Federico Sismondi committed
25 26
### Clonning the project
```
27
git clone --recursive https://gitlab.f-interop.eu/fsismondi/coap_testing_tool.git
Federico Sismondi's avatar
doc++  
Federico Sismondi committed
28
```
29 30 31 32 33 34 35

### Running it as standalone software

for debian based OS & macos:

- installation 

Federico Sismondi's avatar
Federico Sismondi committed
36 37
  - install locally RMQ broker on local machine
    - create RMQ vhost, user, pass on local machine
Federico Sismondi's avatar
Federico Sismondi committed
38
    
Federico Sismondi's avatar
doc++  
Federico Sismondi committed
39 40
    note: on a non-standalone deployment the RMQ broker is provided by f-interop
    
41
  - install supervisor (for spawning and monitoring processes)
Federico Sismondi's avatar
Federico Sismondi committed
42
  
Federico Sismondi's avatar
Federico Sismondi committed
43
- install testing tool requirements:
Federico Sismondi's avatar
Federico Sismondi committed
44 45
	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
46 47 48
    
    ```
    cd coap_testing_tool
49
    ansible-playbook -i ansible/hosts.local ansible/main.yml --ask-become-pass
Federico Sismondi's avatar
Federico Sismondi committed
50
    ```
51

Federico Sismondi's avatar
Federico Sismondi committed
52 53
- export credentials, server, and vhost for local RMQ connection: 
    
54
    ```
Federico Sismondi's avatar
Federico Sismondi committed
55
    export AMQP_URL='amqp://someUser:somePassword@server/amqp_vhost'
Federico Sismondi's avatar
Federico Sismondi committed
56
    export AMQP_EXCHANGE='default'
57 58 59
    ```

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

    ```
Federico Sismondi's avatar
Federico Sismondi committed
67 68
	note: use -E when launching supervisor process, it preserves the
	env vars
69 70 71