README.md 2.21 KB
Newer Older
Federico Sismondi's avatar
Federico Sismondi committed
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
Federico Sismondi's avatar
Federico Sismondi committed
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
- fix: supervisor 'stop all' singal not stoping processes
- fix: zombie processes issue with TAT/dissector
Federico Sismondi's avatar
Federico Sismondi committed
16
17
18
19
20
21
22
23
24
25
- 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)

Federico Sismondi's avatar
doc++    
Federico Sismondi committed
26
27
28
29
30
31
### Clonning the project
```
git clone --recursive git@gitlab.distantaccess.com:fsismondi/coap_testing_tool.git
cd coap_testing_tool
git submodule update --init --recursive
```
Federico Sismondi's avatar
Federico Sismondi committed
32
33
34
35
36
37
38
39

### Running it as standalone software

for debian based OS & macos:


- installation 

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

Federico Sismondi's avatar
Federico Sismondi committed
56
57
- export credentials, server, and vhost for local RMQ connection: 
    
Federico Sismondi's avatar
Federico Sismondi committed
58
    ```
Federico Sismondi's avatar
Federico Sismondi committed
59
60
61
62
63
    export AMQP_VHOST='/'
    export AMQP_EXCHANGE='default'
    export AMQP_USER='walrus'
    export AMQP_PASS='somePassword’
    export AMQP_SERVER='f-interop.rennes.inria.fr'
Federico Sismondi's avatar
Federico Sismondi committed
64
65
66
    ```

- run CoAP testing tool and monitor processes
Federico Sismondi's avatar
Federico Sismondi committed
67
    
Federico Sismondi's avatar
Federico Sismondi committed
68
69
    ```
    cd coap_testing_tool
70
    sudo -E supervisord -c supervisor.conf 
Federico Sismondi's avatar
Federico Sismondi committed
71
72
73
    sudo supervisorctl -c supervisor.conf  

    ```
Federico Sismondi's avatar
doc++    
Federico Sismondi committed
74
	note: use -E when launching supervisor process, it preserves the env vars
Federico Sismondi's avatar
Federico Sismondi committed
75
76
77