aboutsummaryrefslogtreecommitdiffstats
path: root/s3p/README.stability.md
blob: d96a8c411ec613471f8bf6cbf626f720237ccd7b (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
tability Test for Policy Distribution
## Steps to Run stability test
1. Download Apache JMeter
Download JMeter 5.0 from https://jmeter.apache.org/download_jmeter.cgi, and extracted it locally.
 
2. Launch the policy distribution service
Launch the policy distribution service with the configuration from s3pConfig.json, you need to make sure when the service is being launched, the directory configured in s3pConfig.json by receptionHandlerConfigurationParameters.fileConfiguration.parameters.watchPath is a valid local directory(Default directory is /tmp/policy_distribution/csar/).
The policy distribution service will use the FileSystemReceptionHandler plugin to monitor the local directory specified by the 'watchPath' parameter for newly added csar file, parse them to generate policies and forward it to PDP.
```
java -cp "<comma separated directories containing jar files>" org.onap.policy.distribution.main.startstop.Main -c s3pConfig.json
```
  Or if you want to launch it from docker, please do the followings:
```
mkdir -p /tmp/policy_distribution/csar/
docker run -d -e "CONFIG_FILE=/opt/app/policy/distribution/etc/s3pConfig.json" \
           -v /tmp/policy_distribution/csar/:/tmp/policy_distribution/csar/ \
           -p 6969:6969 \
           --name policy-distribution policy-distribution
```
Here we use -e option to "docker run" to pass the config file which the policy distribution service will be launched upon and use -v option to map the local host /tmp/policy_distribution/csar/ directory as the directory of /tmp/policy_distribution/csar/ within the policy-distribution docker.

**NOTED:**
Please make sure when you launch the policy distribution service, the following requirements are met:
a. The policy PDP service is active, and can be reached using the parameters configured by policyForwarderConfigurationParameters.xacmlPdpConfiguration.parameters in the s3pConfig.json file.

b. Make sure you have installed the AAF root CA either in local host or in the docker image(running as root):
```
curl -s https://git.onap.org/dmaap/buscontroller/plain/misc/cert-client-init.sh | bash --
```

3. Get the Jmeter configuration ans scripts
Git clone the policy distribution code, and goto the s3p directory:
```
git clone https://git.onap.org/policy/distribution policy-distribution
```

4. Run the JMeter stability test
```
rm -f stability.log; <jmeter_dir>/bin/jmeter.sh -t stability.jmx -n -Jhost=<pdp service hostname> -Jduration=100 -l stability.log
```
Search for 'get policy failed' in the stability.log file to see if there is any errors found during the stability test.

## JMeter properties
We can configure the following properties when running the JMeter stability test for policy distribution 
| Property Name | Default Value | Description |
|---------------|-------------|---------------|
| host | pdp | PDP service host name or ip  |
| csardir | /tmp/policy_distribution/csar | Directory where to store the generated csar files |
| duration | 30 | Number of seconds for how long to run the tests |
| retry | 10 | Number of retry to retrieve the policy of each csar |
| wait | 1000 | Milliseconds to wait between each retry |