You configure SDC (Service Design and Creation) ONAP (Open Network Automation Platform)
Observer jobs to dynamically load data from the SDC REST interface.
Important: The SDC ONAP Observer supports the SDC release 8.0.0.
Ensure you have the SDC ONAP service details to hand, such as username, password, hostname and
port.
The observer is installed as part of the core installation procedure.
SDC manages two levels of assets:
- Resource
- A fundamental capability, implemented either entirely in software, or as software that interacts
with a hardware device. Each Resource is a combination of one or more Virtual Function Components
(VFCs), along with all the information necessary to instantiate, update, delete, and manage the
Resource. A resource also includes license-related information. There are three kinds of Resource:
- Infrastructure: Cloud resources, such as Compute, Storage, etc
- Network: Network connectivity functions & elements, for example a Virtual Network Function
(VNF)
- Application: Features and capabilities of a software application, for example a load-balancing
function=
- Service
- A well-formed object comprising one or more resources.
- Service designers create services from resources, and include all of the information about the
service needed to instantiate, update, delete, and manage the service.
The SDC ONAP Observer job retrieves the service design data from the SDC server via REST. The
observer loads and updates the resources and their relationships within the Agile Service Manager
core topology service.
You define and start the following jobs:
- Load
- Run this job whenever you need SDC ONAP topology data refreshed.
- By default, these jobs are one-off, transient jobs that perform a full upload of all requested
topology data as soon as they are triggered.
- You can also run these jobs (again) manually from the Observer UI, or schedule them to run at
set times when configuring them.
- Listen
- A long-running job that consumes relevant messages from the SDC DMaaP broker continually until
it is explicitly stopped, or until the observer is stopped.
- You should run this job after a load job has been completed.
-
From the Observer Configuration UI, click Configure
under the SDC ONAP icon, or select an existing job to be edited.
-
Choose either Load or Listen from the
Job type drop-down.
-
Configure the following parameters for the required job type, then click
Save to save and run the job.
Table 1. SDC ONAP Observer load
job parameters
Parameter |
Action |
Details |
Unique ID |
Enter a unique name for the job |
Required |
SDC Distribution Engine host |
Specify the host name of the SDC Distribution Engine |
Required |
SDC Distribution Engine port |
Specify the port number of the SDC Distribution Engine |
Required |
SDC username |
Specify the user name to use when connecting to the SDC |
Required |
SDC password |
Specify the password to use when connecting to the SDC |
Required. Use plain text. |
Target system Key Store file name |
Specify the key store name that contains either the CA certificate or the SDC's public
key |
Required. For information on encrypting the contents of the key store file, see the following
step. |
Target system Key Store password |
Specify the password to access the key store file |
Required. Use plain text. |
Job schedule |
Specify when the job should run, and whether it should run at regular intervals.
By default the job runs immediately, and only once.
Optionally you can specify a future date and time for the job to run, and then set it to
run at regular intervals after that.
|
Optional. Transient (one-off) jobs only.
If you set a job schedule, the run intervals must be at least 90 seconds apart, and if you set
them at less than 15 minutes, a warning is displayed, as the frequency can impact system
performance.
|
Observer job description |
Enter additional information to describe the job. |
Optional |
Table 2. SDC ONAP Observer
listen job parameters
Parameter |
Action |
Details |
Unique ID |
Enter a unique name for the job |
Required |
SDC Distribution Engine host |
Specify the host name of the SDC Distribution Engine |
Required |
SDC Distribution Engine port |
Specify the port number of the SDC Distribution Engine |
Required |
SDC username |
Specify the user name to use when connecting to the SDC |
Required |
SDC password |
Specify the password to use when connecting to the SDC |
Required. Use plain text. |
SDC environment name |
Specify the environment name configured on the SDC, for example TEST,
PROD, AUTO, etc |
Required |
DMaaP message-router address |
Specify the DMaaP message bus addresses on which to listen for distribution events |
Required |
DMaaP message-router port |
Specify the DMaaP message bus port on which to listen for distribution events |
Required |
Target system Key Store file name |
Specify the Key Store name that contains either the CA certificate or the SDC's public
key |
Required. For more information, see Configuring observer job security.
- On-prem
- Create and store the certificate in the ASM_HOME/security directory.
- OCP
- Obtain the authentication certificate using OpenSSL and store it as a secret.
See the following
step in the 'Configuring observer job security' topic.
|
Target system Key Store password |
Enter the password to access key store file |
Required. Use plain text. |
DMaaP polling interval (in seconds) |
Specify how often (in seconds) to poll the DMaaP cluster for new model events |
Required. The default is 20s. |
DMaaP polling timeout (in seconds) |
Specify the timeout value (in seconds) when polling DMaaP for new model events |
Optional. The default is 20s. |
Observer job description |
Enter additional information to describe the job. |
Optional |