X-Git-Url: https://gerrit.onap.org/r/gitweb?a=blobdiff_plain;f=docs%2Fsections%2Finstallation%2FInstallation.rst;h=095739b499cd043cebf43c7d69e76cfc2ab5fdad;hb=7a1817bf3cf3c40c6c33f673ddc46c3f115cc3bc;hp=1852f848fe1d4d00a8d76ba3984adb4096f7640d;hpb=bbe7154de3be6ff4fb3433ee6ea3688b4929ef71;p=aaf%2Fauthz.git diff --git a/docs/sections/installation/Installation.rst b/docs/sections/installation/Installation.rst index 1852f848..095739b4 100644 --- a/docs/sections/installation/Installation.rst +++ b/docs/sections/installation/Installation.rst @@ -1,19 +1,104 @@ .. This work is licensed under a Creative Commons Attribution 4.0 International License. .. http://creativecommons.org/licenses/by/4.0 +.. Copyright © 2017 AT&T Intellectual Property. All rights reserved. Installation ============ +This document will illustrates how to build and deploy all AAF components. -Environment ------------ +Clone AAF Code: +Build AAF with settings.xml: +Build Docker Images: +Modify the properties file: +Mount the sample to /opt/app/osaaf: +Run the docker containers: +Clone AAF Code: +bharath@bharath:~$ git clone https://git.onap.org/aaf/authz + + +Build AAF with settings.xml: +--------------------------- +Copy the settings.xml from here and paste in ~/.m2/settings.xml + +Then run the following command + +.. code:: bash + + bharath@bharath:~$ cd authz && mvn clean install -DskipTests + + +If the build is successful, then you can see a folder in "authz/auth" called "aaf_VERSION-SNAPSHOT" which contains all binaries of the components + +.. code:: bash + + bharath@bharath:~/authz/auth$ ls +aaf_2.1.1-SNAPSHOT auth-cass auth-cmd auth-deforg auth-gui auth-locate auth-service pom.xml target +auth-batch auth-certman auth-core auth-fs auth-hello auth-oauth docker sample + +Build Docker Images: +------------------- +Now after building binaries, the next step is to build docker images for each aaf component. + +.. code:: bash + + bharath@bharath:~/authz/auth/docker$ chmod +x *.sh + bharath@bharath:~/authz/auth/docker$ ./dbuild.sh + +The above command will build the following images: + +aaf_service +aaf_oauth +aaf_locate +aaf_hello +aaf_gui +aaf_fs +aaf_cm +Modify the properties file: +Modify the contents of the "authz/auth/docker/d.props + +.. code:: bash + + bharath@bharath:~/authz/auth/docker$ cat d.props + +# Variables for building Docker entities +ORG=onap +PROJECT=aaf +DOCKER_REPOSITORY=nexus3.onap.org:10003 +OLD_VERSION=2.1.0-SNAPSHOT +VERSION=2.1.1-SNAPSHOT +CONF_ROOT_DIR=/opt/app/osaaf + + +# Local Env info +HOSTNAME="" +HOST_IP="" +CASS_HOST="cass" + +Replace the with your hostname and HOST_IP with your host IP. + +Add the following entry to your /etc/hosts file + + + +127.0.0.1 aaf.osaaf.org +Mount the sample to /opt/app/osaaf: +As you can see there is a parameter "CONF_ROOT_DIR" which is set to "/opt/app/osaaf". So we have to create a folder "/opt/app/osaaf" and copy the contents of authz/auth/sample to /opt/app/osaaf + +.. code:: bash + + bharath@bharath:~/authz/auth$ mkdir -p /opt/app/osaaf + bharath@bharath:~/authz/auth$ cp -r sample/* /opt/app/osaaf/ + +Run the docker containers: +-------------------------- +.. code:: bash + + bharath@bharath:~/authz/auth/docker$ ls + dbash.sh dbuild.sh dclean.sh Dockerfile d.props dpush.sh drun.sh dstart.sh dstop.sh + bharath@bharath:~/authz/auth/docker$ ./drun.sh -Steps ------ - -Testing --------