Providing a customer-centric system view with services
In this tutorial, you will learn how to create a service for a television channel. In a first setup, this service will take its input from two different receiver elements. Depending on the position of a switch, one or the other will be picked to include in the service. Afterwards, you will reconfigure the service so it will always include both elements but will limit the influence the element alarm states have on the overall alarm severity of the service based on the switch position. In both situations, your service will indicate how it is performing towards your customers, regardless of the underlying infrastructure.
The content and screenshots for this tutorial have been created using DataMiner 10.5.2.
Expected duration: 20 minutes
Tip
See also: Kata #60: Building a customer-centric system view with services on DataMiner Dojo 
Prerequisites
- A DataMiner System that is connected to dataminer.services.
Overview
This tutorial consists of the following steps:
- Step 1: Deploy the DataMiner Service Tutorial package from the Catalog
- Step 2: Create a new service
- Step 3: Configure your service for dynamic element inclusion
- Step 4: Reconfigure your service for dynamic service alarm influencing
Step 1: Deploy the DataMiner Service Tutorial package from the Catalog
Go to https://catalog.dataminer.services/details/62840610-072c-4316-9e04-703f7688e857.
Deploy the Catalog item to your DataMiner Agent by clicking the Deploy button.
Tip
See also: Deploying a Catalog item to your system
When the package has been fully deployed, you will see the following view structure in the Surveyor in DataMiner Cube:
Step 2: Create a new service
In the Cube Surveyor, right-click the view Services - Tutorial > TV Channels and select New > Service.
On the edit page, in the Name field, specify BBC Sports.
Click Next.
On the parameters page, click Add element.
Select ird-uk-lon-01 and ird-uk-man-01 and click ADD > >.
Click OK to close the pop-up window.
Click Create to create the service.
At this point, you have created a service that includes two elements:
Step 3: Configure your service for dynamic element inclusion
In this step, you will configure the service to dynamically include the element providing the active signal source, based on the position of a switch.
In the Surveyor, right-click the BBC Sports service you created earlier and select Edit.
Go to the parameters page.
Select the ird-uk-lon-01 element and configure the following details in the pane on the right:
In the Alias field, specify Site 1.
Clear the All parameters checkbox.
Select the Audio Output Level parameter.
Under THIS ELEMENT IS INCLUDED IN THE SERVICE, select Based on conditions and Include (In use when condition matches).
Click Add condition and configure the following condition:
The configuration for this element should now look like this:
Select the ird-uk-man-01 element and configure the following details in the pane on the right:
In the Alias field, specify Site 2.
Clear the All parameters checkbox.
Select the Audio Output Level parameter.
Under THIS ELEMENT IS INCLUDED IN THE SERVICE, select Based on conditions and Include (In use when condition matches).
Click Add condition and configure the following condition:
The configuration for this element should now look like this:
Click Apply to save the changes.
Now your service will only include the element that is active based on the Switch Site Selection parameter from the sw-uk-01 element. Switching this parameter from Site 1 to Site 2 and vice versa will change the included element. This makes sure you will get the live status of your service regardless of the source of your signal.
Step 4: Reconfigure your service for dynamic service alarm influencing
Having only the active element in your service can give you a false sense of security. Your service could be running fine on the current source input, but your other source might have an alarm that you are currently missing. This means that when you need to switch to the other source, you could run into problems. In this step, you will adapt the service to get an early warning for potential problems with the other signal.
In the Surveyor, right-click the BBC Sports service you created earlier and select Edit.
Go to the parameters page.
Select the ird-uk-lon-01 element and configure the following details in the pane on the right:
Under THIS ELEMENT IS INCLUDED IN THE SERVICE, select Always.
Under ONCE INCLUDED, THIS ELEMENT WILL INFLUENCE THE OVERALL ALARM SEVERITY OF THE SERVICE, select Based on conditions.
Add the condition Is Parameter value sw-uk-01 Switch Site Selection Equal to value Site 1.
Under ADVANCED, configure the option Maximum severity on element not used and set it to Warning.
The configuration for this element should now look like this:
Select the ird-uk-man-01 element and configure the following details in the pane on the right:
Under THIS ELEMENT IS INCLUDED IN THE SERVICE, select Always.
Under ONCE INCLUDED, THIS ELEMENT WILL INFLUENCE THE OVERALL ALARM SEVERITY OF THE SERVICE, select Based on conditions.
Add the condition Is Parameter value sw-uk-01 Switch Site Selection Equal to value Site 2.
Under ADVANCED, configure the option Maximum severity on element not used and set it to Warning.
The configuration for this element should now look like this:
Click Apply to save the changes.
Open the sw-uk-01 element and change the Switch Site Selection parameter to Site 2.
Now your service will include both elements, but the service will indicate the one that is in use. The source that is not active will at most cause a warning alarm on the service.
In Cube, you will now see a warning alarm on the service coming from the signal from Site 1, while the signal from Site 2 is working fine. This way, you will be able to spot problems with the other signal early, before you need to use it.
