Recordings

Recorded Session 2018-02-16

Attendees - 

Goals

  • Get status on AAI lab resources
  • Discuss MSB/AAF and establish clear direction on approach for Beijing
  • Status on Cassandra clustering
  • AAI Administrivia

Discussion items


BabelDamian Nowak

Tian Lee provided an overview of Babel. Damian requested documentation, Tian Lee and CT Paterson suggested some docs that can be provided.

Models come into AAI thru babel, so changes to the models must be made in SDC.

Nokia is interested in model changes for 5G PNF support.

Clarified difference between service/resource models and schema.


New contributor to the AAI Portal project

Kang Xi

xing xiaocheng

Arul Nambi

Kang would like to introduce a new developer, XiaoCheng, to contribute to the AAI Portal project

XiaoCheng is interested in improving the A&AI portal to show the logical relationship among instances. Service to models, instances etc.

Has done code analysis of AAI

No impact to other components

Liaise with Arul Nambi

Arul Nambi - would like to be included in planning/design/code submission.  Please add as reviewer. 2018-02-16: James Forsyth or other committers will add Arul when they see sparky changes. Contributors can add any user to the reviewers list.


LicensingJames Forsyth

Modified files should be tagged with a new date of 2017-2018.

Copyright © 2017-2018 AT&T Intellectual Property. All rights reserved.

AAI-747 - Getting issue details... STATUS

James Forsyth will get clarification on what's needed for the various repos to satisfy the various orgs.


CII Badging

James Forsyth

Arul Nambi

Wiki page with instructions on the process: CII Badging Program


We have two CII Badging submissions currently active on CII Best Practice Badge Program: 1) AAI and 2) Sparky-fe


The team needs to decide how to split up the project - AAI is too big to fit under a single project.  James Forsyth proposes the following breakdown for CII badging:

1) AAI core (REST providers and common code): James Forsyth - Project created, ongoing progress.

  • aai-common
  • aai-resources
  • aai-traversal
  • gizmo
  • champ
  • graphadmin

2) GUI - Arul Nambi - Need to include more repos to the current "front-end" project

  • sparky-fe
  • sparky-be
  • data-router
  • search-data-service
  • router-core


3) Model loader - Tian Lee - Need to create projects

  • model-loader
  • babel

4) Graph utils / eventing / logging - Steven Blimkie - Need to create projects

  • spike
  • gap - Tian Lee
  • graphgraph - Stretch for Beijing
  • event-client - Tian Lee
  • rest-client


5) ESR - Zi Li - Project is created, still ongoing process to meet all the requirements

  • esr-gui
  • esr-server


The idea is that we assign one key person who will be responsible for getting the badge on their set of repos.  This is just a suggestion, and I invite discussion, re-categorization, and complete rewrites. Owners of the sets can decide whether it makes sense to group sets into one CII badging request, or split. Every repo above must be included in 1 CII submission.



AAI-494 - Improve API Swagger Documentation IN PROGRESS

Richard Epp

Pavel Paroulek

Issue 1 - Parsing of YAML file into RST format

Richard Epp to send yaml file via email to Pavel and attach to wiki so all can see.

YAML file too large and resulting RST file cannot be read by readmedoc causing it to be unusable.

Issues parsing the YAML file into RST format - structure is not correct - structure of YAML file must follow SWAGGER structure.


Issue 2 - Exposing AAI Swagger through MSB

Suggestion of using MSB portal with link of file to readmedoc.

How to display REST APIs via the swagger UI integrated with MSB: https://wiki.onap.org/display/DW/Microservice+Bus+API+Documentation#MicroserviceBusAPIDocumentation-APIDefinitionandSwagger-UI

Will need to continue as open item until resolved.

Contact Zi Li / HuabingZhao for more information about integration. Just require the swagger JSON file for integration - Richard Epp please provide the JSON to Zi Li -

https://wiki.onap.org/display/DW/2018-02-02+AAI+Weekly+Meeting+notes?preview=%2F25429783%2F25432551%2FNetwork_v13.yaml

Zi Li - please download the yaml file above and see if you can make use of it in MSB


Note: Alternate Swagger UI service already available.


Huabing - Please refer to the below comments for session sticky and AAF plugin progress


2018-02-16: Generator of the RST can't find the definitions (there is a getDefinitions and patchDefinitions) and parser can't deal with it. Generator only can parse ASCII and there are characters outside the ASCII set. PATCH and GET methods can possibly be split into their own files. Richard Epp will look into installing swagger UI in Windriver lab; Venkata Harish Kajur knows how to access, contact Stephen Gooch for access


Jenkins

Venkata Harish Kajur

Release jenkins jobs are still failing.  Helpdesk ticket # 52082

Changes to AAI-COMMON not picked up by downstream projects (resources, traversal)

Unable to release aai-common, as cannot release multiple times, without incrementing the version.

Liasing with ONAP helpdesk about whether we can release multiple minor versions of an artifact.


Proposal for Monday PTL meeting to align SNAPSHOT strategy

Venkata Harish Kajur to include Steven Blimkie on email exhange with ONAP Help desk.

2018-02-16: James Forsyth raised on the PTL call on Monday. Decision is to use SNAPSHOT for Beijing development, currently we're setting our snapshot as 1.2.1 Disabled the daily jobs (which fail because the snapshot/staging artifacts don't exist). Removed all amsterdam jjb jobs.

Need a better plan for Casablanca.


HPA
Dileep Ranganathan

I would like to discuss about the Persistence of HPA related information in A&AI in the weekly meeting call.

I would like to discuss my proposal to capture the HPA capabilities in a generic way in A&AI as

represented here à https://wiki.onap.org/display/DW/Persistence+of+HPA+related+information+in+AAI

I would appreciate if we could include this in tomorrow’s meeting.

Dileep Ranganathan presented   https://wiki.onap.org/display/DW/Persistence+of+HPA+related+information+in+AAI .  General discussion.

Alexander Vul met with OAF team yesterday to determine optimal way to consume info from A&AI, will go back

To OAF with using key value pairs; implementation needs to be agnostic and optimal.

Alex to post on wiki general format and value specifics; will meet with OAF on Mon on how to represent the values.


Alexander Vul to review changes with Christina for specific schema proposal

Functional requirements for HPA : https://wiki.onap.org/display/DW/Hardware+Platform+Enablement+In+ONAP

2018-02-16: Schema changes are done, need custom query to get the parent node from a given node. Christina Monteleone and AAI team need to follow up on the custom query.


MSB Integration Status

HuabingZhao

The MSB AAF auth plugin
Two-way SSL at MSB API Gateway
Any problems in the integration

AAI-671 - Replace HAPROXY with MSB OPEN Opened questions to be answered

Might need a plugin in MSB to achieve stickiness of requests


Huabing asked Jonathan Gathman about AAF API - further details required.

2018-02-16: Adrian Slavkovsky is waiting for MSB fixes - stickyness/ip_hash load balancing doesn't work. kube2msb registrator doesn't register ports correctly. We need to socialize the hostname that clients will use - follow up with HuabingZhao and other teams about how this will work. James Forsyth will raise the issue on next Monday's PTL call.


Cassandra Clustering

Pavel Paroulek

Venkata Harish Kajur

Goal - provide HA to AAI


Issue 1 - remote storage

Meetings with Michael O'Brien - (deprecated as of 20170508) - use obrienlabs

OOM team should check the video recording of the session

@michaelobrien will arrange further meeting on Monday


Issue 2 - simulating outage

Pavel + Harish will try to simulate on Monday


We have a 3 node replicated cluster configured with local storage; need to discuss if this will be adequate to the purpose of Beijing integration testing.

AAI-539 - Set up Cassandra docker images in 3 node cluster OPEN OOM-591 - AAI needs persistent volumes configured, need help with OS in lab REOPENED

Michael O'Brien from OOM team will assist w/ OOM-591

Michael O'Brien to respond back to Harish’s email and setup meeting on Monday 10 AM; Will put on OAM discussion page so others interested can attend. 

https://lists.onap.org/pipermail/onap-discuss/2018-February/007954.html

https://lists.onap.org/pipermail/onap-discuss/2018-February/007955.html

ONAP on Kubernetes on Windriver Titanium Cloud - Openlab#Openlab-20180205:AAIandOOMworkingsessiononCINDERKubernetesPV

https://wiki.onap.org/download/attachments/25431372/20180205_aai_oom_cinder_kubernetes_pv_work_session_1_of_2_zoom_0.mp4?version=1&modificationDate=1517867225191&api=v2

2016-02-16: Working cluster; titan + thrift allowed us to use Cassandra 3. Janus will not have thrift requirement.


Event-Client
Tian Lee
Auto-generated build jobs failing. Tian will investigate - update next week. 2018-02-16: jobs working,

Files from Richard Epp:

NetworkGet_v13.rst

NetworkPut_v13.rst

BusinessGet_v13.rst

BusinessPut_v13.rst

ServiceDesignAndCreationGet_v13.rst

ServiceDesignAndCreationPut_v13.rst

CloudInfrastructureGet_v13.rst

CloudInfrastructurePut_v13.rst

2 Comments

  1. HuabingZhao

    Session sticky is natively supported by MSB, no plugin needed.

    To achieve session sticky for a specific service, we just need to take the following items into consideration when registering the services

    1. Chose IP-Hash LB method in the k8s annotation
    2. Register at k8s Pod level rather than  k8s service(Cluster IP) level so MSB can do LB for the registered services

    The msb registration annotation should be in the Pod part of aai-deployment.yaml file rather than all-services.yaml

    Example:

    apiVersion: extensions/v1beta1
kind: Deployment
metadata:
  name: aai-service
  namespace: "{{ .Values.nsPrefix }}-aai"
spec:
  selector:
    matchLabels:
      app: aai-service
  template:
    metadata:
      annotations:
        msb.onap.org/service-info: '[
        {
              "serviceName": "aai-cloudInfrastructure",
              "version": "v11",
              "url": "/aai/v11/cloud-infrastructure",
              "protocol": "REST",
              "port": "8443",
              "enable_ssl": true,
              "lb_policy":"ip_hash"
              "visualRange": "1"
          },
          {
              "serviceName": "aai-cloudInfrastructure-deprecated",
              "version": "v11",
              "url": "/aai/v11/cloud-infrastructure",
              "protocol": "REST",
              "port": "8443",
              "enable_ssl": true,
              "visualRange": "1",
              "lb_policy":"ip_hash" 
              "path": "/aai/v11/cloud-infrastructure"
          }
          ]'
      labels:
        app: aai-service
      name: aai-service
    spec:
      initContainers:
      - command:
        - /root/ready.py
     --- omitted for brevity----

  2. HuabingZhao

    Regarding Auth Plugin:

    AAF support Basic Auth, but they don't provide REST APIs for authentication/authorization right now. We need to wait until the APIs are defined.