#106 AMF notification related enhancements

[Nagendra Kumar]

Migrated from http://devel.opensaf.org/ticket/1367

• Information regarding old state (see spec) should be sent to NTF.

• The following notifications are not generated by AMF and should be added:

• error report not
• error clear not

[Praveen]

Old state inclusion in notifications:
1)Operational state :
=== Jun 23 14:13:20 - State Change ===
eventType = SA_NTF_OBJECT_STATE_CHANGE
notificationObject = "safSu=SU1,safSg=AmfDemo,safApp=AmfDemo1"
notifyingObject = "safApp=safAmfService"
notificationClassId = SA_NTF_VENDOR_ID_SAF.SA_SVC_AMF.108 (0x6c)
additionalText = "Oper state safSu=SU1,safSg=AmfDemo,safApp=AmfDemo1 changed"
sourceIndicator = SA_NTF_OBJECT_OPERATION
State ID = SA_AMF_OP_STATE
Old State: SA_AMF_OPERATIONAL_DISABLED
New State: SA_AMF_OPERATIONAL_ENABLED

2)Admin state:
=== Jun 23 14:13:23 - State Change ===
eventType = SA_NTF_OBJECT_STATE_CHANGE
notificationObject = "safSu=SU1,safSg=AmfDemo,safApp=AmfDemo1"
notifyingObject = "safApp=safAmfService"
notificationClassId = SA_NTF_VENDOR_ID_SAF.SA_SVC_AMF.102 (0x66)
additionalText = "Admin state of safSu=SU1,safSg=AmfDemo,safApp=AmfDemo1
changed"
sourceIndicator = SA_NTF_MANAGEMENT_OPERATION
State ID = SA_AMF_ADMIN_STATE
Old State: SA_AMF_ADMIN_LOCKED_INSTANTIATION
New State: SA_AMF_ADMIN_LOCKED

3)Presence state
=== Jun 23 14:13:23 - State Change ===
eventType = SA_NTF_OBJECT_STATE_CHANGE
notificationObject = "safSu=SU1,safSg=AmfDemo,safApp=AmfDemo1"
notifyingObject = "safApp=safAmfService"
notificationClassId = SA_NTF_VENDOR_ID_SAF.SA_SVC_AMF.109 (0x6d)
additionalText = "Presence state of SU safSu=SU1,safSg=AmfDemo,safApp=AmfDemo1
changed"
sourceIndicator = SA_NTF_OBJECT_OPERATION
State ID = SA_AMF_PRESENCE_STATE
Old State: SA_AMF_PRESENCE_INSTANTIATING
New State: SA_AMF_PRESENCE_INSTANTIATED

4)Assignment state
=== Jun 23 14:13:23 - State Change ===
eventType = SA_NTF_OBJECT_STATE_CHANGE
notificationObject = "safSi=AmfDemo1,safApp=AmfDemo1"
notifyingObject = "safApp=safAmfService"
notificationClassId = SA_NTF_VENDOR_ID_SAF.SA_SVC_AMF.111 (0x6f)
additionalText = "The Assignment state of SI safSi=AmfDemo1,safApp=AmfDemo1
changed"
sourceIndicator = SA_NTF_OBJECT_OPERATION
State ID = SA_AMF_ASSIGNMENT_STATE
Old State: SA_AMF_ASSIGNMENT_UNASSIGNED
New State: SA_AMF_ASSIGNMENT_PARTIALLY_ASSIGNED

5)SU HA state notification:
=== Jun 23 14:13:23 - State Change ===
eventType = SA_NTF_OBJECT_STATE_CHANGE
notificationObject = "safSu=SU1,safSg=AmfDemo,safApp=AmfDemo1"
notifyingObject = "safApp=safAmfService"
notificationClassId = SA_NTF_VENDOR_ID_SAF.SA_SVC_AMF.110 (0x6e)
additionalText = "The HA state of SI safSi=AmfDemo1,safApp=AmfDemo1 assigned
to SU safSu=SU1,safSg=AmfDemo,safApp=AmfDemo1 changed"
- additionalInfo: 0 -
infoId = 2
infoType = 10
infoValue = "safSi=AmfDemo1,safApp=AmfDemo1"
sourceIndicator = SA_NTF_OBJECT_OPERATION
State ID = SA_AMF_HA_STATE
Old State:
New State: SA_AMF_HA_ACTIVE

Error report and Error clear notifications:
=== Jun 23 10:44:27 - Alarm ===
eventType = SA_NTF_ALARM_PROCESSING
notificationObject =
"safComp=AmfDemo3,safSu=SU1,safSg=AmfDemo,safApp=AmfDemo1"
notifyingObject = "safApp=safAmfService"
notificationClassId = SA_NTF_VENDOR_ID_SAF.SA_SVC_AMF.401 (0x191)
additionalText = "Error reported on
safComp=AmfDemo3,safSu=SU1,safSg=AmfDemo,safApp=AmfDemo1 with recovery
COMPONENT_RESTART"
- additionalInfo: 0 -
infoId = 4
infoType = 7
Unimplemented additionalInfo type
probableCause = SA_NTF_SOFTWARE_ERROR
perceivedSeverity = SA_NTF_SEVERITY_MAJOR

=== Jun 23 10:44:27 - Alarm ===
eventType = SA_NTF_ALARM_PROCESSING
notificationObject =
"safComp=AmfDemo3,safSu=SU1,safSg=AmfDemo,safApp=AmfDemo1"
notifyingObject = "safApp=safAmfService"
notificationClassId = SA_NTF_VENDOR_ID_SAF.SA_SVC_AMF.402 (0x192)
additionalText = "Previous raised alarm of
safComp=AmfDemo3,safSu=SU1,safSg=AmfDemo,safApp=AmfDemo1 is now cleared"
probableCause = SA_NTF_SOFTWARE_ERROR
perceivedSeverity = SA_NTF_SEVERITY_CLEARED

[Praveen]

Limitations/Deviations:
1)Error report and error clear are miscellaneous types of notifications.
At present Notification Service does not support saNtfMiscellaneousNotificationAllocate().
Instead of miscellaneous types notifications, alarms will be sent and cleared whenever
AMF reports error and clears error on component respectively.
2)Notification will be sent for all versions of APIs i.e:
saAmfComponentErrorReport() and saAmfComponentErrorReport_4(),
saAmfComponentErrorClear() and saAmfComponentErrorClear_4().
3)Currently time stamp will not be uptdated even if user passes it
in the argument.
4)Alarm sent status, like other component related alarms, is not
check pointed at AMFD.

[Praveen]

changeset: 5462:0aa1a65adb00
user: praveen.malviya@oracle.com
date: Mon Jul 14 18:00:16 2014 +0530
summary: amfd : send old state of AMF entities in notifications [#106]

changeset: 5463:5b4d19c056ed
user: praveen.malviya@oracle.com
date: Mon Jul 14 18:01:05 2014 +0530
summary: amfd : send error report and clear notifications [#106]

changeset: 5464:47451ddb604e
user: praveen.malviya@oracle.com
date: Mon Jul 14 18:01:56 2014 +0530
summary: amfnd : inform AMFD to send error report notification [#106]

changeset: 5465:3489da7781cc
tag: tip
user: praveen.malviya@oracle.com
date: Mon Jul 14 18:02:27 2014 +0530
summary: amfnd : inform AMFD to send error clear notification [#106]

[Nagendra Kumar]

Amf doc updated:

changeset: 125:778798269ff8
tag: tip
user: Nagendra Kumarnagendra.k@oracle.com
date: Fri Sep 05 15:23:41 2014 +0530
summary: Amf: Add section 11.2.3 in 2.2.2 Compliance Report [#106]

[staging:778798]