# Managing Accounts and SLAs

# Creating and Maintaining Service Provider and Application Accounts

An essential part of managing Oracle Communications Services Gatekeeper is dealing with service provider partners. Oracle Communications Services Gatekeeper provides a partner administration model to help operators handle the needs and demands of their partners in a flexible and powerful way:

- Each application that uses the application-facing interfaces in Oracle Communications Services Gatekeeper must establish an account. The account is uniquely identified by an application instance.
- An application instance belongs to an application account and a service provider account.
- An application account belongs to a service provider account and an application group.
- A service provider account belongs to a service provider group. A service provider account can have zero or more application accounts associated with it.
- An application group is associated with an application group SLA and zero or more custom application group SLAs.
- A service provider group is associated with a service level agreement on the service provider-level and may also be associated with a service provider node SLA and zero or more custom service provider group SLAs.
- Zero or more custom global SLAs can be defined,. These are not associated with any special group or account, but are valid for all accounts and groups
- A global node SLA is not associated with any special group or account, but is valid for all accounts and groups.

The SLAs are defined in XML. System SLA have static XSDs and enforcement logic, while custom SLAs are defined in addition to the system SLAs. The XSDs and the enforcement logic for custom SLAs must be developed.

The following SLAs are system SLAs:

- Service provider group SLA
- Application group SLA
- Service provider node SLA
- Global node SLA
- Subscriber SLA

The following SLAs are custom SLAs

- Custom service provider group SLAs
- Custom application group SLAs
- Custom global SLAs

See Figure 2-1 for an illustration of the relationship among the different account types and SLAs.

Figure 2-1 Service provider and application model with SLAs

The separation of accounts and groups provides a flexible way of defining service level agreements. Groups allow the Oracle Communications Services Gatekeeper administrator to offer tiers of service at both the service provider (via service provider group SLAs) and application (via application group SLAs) level.

Application group SLAs and Service provider group SLAs can be managed and enforced either locally in one site or across geo-redundant sites.

## System SLAs

The system SLAs have static XSDs. The enforcement logic is already in place for these types of SLAs, except for the subscriber SLA which needs custom subscriber policy logic.

See Defining Service Provider Group and Application Group SLAs, Defining Global Node and Service Provider Group Node SLAs, and Managing a Subscriber SLA for more information about the system SLAs.

Below is an example of how an Oracle Communications Services Gatekeeper administrator might use system SLAs to create three different categories of service providers:

- Bronze
- Silver
- Gold

Each of these would have different privileges when it comes to maximum throughput and QoS parameters. When a new service provider is provisioned, the service provider is associated with an appropriate group based on, for example, the amount of network traffic the service provider is projected to generate. If the outcome is not what was predicted, the service provider account can be reassigned to another service provider group with a different QoS parameter defined in the service provider level SLA.

Note: | IDs of service provider groups, application groups, application instances, service provider accounts must be unique. The combination of service provider account and application account for an application instance must be unique.

The service provider and application account and group registrations are performed either through the Oracle Communications Services Gatekeeper Administration Console or through external management systems integrated with Oracle Communications Services Gatekeeper using the Oracle Communications Services Gatekeeper Partner Relationship Management Interfaces or via MBeans. This guide describes many of the tasks associated with establishing and maintaining these accounts and groups using the Administration Console.

Note: | Service provider accounts, application accounts, and application instances have states that can be changed using OAM, so they can be temporarily be taken out of service. See States of Accounts.

## Custom SLAs

Custom SLAs are enforced by custom logic that operates on data provided in the SLAs and on data that comes with the request from an application and data about the originator of the request. The request can provide information such as application ID, application instance, service provider ID, application group ID, and service provider group ID. The data in the SLA is formatted according to the SLA XSD, and the enforcement logic uses the Document Object Model (DOM) representation of the XSD to get the data in the SLA.

Custom SLAs can be associated with application groups and service provider groups or be global. A custom global SLA is valid for all requests, regardless of which application group or service provider group the application that triggered the request belongs to.

Custom SLAs are loaded either through the Oracle Communications Services Gatekeeper Administration Console or through external management systems integrated with Oracle Communications Services Gatekeeper using the MBeans.

## Typical workflow

1. Define the set of service classes, expressed as SLAs, at both the service provider group level and the application group level, see Defining Service Provider Group and Application Group SLAs.
2. Define the set of node service classes, expressed as SLAs, at both the service provider node level and global node level, see Defining Global Node and Service Provider Group Node SLAs.
3. Create service provider and application groups that correspond to these SLAs, see Managing Groups.
4. Associate the service provider group SLAs and application group SLAs with the groups, see Managing SLAs.
5. Load the global node SLA and service provider group node SLAs, see Managing SLAs.
6. Create a service provider account and associate it with the appropriate service provider group. See Managing Service Provider and Application Accounts.
7. Create an application account and associate it with the appropriate application group. See Managing Service Provider and Application Accounts.
8. Create an application instance, see Managing Application Instances.
9. Depending on which communication service is being used, provision communication service specific data using the operation and management for relevant communication service.
10. Distribute the credentials to be used by the application to the service provider.

Note: | It is also possible to create unique SLAs and groups for an individual application. Accounts can be associated with other groups in runtime, so the class of service can be adjusted over time.