MTAS Calling Name Identity Presentation Management Guide for Cname
MTAS

Contents

1Introduction
1.1Prerequisites

2
Overview

3
Configure OCNIP or CNIP Service
3.1Activate OCNIP or CNIP Service
3.2Deactivate OCNIP or CNIP Service
3.3Modify OCNIP or CNIP Mode
3.4Modify CNIP Protocol
3.5Modify Calling Name Server Address
3.6Modify CNIP Time-out
3.7Modify the Names of Cname Private Headers
3.8Calling Name Server Redundancy
3.9Select IP Protocol Version
3.10Modify Default Display Name
3.11Modify Privacy Display Name
3.12Modify Oir Override Skip Query

1   Introduction

This document describes how to configure the Originating Calling Name Identity Presentation (OCNIP) and the Calling Name Identity Presentation (CNIP) service in the MTAS using the Cname interface.

1.1   Prerequisites

It is assumed that the user of this document is familiar with the Operation and Maintenance (O&M) area, in general.

1.1.1   Documents

Before starting any procedure in this document, ensure that the following documents are available:

1.1.2   Conditions

Before starting any of the procedures in this document, ensure that the following conditions apply:

2   Overview

The purpose of the OCNIP as well as the CNIP service is to alter the originating identity information presented in a communication based on the participant’s preferences and information retrieved from an external node outside IMS. These services are managed by the operator and not by the end user.

The OCNIP is an originating service that retrieves the caller's identity information (including display-name) from CNS and inserts it in the outgoing SIP signalling from the originating MTAS.

The CNIP is a terminating service that retrieves the caller's identity information (including display-name) from CNS and inserts it in the outgoing SIP signalling from the terminating MTAS.There are two categories of configuration on node level:

There are two categories of configuration on node level:

For more information on service management of the Identity Presentation, refer to MTAS Service Management Guide.

It is the administrative state of the OCNIP or CNIP function that decides if the function is activated (Unlocked) or deactivated (Locked).

Both OCNIP and CNIP services replace the display name portion of the identity information in the From and PAI headers of the originating participant with the retrieved calling name from an external database CNS.

Both OCNIP and CNIP services can operate in one of the two modes, where the operator can control when to query the name database CNS:

The amount of time that the MTAS waits for the CNS to answer a query can be controlled by the mtasIdPresCnipTimeout attribute.

The OCNIP/CNIP function relies on the Cname interface to perform the queries to the CNS.

For more information about the Cname, refer to the following document:

3   Configure OCNIP or CNIP Service

The following sections describe how to configure the OCNIP or CNIP services.

3.1   Activate OCNIP or CNIP Service

To be able to activate the OCNIP or CNIP service, the mtasIdPresAdministrativeState attribute must be unlocked. A valid URI for the mtasIdPresCnipCnameServerName attribute must exist.

For more details, refer to MTAS Service Management Guide, and Managed Object Model (MOM).

To activate the OCNIP or CNIP service:

  1. Navigate to the MtasIdPres MO.
  2. Set the mtasIdPresOcnipAdminState or mtasIdPresCnipAdminState attribute to 1 (Unlocked).
  3. Click Submit.
  4. Perform a backup. For more information, refer to Create Backup.

3.2   Deactivate OCNIP or CNIP Service

To deactivate the OCNIP or CNIP service:

  1. Navigate to the MtasIdPres MO.
  2. Set the mtasIdPresOcnipAdminState or mtasIdPresCnipAdminState attribute to 0 (Locked).
  3. Click Submit.
  4. Perform a backup. For more information, refer to Create Backup.

3.3   Modify OCNIP or CNIP Mode

The mtasIdPresOcnipMode and mtasIdPresCnipMode attributes allow control of when to query the name database (CNS).

The value 1 indicates mode always and the CNS is always queried. When in mode interrogate-on-unavailability, that is, value 0, the CNS is only queried when the display names are absent in both the From and P-Asserted-Identity headers.

To modify the OCNIP or CNIP mode:

  1. Navigate to the MtasIdPres MO.
  2. Set the mtasIdPresCnipMode / mtasIdPresOCnipMode attribute to either 0 (Interrogate-on-unavailability) or 1 (Always).
  3. Click Submit.
  4. Perform a backup. For more information, refer to Create Backup.

3.4   Modify CNIP Protocol

The mtasIdPresCnipProtocol attribute allows control of which protocol to use when CNIP queries the name database (CNS). The value 1 indicates the protocol SIP, and the CNS is queried by sending a calling name SUBSCRIBE (Event: calling-name). CNS sends calling name NOTIFY (Event: calling-name) containing the calling name information.

To modify the CNIP protocol:

  1. Navigate to the MtasIdPres MO.
  2. Set the mtasIdPresCnipProtocol attribute to 1 (SIP).
  3. Click Submit.
  4. Perform a backup. For more information, refer to Create Backup.

3.5   Modify Calling Name Server Address

The mtasIdPresCnipCnameServerName attribute defines the address of SIP-based CNS. The value of this attribute is used to construct the Request-URI of calling name SUBSCRIBE (Event: calling-name).

To modify the CNS Address:

  1. Navigate to the MtasIdPres MO.
  2. Set the mtasIdPresCnipCnameServerName attribute to either an FQDN or IP. Optionally, the attribute can have a port appended with IP separated by a colon, where the port is defined as four to five digits forming a number between the range 1024-65535. Numerical IPv6 addresses must be enclosed with brackets, for example, [1080::8:800:200c:417A]:8080. Port value 0 means that a domain name is specified, so the port to use is fetched from DNS with SRV lookup. When port is not specified, MTAS uses the 5060 default SIP port.
  3. Click Submit.
  4. Perform a backup. For more information, refer to Create Backup.

3.6   Modify CNIP Time-out

The mtasIdPresCnipTimeout attribute sets the amount of time that the MTAS waits for the CNS to answer a query. The default value is 500 ms.

To modify the time-out attribute:

  1. Navigate to the MtasIdPres MO.
  2. Set the mtasIdPresCnipTimeout attribute to a new value within the range 200-5000.
  3. Click Submit.
  4. Perform a backup. For more information, refer to Create Backup.

3.7   Modify the Names of Cname Private Headers

This section describes how to modify the names of Cname private headers.

3.7.1   Modify Name of Replacement Address Header

The mtasIdPresReplacementAddressHeader attribute defines the name of the private header received in SIP NOTIFY from the name database (CNS) that contains the replacement-address (company-number). The URI portion of the originating participant’s identity (FROM/PAI) is replaced by the replacement address. This attribute is valid both for Originating (OCNIP) and Terminating (CNIP) MTAS. The name of this header is case insensitive.

To modify the replacement-address-header attribute:

  1. Navigate to the MtasIdPres MO.
  2. Set the mtasIdPresReplacementAddressHeader attribute to a new string value 0-255 characters in length.
  3. Click Submit.
  4. Perform a backup. For more information, refer to Create Backup.

3.7.2   Modify Names of Transparent Headers

The mtasIdPresOCnipTransparentHeaders (OCNIP) and mtasIdPresCnipTransparentHeaders (CNIP) attributes each define a list of strings, where each string represents a private header that is to be transparently copied to the outgoing initial INVITE from the list of private headers in SIP Notify which comes from the Cname server to Originating (OCNIP) and Terminating (CNIP) MTAS. The names of these headers are case insensitive.

To modify the transparent-headers list attribute:

  1. Navigate to the MtasIdPres MO.
  2. Set the mtasIdPresOCnipTransparentHeaders list attribute [0-9] to a new string value 0-255 characters in length.
  3. Click Submit.
  4. Perform a backup. For more information, refer to Create Backup.

3.8   Calling Name Server Redundancy

MTAS supports DNS-based redundancy of the CNS using the Cname interface (SIP).

The following events can trigger failover to another CNS server:

When the CNIP Time-out timer attribute mtasIdPresCnipTimeout expires, the Calling Name retrieval procedure is terminated.

For more information about the Failover and Greylisting of the Calling Name Server when SIP is the used protocol, refer to MTAS SIP Management Guide.

For more information about DNS configuration, refer to Managed Object Model (MOM).

3.9   Select IP Protocol Version

The mtasIdPresDbIpVersion attribute sets the IP protocol version of the Cname interface.

To modify the IP version attribute:

  1. Navigate to the MtasIdPres MO.
  2. Set the mtasIdPresDbIpVersion attribute to 0 (IPv4) or 1 (IPv6).
  3. Click Submit.
  4. Perform a backup. For more information, refer to Create Backup.

3.10   Modify Default Display Name

The mtasIdPresDefaultDisplayName attribute defines the default display name (for example, "Unavailable") that is copied to the FROM/PAI header(s) in the outgoing SIP signalling when there is no display name available for OCNIP or CNIP, or when OCNIP or CNIP is disabled.

To modify the default display name attribute:

  1. Navigate to the MtasIdPres MO.
  2. Set the mtasIdPresDefaultDisplayName attribute to a new value.
  3. Click Submit.
  4. Perform a backup. For more information, refer to Create Backup.

3.11   Modify Privacy Display Name

The mtasIdPresPrivacyDisplayName attribute defines a display name (for example, "Restricted") that is copied to the FROM/PAI header(s) in the outgoing SIP signalling when privacy is requested or the Calling Name Server returns the information that the Calling Name Status is Restricted for OCNIP or CNIP.

To modify the privacy display name attribute:

  1. Navigate to the MtasIdPres MO.
  2. Set the mtasIdPresPrivacyDisplayName attribute to a new value.
  3. Click Submit.
  4. Perform a backup. For more information, refer to Create Backup.

3.12   Modify Oir Override Skip Query

The mtasIdPresCnipOirOverrideSkipQuery attribute defines whether the query to the name database (CNS) is to take place when OIR override is active. The default value is 0, that is, the query is done when OIR override is active.

To modify the Oir Override Skip Query attribute:

  1. Navigate to the MtasIdPres MO.
  2. Set the mtasIdPresCnipOirOverrideSkipQuery attribute to either 0 (query is done) or 1 (query is not done when OIR override is active).
  3. Click Submit.
  4. Perform a backup. For more information, refer to Create Backup.


Copyright

© Ericsson AB 2016. All rights reserved. No part of this document may be reproduced in any form without the written permission of the copyright owner.

Disclaimer

The contents of this document are subject to revision without notice due to continued progress in methodology, design and manufacturing. Ericsson shall have no liability for any error or damage of any kind resulting from the use of this document.

Trademark List
All trademarks mentioned herein are the property of their respective owners. These are shown in the document Trademark Information.

    MTAS Calling Name Identity Presentation Management Guide for Cname         MTAS