docs/sections/installation/AAF_6_running.rst

   1 .. This work is licensed under a Creative Commons Attribution 4.0 International License.
   2 .. http://creativecommons.org/licenses/by/4.0
   3 .. Copyright © 2017 AT&T Intellectual Property. All rights reserved.
   4
   5 Running AAF
   6 =========================
   7
   8 The default methodology for running AAF for ONAP is to run as on of the ONAP OOM charts.  This allows AAF to be starting in the right order, be available, etc for ONAP Components.
   9
  10 AAF is very effective as Standalone Java processes, Docker or non OOM Helm Charts, because AAF is an infrastructure component used by ONAP.  It is not an integral ONAP Component,
  11 which means that it can be run independently in a number way.  From someone's home computer to the extreme Scale and Resilency requirements of Class A Enterprises.
  12
  13 OOM
  14 ---
  15
  16 Please see OOM Documentation to run AAF with other ONAP Components
  17
  18 Helm
  19 ----
  20
  21 Use git to pull down "authz" code set.  Build if desired.
  22
  23         - Ensure Docker and K8s is install (Minikube is very useful for local machines, see internet)
  24         - Ensure Helm is installed an configured (see internet)
  25         - cd authz/auth/helm
  26         - helm --namespace onap -n dublin install aaf
  27                 - Control with kubectl (see K8S/Minikub docs)
  28
  29         - A sample App that generates all its certificates and configurations automatically is available as "aaf-hello
  30         - helm --namespace onap -n hello install aaf-hello
  31
  32 Docker
  33 ------
  34
  35 Use git to pull down "authz" code set. See Build info for Docker.
  36
  37         - cd authz/auth/docker
  38         - if you need Docker Container, cd ../cass/docker
  39                 - bash dinstall.sh
  40                         - (note: if you add the word "publish", cqlsh is available for your local apps at port 9042)
  41
  42                 - bash dcqlsh.sh    (puts you into CQLSH inside Docker)
  43                         - docker container exec -it aaf-cass  bash -c "cqlsh -k authz --request-timeout=60"
  44                 - bash dbash.sh     (short cut to get you a Shell in the "cass" container)
  45
  46         - all the d...sh scripts utilize short-cut names.
  47                 - "cass" is actually aaf-cass in Docker, "service" is actually aaf-service in Docker
  48
  49         - dbuild.sh      (builds new Docker Containers, see Build)
  50         - dclean.sh      (cleans out Docker Containers, getting ready for a new build)
  51         - drun.sh <blank|shortcut name>       (Creates and Starts Container for all or one AAF components)
  52         - dstop.sh <blank|shortcut name>      (Stops Container for all or one AAF Components)
  53         - dstart.sh <blank|shortcut name>     (Use when container exists for all or one AAF Components)
  54