How it works

The web interface communicates with a web application hosted by Rhino Element Manager, which communicates with the HSS through Diameter Sh. Administrators can use it to:

  • view provisioned data

  • configure important settings

  • add new data to the HSS

  • remove data from the HSS.

Prerequisites

Before using the editor, you need to configure:

For more information on Operator Determined Barring see Operator Determined Barring.

Using the Data Editor

To use the Data Editor:

1

From REM’s monitoring screen, select Sentinel ▶ HSS Subscriber Data.

location subcriber data editor

It may take a few seconds before the screen appears on first load. It should look like this:

hss data query box

2

Follow the procedures to load or view, edit, or remove transparent data for an IMS public identity.

Load or view transparent data for an IMS public identity

Warning The HSS that the Editor queries depends on which network you’ve chosen. These instructions assume that, before loading data, you have configured the HSS address for the network operator.

To load or view data:

1

Type the IMS public identity into the IMS User Identity field, and click the Load button.

load an identity from hss

HSS Subscriber Data displays.

loaded hss subscriber data
Note
Loading errors

If there’s an error — for example, because the HSS is unavailable, the network operator is not configured properly, or the data cannot be parsed — a red-coloured error message will display in the panel, and red text in the log below. In the following example, a new Sentinel network operator called ‘SteveInc’ has not been configured properly.

misconfigured network operator

Edit transparent data for an IMS public identity

To edit data that you’ve loaded in the Editor:

1

Click the Edit button.

Fields become editable.

editing a users data

2

Make your changes, depending on the field type.

Field type How to edit Example

Boolean

select from a list

CDIV Active

integer

enter in a text box

CDIV No Reply Timer

complex XML

enter in a resizable text box, with basic XML validation (checks that the XML is well-formed)

Click and drag the lower right corner to resize.

resizable box
CDIV Rules

enumeration

select one of N values

OIR Default Behaviour

3

Click the Save button at the lower right.

If entered data is validated and saved successfully to the HSS, a green message displays in the panel and REM log.

editing save success

If saving fails, a red message displays in the panel and log. In the following example, the XML is not well-formed (in the CDIV Rules attribute), so REM rejects the user’s input before attempting to reach the HSS.

editing save failure

Remove transparent data for an IMS public identity

To remove data that you’ve loaded in the Editor:

1

Click the Delete button (error ).

The editor prompts you to confirm the deletion.

remove hss data popup

2

Click OK.

The panel becomes blank, and a green message displays in the REM log below.

Required configuration for MMTel

To edit HSS transparent user data so it can use OpenCloud’s out-of-the-box IR.92 features, follow the manual configuration steps below.

Tip The volte-sentinel-mappings-config tool will carry out these steps for you. See Populate XCAP server settings and MMTel service data.

1

Select Sentinel ▶ Feature Configuration ▶ Subscriber Data Lookup from HSS (sip).

400

2

Once the data’s loaded, select the Provisioning Field Mappings tab.

Warning not the Session State Field Mappings tab!

3

Each network operator installed in Sentinel can have their own configuration. To select the defaults for the platform, select (none) under the Network section of the screen. Otherwise, to configure a particular operator, select it.

Below are examples with and without fields configured for the currently selected network operator.

test operator first use field mappings
image::{here}field-mappings.png[]

4

Click the Add Field Group button.

A prompt displays to enter details.

add field group

5

Fill in the following values — either by typing, or by selecting the text box and pressing the down arrow on your keyboard to select these default values:

Field Default

Service indication

MMTEL-Services

Service data class

com.opencloud.volte.sentinel.simservs.xcap.TMMTelServicesType

Service data codec class

com.opencloud.volte.sentinel.provisioning.hss.TMMTelServicesCodec

JXPath factory class

com.opencloud.volte.sentinel.simservs.xcap.MMTelJXPathFactory

And select OK.

6

Once the field group for MMTEL-Services has been added, select it; and click the Add Field button to add the following fields:

Field

Type

Description

Xpath

OIP Active

java.lang.Boolean

Whether or not originating identity presentation is active for this user. Refer to documentation for the ‘unset’ value.

complete-originating-identity-presentation/originating-identity-presentation/@active

OIR Active

java.lang.Boolean

Whether or not originating identity presentation restriction is active for this user. Refer to documentation for the ‘unset’ value

complete-originating-identity-restriction/originating-identity-presentation-restriction/@active

OIR Default Behaviour

com.opencloud.volte.sentinel.simservs.xcap. OriginatingIdentityPresentationRestriction$DefaultBehaviourType

Default behaviour value

complete-originating-identity-restriction/originating-identity-presentation-restriction/default-behaviour

TIP Active

java.lang.Boolean

Whether or not Terminating Identity Presentation is active for this user. Refer to documentation for the ‘unset’ value

complete-terminating-identity-presentation/terminating-identity-presentation/@active

TIR Active

java.lang.Boolean

Whether or not Terminating Identity Presentation Restriction is active for this user. Refer to documentation for the ‘unset’ value

complete-terminating-identity-restriction/terminating-identity-presentation-restriction/@active

TIR Default Behaviour

com.opencloud.volte.sentinel.simservs.xcap. TerminatingIdentityPresentationRestriction$DefaultBehaviourType

Default behaviour value

complete-terminating-identity-restriction/terminating-identity-presentation-restriction/default-behaviour

ICB Active

java.lang.Boolean

Whether or not Incoming Communication Barring is active for this user. Refer to documentation for the ‘unset’ value

complete-communication-barring/incoming-communication-barring/@active

OCB Active

java.lang.Boolean

Whether or not Outgoing Communication Barring is active for this user. Refer to documentation for the ‘unset’ value

complete-communication-barring/outgoing-communication-barring/@active

CW Active

java.lang.Boolean

Whether or not Communication Waiting is active for this user. Refer to documentation for the ‘unset’ value

complete-communication-waiting/communication-waiting/@active

CDIV Active

java.lang.Boolean

Whether or not Communication Diversion is active for this user. Refer to documentation for the ‘unset’ value

complete-communication-diversion/communication-diversion/@active

CDIV No Reply Timer

java.lang.Integer

Communication Diversion no reply timer

complete-communication-diversion/communication-diversion/NoReplyTimer

CDIV Rules

com.opencloud.volte.sentinel.common.policy.Ruleset

Communication Diversion rules

complete-communication-diversion/communication-diversion/ruleset

Operator CDIV Authorised

java.lang.Boolean

Enables Operator CDIV configuration for this user. If true, Operator CDIV rules are considered when determining CDIV actions. If false, Operator CDIV rules are ignored.

complete-communication-diversion/operator-communication-diversion/@authorized

Operator CDIV Rules

com.opencloud.volte.sentinel.common.policy.Ruleset

Operator Communication Diversion rules

complete-communication-diversion/operator-communication-diversion/ruleset

Operator CDIV Maximum Diversion Count

java.math.BigInteger

Operator Communication Diversion maximum diversion count

complete-communication-diversion/operator-communication-diversion/total-number-of-diversions-for-each-communication

Operator CDIV No Reply Timer

java.lang.Integer

Operator Communication Diversion no reply timer

complete-communication-diversion/operator-communication-diversion/communication-forwarding-on-no-reply-timer

ICB Rules

com.opencloud.volte.sentinel.common.policy.Ruleset

Incoming Communication Barring rules

complete-communication-barring/incoming-communication-barring/ruleset

Flexible Alerting Active

java.lang.Boolean

Whether or not Flexible Alerting is active for this user. Refer to documentation for the ‘unset’ value

complete-flexible-alerting/operator-flexible-alerting/@authorized

Flexible Alerting Group Active

java.lang.Boolean

Whether or not Flexible Alerting group is active for this user. Refer to documentation for the ‘unset’ value

complete-flexible-alerting/operator-flexible-alerting-group/@authorized

Flexible Alerting Pilot Number

com.opencloud.volte.sentinel.common.policy.IdentityType

The URI that defines the flexible alerting group and triggers the feature to activate.

complete-flexible-alerting/operator-flexible-alerting-group/identity

Flexible Alerting Group Members

com.opencloud.volte.sentinel.simservs.xcap.OperatorFlexibleAlertingGroup$Members

The identities of the members that belong to this group

complete-flexible-alerting/operator-flexible-alerting-group/members

Flexible Alerting Membership Type

com.opencloud.volte.sentinel.simservs.xcap.OperatorFlexibleAlertingGroup$MembershipType

The membership type specifying whether a member is allowed to unsubscribe from the group or not. ‘Permanent’ means not allowed.

complete-flexible-alerting/operator-flexible-alerting-group/membership

Flexible Alerting Group Type

com.opencloud.volte.sentinel.simservs.xcap.OperatorFlexibleAlertingGroup$GroupType

Whether the type of the group is single-user or multiple-users. For single user, the pilot number is busy if one of the members is busy. For multiple-user’s the pilot number is busy when all members are busy.

complete-flexible-alerting/operator-flexible-alerting-group/group-type
Note

None of these fields are required.

To delete a field: select it, and click the error that displays next to it.

7

Click Save.

8

Once you have finished adding, editing, and/or removing fields — for the changes to take effect — disconnect from REM, and then log in again

Active flags information

The active flags (OIRActive, CDIVActive, and ICBActive) are specified as optional Boolean attributes in the XCAP and MMTEL XML schemas.

In an XML document, this means they can have three possible values:

  • does not exist (that is, attribute is not declared)

  • exists with the value true

  • exists with the value false.

In the transparent data editor user interface, these are reflected by these three values: Unset, True, or False,

For short, we refer to them as the ‘active’ attributes.

The XCAP and MMTEL specifications assign special meaning to these ‘active’ attributes when their attribute does not exist (that is, when they have the value ‘unset’ in the REM user interface):

  1. The session processing (that is, the feature) should act as though the value is true.

  2. The XCAP requests from the user equipment are subject to special rules:

    • A request is not allowed to

      • create the ‘active’ attribute (if a request does this, the XCAP server returns an HTTP error response)

      • toggle the ‘active’ attribute for the feature via the XCAP interface (if a request does this the XCAP server returns an HTTP error response).

    • A request is allowed to configure other portions of that service’s data.
      For example, if Communication Diversion has no ‘active’ attribute, a request can configure communication diversion rules.

In summary, the means that the user equipment cannot disable the feature. If the operator wants the user equipment to be able to enable or disable the feature, then the ‘active’ attribute should exist (and therefore be either true or false).

Required configuration for Operator Determined Barring

To edit HSS transparent user data so it can use OpenCloud’s out-of-the-box IR.92 features:

1

Select Sentinel ▶ Feature Configuration ▶ Subscriber Data Lookup from HSS (sip).

400

2

Once the data’s loaded, select the Provisioning Field Mappings tab.

Warning not the Session State Field Mappings tab!

3

Each network operator installed in Sentinel can have their own configuration. To select the defaults for the platform, select (none) under the Network section of the screen. Otherwise, to configure a particular operator, select it.

Below are examples with and without fields configured for the currently selected network operator.

test operator first use field mappings
image::{here}field-mappings.png[]

4

Click the Add Field Group button.

A prompt displays to enter details.

add field group

5

Fill in the following values — either by typing, or by selecting the text box and pressing the down arrow on your keyboard to select these default values:

Field Default

Service indication

IMS-ODB-Information

Service data class

com.opencloud.volte.sentinel.mmtel.odb.TOdbForImsOrientedServices

Service data codec class

com.opencloud.mmtel.feature.hssdata.OdbServiceDataCodec

JXPath factory class

com.opencloud.volte.sentinel.mmtel.odb.OdbJXPathFactory

And select OK.

6

Once the field group for IMS-ODB-Information has been added, select it; and click the Add Field button to add the following fields:

Field

Type

Description

Xpath

Outgoing barring condition

java.lang.Short

Set the condition for outgoing barring

OdbForImsMultimediaTelephonyServices/OutgoingBarring

Incoming barring condition

java.lang.Short

Set the condition for incoming barring

OdbForImsMultimediaTelephonyServices/IncomingBarring

Barring of roaming condition

OdbForImsMultimediaTelephonyServices/BarringOfRoaming

Set the condition for barring of roaming

OdbForImsMultimediaTelephonyServices/BarringOfRoaming

Bar premium rate communications information

java.lang.Boolean

Set the condition for outgoing barring of premium rate communication information

OdbForImsMultimediaTelephonyServices/OutgoingPremiumRateBarring/PremiumRateCommunicationsInformation

Bar premium rate calls information when roaming outside hplmn country

java.lang.Boolean

Set the condition for outgoing barring of premium rate communication information when roaming"

OdbForImsMultimediaTelephonyServices/OutgoingPremiumRateBarring/PremiumRateCallsInformationWhenRoamingOutsideHplmnCountry

Bar premium rate communications entertainment

java.lang.Boolean

Set the condition for outgoing barring of premium rate communication entertainment

OdbForImsMultimediaTelephonyServices/OutgoingPremiumRateBarring/PremiumRateCommunicationsEntertainment

Bar premium rate calls entertainment when roaming outside hplmn country

java.lang.Boolean

Set the condition for outgoing barring of premium rate communication entertainment when roaming

OdbForImsMultimediaTelephonyServices/OutgoingPremiumRateBarring/PremiumRateCallsEntertainmentWhenRoamingOutsideHplmnCountry"

Evaluate ruleset Type1

java.lang.Boolean

Activate/Deactivate processing barring ruleset type1

OdbForImsMultimediaTelephonyServices/OperatorSpecificBarring/Type1

Evaluate ruleset Type2

java.lang.Boolean

Activate/Deactivate processing barring ruleset type2

OdbForImsMultimediaTelephonyServices/OperatorSpecificBarring/Type2

Evaluate ruleset Type3

java.lang.Boolean

Activate/Deactivate processing barring ruleset type3

OdbForImsMultimediaTelephonyServices/OperatorSpecificBarring/Type3

Evaluate ruleset Type4

java.lang.Boolean

Activate/Deactivate processing barring ruleset type4

OdbForImsMultimediaTelephonyServices/OperatorSpecificBarring/Type4

Barring of supplementary services management

java.lang.Boolean

Set the condition to bar the supplementary services management

OdbForImsMultimediaTelephonyServices/BarringOfSupplementaryServicesManagement

Diverted to address registration barring

java.lang.Short

Set the condition to bar the registration of diverted address

OdbForImsMultimediaTelephonyServices/DivertedToAddressRegistrationBarring

Simple invocation of communication transfer barring

java.lang.Short

Set the condition to bar a communication transfer

OdbForImsMultimediaTelephonyServices/SimpleInvocationOfCommunicationTransferBarring

Multiple invocation of communication transfer barring

java.lang.Boolean

Set the condition to bar multiple communication transfer

OdbForImsMultimediaTelephonyServices/MultipleInvocationOfCommunicationTransferBarring

Invocation of chargeable communication transfer barring

java.lang.Boolean

Set the condition to bar a chargeable communication transfer

OdbForImsMultimediaTelephonyServices/InvocationOfChargeableCommunicationTransferBarring
Note

None of these fields are required.

To delete a field: select it, and click the error that displays next to it.

7

Click Save.

8

Once you have finished adding, editing, and/or removing fields — for the changes to take effect — disconnect from REM, and then log in again

Previous page Next page
Sentinel VoLTE Version 2.7.0