docker-compose/README.md

   1 ## License
   2 Copyright (C) 2020 Nordix Foundation.
   3 Licensed under the Apache License, Version 2.0 (the "License")
   4 you may not use this file except in compliance with the License.
   5 You may obtain a copy of the License at
   6
   7       http://www.apache.org/licenses/LICENSE-2.0
   8
   9 Unless required by applicable law or agreed to in writing, software
  10 distributed under the License is distributed on an "AS IS" BASIS,
  11 WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
  12 See the License for the specific language governing permissions and
  13 limitations under the License.
  14
  15 For more information about license please see the [LICENSE](LICENSE.txt) file for details.
  16
  17 ## O-RAN-SC docker-compose files:
  18 The docker compose file helps the user to deploy all or partial components of nonrtric with one command.
  19
  20 All the components in nonrtric has individual docker compose file so you can simply mix and match different components and deploy
  21 it at your preference.
  22
  23 For ex.
  24 I want to Control Panel, A1 Policy Management Service & A1 Simulator,
  25 docker-compose -f docker-compose.yaml -f control-panel/docker-compose.yaml -f policy-service/docker-compose.yaml -f a1-sim/docker-compose.yaml up -d
  26
  27 To remove all the containers use the same command,
  28 docker-compose -f docker-compose.yaml -f control-panel/docker-compose.yaml -f policy-service/docker-compose.yaml -f a1-sim/docker-compose.yaml down
  29
  30 It can be used with any combination to deploy nonrtric components.
  31
  32 ## Policy Service Prerequisite:
  33 The A1 Policy Service can perform A1 Policy management with or without A1 Adapter. To enable/disable A1 Adapter all you have to do is,
  34 With SDNC A1 Adapter:
  35 Rename application_configuration.controller.json to application_configuration.json & start the container. Don't forget to add the A1 Adapter url,username & password in the application_configuration.json file.
  36 You also need to update the A1 Adapter url & credentials in the application_configuration file.
  37 Ex:
  38 For example if you use the OSC A1 Adapter then,
  39 "baseUrl": "http://a1controller:8282"
  40 "userName": "admin",
  41 "password": "Kp8bJ4SXszM0WXlhak3eHlcse2gAw84vaoGGmJvUy2U"
  42 docker-compose -f docker-compose.yaml -f policy-service/docker-compose.yaml -f a1-sim/docker-compose.yaml up -d
  43 Without SDNC A1 Adapter:
  44 Rename application_configuration.nocontroller.json to application_configuration.json & start the container.
  45 Ex:
  46 docker-compose -f docker-compose.yaml -f policy-service/docker-compose.yaml -f a1-sim/docker-compose.yaml up -d
  47
  48 ## To create sample data:
  49 The scripts in data/ will generate some dummy data in the running system.
  50 It will create:
  51 one policy type in a1-sim-OSC
  52 one service in policy agent
  53 one policy in a1-sim-OSC
  54 one policy in a1-sim-STD
  55
  56 Run command:
  57 cd data/
  58 ./preparePmsData.sh [policy-agent-port] [a1-sim-OSC-port] [a1-sim-STD-port] [http/https]
  59
  60 Open link:
  61 http://localhost:[control-panel-port]/
  62
  63 All the generated data is shown on the web page
  64
  65 By default, if the containers are started up and running by docker-compose file in the same directory, just run commands:
  66 ./preparePmsData.sh
  67
  68 prepareIcsData.sh
  69 This is to generate some data into the ICS microservice
  70
  71 prepareDmaapMsg.sh
  72 This is to generate some data into the Dmaap MR, so that PMS reads message from MR
  73
  74 ## O-RAN-SC Control Panel
  75
  76 The Non-RT RIC Control Panel is a graphical user interface that enables the user to view and manage the A1 policies in the RAN and also view producers and jobs for the Information coordinator service.
  77
  78 ### O-RAN-SC Control Panel Gateway:
  79
  80 To view the policy or information jobs and types in control panel gui along with Policy Management Service & Information Coordinator Service you should also have nonrtric gateway because all the request from the gui is passed through this API gateway.
  81
  82 #### Prerequisite:
  83
  84 Make sure to follow the section regarding sample data so there is data available to see in the interface.
  85
  86 To start all the necessary components, run the following command:
  87
  88 docker-compose -f docker-compose.yaml -f control-panel/docker-compose.yaml -f nonrtric-gateway/docker-compose.yaml -f policy-service/docker-compose.yaml -f ics/docker-compose.yaml -f a1-sim/docker-compose.yaml up