docs/platform/tutorial_cl.rst

   1
   2 .. This work is licensed under a Creative Commons Attribution 4.0 International License.
   3 .. http://creativecommons.org/licenses/by/4.0
   4
   5 ***********************************************************************************************
   6 Tutorial: Generating and Testing your own Control Loop Operational Policy in a standalone PDP-D
   7 ***********************************************************************************************
   8
   9 .. contents::
  10     :depth: 3
  11
  12 To generate your own control loop operational policy, use the *create-cl-amsterdam* tool.  The *create-cl-amsterdam* script is located in *${POLICY_HOME}/bin (/opt/app/policy/bin)*.  When the script is run, it will ask for values for a variety of fields.  The fields will have pre-filled out defaults, and for the most part, the defaults are fine to leave in.  The two main fields that should be changed are the Template Control Loop Name and the Control Loop Yaml.
  13
  14     .. image:: Tut_cl_valuesHighlight.png
  15
  16 Make sure the Yaml’s controlLoopName matches the Template Control Loop Name you pass in. Finally, confirm that the parameters are correct, confirm the directory it will add the policy files in (default is /tmp) and tell the script to create the maven artifact.
  17
  18     *Confirm the parameters and enter the directory to install in as shown below:*
  19
  20     .. image:: Tut_cl_confirmAndDirectory.PNG
  21
  22     *Choose whether to immediately deploy (in this case the directory is /tmp/amsterdam)*
  23
  24     .. image:: Tut_cl_preDeploy.PNG
  25
  26 When the processing is done, you get the choice of immediately deploying the policy to the local repository, or first examining the rules in the directory it tells you.  If you don’t immediately deploy, you need to use the “*mvn install*” command in the newly created directory to continue.  When all that is done, go to the directory where the rule was placed (the /tmp/amsterdam directory in this case) and copy the *<name>-controller.properties* file to *${POLICY_HOME}/config*.  Turn the engine off and then back on with “*policy stop*” and then “*policy start*”.
  27
  28     *Location of the properties file*
  29
  30     .. image:: Tut_cl_propFile.PNG
  31
  32     *Moving the properties file to ${POLICY_HOME}/config*
  33
  34     .. image:: Tut_cl_finalStep.PNG
  35
  36 Proceed with testing your new policy as described in the specific tutorials:
  37
  38 • vCPE - Tutorial: Testing the vCPE use case in a standalone PDP-D
  39 • vDNS - Tutorial: Testing the vDNS Use Case in a standalone PDP-D
  40 • vFW - Tutorial: Testing the vFW flow in a standalone PDP-D
  41 • VoLTE - Tutorial: Testing the VOLTE Use Case in a standalone PDP-D
  42
  43 If you would like to deploy a control loop in Eclipse from the control loop archetype template:
  44
  45 • Modifying the Amsterdam release template
  46
  47
  48
  49
  50 End of Document
  51
  52
  53
  54
  55 .. SSNote: Wiki page ref. https://wiki.onap.org/display/DW/Tutorial%3A+Generating+and+Testing+your+own+Control+Loop+Operational+Policy+in+a+standalone+PDP-D
  56