Oracle® Communications Services Gatekeeper Accounts and SLAs Guide Release 5.1 E37537-01 |
|
|
PDF · Mobi · ePub |
This chapter describes how the different types of SLAs are managed and provisioned. See the following sections:
See "Reference: ApplicationSLAs" for information on finding the operations in the Administration Console and for the name of the MBean.
There are two different kinds of SLAs:
System level SLAs
Custom SLAs
System level SLAs have static XSDs that are already defined in Services Gatekeeper, while custom SLAs provides the possibility to use a custom XSD. Any given service provider group or application group can have only one system SLA associated with it, while they can have many custom SLAs. Create custom SLAs when additional SLA enforcement logic is required that is not provided by default in Services Gatekeeper. The enforcement logic for a Custom SLA needs to be created. See Platform Development Studio Developer's Guide for information on how to develop Custom SLAs.
When SLAs are loaded into memory, they are stored in the SLA repository. SLAs can be loaded into the repository in two ways:
The contents of the SLA is provided as a parameter in the operation that loads the SLA.
The SLA is stored in a file and the URL to that file is provided as a parameter in the operation that loads the SLA.
SLAs are retrieved from the SLA repository using the retrieve operations.
The SLA loaded into the SLA repository is the one being enforced. Changes to the file after the SLA is loaded into the repository are not automatically reflected in the active version.
Table 5-1 outlines the different SLA types, the IDs and their scope.
SLA Type | ID(s) | Description |
---|---|---|
Application Group |
application system:geo_application |
System SLA. Defines how application can use Services Gatekeeper. See "Application Group SLAs" for a summary of related management operations. For information on creating these SLAs, see "Defining Service Provider Group and Application Group SLAs". The SLA type ID:
|
Service Provider Group |
service_provider system:geo_service_provider |
System SLA. Defines how service providers can use Services Gatekeeper. See "Service Provider Group SLAs" for a summary of related management operations. For information on creating these SLAs, see "Defining Service Provider Group and Application Group SLAs". The SLA type ID:
|
Global Node |
global_node |
System SLA. Defines how Services Gatekeeper is allowed to use the underlying telecom network nodes. See "Global Node SLAs" for a summary of related management operations. For information on creating these SLAs, see "Defining Service Provider Group and Application Group SLAs". This SLA type is loaded and enforced locally in the network tier cluster it is loaded. |
Service Provider Node |
service_provider_node |
System SLA. Defines how Service Providers are allowed to use the underlying telecom network nodes. See "Service Provider Node SLAs". For information on creating these SLAs, see "Defining Service Provider Group and Application Group SLAs". This SLA type is loaded and enforced locally in the network tier cluster it is loaded. |
Subscriber |
subscr |
System SLA. Defines classes of application services that can be associated with subscribers in the context of Services Gatekeeper. Using the Platform Development Studio, an operator or integrator may create a subscriber-centric policy mechanism. The specifics of this mechanism are covered in the “Subscriber-centric Policy” chapter in the Oracle Communications Services Gatekeeper Platform Development Studio Developer's Guide, a separate document in this set. This SLA type is loaded and enforced locally in the network tier cluster on which it is loaded. |
Custom |
Defined at load time |
Custom SLA. A custom SLA is defined by an XSD, that must be created and loaded. A custom SLA type ID is associated with the XSD, and this type is the one being referenced when loading the custom SLAs. In addition to the SLA, the enforcement logic that operates on the data in the SLA must be created. See the section Custom Service Level Agreements in Oracle Communications Services Gatekeeper Platform Development Studio Developer's Guide. Just like system SLAs, the custom SLAs are associated with service provider groups and application groups. In addition there is a custom global SLA, that does not take into consideration the originator of the request, but affects all requests. SLAs of custom type are loaded and enforced locally in the network tier cluster it is loaded. |
Note:
The prefix system is reserved, and should not be used by custom SLAs. For reasons of backwards compatibility, there is a set of SLA type without this prefix.This provides a summary of tasks related to the management of SLAs.
The first group concerns Service Provider and Application Group System SLAs.
Table 5-2 describes the tasks related to managing Application Group SLAs and the operations you use to perform those tasks.
Table 5-2 Tasks Related to Managing Application Group SLAs
Task | Operation to Use |
---|---|
Associate Application Group with SLA |
"loadApplicationGroupSlaByType" loadApplicationGroupSlaFromUrlByType Deprecated: |
View Application Group SLA |
retrieveApplicationGroupSlaByType Deprecated: |
Table 5-3 describes the tasks related to managing Service Provider Group SLAs and the operations you use to perform those tasks.
Table 5-3 Tasks Related to Managing Service Provider Group SLAs
Task | Operation to Use |
---|---|
Associate Service Provider Group with SLA |
loadServiceProviderGroupSlaByType loadServiceProviderGroupSlaFromUrlByType Deprecated: |
View Service Provider Group SLA |
retrieveServiceProviderGroupSlaByType Deprecated: |
This group describes Node SLA management.
Table 5-4 describes the tasks related to managing Global Node SLAs and the operations you use to perform those tasks.
Table 5-5 describes the tasks related to Service Provider Node SLAs and the operations you use to perform those tasks.
Table 5-5 Tasks Related to Managing Service Provider Node SLAs
Task | Operation to Use |
---|---|
Associate Service Provider Node with SLA |
loadServiceProviderGroupSlaByType loadServiceProviderGroupSlaFromUrlByType Deprecated: |
View Service Provider Node SLA |
retrieveServiceProviderGroupSlaByType Deprecated: |
Subscriber SLAs are a feature that can be developed using the Platform Development Studio. Table 5-6 describes the tasks related to managing Subscriber SLAs and the operations you use to perform those tasks.
Custom SLAs are a feature that can be developed using the Platform Development Studio. This section describes the management of Custom SLAs.
Table 5-7 describes the tasks related to managing Custom XSDs and the operations you use to perform those tasks.
Table 5-8 describes the tasks related to managing Custom Application Group SLAs and the operations you use to perform those tasks.
Table 5-9 describes the tasks related to managing Custom Service Provider Group SLAs and the operations you use to perform those tasks.
Table 5-9 Tasks Related to Managing Custom Service Provider Group SLAs
Task | Operation to Use |
---|---|
Associate Custom Service Provider Group with SLA |
|
View Custom Service Provider Group SLA |
|
Count Custom Service Provider Group SLA |
|
List Custom Service Provider Group SLA |
Table 5-10 describes the tasks related to managing Custom Global SLAs and the operations you use to perform those tasks.
All operations are reachable from:
Services Gatekeeper Administration Console Managed Object: ApplicationSLAs
MBean: com.bea.wlcp.wlng.account.management.ServiceLevelAgreementMBean
Following is a list of operations for management:
The countApplicationGroupsByType operation displays the number of a application groups that are associated with a specific system SLA type or custom SLA type.
The countApplicationGroupSlaTypes operation displays the number of system and custom SLA types for an application group.
The countApplicationSlaGroups operation is deprecated. Use "countApplicationGroupsByType" with slaType application.
Information on countApplicationSlaGroups is provided here for backward-compatibility only.
This operation displays the number of registered application groups that have SLAs associated with them.
The countCustomSlaXSDDefintions operation displays the number of registered custom SLA types.
The countGlobalSlaTypes operation displays the number of registered SLA types that have global scope.
The countServiceProviderGroupsByType operation displays the number of service provider groups that are associated with a specific SLA type.
The system SLA type or custom SLA type.
For custom SLAs, the SLA type was registered in "setupCustomSlaXSDDefinition".
The countServiceProviderGroupsSlaTypes operation displays the number of system SLA types and custom SLA types for a service provider group.
The countServiceProviderSlaGroups operation is deprecated. Use "countServiceProviderGroupsByType" with slaType service_provider.
The countServiceProviderSlaGroups operation displays the number of registered service provider groups that have SLAs associated with them.
The listApplicationGroupsByType operation displays a list of registered application groups that have a system level or custom SLA associated, filtered by the SLA type.
The list contains application group IDs.
The SLA type.
For custom SLAs, the SLA type was registered in "setupCustomSlaXSDDefinition".
For system level SLAs, see "SLA Types".
Offset in the list. Starts with 0 (zero)
Size of the list.
For no restrictions on the size of the list, use 0 (zero).
The listApplicationGroupSlaTypes operation displays a list of system and custom SLAs for an application group.
The listApplicationSlaGroups operation displays a list of registered application groups that has application SLAs associated.
The list contains application group IDs.
The listApplicationSlaGroups operation displays a list of registered custom SLA XSD.
The list contains custom SLA types.
The listGlobalSlaTypes operation displays a list of system and custom global SLA types.
The listServiceProviderGroupsByType operation displays a list of registered service provider groups that have a system level or custom SLA associated, filtered by the SLA type.
The list contains service provider group IDs.
The SLA type.
For custom SLAs, the SLA type was registered in "setupCustomSlaXSDDefinition".
For system level SLAs, see "SLA Types".
Offset in the list. Starts with 0 (zero)
Size of the list.
For no restrictions on the size of the list, use 0 (zero).
The listServiceProviderGroupSlaTypes operation displays a list of system and custom SLA types defined for a service provider group.
listServiceProviderGroupSlaTypes(applicationGroupIdentifier: String, Offset: int, Size: int)
The listServiceProviderSlaGroups operation is deprecated. Use "listServiceProviderGroupsByType" with slaType service_provider.
The listServiceProviderSlaGroups operation displays a list of registered service provider groups that has application SLAs associated.
The list contains service provider group IDs.
The loadApplicationGroupSla operation is deprecated. Use "loadApplicationGroupSlaByType" with slaType application.
The loadApplicationGroupSla operation associates an application group SLA with an application group using the contents of the SLA as a parameter.
The loadApplicationGroupSlaByType operation associates a system or custom SLA with an application group using the contents of the SLA as a parameter.
loadApplicationGroupSlaByType(slaType: String, ApplicationGroupIdentifier : String, ServiceLevelAgreement: String)
The SLA type.
For custom SLAs, the SLA type was registered in "setupCustomSlaXSDDefinition".
For system level SLAs, see "SLA Types".
Unique ID for the application group.
Contents of the system level SLA or custom SLA. The content must be formatted according to the XSD associated with the SLA type.
The loadApplicationGroupSlaFromUrl operation is deprecated. Use "loadApplicationGroupSlaFromUrlByType" with slaType application.
The loadApplicationGroupSlaFromUrl operation associates an application group SLA with an application group using the URL to a file that contains the SLA.
loadApplicationGroupSlaFromUrl(ApplicationGroupIdentifier : String, ServiceLevelAgreementURL: String)
The loadApplicationGroupSlaFromUrlByType operation associates a system or custom SLA with an application group using the URL to a file that contains the SLA.
loadApplicationGroupSlaFromUrlByType(slaType: String, ApplicationGroupIdentifier : String, serviceLevelAgreementURL: String)
The SLA type.
For custom SLAs, the SLA type was registered in "setupCustomSlaXSDDefinition".
For system level SLAs, see "SLA Types".
Unique ID for the application group.
The URL to the system level SLA or custom SLA. The content must be formatted according to the XSD associated with the SLA type.
The loadGlobalNodeSla operation is deprecated. Use "loadGlobalSlaByType" with slaType global_node.
The loadGlobalNodeSla operation loads the global node SLA using the contents of the SLA as a parameter.
The loadGlobalNodeSlaFromUrl operation is deprecated. Use "loadGlobalSlaFromUrlByType" with slaType global_node.
The loadGlobalNodeSlaFromUrl operation loads a global node SLA using the URL to a file that contains the SLA as a parameter.
The loadGlobalSlaByType operation loads a system level or custom global SLA.
The SLA type.
For custom SLAs, the SLA type was registered in "setupCustomSlaXSDDefinition".
For system level SLAs, see "SLA Types".
Contents of the global SLA. The content must be formatted according to the XSD associated with the SLA type.
The loadGlobalSlaFromUrlByType operation loads a global SLA using the URL to a file that contains the SLA as a parameter.
The SLA type.
For custom SLAs, the SLA type was registered in "setupCustomSlaXSDDefinition".
For system level SLAs, see "SLA Types".
The URL to the global SLA. The content must be formatted according to the XSD associated with the SLA type.
The loadServiceProviderGroupNodeSla operation is deprecated. Use "loadServiceProviderGroupSlaByType" with slaType service_provider_node.
The loadServiceProviderGroupNodeSla operation associates a service provider group node SLA with a service provider group using the contents of the SLA a parameter.
loadServiceProviderGroupNodeSla(ServiceProviderGroupIdentifier : String, ServiceLevelAgreement: String)
Unique ID for the service provider group.
The contents of the service provider group node SLA.
The loadServiceProviderGroupSlaFromUrl operation is deprecated. Use "loadServiceProviderGroupSlaFromUrlByType" with slaType service_provider_node.
The loadServiceProviderGroupSlaFromUrl operation associates a service provider group node SLA with a service provider group using the URL to a file that contains the SLA. as a parameter.
loadServiceProviderGroupNodeSlaFromUrl(ServiceProviderGroupIdentifier : String, ServiceLevelAgreementUrl: String)
The loadServiceProviderGroupSla operation is deprecated. Use "loadServiceProviderGroupSlaByType" with slaType service_provider.
The loadServiceProviderGroupSla operation associates a service provider group SLA with a service provider group using the contents of the SLA as a parameter.
loadServiceProviderGroupSla(ServiceProviderGroupIdentifier: String, ServiceLevelAgreement: String)
The loadServiceProviderGroupSlaFromUrl operation is deprecated. Use "loadServiceProviderGroupSlaFromUrlByType" with slaType service_provider.
The loadServiceProviderGroupSlaFromUrl operation associates a service provider group SLA with a service provider group using the URL to a file that contains the SLA as a parameter.
loadServiceProviderGroupSlaFromUrl(ServiceProviderGroupIdentifier : String, ServiceLevelAgreementURL: String)
The loadServiceProviderGroupSlaFromUrlByType operation associates a system level or custom SLA with a service provider group using the URL to a file that contains the SLA as a parameter.
loadServiceProviderGroupSlaFromUrlByType(slaType: String, serviceProviderGroupIdentifier : String, serviceLevelAgreementURL: String)
The SLA type.
For custom SLAs, the SLA type was registered in "setupCustomSlaXSDDefinition".
For system level SLAs, see "SLA Types".
The ID for the service provider group.
The URL to the SLA. The content must be formatted according to the XSD associated with the SLA type.
The loadServiceProviderGroupSlaByType operation associates a system level or custom SLA with a service provider group using the contents of the SLA as a parameter.
loadServiceProviderGroupSlaByType(slaType: String, serviceProviderGroupIdentifier : String, ServiceLevelAgreement: String)
The SLA type.
For custom SLAs, the SLA type was registered in "setupCustomSlaXSDDefinition".
For system level SLAs, see "SLA Types".
The ID for the service provider group.
Contents of the system level SLA or custom SLA. The content must be formatted according to the XSD associated with the custom SLA type.
The loadSubscriberSla operation is deprecated. Use "loadGlobalSlaByType" with slaType subscr.
Loads the Subscriber SLA into the repository.
The loadSubscriberSlaFromUrl operation is deprecated. Use "loadGlobalSlaFromUrlByType" with slaType subscr.
The loadSubscriberSlaFromUrl operation loads the Subscriber SLA into the repository using a URL.
The retrieveApplicationGroupSla operation is deprecated. Use "retrieveApplicationGroupSlaByType" with slaType application.
The retrieveApplicationGroupSla operation retrieves an application group SLA.
The retrieveApplicationGroupSlaByType operation retrieves a system level or custom SLA for an application group.
The SLA type.
For custom SLAs, the SLA type was registered in "setupCustomSlaXSDDefinition".
For system level SLAs, see "SLA Types".
Unique ID for the application group.
The retrieveCustomSlaXSDDefinition operation retrieves the XSD that defines the custom SLA type.
The retrieveGlobalNodeSla operation is deprecated. Use "retrieveGlobalSlaByType" with slaType global_node.
The retrieveGlobalNodeSla operation retrieves a global node SLA.
The retrieveGlobalSlaByType operation retrieves a system level or custom global SLA.
For custom SLAs, the SLA type was registered in "setupCustomSlaXSDDefinition".
For system level SLAs, see "SLA Types".
The retrieveServiceProviderGroupNodeSla operation is deprecated. Use "retrieveServiceProviderGroupSlaByType" with slaType service_provider_node.
The retrieveServiceProviderGroupNodeSla operation retrieves an service provider group node SLA.
The retrieveServiceProviderGroupSla operation is deprecated. Use "retrieveServiceProviderGroupSlaByType" with slaType service_provider.
The retrieveServiceProviderGroupSla operation retrieves an service provider group SLA.
The retrieveServiceProviderGroupSlaByType operation retrieves a system level or custom SLA for a service provider group.
retrieveServiceProviderGroupSlaByType(slaType : String, serviceProviderGroupIdentifier : String)
The SLA type.
For custom SLAs, the SLA type was registered in "setupCustomSlaXSDDefinition".
For system level SLAs, see "SLA Types".
The ID for the service provider group.
The retrieveSubscriberSla operation is deprecated. Use "retrieveGlobalSlaByType" with slaType subscr.
The retrieveSubscriberSla operation returns the Subscriber SLA.
The setupCustomSlaXSDDefinitionoperations sets up an XSD document defined as a custom Service Level Agreement type.
The setupCustomSlaXSDDefinitionFromUrl operation sets up an XSD document defined as a custom Service Level Agreement type.