Merge "Step versions on master after release"
[nonrtric.git] / test / usecases / odusliceassurance / goversion / README.md
1 # O-RAN-SC Non-RealTime RIC O-DU Closed Loop Usecase Slice Assurance 
2
3 ## Configuration
4
5 The consumer takes a number of environment variables, described below, as configuration.
6
7 >- MR_HOST              **Required**. The host for Dmaap Message Router.                           Example: `http://mrproducer`
8 >- MR_PORT              **Required**. The port for the Dmaap Message Router.                       Example: `8095`
9 >- SDNR_ADDRESS         Optional. The address for SDNR.                                            Defaults to `http://localhost:3904`.
10 >- SDNR_USER            Optional. The user for the SDNR.                                           Defaults to `admin`.
11 >- SDNR_PASSWORD        Optional. The password for the SDNR user.                                  Defaults to `Kp8bJ4SXszM0WXlhak3eHlcse2gAw84vaoGGmJvUy2U`.
12 >- LOG_LEVEL            Optional. The log level, which can be `Error`, `Warn`, `Info` or `Debug`.  Defaults to `Info`.
13 >- POLLTIME             Optional. Waiting time between one pull request to Dmaap and another.      Defaults to 10 sec
14
15
16 ## Development
17
18 To make it easy to test during development of the consumer, there is a stub provided in the `stub` folder.
19
20 This stub is used to simulate both received VES messages from Dmaap MR with information about performance measurements for the slices in a determinated DU and also SDNR, that sends information about Radio Resource Management Policy Ratio and allows to modify value for RRM Policy Dedicated Ratio from default to higher value. 
21
22 By default, SDNR stub listens to the port `3904`, but his can be overridden by passing a `--sdnr-port [PORT]` flag when starting the stub. For Dmaap MR stub default port is `3905` but it can be overriden by passing a `--dmaap-port [PORT]` flag when starting the stub.
23
24 To build and start the stub, do the following:
25
26 >1. cd stub
27 >2. go build
28 >3. ./stub [--sdnr-port <portNo>] [--dmaap-port <portNo>]
29
30 ## License
31
32 Copyright (C) 2021 Nordix Foundation.
33 Licensed under the Apache License, Version 2.0 (the "License")
34 you may not use this file except in compliance with the License.
35 You may obtain a copy of the License at
36
37       http://www.apache.org/licenses/LICENSE-2.0
38
39 Unless required by applicable law or agreed to in writing, software
40 distributed under the License is distributed on an "AS IS" BASIS,
41 WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
42 See the License for the specific language governing permissions and
43 limitations under the License.
44
45 For more information about license please see the [LICENSE](LICENSE.txt) file for details.