This guide describes the HEAT installation of A&AI

Prerequisites

The following software is needed in order to do HEAT installation of A&AI

• docker
• docker-compose
• bash

Step-by-step guide

1. You would need to have root access to the vm

2. Code Block
   language bash
   sudo su - root

3.  Add/Update the /etc/hosts file to add the following entry:

   Code Block
   language bash
   127.0.0.1 aai.hbase.simpledemo.onap.org

4. Code Block
   language bash
   cd /opt

5. Code Block
   language bash
   git clone http://gerrit.onap.org/r/aai/test-config

6. Code Block
   language bash
   cd test-config

7. In deploy_vm1.sh comment out the lines 89-94 which should be an if statement checking for the /opt/message-router folder
8. Create a directory called /opt/config

   1. Code Block
      language bash
      mkdir /opt/config/

9. Create a file called /opt/config/nexus_username.txt containing the text: docker

   1. Code Block
      language bash
      echo "docker" > /opt/config/nexus_username.txt

10. Create a file called /opt/config/nexus_password.txt containing the text: docker

    1. Code Block
       language bash
       echo "docker" > /opt/config/nexus_password.txt

11. Create a file called /opt/config/dmaap_topic.txt containing the text: AAI-EVENT

    1. Code Block
       language bash
       echo "AAI-EVENT" > /opt/config/dmaap_topic.txt

12. Create a file called /opt/config/nexus_docker_repo.txt containing text: nexus3.onap.org:10001

    1. Code Block
       language bash
       echo "nexus3.onap.org:10001" > /opt/config/nexus_docker_repo.txt

13. Create a file called /opt/config/docker_version.txt containing text: 1.2-STAGING-latest

    1. Code Block
       language bash
       echo "1.2-STAGING-latest" > /opt/config/docker_version.txt

14. Please note that in the previous step, docker version is currently 1.2-STAGING-latest and this will be changed later
    

15. Code Block
    language bash
    ./deploy_vm2.sh && ./deploy_vm1.sh

    
    
    

Troubleshooting FAQ

1. Cassandra throwing seedy exceptions

If you encounter the following errors:

...

You can try to resolve the problem by commenting out the line "- CASSANDRA_SEEDS=aai.hbase.simpledemo.onap.org" in the file "docker-compose-db.yml"

2. Containers are unable to connect to Cassandra DB

If any docker container is unable to connect to cassandra container, edit "docker-compose-db.yml", and remove the "network: host" config option from the cassandra docker config block, and repeat step 15

3. Disabling AAF authentication

If for any reason you want to disable AAF you can edit the following files aai-traversal/appconfig/application.properties and aai-resources/appconfig/application.properties and replace the following:

...

spring.profiles.active=production,one-way-ssl,dmaap

4. Unable to resolve aaf-onap-test.osaaf.org

Either add a line

10.12.6.214     aaf-onap-test.osaaf.org

...

Note: The current certificate allows only for a defined set of hostnames (like aaf-onap-test.osaaf.org) and does not allow IPs. The the AAF server (aaf-onap-test.osaaf.org) is currently located in the Windriver lab and the IP address is subject to change and might not be the current one in use at present. Alternatively use the property aaf_locate_url to point to your local AAF instance.

Related articles

...