This section describes how the different types of SLAs are managed and provisioned:
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 have static XSDs tat are already defined in Oracle Communications 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 them, while they can have many custom SLAs. Custom SLAs should be used when there is a need of additional SLA enforcement logic that is not provided out-of-the-box by Oracle Communications Services Gatekeeper. The enforcement logic for a Custom SLA needs to be created. See Oracle Communications Services Gatekeeper 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:
SLAs can be retrieved from the SLA repository using the retrieve operations.
The SLA that is loaded into the SLA repository is the one being enforced. Changes to the file after the SLA is loaded into the repository will not automatically be reflected in the active version.
Table 6-1 Outlines the different SLA types, the IDs and their scope.
Defines how application can use Oracle Communications 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.
|
||
Defines how service providers can use Oracle Communications 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.
|
||
Defines how Oracle Communications 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 Global Node and Service Provider Group Node SLAs.
|
||
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 Global Node and Service Provider Group Node SLAs.
|
||
Defines classes of application services that can be associated with subscribers in the context of Oracle Communications 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 Platform Development Studio - Developer’s Guide, a separate document in this set.
|
||
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.
|
Note: | The prefix system: is reserved, and should not be used by custom SLAs. Due to reasons of backwards compatibility, there is a set of SLA type without this prefix. |
All operations are reachable from:
Below is a list of operations for management:
Displays the number of a application groups that are associated with a specific system SLA type or custom SLA type.
countApplicationGroupsByType(SlaType: String)
Displays the number of system and custom SLA types for an application group.
countApplicationGroupSlaTypes(applicationGroupIdentifier: String)
Deprecated. Use Operation: countApplicationGroupsByType with slaType application.
Displays the number of registered application groups that have SLAs associated with them.
countApplicationSlaGroups()
Displays the number of registered custom SLA types.
countApplicationSlaGroups()
Displays the number of registered SLA types that has global scope.
countGlobalSlaTypes()
Displays the number of service provider groups that are associated with a specific SLA type.
countServiceProviderGroupsByType(slaType: String)
For custom SLAs, the SLA type was registered in Operation: setupCustomSlaXSDDefinition.
|
Displays the number of system SLA types and custom SLA types for a service provider group.
countServiceProviderGroupSlaTypes(serviceProviderGroupIdentifier: String)
Deprecated. Use Operation: countServiceProviderGroupsByType with slaType service_provider.
Displays the number of registered service provider groups that have SLAs associated with them.
countServiceProviderGroups()
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.
listApplicationGroupsByType(slaType: String, Offset: int, Size: int)
For custom SLAs, the SLA type was registered in Operation: setupCustomSlaXSDDefinition.
For system level SLAs, see SLA Types.
|
|
Displays a list of system and custom SLAs for an application group.
listApplicationGroupSlaTypes(applicationGroupIdentifier: String, Offset: int, Size: int)
Deprecated. Use Operation: listApplicationGroupsByType with slaType application.
Displays a list of registered application groups that has application SLAs associated.
The list contains application group IDs.
listApplicationSlaGroups(Offset: int, Size: int)
Displays a list of registered custom SLA XSD.
The list contains custom SLA types.
listCustomSlaXSDDefinition(Offset: int, Size: int)
Displays a list of system and custom global SLA types.
listGlobalSlaTypes(Offset: int, Size: int)
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.
listServiceProviderGroupsByType(slaType: String, Offset: int, Size: int)
For custom SLAs, the SLA type was registered in Operation: setupCustomSlaXSDDefinition.
For system level SLAs, see SLA Types.
|
|
Displays a list of system and custom SLA types defined for a service provider group.
listServiceProviderGroupSlaTypes(applicationGroupIdentifier: String, Offset: int, Size: int)
Deprecated. Use Operation: listServiceProviderGroupsByType with slaType service_provider.
Displays a list of registered service provider groups that has application SLAs associated.
The list contains service provider group IDs.
listServiceProviderSlaGroups(Offset: int, Size: int)
Deprecated. Use Operation: loadApplicationGroupSlaByType with slaType application.
Associates an application group SLA with an application group using the contents of the SLA as a parameter.
loadApplicationGroupSla(ApplicationGroupIdentifier String, ServiceLevelAgreement: String)
Scope: Domain or all geo-redundant sites.
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)
For custom SLAs, the SLA type was registered in Operation: setupCustomSlaXSDDefinition.
For system level SLAs, see SLA Types.
|
|
Deprecated. Use Operation: loadApplicationGroupSlaFromUrlByType with slaType application.
Associates an application group SLA with an application group using the URL to a file that contains the SLA.
loadApplicationGroupSlaFromUrl(ApplicationGroupIdentifier : String, ServiceLevelAgreementURL: String)
Scope: Domain or all geo-redundant sites.
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)
For custom SLAs, the SLA type was registered in Operation: setupCustomSlaXSDDefinition.
For system level SLAs, see SLA Types.
|
|
Deprecated. Use Operation: loadGlobalSlaByType with slaType global_node.
Loads the global node SLA using the contents of the SLA as a parameter.
loadGlobalNodeSla(ServiceLevelAgreement: String)
Deprecated. Use Operation: loadGlobalSlaFromUrlByType with slaType global_node.
Loads a global node SLA using the URL to a file that contains the SLA as a parameter.
loadGlobalNodeSlaFromUrl(ServiceLevelAgreement: String)
Loads a system level or custom global SLA.
loadGlobalSlaByType(ServiceLevelAgreement: String)
For custom SLAs, the SLA type was registered in Operation: setupCustomSlaXSDDefinition.
For system level SLAs, see SLA Types.
|
|
Loads a global SLA using the URL to a file that contains the SLA as a parameter.
loadGlobalSlaFromUrlByType(ServiceLevelAgreement: String)
For custom SLAs, the SLA type was registered in Operation: setupCustomSlaXSDDefinition.
For system level SLAs, see SLA Types.
|
|
Deprecated. Use Operation: loadServiceProviderGroupSlaByType with slaType service_provider_node.
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)
Deprecated. Use Operation: loadServiceProviderGroupSlaFromUrlByType with slaType service_provider_node.
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)
Deprecated. Use Operation: loadServiceProviderGroupSlaByType with slaType service_provider.
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)
Deprecated. Use Operation: loadServiceProviderGroupSlaFromUrlByType with slaType service_provider.
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)
Scope: Domain or all geo-redundant sites
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)
For custom SLAs, the SLA type was registered in Operation: setupCustomSlaXSDDefinition.
For system level SLAs, see SLA Types.
|
|
Scope: Domain or all geo-redundant sites
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)
For custom SLAs, the SLA type was registered in Operation: setupCustomSlaXSDDefinition.
For system level SLAs, see SLA Types.
|
|
Deprecated. Use Operation: loadGlobalSlaByType with slaType subscr.
Loads the Subscriber SLA into the repository.
loadSubscriberSla(ServiceLevelAgreement: String)
Deprecated. Use Operation: loadGlobalSlaFromUrlByType with slaType subscr.
Loads the Subscriber SLA into the repository using a URL.
loadSubscriberSlaFromURL(ServiceLevelAgreementURL: String)
Deprecated. Use Operation: retrieveApplicationGroupSlaByType with slaType application.
Retrieves an application group SLA.
retrieveApplicationGroupSla(ApplicationGroupIdentifier : String)
Retrieves a system level or custom SLA for an application group.
retrieveApplicationGroupSlaByType(slaType : String, ApplicationGroupIdentifier : String)
For custom SLAs, the SLA type was registered in Operation: setupCustomSlaXSDDefinition.
For system level SLAs, see SLA Types.
|
|
Retrieve the XSD that defines the custom SLA type.
retrieveCustomSlaXSDDefinition(slaType : String)
Deprecated. Use Operation: retrieveGlobalSlaByType with slaType global_node.
retrieveGlobalNodeSla()
Retrieves a system level or custom global SLA.
retrieveGlobalSlaByType(slaType : String)
For custom SLAs, the SLA type was registered in Operation: setupCustomSlaXSDDefinition.
For system level SLAs, see SLA Types.
|
Deprecated. Use Operation: retrieveServiceProviderGroupSlaByType with slaType service_provider_node.
Retrieves an service provider group node SLA.
retrieveServiceProviderGroupNodeSla(ServiceProviderGroupIdentifier : String)
Deprecated. Use Operation: retrieveServiceProviderGroupSlaByType with slaType service_provider.
Retrieves an service provider group SLA.
retrieveServiceProviderGroupSla(ServiceProviderGroupIdentifier : String)
Retrieves a system level or custom SLA for a service provider group.
retrieveServiceProviderGroupSlaByType(slaType : String, serviceProviderGroupIdentifier : String)
For custom SLAs, the SLA type was registered in Operation: setupCustomSlaXSDDefinition.
For system level SLAs, see SLA Types.
|
|
Deprecated. Use Operation: retrieveGlobalSlaByType with slaType subscr.
Set up an XSD document defined as a custom Service Level Agreement type.
setupCustomSlaXSDDefinition(slaType : String, xsdDocument : String)
Set up an XSD document defined as a custom Service Level Agreement type.
setupCustomSlaXSDDefinitionFromUrl(slaType : String, xsdDocumentURL : String)