Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.


Casablanca

Alpine base image is used for SO in Casablanca

Code Block
titleAlpine Linux
root@oom-rancher:~# kubectl -n onap exec -it dev-so-so-bpmn-infra-5887f8c6c8-xdvvj sh
/app # cat /etc/os-release
NAME="Alpine Linux"
ID=alpine
VERSION_ID=3.8.1
PRETTY_NAME="Alpine Linux v3.8"
HOME_URL="http://alpinelinux.org"
BUG_REPORT_URL="http://bugs.alpinelinux.org"
/app # apk add tcpdump


Known issue

  1. After ONAP installation, update so docker container topology.properties with correct MSB and SDNC ip and port. Every time SO VM is restarted, this file needs to update again (don't restart the docker after config file update).

Enable debug log

Turn on debug by access http://{{so}}:8080/mso/logging/debug from browser. Also you need to add/change line like "log.debug.CustomE2EGetService=true" in /etc/mso/config.d/mso.bpmn.urn.properties to enable Groove file level debugging. Other debug flags are: 

log.debug.CreateCustomE2EServiceInstance=true

log.debug.DoCreateE2EServiceInstanceV3=true

log.debug.DecomposeService=true

log.debug.CustomE2EGetService=true

log.debug.CustomE2EPutService=true

log.debug.DoCreateResourcesV3=true

log.debug.CreateSDNCNetworkResource=true

log.debug.CreateVFCNSResource=true

log.debug.DeleteCustomE2EServiceInstance=true

log.debug.DoDeleteE2EServiceInstance=true

log.debug.DoDeleteResourcesV1=true

log.debug.DeleteVFCNSResource=true

log.debug.DeleteSDNCNetworkResource=true

log.debug.CompareModelofE2EServiceInstance=trueA

log.debug.DoCompareModelofE2EServiceInstance=true

log.debug.DoCompareModelVersions=true

log.debug.UpdateCustomE2EServiceInstance=true

log.debug.DoUpdateE2EServiceInstance=true

log.debug.ScaleCustomE2EServiceInstance=true

log.debug.DoScaleE2EServiceInstance=true

log.debug.DoScaleVFCServiceInstance=true


You can also use REST API to turn on debug log at module level:


Code Block
titleTurn on debug
collapsetrue
# Enabling debug logging for Requests-DB-Adapter . . .
curl -s -o /dev/null -w '%{http_code}' --user \"MSOClient:password1$\" \"http://mso:8080/dbadapters/logging/debug?enable=true\" 

# Enabling debug logging for ASDC-Controller . . .
curl -s -o /dev/null -w '%{http_code}' --user \"MSOClient:password1$\" \"http://mso:8080/asdc/logging/debug?enable=true\"

# Enabling debug logging for API-Handler-Infra . . .
curl -s -o /dev/null -w '%{http_code}' --user \"MSOClient:password1$\" \"http://mso:8080/ecomp/mso/infra/logging/debug?enable=true\"

# Enabling debug logging for BPMN . . .
curl -s -o /dev/null -w '%{http_code}' \"http://mso:8080/mso/logging/debug?enable=true\"

# Enabling debug logging for SDNC-Adapter . . .
curl -s -o /dev/null -w '%{http_code}' --user \"MSOClient:password1$\" \"http://mso:8080/adapters/rest/logging/debug?enable=true\"

# Enabling debug logging for Network-Adapter . . .
curl -s -o /dev/null -w '%{http_code}' --user \"MSOClient:password1$\" \"http://mso:8080/networks/rest/logging/debug?enable=true\"

# Enabling debug logging for VNF-Adapter . . .
curl -s -o /dev/null -w '%{http_code}' --user \"MSOClient:password1$\" \"http://mso:8080/vnfs/rest/logging/debug?enable=true\"

# Enabling debug logging for Tenant-Adapter . . .
curl -s -o /dev/null -w '%{http_code}' --user \"MSOClient:password1$\" \"http://mso:8080/tenants/rest/logging/debug?enable=true\"

# Enabling debug logging for Workflow-Message-Adapter . . .
curl -s -o /dev/null -w '%{http_code}' \"http://mso:8080/workflows/messages/logging/debug?enable=true\"


Log files

Log file /var/log/ecomp/MSO/BPMN/debugmso.log in testlab_mso_1 container is very helpful to debug issues

Request log under /var/log/ecomp/MSO/ApiHandlerInfra

MariabDB login

Code Block
root@db:~# mysql -uroot -ppassword


Important tables are vnf_resource and vnf_recipe


Monitor container disk usage 

Code Block
collapsetrue
ubuntu@onap-so:~$ sudo docker inspect testlab_mariadb_1
...
            {
                "Type": "volume",
                "Name": "ffca8a9114d9eb731e7316a07caaa5391877a9d8d130561568792d19125fe115",
                "Source": "/var/lib/docker/volumes/ffca8a9114d9eb731e7316a07caaa5391877a9d8d130561568792d19125fe115/_data",
                "Destination": "/var/lib/mysql",
                "Driver": "local",
                "Mode": "",
                "RW": true,
                "Propagation": ""
            }
...
ubuntu@onap-so:~$ sudo docker system df -v
Images space usage:

REPOSITORY          TAG                 IMAGE ID            CREATED ago         SIZE                SHARED SIZE         UNIQUE SiZE         CONTAINERS
openecomp/mso       latest              e7a0ef21d895        2 months ago ago    1.539GB             0B                  1.539GB             1
mariadb             10.1.11             d1553bc7007f        2 years ago ago     346.5MB             0B                  346.5MB             1

Containers space usage:

CONTAINER ID        IMAGE               COMMAND                  LOCAL VOLUMES       SIZE                CREATED ago         STATUS              NAMES
5fcbcaa0d604        openecomp/mso       "/wait-for.sh -q -..."   0                   1.15GB              5 hours ago ago     Up 5 hours          testlab_mso_1
a77947adaa07        mariadb:10.1.11     "/docker-entrypoin..."   1                   204B                5 hours ago ago     Up 5 hours          testlab_mariadb_1

Local Volumes space usage:

VOLUME NAME                                                        LINKS               SIZE
ffca8a9114d9eb731e7316a07caaa5391877a9d8d130561568792d19125fe115   1                   6.869GB


Workflow Designer - Camunda Modeler

Usage: Use the tool to open an BPMN file. VoLTE use case entry bpmn is under

so project /bpmn/MSOInfrastructureBPMN/src/main/resources/process/CreateCustomE2EServiceInstance.bpmn. Look at the right side menu, it shows the name and type of subprocess or script being invoked from bpmn workflow