Commit c2fcf765 authored by Yann Garcia's avatar Yann Garcia
Browse files

Review README.md files, Bug fixed in virtualization/docker

parent cd501fe1
Loading
Loading
Loading
Loading
+14 −28
Original line number Diff line number Diff line
@@ -30,7 +30,7 @@ See the attached LICENSE file or visit https://forge.etsi.org/legal-matters.
## STFs/TTFs

The following STFs were or are currently involved in the evolutions of the ETSI ITS protocols project:
- STF 405, STF 422, STF 424, STF 455, STF 462, STF 481, STF 484, STF 507, STF 517, STF 525, STF 538, STF 545, STF 594, TTF T002, TTF T011
- STF 405, STF 422, STF 424, STF 455, STF 462, STF 481, STF 484, STF 507, STF 517, STF 525, STF 538, STF 545, STF 594, TTF T002, TTF T011, TTF T024, TTF T025


# Installation
@@ -82,7 +82,7 @@ Procedure on the host machine:
- Clone the ETSI ITS Test System

```sh
$ git clone --recurse-submodules https://forge.etsi.org/gitlab/ITS/TS.ITS.git ./TS.ITS_r1
$ git clone --recurse-submodules https://forge.etsi.org/gitlab/ITS/TS.ITS.git ./TS.ITS
```

- Select the branch you need:
@@ -288,27 +288,13 @@ Procedure:
- Clone the ETSI ITS protocols project into $HOME/dev folder

```sh
$ git clone --recurse-submodules https://forge.etsi.org/gitlab/ITS/TS.ITS.git ./TS.ITS_r1
$ git clone --recurse-submodules --branch=TTF_T036 https://forge.etsi.org/gitlab/ITS/TS.ITS.git TS.ITS.TTF_T036
```

- Select the branch you need:

 ITS Release 1 (this example)

```sh
$ git checkout devel
```

 ITS Release 2

```sh
$ git checkout ttf_t024
```

- Apply the configuration
- Execute the script install.sh

```sh
$ ./switch_its_r2.sh
$ ./install.sh
```

- Build a test suite (e.g. AtsCAM)
@@ -332,7 +318,7 @@ Pre-requisites:
- Your are logged as 'etsi' or 'vagrant' user
- Procedure using TITAN command line (only):
    - Open several SSH session (PuTTY...)
    - Change to the directory ~/dev/TS.ITS_r1/
    - Change to the directory ~/dev/TS.ITS.TTF_T036/
    - Modify the file config.mk according to your system:
        - On Linux, comment all the lines using the '#' character
        - On Windows, update the path accordingly
@@ -351,7 +337,7 @@ $ make
- To run the test suitem, execute the following command:

```sh
$ cd ~/dev/TS.ITS_r1/scripts
$ cd ~/dev/TS.ITS.TTF_T036/scripts
$ ../run_all.bash
...
```
@@ -385,22 +371,22 @@ $ make

### Generate the certificates

After applying the previous clause, change to the folder '~/dev/TS.ITS_r1/data/certificates' and execute 'make' command:
After applying the previous clause, change to the folder '~/dev/TS.ITS.TTF_T036/data/certificates' and execute 'make' command:
```
$ cd ~/dev/TS.ITS_r1/data/certificates
$ cd ~/dev/TS.ITS.TTF_T036/data/certificates
$ CERTGEN=~/dev/itscertgen/ make
$ CERTGEN=~/dev/itscertgen/ make install
```
The certificates will be located in the folder '~/dev/TS.ITS_r1/data/certificates/certificates'.
The certificates will be located in the folder '~/dev/TS.ITS.TTF_T036/data/certificates/certificates'.

To use this newly generated certificates, you shall update two parameters located in the TTCN-3 file LibItsSecurity_Pixits. These are:
- LibItsSecurity_Pixits.PX_CERTIFICATE_POOL_PATH, which is the path the certificates folder (e.g. LibItsSecurity_Pixits.PX_CERTIFICATE_POOL_PATH := "/home/<user>/dev/TS.ITS_r1/data/certificates")
- LibItsSecurity_Pixits.PX_CERTIFICATE_POOL_PATH, which is the path the certificates folder (e.g. LibItsSecurity_Pixits.PX_CERTIFICATE_POOL_PATH := "/home/<user>/dev/TS.ITS.TTF_T036/data/certificates")
- LibItsSecurity_Pixits.PX_IUT_SEC_CONFIG_NAME, which is the name of the certificates folder (e.g. LibItsSecurity_Pixits.PX_IUT_SEC_CONFIG_NAME := "certificates")


### Modify or create new certificates

The folder '~/dev/TS.ITS_r1/data/profiles' contains an XML file for each certificate to be generated.
The folder '~/dev/TS.ITS.TTF_T036/data/profiles' contains an XML file for each certificate to be generated.
This XML file describes the certificate content (e.g. CERT_IUT_A_RCA.xml describes the root certificate for all CERT_IUT_A certificates).

By modifying these files, you can change create new certificate with different geographical area, different validity periods or different SSPs.
@@ -421,7 +407,7 @@ In this cases, the following parameters shall be modified to match the ITS devic
In addition, the Test System shall be configured to support the security modifying the following settings as described below:
- device_mode=1
- secured_mode=1
- sec_db_path=/home/<user>/dev/TS.ITS_r1/data/certificates/certificates
- sec_db_path=/home/<user>/dev/TS.ITS.TTF_T036/data/certificates/certificates


### ITS Protocol Test suites for Transport layer
@@ -434,7 +420,7 @@ In this cases, the following parameters shall be modified to match the ITS devic
In addition, the Test System shall be configured to support the security modifying the following settings as described below:
- device_mode=1
- secured_mode=1
- sec_db_path=/home/<user>/dev/TS.ITS_r1/data/certificates/certificates
- sec_db_path=/home/<user>/dev/TS.ITS.TTF_T036/data/certificates/certificates


### ITS Protocol Test suites for Security
Compare e1c90f29 to 10d783e6
Original line number Diff line number Diff line
Subproject commit e1c90f29e9b2fcdbb79f064f90ba5f34710b8a2c
Subproject commit 10d783e6916df22cab65c67a68982be6888d19e5
+1 −1
Original line number Diff line number Diff line
@@ -2,7 +2,7 @@ FROM alpine:3.16

# Install dependencies
RUN apk update && \
    apk add --no-cache autoconf automake sudo make git g++ diffutils expect openssl-dev libxml2-dev libxml2-utils libxslt-dev libtool ncurses-dev jsoncpp-dev readline-dev flex bison perl libexecinfo-dev bash libedit libedit-dev lksctp-tools lksctp-tools-dev libpcap-dev curl
    apk add --no-cache autoconf automake sudo make git g++ diffutils expect openssl-dev libxml2-dev libxml2-utils libxslt-dev libtool ncurses-dev jsoncpp-dev readline-dev flex bison perl libexecinfo-dev bash libedit libedit-dev lksctp-tools lksctp-tools-dev libpcap-dev zlib-dev curl

# Create user and sudouser
RUN \
+1 −1
Original line number Diff line number Diff line
@@ -3,7 +3,7 @@ set -exo pipefail

cd "$(dirname ${BASH_SOURCE})"

PRJ=TS.ITS_r2
PRJ=TS.ITS.TTF_T036
docker run --rm -it \
        -w $HOME/dev/$PRJ \
        -e GEN_DIR=$HOME/dev/$PRJ \