On this page we explain how the answers given to the various questions asked by the installer affect the configuration of the Sentinel VoLTE SDK, and how this configuration can be changed without reinstalling the Sentinel VoLTE SDK.
Where changes to profile tables do not specify an explicit profile, the change is made to the profile ${platform.operator.name}::::
.
Please note that some parts of the installer do not require user input, hence some of the sections below do not appear in the installer.
- Basic SDK questions
- Rhino
- Deploy module
- Home PLMN IDs
- Determine international and roaming status
- Play announcements
- Online charging
- Diameter (RO & CCA)
- Diameter Rf
- Call detail records (CDRs)
- CAP charging (IM-SSF)
- Sh Cache Microservice RA
- Sentinel registrar
- Cassandra
- SIP SIS RA
- MMTel conferencing
- Enable HSS IMS-ODB-Information query
- Enable HSS Metaswitch-TAS-Services query
- IMCSI Configuration
- Correlation RA
- CDMA HLR
- HLR GSM
- TADS
Basic SDK questions
Rhino
Deploy module
Notes
This question determines which features are deployed (this always includes the core features, and can include MMTel and SCC features) and whether the GSM or CDMA features are deployed. Only the chosen features, with their configurations, are deployed. This setting cannot be changed without a reinstall of the Sentinel VoLTE SDK.
Determine international and roaming status
Configuration profile changes
The installer create two kinds of profiles, one named DEFAULT
and one named after every configured home network MCC, in:
-
${platform.operator.name}_DetermineInternationalAndRoamingStatus_AddressListEntryTable
, and -
${platform.operator.name}_DetermineInternationalAndRoamingStatus_AddressListConfigurationTable
.
These profiles are initialised using the configured home PLMN IDs from the Home PLMN IDs section.
Furthermore, it sets the following value in the SipSentinelConfigurationTable
profile table:
-
HomeNetworkIDs
is set to the home domain.
Finally, the NormalizationFeatureConfigProfileTable
is updated as follows:
-
CountryCode
is set to the configured home network prefix.
Notes
All values can be changed after installation.
Furthermore, more profiles can be added to ${platform.operator.name}_DetermineInternationalAndRoamingStatus_AddressListEntryTable
and ${platform.operator.name}_DetermineInternationalAndRoamingStatus_AddressListConfigurationTable
, using the installer-created profiles as a prototype.
Online charging
Configuration profile changes
If using Diameter Ro online charging, the DestinationRealm
in the DiameterMediationOcsConfigurationTable
is set to the value chosen for the destination realm during the Diameter configuration.
Diameter (RO & CCA)
Configuration profile changes
The installer sets Host
in the DiameterConfig
profile table to the supplied host.
If using the installer to set up a simple configuration, all profiles in the DiameterConfig
profile table, except the default profile (the nameless profile), are updated as follows:
-
PeerTable
is updated using the supplied peer URI and address, -
Realm
is set to the configured realm name, and -
RealmTable
is updated using the supplied realm name and peer URI.
If setting up a simple configuration, and deploying against a production Rhino (as configured in the Rhino step), we additionally set in the same profiles:
-
EnableMultiNodeConfig
is set to theEnableMultiNodeConfig
value of theDiameterRoOcsProfile
(defaultfalse
),) -
NodeIDs
is set using the node configuration from the Rhino step, and -
PerNodeHosts
is set using the node configuration from the Rhino step.
Finally, the installer sets DisableCharging
in the DetermineChargingConfigProfileTable to false
exactly if Diameter Ro online charging was selected in the Online charging step.
Resource adaptor configuration changes
The field 3GPPVersion
in the diameterro-0
resource adaptor configuration is set to the configured version.
If Session Replication is enabled, the following diameterro-0
resource adaptor configuration properties are adjusted:
-
ReplicateActivities
is set totrue
-
ReplicateByDefault
is set tofalse
Diameter Rf
Configuration profile changes
The installer sets host
in the client
profile of the RfControlDiameterConfiguration
table to the supplied host.
If using the installer to set up a simple configuration, all profiles in the RfControlDiameterConfiguration
profile table are updated as follows:
-
PeerTable
is updated using the supplied peer URI and address, -
Realm
is set to the configured realm name, and -
RealmTable
is updated using the supplied realm name and peer URI.
Resource adaptor configuration changes
The rf-control-ra
resource adaptor configuration is updated as followed:
-
3GPPVersion
is set to the configured version.
Additionally, if using the installer to set up a simple configuration:
-
DestinationHost
is set to the peer host, and -
DestinationRealm
is set to the realm name.
Finally, if not using Diameter Rf, the rf-control-ra
resource adaptor is deactivated.
Notes
The configuration can be changed after installation. If enabling Diameter Rf after installation, please also make the required changes in the Call detail records (CDRs) step.
Call detail records (CDRs)
Configuration profile changes
The installer makes the following changes in the DetermineChargingConfigProfileTable
profile table:
-
InterimCdrsEnabled
is set totrue
exactly if interim CDRs have been enabled, and -
SessionCdrsEnabled
is set totrue
exactly if session CDRs have been enabled.
Similarly, the installer makes the following changes to all profiles in the SipInterimCdrProfileTable
profile table:
-
UseCdrRa
is set totrue
exactly if interim CDRs have been enabled, and -
UseRfControlRa
is set totrue
exactly if Diameter Rf has been enabled in the Diameter Rf step.
CAP charging (IM-SSF)
Property file changes
The properties file imssf-install.properties
is updated as follows:
-
imssf.countrycode
is set to the supplied country code, and -
imssf.default.mediaserver.address
is set to the supplied default media server address.
Notes
These values can be changed after installation as detailed in the IM-SSF documentation.
Sh Cache Microservice RA
Configuration profile changes
The following values are set in the sh-cache-microservice-ra
resource adaptor configuration:
-
serverURL
is set to the URL for the Sh Cache Microservice -
proxy.enabled
is set to true if a proxy has been enabled, and -
proxy.host
andproxy.port
are set to the configured proxy values (if enabled).
Sentinel registrar
Configuration profile changes
The installer sets the following values in the RegistrarConfigurationTable
profile table:
-
AtuSti
is set to the configured ATU-STI, -
AtcfUpdateTimeout
is set to the configured ATCF update timeout, -
StnSr
is set to the configured STN-SR, and -
SubscriberDataFacadeType
is set to the chosen registration data storage type.
Additionally it will set one value on the VolteServiceConfigProfileTable
profile table:
-
RegistrationDataSource
will be set to eitherHSS
orCASSANDRA
.
Furthermore, a prototype profile ${platform.operator.name}:::::101
is created in the same profile table, with a single entry:
-
AtuSti
is set to the configured ATU-STI.
Resource adaptor configuration changes
If Cassandra has been chosen for the registration data storage, the installer enables the cassandra
resource adaptor, and sets the following values in the cassandra-third-party-reg
resource adaptor configuration:
-
cassandraContactPoints
is set to the configured Cassandra contact points, and -
policy.protocol.port
is set to the configured Cassandra port.
If Cassandra has not been chosen for the registration data storage, the installer disables the cassandra-third-party-reg
resource adaptor.
Cassandra
SIP SIS RA
Resource adaptor configuration properties
The sis-sip-ra
entity has the following properties set:
-
RFC3263:failover_enabled
is set totrue
-
RFC3263:failover_timer
is set to10000
-
RFC3263:blacklist_timer
is set to300000
Network Interface changes
The DNS domain name specified during installation will be set:
-
in the
VirtualAddresses
configuration property for the network interface (namedsip-sis-ra-default
) of thesip-sis-ra
resource adaptor entity.
Additionally, if session replication was specified during installation, the Dynamic SRV Name format will be set:
-
in the
DynamicSRVNameFormat
configuration property for the network interface (namedsip-sis-ra-default
) of thesip-sis-ra
resource adaptor entity-
If the TAS domain name is tas.example.com then this is set to the value
node-${ip}.tas.example.com
.
-
If the Dynamic SRV Name was not specified at installation time, this resource adaptor entity configuration property will be left blank.
Configuration file changes
The installer records the configured SIP SIS RA hostname in the IPAddress
property in sentinel-volte-base-service-components/config.ant.xml
.
Notes
Please see the SIP network settings for more information about changing the RFC 3263 settings.
Further information on the use of the DNS domain name is available in Non-sharded DNS configuration and SIP default network interface settings.
MMTel conferencing
Configuration profile changes
The installer sets the following values in the MMTelCONFConfigProfileTable
profile table:
-
ICSCFURI
is set to the configured conference I-CSCF URI, -
MRFURI
is set to the configured MRF URI, and -
ConfFactoryPSI
is set to the configured conference factory PSI.
Furthermore, it sets the following values in the MMTelECTConfigProfileTable
profile table:
-
ICSCFURI
is set to the configured ECT I-CSCF URI.
It also sets the following values in the SccConfHandlingConfigProfileTable
profile table:
-
ConfFactoryPSI
is set to the configured conference factory PSI.
Finally, it updates the SentinelMapperSetEntryTable
to use the mappers corresponding to the configured MSML vendor.
Enable HSS IMS-ODB-Information query
Configuration profile changes
In the IMS-ODB-Information
profile of the ${platform.operator.name}_SubscriberDataLookupFromHss2ServiceIndicationProfileTable
profile table, DisableQuery is set to true
if the HSS query for IMS-ODB-Information
has been disabled.
Notes
This value can be changed after installation. If this value is changed post installation there are some secondary steps required as well.
You will need to run the sentinel-volte-mappings-config
tool
making use of both the -im
and -o
flags to add or remove mappings.
-
If you are changing the flag from
false
totrue
you will need to remove the mappings by not including them in your-im
list. -
If you are changing the flag from
true
tofalse
you will need to add the mappings by including them in your-im
list.
Enable HSS Metaswitch-TAS-Services query
Configuration profile changes
In the Metaswitch-TAS-Services
profile of the ${platform.operator.name}_SubscriberDataLookupFromHss2ServiceIndicationProfileTable
profile table, DisableQuery is set to true
if the HSS query for Metaswitch-TAS-Services
has been disabled.
Notes
This value can be changed after installation. If this value is changed post installation there are some secondary steps required as well.
You will need to run the sentinel-volte-mappings-config
tool
making use of both the -im
and -o
flags to add or remove mappings.
-
If you are changing the flag from
false
totrue
you will need to remove the mappings by not including them in your-im
list. -
If you are changing the flag from
true
tofalse
you will need to add the mappings by including them in your-im
list.
IMCSI Configuration
Configuration profile changes
This step only makes any changes if installing a GSM deploy, and using CAP for online charging. If so the installer sets the following values in the FetchIMCSIConfigProfileTable
profile table:
-
FetchImcsiEnabledOnOrigCall
determines if the IMCSI should be fetched for originating calls -
FetchImcsiEnabledOnTermCall
determines if the IMCSI should be fetched for terminating calls
Correlation RA
Configuration profile changes
The default profiles (i.e. the profiles without a name) in both the ReoriginationCorrelationIdPools
and EtcAriCorrelationIdPools
tables are updated in the following way:
-
NodeIds
is set using the node configuration from the Rhino step, and -
PreconfiguredCorrelationIdSet
is set using the node configuration from the Rhino step.
CDMA HLR
Configuration profile changes
This step only makes any changes if installing a CDMA deploy, and using TLDN for SCC TADS routing.
If so, the installer first makes the following change in VolteServiceConfigProfileTable
:
-
UseHLRBasedCSRN
is set totrue
.
Next the installer sets the following values in the CDMAHLRConfigProfileTable
profile table:
-
HLRSccpAddressAsString
is set to the configured HLR Address, -
SentinelSccpAddressAsString
is set to the configured originating Sentinel address, -
HLRInvokeTimeout
is set to the configured invoke timeout, -
MarketID
is set to the configured market ID, and -
SwitchNumber
is set to the configured switch number.
HLR GSM
Configuration profile changes
This step only makes any changes if installing a GSM deploy, and using either the MSRN from the HLR for SCC TADS routing, or determining roaming from HLR.
If using the MSRN from the HLR, the installer first makes the following change in VolteServiceConfigProfileTable
:
-
UseHLRBasedCSRN
is set totrue
.
If determining roaming from HLR, the installer makes another change in VolteServiceConfigProfileTable
:
-
RetrieveHLRRoamingStatus
is set totrue
.
Next the installer sets the following values in the HLRConfigProfileTable
profile table:
-
HLRSccpAddressAsString
is set to the configured HLR Address, -
SentinelSccpAddressAsString
is set to the configured originating Sentinel address, -
SentinelSccpMscEndpointAddressAsString
is set to the configured originating Sentinel address, -
SentinelAddressStringAsString
is set to the configured MLC address, and -
HLRInvokeTimeout
is set to the configured invoke timeout.
TADS
Configuration profile changes
If configured to allow WLAN access, the following profiles are added to the SCCTADSNetworkTypeConfigProfileTable
:
-
${platform.operator.name}:::::0
-
NetworkType: 0
-
Description: RAT value 0 = WLAN from TS 29.212 section 5.3.31
-
TerminatingDomain: PS=WLAN
-
-
${platform.operator.name}:::::3GPP-WLAN
-
NetworkType: 3GPP-WLAN
-
Description: P-Access-Network-Info value from TS 24.229 section 7.2A.4
-
TerminatingDomain: PS=WLAN
-
-
${platform.operator.name}:::::IEEE-802.11
-
NetworkType: IEEE-802.11
-
Description: P-Access-Network-Info value from TS 24.229 section 7.2A.4
-
TerminatingDomain: PS=WLAN
-
-
${platform.operator.name}:::::IEEE-802.11A
-
NetworkType: IEEE-802.11A
-
Description: P-Access-Network-Info value from TS 24.229 section 7.2A.4
-
TerminatingDomain: PS=WLAN
-
-
${platform.operator.name}:::::IEEE-802.11B
-
NetworkType: IEEE-802.11B
-
Description: P-Access-Network-Info value from TS 24.229 section 7.2A.4
-
TerminatingDomain: PS=WLAN
-
-
${platform.operator.name}:::::IEEE-802.11G
-
NetworkType: IEEE-802.11G
-
Description: P-Access-Network-Info value from TS 24.229 section 7.2A.4
-
TerminatingDomain: PS=WLAN
-
-
${platform.operator.name}:::::IEEE-802.11N
-
NetworkType: IEEE-802.11N
-
Description: P-Access-Network-Info value from TS 24.229 section 7.2A.4
-
TerminatingDomain: PS=WLAN
-