The Policy POLICY is a subsystem of OpenECOMP ONAP that maintains, distributes, and operates on the set of rules that underlie OpenECOMP’s ONAP’s control, orchestration, and management functions.
POLICY Policy provides a logically centralized environment for the creation and management of easily-updatable policies, including conditional rules. It enables enables users to This provides the capability to create and validate policies and /rules, identify and overlaps, resolve overlaps and conflicts, and derive additional policies where needed. as needed. Policies are used to control, influence, and help ensure compliance with goals. Policies can support infrastructure, products and services, operation automation, and security. Users, who can be a variety of stakeholders such as Users, including network and service designers, operations engineers, and security experts, can easily create, change, and manage policy rules from the Policy the POLICY Manager in the OpenECOMP Portal.ONAP Portal.
The figure below represents the target POLICY Architecture.
The figure below represents the current POLICY Architecture.
A policy is defined Policies are used to control, to influence, and to help ensure compliance with goals. A policy can be defined at a high level to create a condition, requirement, constraint, decision, or a need that must be provided, evaluated, maintained, and enforced. A policy can also be defined at a lower or functional level, such as a machine-readable rule or software condition/assertion which enables actions to be taken based on a trigger or request, specific to particular selected conditions in effect at that time. Some examples of types of policies are
- VM placement — rules governing where VNFs should be placed, including affinity rules
- Data and feed management — what data to collect and when, retention periods, and when to send alarms about issues
- Access control — who (or what) can have access to which data
- Trigger conditions and actions — what conditions are actionable, and what to do under those conditions
- Interactions — how interactions between change management and fault/performance management are handled (for example, should closed loops be disabled during maintenance?)
OpenECOMP supports XACML policies, Drools rules, and lower-level policies that are embodied in modeling languages such as YANG and TOSCA. Several configuration and operational policies are pre-loaded.
...
or enforced. The policy is validated and corrected for any conflicts,
...
and then placed in
...
the appropriate repository, and
...
made available
...
for use by other subsystems and components
...
. Alternately, some policies are directly distributed to policy decision engines such as Drools or XACML. In this manner, the constraints, decisions and actions to be taken are distributed.
System Architecture
ONAP POLICY is composed of several
Figure 1 depicts the Policy architecture.
*****
The function of Policy is to maintain, distribute and/or operate on the set of rules that underlie ECOMP’s control, orchestration, and management functions.
ECOMP Policy is composed of subcomponents: the Policy Administration Point (PAP)<<Link to PAP top page>>, which offers interfaces for policy creation, and two types of Policy Decision Point (PDP), each based on a specific rules technology. PDP-X<<Link to PDP-X top page>> is based on XacML XACML technology [1] and PDP-D<<Link to PDP-D top page>> is based on Drools technology [2]. PDP-X is stateless and can be implemented using deployed as a resource pool of PDP-X servers. The number of servers can be grown to increase both capacity (horizontal scalability) and , also, to increase availability. The PDP-D is stateful, as it utilizes Drools in its native, stateful way and transactions persist so long as the PDP-D is active. Persistent Drools sessions, state management, local and geo-redundancy have been deactivated for this the initial release of ECOMP Policy ONAP POLICY and will can be turned on when testing is completedin a future release. Additional instances of XACML/Drools engines and assigned roles/purposes may also be added in the future to provide a flexible, expandable policy capability.
As illustrated in the Figure 1below, the Policy POLICY components are supported by a number of interfaces and subsystems. The ECOMP Portal <<Link to Policy User Guide top page>> ONAP Portal provides a human interface for the creation, management and deployment of policies. It is a web-based system that utilizes internal POLICY APIs in provided by the PAP.
The PAP provides interfaces and for the management of policy definitionspolicies. It utilizes the XACML DB database to store policy definitions policies, which are then distributed to the PDPs.
The XACML and Drools databases<<Link to database top page>> databases are hosted in a Maria DB clusterMariaDB cluster. The XACML DB database is used to persist policies and policy definitions dictionaries and provide a point for PDPs to retrieve policy definitionspolicies. The XACML DB database also has tables used for node state management<<Link to state management top page>>, detection of node failure and failover<<Link to system integrity top page>>failover. As indicated above, the state management tables will only include entries for the PAP and PDP-X as the testing is not yet complete for the PDP-D.
The PDP-X receives deployed policies and has interfaces to handle XACML policy transactions<<Link to XACML transaction interface top page>>transactions. These transactions are stateless and once complete, they are removed from memory. If a policy that is deployed to the PDP-X is of an operational nature it will contain Drools rules and Java executables. These artifacts are processed into Maven artifacts and pushed to the Maven Repository<<Link to the Maven Repository top page>>repository. The PDP-D is then notified a new policy has been deployed.
When the PDP-D is notified a new policy has been deployed, it downloads it from the Maven repository and assigns it to an internal controller. This controller provides the external Closed Loop<<Link to Closed Loop transactions top page>> interfaces to the UEB/ DMaaP message bus over which events and messages are exchanged with external systems. As events or messages arrive at the PDP-D, they are assigned to the appropriate controller and a Drools session is either created or retrieved from memory. The events, messages or facts are passed to the Drools session and the corresponding rule engine is fired, resulting in a change of internal session state and /or possibly actions taken in response to the rule processing. Response messages and requests are passed by the controller back over the UEB/ DMaaP message bus to the appropriate system. The Drools session can also have timers and autonomous events. In a future release the PDP-D will can enable the node state management and session persistence in the Drools DB.
*************
Policy Creation
The Policy Creation component of the Policy subsystem enables creation of new policies and modification of existing polices, both online and offline.
Once policies are created, Policy Creation also provides:
...
during the design phase and during runtime. Policy Creation is targeted to be integrated to a unified Service Design and Creation (SDC) environment.
A policy can be defined at a high level to create a condition, requirement, constraint, decision or a need that must be provided, evaluated, maintained, and/or enforced. A policy can also be defined at a lower or functional level, such as a machine-readable rule or software condition/assertion which enables actions to be taken based on a trigger or request, specific to particular selected conditions in effect at that time.
Some examples of types of policies are:
- VNF placement — rules governing where VNFs should be placed, including affinity rules
- Data and feed management — what data to collect and when, retention periods, and when to send alarms about issues
- Access control — who (or what) can have access to which data
- Trigger conditions and actions — what conditions are actionable, and what to do under those conditions
- Interactions — how interactions between change management and fault/performance management are handled (for example, should closed loops be disabled during maintenance?)
...
Policy Distribution
After a policy has been initially created or an existing policy has been modified, the Policy Distribution Framework sends the policy from the repository to its points of use, known as which include Policy Distribution Points, before it is actually neededDecision Points (PDPs) and Policy enforcement points (DCAE, Controllers, etc), before the policy is actually needed.
The decisions and actions taken by the policy are distributed. Policies are distributed either in conjunction with installation packages (for example, related to service instantiation) or independently, if unrelated to a particular service. Some policies can be configured (e.g., configuring policy parameters within microservices), while other polices are delivered to policy engines such as XAMCL and Drools. With this methodology, policies will already be available when needed by a component, minimizing real-time requests to a central policy engine or PDP (Policy Decision Point). This improves scalability and reduces latency.
Separate notifications or events communicate the link or URL for a policy to the components that need it. Then, when a component needs the policy, it uses the link to fetch it. Components in some cases might also publish events indicating that they need new policies, eliciting a response with updated links or URLs. Also, in some cases, policies can indicate to components that they should subscribe to one or more policies, so that they receive automatic updates to those policies as they become available.
Policy Decision and Enforcement
Run-time policy enforcement is performed by OpenECOMP ONAP subsystems that are called from the policy. For policy-enabled or can respond to commands from a policy-enabled element such as a PDP. For example, policy rules for data collection are enforced by the data collection functionality of DCAE. Analytic policy rules, identification of anomalous or abnormal conditions, and publication of events signaling detection of such conditions are enforced by DCAE analytic applications. Policy Policy rules for associated remedial actions, or for further diagnostics, are enforced by the correct component in a control loop such as the MSO, a Controller, or DCAE. Policy engines such as XACML and Drools also enforce policies and can trigger other components as a result (for example, causing a controller to take specific actions specified by the policy). Additionally, some policies (“Guard Policies”) may enforce checks against decided actions.
Policy Unification and Organization
Because the policy POLICY framework is expandable and multipurpose, it might is likely to contain many types of policies , which users might want to organize which require organization according to some useful dimensions. Users can define attributes that specify the scope of policies, and these attributes can be extended to the policy-enabled functions and components. Useful policy organizing dimensions might include:
- Policy type or category (taxonomical)
- Policy life cycle
- Policy ownership or administrative domain
- Geographic area or location,
- Technology type
- Policy language and version
- Security level or other security-related values, specifiers, or limiters
Attributes can be specified for each dimension. In addition to being defined for individual policies themselves, these attributes can be used to define the scope of these additional additional policy-related functions:
- Policy events or requests/triggers
- Policy decision, enforcement, or other functions
- Virtual functions of any type type
Policy Use
At runtime, policies that were previously distributed to policy-enabled components are used by those components to control or influence their functionality and behavior, including any actions that are taken.
In many cases, those policies will be used to make decisions, where these decisions will often be conditional upon the current situation. An example of this approach is the feedback/control loop pattern that is driven by DCAE. Many specific control loops can be defined. Each component in a particular control loop (for example, orchestrator, controller, DCAE, virtual function) receives policies that determine how it should function as part of that loop. All of the policies for that loop will have been previously created together, ensuring correct and coordinated closed-loop action. DCAE can receive specific policies for data collection (for example, what data to collect, how to collect, and how often), data analysis (for example, what type and depth of analysis to perform), and signature and event publishing (for example., what analysis results to look for as well as the specifics of the event to be published upon detecting those results). Remaining components of the loop (such as orchestrators and controllers) can receive specific policies that determining the actions to take upon receiving the triggered event from DCAE. Each component in the loop can also receive policies that specify the events to which the component subscribes.