You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 13 Current »

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. sudo su - root

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

    127.0.0.1 aai.hbase.simpledemo.onap.org
  4. cd /opt
  5. git clone http://gerrit.onap.org/r/aai/test-config
  6. 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. mkdir /opt/config/
  9. Create a file called /opt/config/nexus_username.txt containing the text: docker
    1. echo "docker" > /opt/config/nexus_username.txt
  10. Create a file called /opt/config/nexus_password.txt containing the text: docker
    1. echo "docker" > /opt/config/nexus_password.txt
  11. Create a file called /opt/config/dmaap_topic.txt containing the text: AAI-EVENT
    1. 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. 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. 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. ./deploy_vm2.sh && ./deploy_vm1.sh



Troubleshooting FAQ

1. Cassandra throwing seedy exceptions

If you encounter the following errors:

ERROR 13:31:16 Directory /var/lib/cassandra/data doesn't exist

ERROR 13:31:16 Directory /var/lib/cassandra/commitlog doesn't exist

ERROR 13:31:16 Directory /var/lib/cassandra/saved_caches doesn't exist

ERROR 13:31:48 Exception encountered during startup

java.lang.RuntimeException: Unable to gossip with any seeds

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,aaf-auth,dmaap

with

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

to /etc/hosts

OR

you can edit the files aai-resources/appconfig/aaf/org.osaaf.location.props aai-traversal/appconfig/aaf/org.osaaf.location.props and replace

aaf_locate_url=https://aaf-onap-test.osaaf.org:8095
with 
aaf_locate_url=https://10.12.6.214:8095

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.

  • No labels