Refactor install,config,dev docs, 2
[aaf/authz.git] / docs / sections / installation / AAF_1_Prerequisites.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 =====================
6 Prerequisites for AAF
7 =====================
8
9 To *run* AAF, you need the following:
10   * Java 8+, openjdk is fine (see Version below)
11   * Cassandra
12      * a separate installation is fine
13      * Docker based AAF Envs offer a single instance Cassandra for convenience.  Single Instance Cassandra is **NOT** recommended for real AAF systems.
14   * Machine - one of the following
15      * Standalone Java Processes - Bare Metal or VMs.  No additional running environments necessary
16      * docker - typically available via packages for O/S
17      * kubernetes - various installs available
18
19 To *build* AAF, you additionally need:
20   * Java 8+, openjdk is fine (see Version below)
21   * git
22   * maven
23   * for Container Based, you'll need Docker to build as well
24      * Note: 'minikube' works well to provide both Docker and Kubernetes Single Instance installations. 
25      
26
27 ---------------------------
28 Current Technology Versions
29 ---------------------------
30
31  - Java(tm).  Version 8.121+
32    - Oracle Java previous to Oracle Java SE 8 to version 8 Update 121 is vulnerable to "SWEET32" attack.
33
34      1369383 - CVE-2016-2183 SSL/TLS: Birthday attack against 64-bit block ciphers (SWEET32)
35
36  - Cassandra, Version 3.11+
37
38  - X509 Certificates (at minimum to support HTTP/S TLS transactions (TLS1.1 and TLS1.2 are default, but can be configured).
39