1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
|
.. 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.
============================
Building
============================
*Note: this document assumes UNIX Bash Shell. Being Java, AAF works in Windows, but you will have to create your own script/instruction conversions.*
---------------------
Building from Source
---------------------
Choose the directory you wish to start in... This process will create an "authz" subdirectory::
$ mkdir -p ~/src
$ cd ~/src
Use 'git' to 'clone' the master code::
$ git clone https://gerrit.onap.org/r/aaf/authz
Change to that directory::
$ cd authz
Use Maven to build::
<< TODO, get ONAP Settings.xml>>
$ mvn install
.. -----------------
.. Standalone
.. -----------------
-----------------
Docker Mode
-----------------
After you have successfully run maven, you will need a Cassandra. If you don't have one, here are instructions for a Docker Standalone Cassandra. For a *serious* endeavor, you need a multi-node Cassandra.
From "authz"::
$ cd auth/auth-cass/src/main/cql
$ vi config.dat
------------------
Existing Cassandra
------------------
AAF Casablanca has added a table. If you have an existing AAF Cassandra, do the following *ONCE* :
### If Container Cassandra, add these steps, otherwise, skip
$ docker container cp init2_1.cql aaf_cass:/tmp
$ docker exec -it aaf_cass bash
(docker) $ cd /tmp
###
$ cqlsh -f 'init2_1.cql'
--------------------
New Docker Cassandra
--------------------
Assuming you are in your src/authz directory::
$ cd auth/auth-cass/docker
$ bash dinstall.sh
---------------------
AAF Itself
---------------------
Assuming you are in your src/authz directory::
| $ cd auth/docker
| ### If you have not done so before (don't overwrite your work!)
| $ cp d.props.init d.props
You will need to edit and fill out the information in your d.props file. Here is info to help
**Local Env info** - These are used to load the /etc/hosts file in the Containers, so AAF is available internally and externally
=============== =============
Variable Explanation
=============== =============
HOSTNAME This must be the EXTERNAL FQDN of your host. Must be in DNS or /etc/hosts
HOST_IP This must be the EXTERNAL IP of your host. Must be accessible from "anywhere"
CASS_HOST If Docker Cass, this is the INTERNAL FQDN/IP. If external Cass, then DNS|/etc/hosts entry
aaf_env This shows up in GUI and certs, to differentiate environments
aaf_register_as As pre-set, it is the same external hostname.
cadi_latitude Use "https://bing.com/maps", if needed, to locate your current Global Coords
cadi_longitude ditto
=============== =============
------------------------------
"Bleeding Edge" Source install
------------------------------
AAF can be built, and local Docker Images built with the following::
$ bash dbuild.sh
Otherwise, just let it pull from Nexus
|
