Overview

The AAI Context Builder in POMBA receives the rest call from Context Aggregator and then query AAI to get service data, transform the AAI response data to common model, send the common model data back to Context Aggregator.

File Structure

/opt
|-- app
    |-- config
    |   |-- application.properties
    |   |-- logback.xml
    |-- lib
    |   |-- pomba-aai-context-builder.jar
    |-- bin
        |-- startService.sh

Configuration

application.properties

# Copyright © 2018 Amdocs
#
# Licensed under the Apache License, Version 2.0 (the "License");
# you may not use this file except in compliance with the License.
# You may obtain a copy of the License at
#
#       http://www.apache.org/licenses/LICENSE-2.0
#
# Unless required by applicable law or agreed to in writing, software
# distributed under the License is distributed on an "AS IS" BASIS,
# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
# See the License for the specific language governing permissions and
# limitations under the License

spring.jersey.type=filter
spring.mvc.urls=swagger,docs,prometheus,auditevents,info,heapdump,autoconfig,beans,loggers,dump,env,trace,health,configprops,mappings,metrics,webjars

server.contextPath=/aaicontextbuilder
spring.autoconfigure.exclude=org.springframework.boot.autoconfigure.jdbc.DataSourceAutoConfiguration,org.springframework.boot.autoconfigure.orm.jpa.HibernateJpaAutoConfiguration

#This property is used to set the Tomcat connector attributes.developers can define multiple attributes separated by comma
#tomcat.connector.attributes=allowTrace-true
#The max number of active threads in this pool
server.tomcat.max-threads=200
#The minimum number of threads always kept alive
server.tomcat.min-spare-threads=25

# AAI REST Client Configuration
aai.serviceName=10.69.102.6
aai.servicePort=30233
# AAI APIs authentication mode. Valid values: [basic_auth, client_cert]
aai.authentication=basic_auth
aai.trustStorePath=n/a
aai.keyStorePath=n/a
aai.keyStorePassword=n/a
aai.username=AAI
aai.password=OBF:1gfr1ev31gg7
aai.httpProtocol=https
aai.connectionTimeout=5000
# aai readTimeout unit: msec
aai.readTimeout=30000

# HTTP Basic Authorization credentials for Rest Service API
http.userId=admin
http.password=OBF:1u2a1toa1w8v1tok1u30

aai.searchNodeQuery=/aai/v11/search/nodes-query?search-node-type=service-instance&filter=service-instance-id:EQUALS:

#Servlet context parameters
server.context_parameters.p-name=value #context parameter with p-name as key and value as value.

Service URL

http://<host>:9530/aaicontextbuilder/v2/service/context?serviceInstanceId=<serviceInstanceId>

Error Code

Error Code	Description	Resolution

Error Code	Description	Resolution
400	missing X-FromAppId from the header	Provide X-FromAppId in the header and re-send the request
401	missing basic auth from the header	Provide basic authorization in the header and re-send the request
400	missing mandatory parameter from url (serviceInstanceID)	Provide parameter in the request url

AAI Data Mapping

refer to : Context Builders Mapping to Common Model

Attribute Name Conversion

refer to: POMBA New Resources and Attributes

OXM Data Model

refer to: OXM versions in ONAP