All rights reserved. April 2003.
The informationin this document is subjectto change without notice. The statements, configurations,technicaldata, and
recommendationsin this document are b elieved to be accurate and reliable, but are presented without express or implied
warranty. Users must take full responsibility for their applications of any products specified in this document. The
information in this document is proprietary to Nortel Networks Inc.
The software described in this document is furnished under a license agreement and may be used only in accordance
with the terms of that license. The software license agreement is included in this document.
Trademarks
Nortel Networks, the Nortel Networks logo, the Globemark, Unified Networks, CallPilot, and i2004 Internet Telephone
are trademarks of Nortel Networks.
Adobe and Acrobat Reader are trademarks of Adobe Systems Incorporated.
Microsoft, Windows, Windows NT, Internet Explorer and Outlook are trademarks of Microsoft Corporation.
Netscape is a trademark of Netscape Communications Corporation.
The asterisk after a name denotes a trademarked item.
Restricted rights legend
Use, duplication, or disclosure by the United States Government is subject to restrictions as set forth in subparagraph
(c)(1)(ii) of the Rights in Technical Data and Computer Software clause at DFARS 252.227-7013.
Notwithstanding any other license agreement that m ay pertain to, or accompany the delivery of, this computer software,
the rights of the United States Government regarding its use, reproduction, and disclosure are as set forth in the
Commercial Computer Software-Restricted Rights clause at FAR 52.227-19.
Statement of conditions
In the interest of improving internal design, operational function, and/or reliability, Nortel Networks Inc. reserves the
right to make changes to the products described in this document without notice.
Nortel Networks Inc. does not assume any liability that may occur due to the use or application of the product(s) or
circuit layout(s) described herein.
SUCH PORTIONS OF THE SOFTWARE ARE PROVIDED “AS IS” AND WITHOUT ANY EXPRESS OR IMPLIED
WARRANTIES,INCLUDING,WITHOUT LIMITATION,THE IMPLIED WARRANTIES OF MERCHANTABILITY
AND FITNESS FOR A PARTICULAR PURPOSE.
In addition, the program and informationcontainedherein are licensed only pursuant to a license agreement that contains
restrictions on use and disclosure (that may incorporate by reference certain limitations and notices imposed by third
parties).
NN10043-113
Page 3
[Standard - Nortel Networks Confidential]
Nortel Networks Inc. software license agreement
This Software License Agreement (“License Agreement”) is between you, the end-user (“Customer”) and Nortel
Networks Corporation and its subsidiaries and affiliates (“Nortel Networks”). PLEASE READ THE FOLLOWING
CAREFULLY. YOU MUST ACCEPT THESE LICENSE TERMS IN ORDER TO DOWNLOAD AND/OR USE THE
SOFTWARE. USE OF THE SOFTWARE CONSTITUTES YOUR ACCEPTANCE OF THIS LICENSE
AGREEMENT. If you do not accept these terms and conditions, return the Software, unused and in the original shipping
container, within 30 days of purchase to obtain a credit for the full purchase price.
“Software” is owned or licensed by Nortel Networks, its parent or one of its subsidiaries or affiliates, and is copyrighted
and licensed, not sold. Software consists of machine-readable instructions, its components, data, audio-visual content
(such as images, text, recordings or pictures) and related licensed materials including all whole or partial copies. Nortel
Networks grants you a license to use the Software only in the country where you acquired the Software. You obtain no
rights other than those granted to you under this License Agreement. You are responsible for the selection of the
Software and for the installation of, use of, and results obtained from the Software.
1.Licensed Use of Software. Nortel Networks grants Customer a nonexclusive license to use a copy of the Software
on only one machine at any one time or to the extent of the activation or authorized usage level, whichever is applicable.
To the extent Software is furnished for use with designated hardware or Customer furnished equipment (“CFE”),
Customer is granted a nonexclusive license to use Software only on such hardware or CFE, as applicable. Software
contains trade secrets and Customer agrees to treat Software as confidential information using the same care and
discretion Customer uses with its own similar information that it does not wish to disclose, publish or disseminate.
Customer will ensure that anyone who uses the Software does so only in compliance with the terms of this Agreement.
Customer shall not a) use, copy, modify, transfer or distribute the Software except as expressly authorized; b) reverse
assemble, reverse compile, reverse engineer or otherwise translate the Software; c) create derivative works or
modifications unless expressly authorized; or d) sublicense, rent or lease the Software. Licensors of intellectual property
to Nortel Networks are beneficiaries of this provision. Upon termination or breach of the license by Customer or in the
event designated hardware or CFE is no longer in use, Customer will promptly return the Software to Nortel Networks
or certify its destruction. Nortel Networks may audit by remote polling or other reasonable means to determine
Customer’s Software activation or usage levels. If suppliers of third party software included in Software require Nortel
Networks to include additional or different terms, Customer agrees to abide by such terms provided by Nortel Networks
with respect to such third party software.
2.Warranty.Except as may be otherwise expressly agreed to in writing between Nortel Networks and Customer,
Software is provided “AS IS” without any warranties (conditions) of any kind. NORTEL NETWORKS DISCLAIMS
ALL WARRANTIES (CONDITIONS) FOR THE SOFTWARE, EITHER EXPRESS OR IMPLIED, INCLUDING,
BUT NOT LIMITED TO THE IMPLIED WARRANTIES OF MERCHANTABILITYAND FITNESS FOR A
PARTICULAR PURPOSE AND ANY WARRANTY OF NON-INFRINGEMENT. Nortel Networks is not obligated to
provide support of any kind for the Software. Some jurisdictions do not allow exclusion of implied warranties, and, in
such event, the above exclusions may not apply.
3.Limitation of Remedies. IN NO EVENT SHALL NORTEL NETWORKS OR ITS AGENTS OR SUPPLIERS BE
LIABLE FOR ANY OF THE FOLLOWING: a) DAMAGES BASED ON ANY THIRD P ARTY CLAIM; b) LOSS OF,
OR DAMAGE TO, CUSTOMER’S RECORDS, FILES OR DATA; OR c) DIRECT, INDIRECT,SPECIAL,
INCIDENTAL, PUNITIVE, OR CONSEQUENTIAL DAMAGES (INCLUDING LOST PROFITS OR SAVINGS),
WHETHER IN CONTRACT, TORT OR OTHERWISE (INCLUDING NEGLIGENCE) ARISING OUT OF YOUR
USE OF THE SOFTWARE, EVEN IF NORTEL NETWORKS, ITS AGENTS OR SUPPLIERS HAVE BEEN
ADVISED OF THEIR POSSIBILITY. The forgoing limitations of remedies also apply to any developer and/or supplier
of the Software. Such developer and/or supplier is an intended beneficiary of this Section. Some jurisdictions do not
allow these limitations or exclusions and, in such event, they may not apply.
4.General
a. If Customer is the United States Government, the following paragraph shall apply: All Nortel Networks
Software available under this License Agreement is commercial computer software and commercial computer
software documentation and, in the event Software is licensed for or on behalf of the United States
iii
SIP Provisioning Client User Guide
Page 4
[Standard - Nortel Networks Confidential]
iv
Government, the respective rights to the software and software documentation are governed by Nortel
Networks standard commercial license in accordance with U.S. Federal Regulations at 48 C.F.R. Sections
12.212 (for non-DoD entities) and 48 C.F.R. 227.7202 (for DoD entities).
b. Customer may terminate the license at any time. Nortel Networks may terminate the license if Customer fails to
comply with the terms and conditions of this license. In either event, upon termination, Customer must either
return the Software to Nortel Networks or certify its destruction.
c. Customer is responsible for payment of any taxes, including personal property taxes, resulting from Customer’s
use of the Software. Customer agrees to comply with all applicable laws including all applicable export and
import laws and regulations.
d. Neither party may bring an action, regardless of form, more than two years after the cause of the action arose.
e. The terms and conditions of this License Agreement form the complete and exclusive agreement between
Customer and Nortel Networks.
f. This License Agreement is governed by the laws of the country in which CustomeracquirestheSoftware.If the
Software is acquired in the United States, then this License Agreement is governed by the laws of the state of
The Session Initiation Protocol (SIP) Provisioning Client is a web-based
Graphical User Interface (GUI) for service providers to complete administrative
tasks, for example, provisioning administrators, domains, IP Client Managers
(IPCMs) and IPCM clusters.
Overview
Service providers access the SIP Provisioning Client with any web browser. Being
a web-based system, the SIP Provisioning Client provides the service providers
with an highly efficient access from anywhere capability.
Note: The provisioning abilities visible to a n administrator in the SIP
Provisioning Client GUI depends on the level of authority assigned to
their account.
xix
Audience
This guide is intended for service providers and administrators (with varying
levels of privileges) assigned to manage customer domains.
What is not covered
This document does not cover
•Configuration
•System Management Console
SIP Provisioning Client User Guide
Page 20
[Standard - Nortel Networks Confidential]
xxWelcome
Text and graphic conventions
This guide uses the following text and graphic conventions:
bold textIndicates a menu option, link, or command key you
need to click. Example: Click Ok.
italic textIndicates
•a domain name or subdomain name
•adocumenttitle
•a variable name
separator ( > )Shows menu paths.
Example: Gateway > Add Gateway
Indicates a top level menu item in the SIP Provisioning
Client menu hierarchy.
Indicates a sub menu item in the SIP Provisioning
Client menu hierarchy.
Acronyms
NN10043-113
Indicates a form in the SIP Provisioning Client menu
hierarchy.
This guide uses the following acronyms
CASChannel Associated Signalling
CPLCall Processing Language
COSClass of Service
CS2000Communication Server 2000
DSLDigital Subscriber Line
GMTGreenwich Mean Time
•SIP Personal Agent Getting User Guide (Part No. NN10039-112)
•SIP Multimedia Web Client User Guide (Part No. NN10040-112)
•SIP Multimedia PC Client User Guide (Part No. NN10041-112)
•i2004 Internet Telephone User Guide (Part No. NN10042-113)
SIP Provisioning Client User Guide
Page 22
[Standard - Nortel Networks Confidential]
xxiiWelcome
You can print selected technical manuals and release notes free, directly from the
Internet. Go to the www.nortelnetworks.com/documentation URL. Find t he
product for which you need documentation. Then locate the specific category and
model or version for your hardware or software product. Use Adobe* Acrobat
Reader* to open the manuals and release notes, search for the sections you need,
and print them on most standard printers. Go to Adobe Systems at the
www.adobe.com URL to download a free copy of the Adobe Acrobat Reader.
How to get help
If you purchased a service contract for your Nortel Networks product from a
distributor or authorized reseller, contact the technical support staff for that
distributor or reseller for assistance.
If you purchased a Nortel Networks service program, contact Nortel Networks
Technical Support. To obtain contact information online, go to the
www.nortelnetworks.com/cgi-bin/comments/comments.cgi URL, then click on
Technical Support.
NN10043-113
From the Technical Support page, you can open a Customer Service Request
online or find the telephone number for the nearest Technical Solutions Center.
If you are not connected to the Internet, you can call 1-800-4NORTEL
(1-800-466-7835) to learn the telephone number for the nearest Technical
Solutions Center.
An Express Routing Code (ERC) is available for many Nortel Networks products
and services. When you use an ERC, your call is routed to a technical support
person who specializes in supporting that product or service. To locate an ERC for
your product or service, go to the http://www.nortelnetworks.com/help/contact/
erc/index.html URL.
Page 23
[Standard - Nortel Networks Confidential]
Chapter 1
Getting Started
Topics in this section:
•“SIP Provisioning Client overview” on page 1
•“SIP Provisioning Client features” on page 2
•“System requirements” on page 2
•“Using the online help” on page 5
•“Setting up time zones” on page 5
•“Changing the admin password” on page 9
•“Exiting the SIP Provisioning Client” on page 9
SIP Provisioning Client overview
1
The SIP Provisioning Client is a web-based GUI that you use to perform the
following administrative and provisioning tasks:
•define administration roles and privileges
•manage (list add, modify, or delete) users and devices
•define multiple service packages
•assign services to service packages
•assign service packages to domains
•assign translation information specific to a domain or subdomain
•provision voice mail servers
•provision 911 emergency notification
SIP Provisioning Client User Guide
Page 24
[Standard - Nortel Networks Confidential]
2Chapter 1 Getting Started
SIP Provisioning Client features
The SIP Provisioning Client gives service providers the capability to create and
set security,access, and permissions for the following components and roles of the
user framework:
•administration
•domains and subdomains (users, devices, telephony routes)
•gateways
•IPCM clusters
•voice mail servers
•services
•system
Note: The provisioning capabilities visible to an administrator in the SIP
Provisioning Client menu depend on the level of authority (rights)
assigned to their account.
System requirements
The following section describes the minimum and recommended hardware and
software requirements for the SIP Provisioning Client.
Minimum hardware and software requirements
•200MHz Pentium class or equivalent processor
•No additional free RAM is required. (The minimum memory requirements of
your browser must be met. See your browser documentation for more
information.)
•No additional harddrive space is required. (Local caching of web pages is
performed by your web browser. See your browser documentation for
information on the minimum disk space requirements.)
•Mouse (optional)
•640x480 @8bpp (256 colors) VGA graphics card
NN10043-113
Page 25
[Standard - Nortel Networks Confidential]
•Microsoft* Windows* 98 Second Edition (SE), Microsoft Windows
Millennium Edition (Me), Microsoft Windows 2000, Microsoft XP, or
Microsoft Windows NT* 4.0 with Service Pack 5 (SP5)
•28.8Kbps modem
•Netscape* Communicator 4.77 or Internet Explorer 5.0
•Cookies and javascript enabled
Recommended hardware and software requirements
•300MHz (or higher) Pentium class
•No additional free RAM is required. (The minimum memory requirements of
your browser must be met. See your browser documentation for more
information.)
•No additional harddrive space is required. (Local caching of web pages is
performed by your web browser. See your browser documentation for more
information on the minimum disk space requirements.)
•Mouse (required)
•800x600 or higher @16bpp (65,536 colors) VGA or better video graphics
card
•Microsoft Windows 98 Second Edition (SE), Microsoft Windows 2000,
Microsoft XP, or Microsoft Windows NT 4.0 with Service Pack 5 (SP5)
•56Kbps modem or other high speed connection (For example, cable modem,
Digital Subscriber Line (DSL) modem, 10baseT ethernet, an so forth)
•Netscape Communicator 4.77 or greater, or Internet Explorer 5.0 or greater
•Cookies and javascript enabled
Chapter 1 Getting Started3
Starting the SIP Provisioning Client
To start the SIP Provisioning Client from your PC
1Start any supported web browser.
2Enter the Uniform Resource Locator (URL) for the SIP Provisioning Client.
The SIP Provisioning Client Login window appears (Figure 1).
SIP Provisioning Client User Guide
Page 26
[Standard - Nortel Networks Confidential]
4Chapter 1 Getting Started
Figure 1 SIP Provisioning Client login window.
3Enter your username and password in the respective fields.
4Click LOG IN NOW to log in. Upon a successful login, the SIP Provisioning
Client Welcome window appears.
Figure 2 SIP Provisioning Client welcome window
NN10043-113
If the SIP Provisioning Client GUI is inactive for a period of time, your session
will expire. The following message appears:
Page 27
[Standard - Nortel Networks Confidential]
Figure 3 Session inactivity message
To restart the SIP Provisioning Client, click on the link to login again. Contact
your service provider to request a change to the session expiration time limit.
Using the online help
There are several ways that you can access SIP Provisioning Client help:
•online help - from the SIP Provisioning Client screen, click the Help button to
view a t ask-based help system. The online help provides:
— help pages containing forward and backward navigation icons
— procedures that help you use the SIP Provisioning Client
— a Table of Contents with hypertext links
— an Index with hypertext links
•questionmarkhelp.Clickthequestionmarkicontodisplayadescriptionand
possible values for parameter fields on a form.
Chapter 1 Getting Started5
Settinguptimezones
The SIP Provisioning C lient allows you to define and manage as many time zones
as you require to meet your needs, and to create your own time zones for easy
reference. Time zones define the time zone from which a subscriber normally
accesses the system (that is, the subscribers’s local time zone). Time zones are
used in the SIP Personal Agent Call Manager function to set a screening rule that
applies during a certain time. This time is dependent on the time zone selected.
SIP Provisioning Client User Guide
Page 28
[Standard - Nortel Networks Confidential]
6Chapter 1 Getting Started
The SIP Provisioning Client is initially set up with the standard 24 time zones:
plus or minus 12 hours from the Greenwich Mean Time (GMT) format. However,
there are more than 300+ time zones. What defines a time zone is not just the
offset from the GMT.It is also whether or not the time zone uses Daylight Saving
Time, when Daylight Saving Time occurs, and what the offset is.
Setting up times zones in the United States
As an example, the time zones you would set up across the United States from
East to West are listed in the following table:
1Click the System menu option.
2Click the Timezones form. The Timezone details window appears.
Page 29
[Standard - Nortel Networks Confidential]
Figure 4 Time Zone details window
Chapter 1 Getting Started7
3Select a zone from the list of time zones.
4From the drop down list, select a time zone.
SIP Provisioning Client User Guide
Page 30
[Standard - Nortel Networks Confidential]
8Chapter 1 Getting Started
5Click Save.
Creating a new time zone
To create a new time zone
1Click the System m enu option.
2Click the Timezones form. The Timezone details window appears.
3In the Add new timezone box, enter a meaningful name for the time zone in
the Name field. (This field is visible to subscribers.) Both the name and the
time zone need to be unique.
Figure 5 Add new time zone
4Click Save to save the new time zone. Click View details to see the list of
time zones.
Modifying or Deleting a time zone
The SIP Provisioning Client is preloaded with a number of default times zones.
You may wish to modify or delete a time zone to prevent the time zone from
showing up in the drop down list that is available when creating or modifying a
user.
To modify or delete a time zone
1Click the Services menu option.
2Click the Timezones form. The Timezone details window appears.
3Select the time zone that you wish to delete. Click the Delete link next to any
time zone that you do not need. In the confirmation dialog box, Click Ok to
permanently delete the time zone or Cancel to abort the action.
NN10043-113
Page 31
[Standard - Nortel Networks Confidential]
Tip: You cannot modify or delete a time zone that is currently in use.
Changing the admin password
To change the admin password
1Click the System m enu option.
2Click the icon for the Change Password form. The Change Admin Password
window appears.
3Enter your new password.
4Confirm your new password.
Chapter 1 Getting Started9
5Enter your current password.
6Click Save. Your new password is activated upon your next login.
Exiting the SIP Provisioning Client
To close the SIP Provisioning Client window and exit the SIP Provisioning Client,
click the Logout menu option.
SIP Provisioning Client User Guide
Page 32
[Standard - Nortel Networks Confidential]
10Chapter 1 Getting Started
NN10043-113
Page 33
[Standard - Nortel Networks Confidential]
Chapter 2
Administration Overview
Topics in this section:
•“Introduction” on page 11
•“SIP Provisioning roles, rights, and tasks” on page 12
•“Understanding provisioning roles and rights” on page 15
Introduction
In the SIP Provisioning Client, a provisioning role is defined as a collection of
access rights and privileges t hat allow an administrator to perform various
provisioning tasks. As a System Administrator, you can create any number of
administratorroles, depending on your particular needs. For example, you can add
a provisioning role to allow an administrator to perform multiple tasks, however,
giving them the rights to only a subset of everything available.
11
After logging in to the SIP Provisioning Client, you will see a menu list on the left
side of your screen. This list varies based on the privileges available to you. The
types of tasks you can perform as an administrator is based on the scope of your
defined role.
Note: The provisioning abilities visible to a n administrator in the SIP
Provisioning Client GUI depends on the rights assigned to their
provisioning role.
SIP Provisioning Client User Guide
Page 34
[Standard - Nortel Networks Confidential]
12Chapter2 Administration Overview
SIP Provisioning roles, rights, and tasks
The following table provides an overview of the SIP Provisioning tasks.
Table 1 SIP Provisioning tasks overview
If you have the right
forUse this Provisioning menu option...To perform these tasks...
Full domain accessAdminister all current domains and
Domain managementList, add, modify, or delete domains
IPCM cluster
provisioning
Service Package
Creation
Device ManagementAdd, list, modify, or delete i2004
future domains regardless of initial
provisioning. This allows the
administrator with this role to see all
domains, versus other administrators
that can see only a subset of
domains.
and subdomains.
Add, list, modify,or delete an IPCM or
IPCM cluster. If you add an IPCM
through the SIP Provisioning Client,
the Management Console GUI will not
know that the IPCM exists. It is
recommended that you deploy an
IPCM through the System
Management Console.
Add, list, modify, or delete services
and service packages to a particular
domain or all domains. If you have the
administrator privileges to add a
domain or m ultiple domains, then you
can add or create service packages
within that domain.
devices.
NN10043-113
Page 35
[Standard - Nortel Networks Confidential]
Chapter 2 Administration Overview13
Table 1 SIP Provisioning tasks overview
If you have the right
forUse this Provisioning menu option...To perform these tasks...
or existing gateways, routes, and
trunk groups. When you deploy and
provision a gateway through the
management console, you must
provision the gateway with the similar
trunk groups and routes through the
SIP Provisioning Client to ensure that
the information is saved into the
database that the SIP Application
Module uses.
SIP Provisioning Client User Guide
Page 36
[Standard - Nortel Networks Confidential]
14Chapter2 Administration Overview
Table 1 SIP Provisioning tasks overview
If you have the right
forUse this Provisioning menu option...To perform these tasks...
Voice Mail ManagementAdd, list, modify, or remove new or
User ManagementAdd, list, modify, or delete users,
existing voice mail servers. If voice
mail is enabled in a service package,
a customer can select from the
following voice mail server types:
•SIP based - a forward to your
voice mail system using SIP.
•Trunk based - a Primary Rate
Interface (PRI) or Channel
Associated Signalling (CAS) trunk
is associated with the line.
•Line based - a particular phone
number is associated to the line.
aliases, blended aliases, and i2004
Internet Telephone properties
(available from the domain or
subdomain menu option).
NN10043-113
Page 37
[Standard - Nortel Networks Confidential]
Chapter 2 Administration Overview15
Understanding provisioning roles and rights
Administrators can create, or define, all the necessary provisioning roles to
support their system. They can allow or restrict provisioning roles to carry out
specific actions. The following table provides examples of several administrator
provisioning roles and the rights based restrictions associated with various
provisioning tasks.
Table 2 Example of roles and rights
Provisioning
Role exampleRights givenAllowed tasks
User
administrator
Device
administrator
System
Administrator
•User management with read,
write, and delete access
•Domain management with
read access only
•Domain management with
read access
•Devicemanagementwith read,
write, and delete access
•Full domain accessCansee all domains,regardlessof
Limiting access to a domain
Complementing the rights-based restrictions, administrators can be provisioned
against certain domains in order to limit access to within those domains. This
prevents an administrator from domain xyz from viewing or modifying details in
domain abc, even though they are hosted from the same system. Administrators
can then delegate work for subdomains to other administrators without giving
them access to their own data.
Can view domain details, and add,
delete, or modify users. Does not
have access to other parts of the
system, for example voice mail,
service packages, and so forth.
Cannot add or modify users.
Allowed to add, modify or delete
devices.
who created the domain, or the list
ofdomainsprovisionedagainstthe
administrator.
SIP Provisioning Client User Guide
Page 38
[Standard - Nortel Networks Confidential]
16Chapter2 Administration Overview
For example, if an administrator assigned to the User Administrator provisioning
role was given access to suba.xyz (a subdomain of domain xyz), this administrator
can add, modify, and delete users in the subdomain, but does not have access to
the parent domain, domain xyz. This allows for the delegation of task on both the
rights-level and the domain-level.
Note: Access to any domain implies access to all of its descendant
subdomains. For example, access to domain xyz implies access to
suba.xyz. Full domain access will override this domain allocation and
allow any administrator assigned with a provisioning role that includes
this right, to see all domains regardless of what the administrator is
provisioned against.
System administrator provisioning role
The System Administrator (SA) is the highest level administrator and is the only
provisioning role that is preloaded when the SIP Provisioning Client is deployed.
The SA has full access and rights to all provisioning features and functions.
The SA can designate someone as an Administrative user with the Add Admin
menu option, and grant specific administrator rights to that administrative user
with the Add Roles menu option.
Note: The System Administrator role is the only role that cannot be
changed.
Creating a new provisioning role
To create a new provisioning role
1Click the Admins menu option.
2Click the Add Roles sub menu option. The Add a New Role window appears
(Figure 6).
NN10043-113
Page 39
[Standard - Nortel Networks Confidential]
Figure 6 Add a New Role window
Chapter 2 Administration Overview17
3Enter a name for the provisioning role in the Role Name field (required).
4Enter a description for the provisioning role in the Role Description field.
5To define the level of administrator access, select the checkboxes for Read,
Write,or Delete next to each privilege.
6Click Add. A message appears that the role has been successfully created.
Listing provisioning roles
To view details about a provisioning role to modify or delete the role
1Click the Admins menu option.
SIP Provisioning Client User Guide
Page 40
[Standard - Nortel Networks Confidential]
18Chapter2 Administration Overview
2Click the List Roles sub menu option. The List SystemRoles window appears
(Figure 7).
Figure 7 List System Roles window
NN10043-113
3To view details about a provisioning role or description, click the View
Details link. The Role Details window appears (Figure 8). To delete aprovisioning role, click the Delete link next to the role.
Page 41
[Standard - Nortel Networks Confidential]
Figure 8 Role details window
Chapter 2 Administration Overview19
4To change the provisioning role description, enter a new description in the
Role Description box. To modify privileges, select or deselect privileges in
the checkbox next to the privilege.
5Click Save to save your changes. A message appears that the provisioning
role was modified successfully.
Creating a new administrator
To add an administrator
1Click the Admins menu option.
SIP Provisioning Client User Guide
Page 42
[Standard - Nortel Networks Confidential]
20Chapter2 Administration Overview
2Click the Add Admin sub menu option. The Create new admin window
appears (Figure 9).
Figure 9 Create new admin
3Enter the username of the administrator (required) and other information in
the fields provided.
4Click Add. A message appears that the administrator was successfully added.
Listing administrators
To view details about an administrator or to modify or delete an administrator
1Click the Admins menu option.
NN10043-113
Page 43
[Standard - Nortel Networks Confidential]
2Click the List Admins sub menu option. The Admins window appears
(Figure 10). To delete an administrator, click the Delete link next to the
administrator username.
Figure 10 Admins window
Chapter 2 Administration Overview21
3To modify administrator information, enter the changes in the fields provided
(Table 11).
SIP Provisioning Client User Guide
Page 44
[Standard - Nortel Networks Confidential]
22Chapter2 Administration Overview
Figure 11 Admin Details window
NN10043-113
4Click Save to save your changes. A message appears that the administrator
was modified successfully.
Page 45
[Standard - Nortel Networks Confidential]
Chapter 3
Domain Management
Topics in this section:
•“Introduction to domains” on page 23
•“Domain types” on page 24
•“Adding a local root domain” on page 26
•“Adding a subdomain” on page 31
•“Adding a foreign domain” on page 33
•“Listing/modifying a local or foreign domain” on page 33
•“Deleting a local domain” on page 35
•“Banning a user” on page 36
•“Defining user device status reasons” on page 38
23
Introduction to domains
A domain is used as a control mechanism of users, services, devices and
translation. The SIP Provisioning Client is used to provision a domain. The
provisioning of domains allows service providers to define a domain and service
packages available for the domain.
Once the domain and service packages are defined, service providers can define
subdomains and assign the following:
•services to service packages
•service packages to domain and users
•translation information specific to a domain or a subdomain
•devices for users to an IPCM (IP Client Manager)
SIP Provisioning Client User Guide
Page 46
[Standard - Nortel Networks Confidential]
24Chapter 3 Domain Management
If you have full domain access, you can see all provisioned domains. Otherwise,
you will only be able to see the domains/subdomains you are provisioned against.
The management rights assigned to a domain administrator dictates what you can
do with the domains.
Domain types
There are three types of domains:
•root domain
•subdomain
•foreign domain
Root domain
A root domain is the highest level domain. A service provider can create a root
domain for each of their customers. An example of a root domain is
nortelnetworks.com.
Subdomain
NN10043-113
A subdomain is a category of domains. Subdomains a llow you to divide
subscribersunder a domain into smaller groups. The groups can be used to control
routing and access to services by members of the group.
Under each subdomain, you can add subdomains, service packages, users,
devices, and telephony routes. There are no limits to the levels of nesting of
subdomains. Each subdomain inherits the parameter values from the root domain.
A typical application of subdomains is based on geographical divisions. For
example, using Nortel Networks, you could have nortelnetworks.com as the root
domain, with subdomains of Richardson and Ottawa. Under each of these
subdomains there could be further subdomains as shown in the following
illustration (Figure 12).
Page 47
[Standard - Nortel Networks Confidential]
Figure 12 Domains and subdomains
Chapter 3 Domain Management25
Foreign domain
A foreign domain is a domain that is not served by any SIP Application Modules
in your system. When adding a domain, you must determine whether or not t he
domain is a foreign domain or not. A foreign domain uses foreign routes, while a
local domain uses SIP routing or telephony routes.
A domain that is not local is considered foreign. Usually, a foreign domain is
resolved through DNS and would not need to be provisioned. However, since
some deployment scenarios may not involve a DNS server, you (as the system
administrator) can datafill routes for a foreign domain.
SIP Provisioning Client User Guide
Page 48
[Standard - Nortel Networks Confidential]
26Chapter 3 Domain Management
For example, if the SIP Application Module serving nortelnetworks.com does not
have a DNS server, and there is a need for users to be able to make calls to the
xyz.com domain, then you could add the abc.com domain as a foreign domain and
provide a route to abc’s proxy.
Note: A foreign domain is not controlled by the system. Therefore it
will not be displayed under the domain folder in the menu area, and the
you will not be able to provision users, service packages, devices, and so
forth to these domains.
Adding a local root domain
To add a local root domain
1Click the Domains menu option.
2Click Add Domain. The Create new domain window appears (Figure 13).
NN10043-113
Page 49
[Standard - Nortel Networks Confidential]
Figure 13 Create new domain window
Chapter 3 Domain Management27
SIP Provisioning Client User Guide
Page 50
[Standard - Nortel Networks Confidential]
28Chapter 3 Domain Management
3Enter the name of the new local domain. The domain name m ust not be more
then 60 chars in length and cannot contain the following symbols or
characters as described in the following table:
Table 3 Create new domain name restrictions
‘$()|;
~%_[]/
!^{}?
@& + “ ,
#*=:<>
4Select No. There may be times when you want two domains on different
systems to communicate with each other. If Yes, enter the URL destination(IP
address) of where the domain is located in the Foreign Dest: field.
Tip: Domain parameters are not necessary for foreign domains. When
adding a foreign domain, the parameters can be ignored.
5Enter parameter information in the fields provided. See the following table for
parameter values and descriptions (Table 4).
Table 4 Create new domain parameters
ParameterTypeRangeDefaultDescription
i2004 LocaleString;
select from
drop-down
list
LocationString0-50
Idle DisplayStringUp to 30
NN10043-113
Restricted
to English
in the
current
release.
characters
characters
N/AIndicates the language in which the i2004
Internet Telephone will display. Future
releases will include more supported
languages.
N/ATextdescribingl ocation of device.A specific
format of this string is scheduled for a future
release.
N/AIdle telephone display heading.
Page 51
[Standard - Nortel Networks Confidential]
Chapter 3 Domain Management29
Table 4 Create new domain parameters
ParameterTypeRangeDefaultDescription
WD Phone TimerInteger13-10000150Lengthof time the i2004 Internet Telephone
WD TimerInteger30-1000015Howoften (in seconds) the IPCM will send
Time FMTSelect from
drop down
list:
•12-hour
•French
•24-hour
Date FMTNumeric
Standard
MM/DD or
Numeric
Inverse:
DD/MM
PSEIZ TimerIntegerN/A15Time-out for first dialed digit.
PDIL TimerInteger
(seconds)
AlphaBooleanTrue/FalseFalseEnablesalphanumericdialing as the default
Default Proxy Port5060Any valid
Behind FirewallBooleanTrue/FalseTrueBoolean indicating whether there is a
Allow All CodecsBooleanTrue/FalseFalseAllow all codecs (true) or only selected
0,1,20Thetimeformat of theproxy used as default
2,322-numeric standard (09/16); 3-numeric
N/A4Interdigittime-out (seconds).
5060Default proxy SIP port.
port
waits before determining that is has lost
connection to the IPCM. Should be greater
than WD_Timerby X amount. Where X is
difference between MAX expected network
latency and MIN expected network.
a “reset watchdog timer” message to a
connected I2004 device. When the I2004
receives this watch dog message, it knows
that it is still connected to the IPCM.
for the i2004 Internet telephone 0-> 12 hour
clock
inverse (16/09).
dialing style. If disabled, I2004 defaults
dialing style to numeric.
No validation is done on this field to ensure
validity.
firewall between the IPCM and the i2004
Internet Telephone.
codec (false). See Vocoder parameter
(below).
SIP Provisioning Client User Guide
Page 52
[Standard - Nortel Networks Confidential]
30Chapter 3 Domain Management
Table 4 Create new domain parameters
ParameterTypeRangeDefaultDescription
Active ProxyBooleanTrue/FalseTrueDetermines if default proxy is used. Used
will host the users in this domain. This is
used in an N+M environment. All SIP
Application Modules that are not the home
SIP Application Module will forward
requests for users in this domain to the
specified address as appropriate.
(Example: 10.0.0.8) If no host address is
supplied, or the host address is 0.0.0.0., no
homing is performed.
they are being authenticated. Subscribers
may register in multiple domains. When
they are required to enter a password
during authentication, they need to know
whichdomain i t is so that they can enter the
appropriate password.
NN10043-113
Page 53
[Standard - Nortel Networks Confidential]
Chapter 3 Domain Management31
Table 4 Create new domain parameters
ParameterTypeRangeDefaultDescription
Always Use Media
Portal
Maximum Number of
Presence
Subscriptions
Accepted
6Click Add.
StringTrue/FalseFalseDirects the Application Server to use the
RTP Media Portal when set to true.The
purposeistousetheRTPMediaPortal
function in dealing with special SIP
scenarios. For example, a domain that
straddles multiple sites contains users who
do not have Internet Protocol (IP)
connectivity between them due to firewalls
at different sites. This domain requires the
Always Use Media Portal to be set to True
to negotiate between the firewalls to set up
SIP sessions.
IntegerN/A0Maximum number of inbound subscriptions
to any given user in this domain.The SIP
Personal Agent, the SIP Multimedia PC
Client, and the SIP Multimedia Web Client
will use this limit when allowing a particular
username to be added to a subscriber's list
of buddies.
Tip: In order to see the new root domain added to the list of domains,
you must close and reopen the domains folder to refresh the list of
domains.
Adding a subdomain
To add a subdomain
1Click the Domains menu option
2Under the root domain where you want to add a subdomain, click the
Sub-Domains > Add Sub Domain menu option. The Create new subdomain
window appears with a list of parameters inherited from the parent domain
(Figure 14).
SIP Provisioning Client User Guide
Page 54
[Standard - Nortel Networks Confidential]
32Chapter 3 Domain Management
Figure 14 Create new subdomain window
NN10043-113
3Enter a name for the subdomain.
4Select a COS (Class of Service) for the subdomain from the drop down list of
routing services.
5Click Save.
Page 55
[Standard - Nortel Networks Confidential]
Adding a foreign domain
To add a foreign domain
1Click the Domain > Add Domain menu option. The C reate new domain
window appears (Figure 15). Since parameter fields are not used for foreign
domains, only the fields at the top of the window need to be completed.
Figure 15 Create new domain window
2Enter a name for the foreign domain.
3Select Yes from the Foreign drop down box.
Chapter 3 Domain Management33
4Add a foreign destination into the Foreign Destination box using the
following format
SIP<IP_Addr>:port
5Click Add.
Listing/modifying a local or foreign domain
To list/modify a local or foreign domain
1Click the Domains > List Foreign Domains menu option. The Domains
window appears (Figure 16).
SIP Provisioning Client User Guide
Page 56
[Standard - Nortel Networks Confidential]
34Chapter 3 Domain Management
Figure 16 List Domains window - step 1
2From the Criteria Selection drop down list, select one of the following as a
search criteria:
NN10043-113
—DomainName
— Is a Foreign domain
—ID
or enter the name of the domain, foreign domain, or ID in the criteria selection
text box.
3Click Add Criteria. The search criteria you selected appears in the lower
window and is used to refine your search.
4Repeat steps 1 -3 to list additional domains.
5In the lower window area, select whether to search by All or Any of the
criteria specified. Note that you do not have to add any criteria if you want to
see all the domains in the network.
6Click Search to begin the search, or Remove to remove a search criteria from
the search list. A list of domains (based on the search criteria specified)
appears (Figure 17).
Page 57
[Standard - Nortel Networks Confidential]
Figure 17 List domains - step 2
7In the Domains window, select a domain and click the Details link. The
details for the selected domain, or domains, displays.
8Modify domain information in the parameter fields.
9Click Save.
Deleting a local domain
Caution: Exercise extreme caution when deleting a domain as this will
permanently remove all users, devices, routes, service packages, and so
forth, associated with the domain. This is an irreversible operation that
could be a service-affecting change. For example, any calls in progress to
users or devices in the domain will terminate.
Chapter 3 Domain Management35
To delete a local domain or subdomain
1Click the Domains menu option.
2Click the domain or subdomain you want to delete from the list of domains.
Tip: In order to delete a domain or subdomain you must first delete all of
its children subdomains.
3Click Delete to delete the domain or subdomain you want to delete.
4Click OK in the confirmation dialog box to delete the domain, or Cancel to
cancel the delete operation.
SIP Provisioning Client User Guide
Page 58
[Standard - Nortel Networks Confidential]
36Chapter 3 Domain Management
Deleting a foreign domain
Caution: Exercise extreme caution when deleting a foreign domain as
this will permanently remove all users, devices, routes, service packages,
and so forth, associated with the domain.This is an irreversible operation
that could be a service affecting change. For example, any calls in
progress to users or devices in the domain will terminate.
To delete a foreign domain
1Click the Domains > List Foreign Domains menu option.
2Click the Delete link for the foreign domain you want to delete.
3Click OK in the confirmation dialog box to delete the foreign domain, or
Cancel to cancel the delete operation.
Banning a user
You can ban an individual user or a group of users in a domain or from viewing
the presence information (online status) of a user or group of users in a domain.
The banning takes effect for all subdomains under the domain.
Setting up ban list
To ban a user or a group of users
1Click the Domains menu option.
2Under the domain where you want to ban a user or users, click the Banned
Users > Ban User menu option. The Add a party to Domain Ban List window
appears (Figure 18).
NN10043-113
Page 59
[Standard - Nortel Networks Confidential]
Figure 18 AddapartytoDomainBanListwindow
3Enter the party to ban in the text boxes provided. To ban an individual user,
use the following format:
Chapter 3 Domain Management37
<username>@<domain_name.com>
To ban a group of users in a domain, use the following wildcard format:
<*>@<domain_name.com>
4Enter a reason for banning the user or group of users to the domain list in the
Description text box.
5Click Save. A message displays that the party was successfully added to the
ban list.
Viewing a list of banned users
To view a list of users banned from viewing the presence information (online
status) of a user or a group of users in a domain
1Click the Domains menu option.
2Under domain where you want to view a list of banned users, click the
Banned Users > List Banned User menu option. The D omain Ban List
window appears (Figure 19).
SIP Provisioning Client User Guide
Page 60
[Standard - Nortel Networks Confidential]
38Chapter 3 Domain Management
Figure 19 Domain Ban List window
3To delete a user or a group of users from the ban list, click the Delete link next
to the party to ban.
4Click OK at the deleteconfirmation dialog box, or Cancel to cancel the delete
operation.
Defining user device status reasons
The Status Reason menu option allows you to define a list of reasons for an
inactive user device status.
When a user is inactive, the user cannot register to the SIP Application Module.
This means that the user cannot use any of the services provided by the SIP
Application Module, including making calls or subscribing to other users'
presence. However, the inactive user can log in t o the SIP Personal Agent and
view the reason for their INACTIVE status.
Adding a status reason
To define a status reason for a user device
1Click the Domains menu option.
2Under the domain where you want to define a status reason, click Status
Reason > Add Reason. The Add Status Reason window appears (Figure 20).
NN10043-113
Page 61
[Standard - Nortel Networks Confidential]
Figure 20 Add Status Reason window
Chapter 3 Domain Management39
3From the Status drop down list, select INACTIVE.
4In the Name field (required) enter a name to identify the status reason.
5In the Description field, enter a description for the inactive status. For
example, if a user has not paid their bill, the reason for the inactive status
could be “Inactive for at least 6 months”.
6In the URL field, enter a web page address. This is the web page that the
originator of a call to the user will be presented with, along with the status
reason description, to explain the called user’s inactive status.
7Click Save. A message displays that the status reason was successfully added.
Viewing status reasons
To view a list of status reasons for a user device status
1Click the Domains menu option.
2Under the domain where you want to view the status reasons, click the Status
Reason > List Reasons menu option. The List Reasons window appears
(Figure 21).
SIP Provisioning Client User Guide
Page 62
[Standard - Nortel Networks Confidential]
40Chapter 3 Domain Management
Figure 21 Status Reasons window
3To view or modify status reason information, click the Details link for
information about the status reason. The Modify Status Reason window
appears (Figure 22).
Figure 22 Modify status reason window
NN10043-113
4Enter changes in the fields provided to modify information in the status
reasons fields.
5Click Save. A message displays that the status reason was successfully
modified.
6To delete a status reason, click the Delete link.
7At the delete confirmation dialog box, click OK to delete the status reason, or
Cancel to return to the Status Reasons details window.
Page 63
[Standard - Nortel Networks Confidential]
Chapter 4
IPCMs
Note: You must have IPCM provisioning rights to perform the tasks in
this section.
Topics in this section:
•“What is an IPCM?” on page 41
•“Adding an IPCM cluster” on page 42
•“Assigning and modifying IPCMs to a domain” on page 44
•“Deleting an IPCM cluster” on page 46
•“Listing physical IPCMs” on page 47
41
What is an IPCM?
The IP Client Manager (IPCM) is a network application capable of managing
many internal i2004 Internet Telephones while maintaining the call state and
phone settings. The IPCM also implements features (for example, stock queries
and personal directory) on the i2004 Internet Telephones. An IPCM Cluster may
span multiple domains and/or contain multiple domains.
Note: Users and devices are linked to IPCM Clusters, and not to
individual IPCMs. An IPCM Cluster may contain a single IPCM or a pair
of IPCMs. The IPCM cluster contains a primary and standby IPCM for
each i2004 Internet Telephone. Clustering of IPCMs ensures that each
IPCM retrieves the same user and device data from the database and that
each receives notification of database modifications.
SIP Provisioning Client User Guide
Page 64
[Standard - Nortel Networks Confidential]
42Chapter 4 IPCMs
In order for the IPCM to manage i2004 Internet Telephones, information
pertaining to the IPCM in general, the i2004 telephones, and users that will use
i2004s, must be provisioned. For more information, see the SIP IP ClientManager Basics documentation.
i2004 Internet Telephone information can be provisioned in the following ways:
•Provision each individual i2004 using the SIP Provisioning Client.
•Set up default device properties for a domain, assign an activation key to the
domain,and then use the IPCM to auto-provision each i2004 device whenever
a user enters the desired activation key. (See the SIP IP Client ManagerBasics documentation and the i2004 Internet Telephone User Guide for more
information.)
Note: Normally, the IPCM is deployed prior to provisioning the IPCM.
If this is the case, it is still necessary to assign domains to the IPCM
cluster and to assign a provisioned capacity for the IPCM cluster and
domain. If the IPCM has been deployed, see “Assigning and modifying
IPCMs to a domain.” If the IPCM has not been deployed, and it is
desired to pre-provision the IPCM, see “Adding an IPCM cluster.”
Adding an IPCM cluster
Adding an IPCM cluster creates a virtual IPCM to which users, i2004 devices, and
domains may be assigned. It does not actually create a physical IPCM, nor does it
deploy IPCM software onto a server. The association of the physical IPCM to this
IPCM cluster is performed when the physical IPCM is deployed and configured.
To add an IPCM cluster
1Click the IPCM Cluster > Add IPCM Cluster menu option. The Create new
IPCM window displays. The following figure (Figure 23) shows an example
of creating an IPCM named LAB IPCM. The maximum provisioned capacity
is 1000, i2004 Internet Telephones. Note that the IPCM name is case
sensitive.
NN10043-113
Page 65
[Standard - Nortel Networks Confidential]
Figure 23 Create new IPCM window
Chapter 4 IPCMs43
The following table (Table 5) lists the Create new IPCM parameters and values to
use when creating a new IPCM.
Table 5 Create new IPCM parameters
ParameterTypeRangeDefaultDescription
IPCM NameString(100) Up to 100
characters
Prov. CapacityIntegerMaximum
of 10,000
per IPCM
NoneThenameofthisIPCM.
ThenameoftheIPCM
must be a unique name.
NoneThe number of i2004
Internet Telephones that
are allowed to be
provisioned for this IPCM
(across all domains).
2Click Save.
SIP Provisioning Client User Guide
Page 66
[Standard - Nortel Networks Confidential]
44Chapter 4 IPCMs
Assigning and modifying IPCMs to a domain
An IPCM is not usable until it is assigned to a domain. To assign an IPCM to a
domain
1Click the IPCM Clusters > List IPCM Clusters menu option. A list of
deployed IPCMs appears (Figure 24).
Note: Upon first assignment of an IPCM, the list of deployed IPCMS
may be empty. However, in many cases, the IPCM would have already
been deployed using the System Management Console and will appear in
the list.
Figure 24 List IPCM Clusters window
NN10043-113
2Click the Details link for the IPCM you want to assign to a domain. The
Modify IPCM window appears (Figure 25).
Page 67
[Standard - Nortel Networks Confidential]
Figure 25 Modify IPCM window
3If necessary, modify the IPCM Name or Prov. Capacity parameters and click
Save.
Chapter 4 IPCMs45
Tip: The Avail Capacity field is a read only field calculated by adding
the Assigned Capacity of domains to which this IPCM is assigned and
subtracting that value from the Prov. Capacity of the IPCM.
4Select a domain from the list of available domains in the Assign New Domain
area of the window. Enter information in the following fields for the domain
you are assigning to the IPCM:
FieldDescription
Assigned Capacity:The number of i2004 Internet Telephones you want
to allow in this assigned domain.
Activation Key:A unique string (number) per IPCM/domain
combination that associates default device
properties with this particular domain. The
administratormust pick a unique string (number) for
each domain. If the IPCM is used to auto-provision
i2004 devices, the installer will be prompted for this
activation key during the installation process.
SIP Provisioning Client User Guide
Page 68
[Standard - Nortel Networks Confidential]
46Chapter 4 IPCMs
5Click Save. The IPCM Domain Relation window appears (Figure 26).
Figure 26 IPCM Domain Relation window
6Enter your changes and click Save. A confirmation messages displays
confirming your changes.
7To assign another domain to the IPCM, select a domain from the list in the
Assign New Domain area. Enter information in the parameter fields and click
Save.
Deleting an IPCM cluster
Caution: Exercise extreme caution when deleting an IPCM as this will
permanently remove all i2004 Internet Telephones and users' i2004
capabilities associated with the IPCM that you are deleting.
To delete an IPCM cluster
1Click the IPCM Clusters > List IPCM Clusters menu option.
NN10043-113
Page 69
[Standard - Nortel Networks Confidential]
2Click the Delete link for the IPCM cluster you want to delete.
3Click OK in the confirmation dialog box to delete the IPCM cluster, or
Cancel to cancel the delete operation (Figure 27).
Figure 27 IPCM Delete confirmation dialog box
Listing physical IPCMs
The List Physical IPCMs menu option allows you to view the physical IP Address
of the server on which the IPCM resides.
To list the physical IP address of the IPCM
Chapter 4 IPCMs47
1Click the IPCM Clusters > List Physical IPCMs menu option. The Physical
IPCMs window appears (Figure 28) listing the following fields:
FieldDescription
IPCM Cluster:The name that identifies the virtual IPCM
cluster.
Physical IPCM:The physical IP Address of the server on
Delete Physical IPCM:Allows you to delete the mapping of the
which the IPCM resides.
physical IPCM to the IPCM Cluster.
SIP Provisioning Client User Guide
Page 70
[Standard - Nortel Networks Confidential]
48Chapter 4 IPCMs
Figure 28 Listing physical IPCMs
2To delete a physical IPCM, click the Delete link in the Delete Physical IPCM
column. At the delete confirmation dialog box, click Ok to delete the physical
IPCM or Cancel to cancel the delete operation (Figure 29).
Note: You must have Voice Mail provisioning rights to perform the tasks
in this section.
Topics in this section:
•“Introduction” on page 49
•“Voice mail server types” on page 50
•“Provisioning a SIP-based voice mail server” on page 50
•“Provisioning a Trunk-based voice mail server” on page 54
•“Provisioning a Line-based voice mail server” on page 60
•“Assigning a user to a provisioned voice mail server” on page 67
•“Listing/modifying/deleting a voice mail server” on page 68
•“Using CPL scripts with voice mail” on page 69
49
Introduction
The SIP Provisioning Client allows you to provision third-party voice mail server
information to:
•set up and route calls to voice mail
•associate users to a voice mail server
•set up a voice mail server to receive message waiting indication (MWI)
notifications
SIP Provisioning Client User Guide
Page 72
[Standard - Nortel Networks Confidential]
50Chapter 5 Voice Mail Servers
Voice mail server types
The following voice mail server types are supported as described in the following
table (Table 6).
Table 6 Voice mail server types
Voice mail server typeDescription
SIP-basedAnIP based voice mail server that uses the SIP protocol.
Line-basedA v oice mail server with multiple lines, each identified by
Trunk-basedA legacy Public Switched Telephone Network (PSTN)
This server type does not need a PSTN gateway.
a 10 digit phone number that goes into the voice mail
server. When people leave messages, the individual
lines are used in a round robin manner to connect to the
voice mail server to allow someone to leave a message.
TheSIPApplicationModulesendsanSMDImessageto
the voice mail server to help establish the connection to
the SIP Application Module that uses SMDI to obtain
Message WaitingIndication (MWI) information from the
voice mail server.
based voice mail server that uses a Primary Rate
Interface (PRI) or Channel Associated Signalling (CAS)
gateway.The SIP Application Module uses SMDI to send
call setup information using a Call Detail Message to get
Message WaitingIndication (MWI) information from the
voice mail server.
Provisioning a SIP-based voice mail server
Provisioning a SIP-based voice mail server allows the administrator to configure
the SIP Application Module to communicate with a voice mail server using the
SIP protocol.
NN10043-113
The SIP Application Module is given information on what to query to find the
location of the voice mail server. The SIP Application Module will use this
information to send SIP calls to the voice mail server when calls are routed to
voice mail.
Page 73
[Standard - Nortel Networks Confidential]
Adding a SIP-based voice mail server
To add a SIP-based voice mail server
1Click the VoiceMail > Add Voice Mail Server menu option. The Create new
voice mail server window appears (Figure 30).
Figure 30 Create new voice mail server window (SIP) - step
Chapter 5 Voice Mail Servers51
2Choose SIP-Based Server from the drop down and click Next. The second
page of the Create new voice mail server appears (Figure 31).
SIP Provisioning Client User Guide
Page 74
[Standard - Nortel Networks Confidential]
52Chapter 5 Voice Mail Servers
Figure 31 Create new voice mail server window (SIP) - step 2
3Enter information about the SIP-based voice mail server in the parameter
fields. The following table (Table 7) lists the SIP-based voice mail
parameters.
Table 7 SIP-based voice mail parameters
ParameterTypeRangeDefaultDescription
DescriptionString(100) Up to 100
URI to query to find
Voice Mail Server
String(100) Up to 100
characters
characters
NN10043-113
NoneThe description for the server that
identifies the SIP-based voice
mail server.
NoneThe SIP address of the user that
the SIP Application Module will
look up to find the address of the
voice mail server.
Page 75
[Standard - Nortel Networks Confidential]
Chapter 5 Voice Mail Servers53
Table 7 SIP-based voice mail parameters
ParameterTypeRangeDefaultDescription
Client contactString(100) Up to 100
Application ServerString(60)Up to 60
DomainsString(60)
characters
characters
characters
Up to 60
characters
4Click Save. The SIP-based voice mail server you added now appears in a list
of voice mail servers (Figure 32).
Figure 32 Voice Mail Servers window (SIP)
Voice mailThefieldusedto route voicemail.
ServerHome. With
this default, each
SIP Application
Module will ignore
this field and forward
SIP requests to the
voice mail server
insteadofforwarding
them to a "home"
Application Server.
NoneThe domains that will use this
In most cases, you will use the
default(voicemail).Ifyourequire
a different client contact, contact
your Nortel Networks support
representative.
Specifies the SIP Application
Module will host the voice mail
server being provisioned. This is
used in an N+M environment. All
SIP Application Modules that are
not the home SIP Application
Module will forward requests
destined to voice mail to the
address s pecified in this field.
voice mail server.Use the
Ctrl-click key to select multiple
domains to use the same voice
mail server.
Adding a phantom voice mail server user
After you add a voice mail server, you then need to create a phantom user named
voicemail for the domain that will use the SIP-based voice mail server.
To create a phantom user for the SIP-based voice mail server
1Click the Domains menu option.
SIP Provisioning Client User Guide
Page 76
[Standard - Nortel Networks Confidential]
54Chapter 5 Voice Mail Servers
2Under the domain where you want to add a phantom user, click the Add User
menu option.
3In the Add User form, enter the text "voice mail" for the User Name, Last
Name, First Name, fields. In the password field, enter any password.
4Click Save. The User details screen displays a message that the user was
added successfully.
5At the top of the window, click the Routes link to specify the route to the
voice mail server. Enter the SIP address that the voice mail server is
expecting, along with the domain and IP address (Figure 33).
Figure 33 User routes window
6Click Add.
7Click Save.
Note: For CAS/CallPilot, it is recommended that you do not create a
phantom user.
Provisioning a Trunk-based voice mail server
Provisioning a Trunk-based voice mail server allows the administrator to
configure the SIP Application Module so that it can communicate with a voice
mail server using a PRI or CAS gateway.
NN10043-113
Page 77
[Standard - Nortel Networks Confidential]
The SIP Application Module is given information on what to query to find the
correct gateway to send SIP calls to the voice mail server when calls are routed to
voice mail. An SMDI TELNET session is configured to allow the SIP Application
Module to send call setup information using a SMDI Call Detail Message to
receive SMDI MWI messages.
Adding a Trunk-based voice mail server
To add a Trunk-based voice mail server
1Click the VoiceMail > Add Voice Mail Server menu option. The Create new
voice mail server window appears (Figure 34).
Figure 34 Create new voice mail server window (Trunk-based) - step 1
Chapter 5 Voice Mail Servers55
2Choose Trunk-BasedServerfrom the drop down and click Next. The second
page of the Create new voice mail server appears (Figure 35).
SIP Provisioning Client User Guide
Page 78
[Standard - Nortel Networks Confidential]
56Chapter 5 Voice Mail Servers
Figure 35 Create new voice mail server window (Trunk-based) - step 2
NN10043-113
3Enter SMDI parameter information for the Trunk-based voice mail server.
The following table (Table 8) lists the SMDI parameters.
Page 79
[Standard - Nortel Networks Confidential]
Table 8 SMDI parameters
ParameterTypeRangeDefaultDescription
Chapter 5 Voice Mail Servers57
AddressString(100) Up to 100
characters
PortIntegerNoneNoneThe port for the SMDI
SMDI VersionFloatNoneNoneThe SMDI version. There
UsernameString(60)Up to 60
characters
PasswordString(20)Up to 20
characters
N/AThe IP address of the
terminal (SMDI) server.
server to TELNET to.
are only 2 versions of the
SMDI protocol (Version 1
and Version 2). Version 2
is the latest draft and is
supported by most voice
mail servers.
N/AThe TELNET username
for logging in to the SMDI
TELNET server. Used by
the SIP Application
Moduletologinintothe
terminal server.
N/AThe TELNET password
for logging in to the SMDI
TELNET server.
4Click Next to enter information about the gateway connection. The Create
new voice mail server window appears (Figure 36).
SIP Provisioning Client User Guide
Page 80
[Standard - Nortel Networks Confidential]
58Chapter 5 Voice Mail Servers
Figure 36 Create new voice mail server window (Trunk-based) - step 3
NN10043-113
Page 81
[Standard - Nortel Networks Confidential]
Chapter 5 Voice Mail Servers59
5Enter information about the Trunk-based voice mail server gateway
connection in the parameter fields. The following table (Table 9) lists the
gateway connection parameters.
Table 9 PRI Gateway connection parameters
ParameterTypeRangeDefaultDescription
DescriptionString(100)Up to 100
characters
URI to query to
find gateway
Type of TrunkDrop ListNAPRI_TRUNKA specification of whether the voice
Client contactString(100)Up to 100
String(100)Up to 100
characters
characters
NoneThe description for the server that
identifies the Trunk-based voice
mail server.
NoneFor PRI Gateway: The address (in
either 10 digit phone number and
domainname format or in SIP:voice
mail@nortelnetworks.com format)
of the machine that will host this
voice m ail server. The SIP
Application Module performs
translations on the phone number
and domain to understand which
gatewayto use. Youcanchange the
translations to use a different
gateway, and do nothave to change
this field.
For CAS Gateway (CallPilot): The
SIP address for the CAS Gateway
that routes to the CallPilot. The
addressis made up of a DN that the
gateway routes to the CallPilot, and
an maddr specification for the CAS
Gateway. (For example,
sip:66250@nortelneworks.com;ma
ddr=46.10.11.219).
mail Gateway is PRI or CAS.
Voice mailThefield used to route voice mail. In
most cases, you will use the default
(voice mail). If you require a
different client contact, contact your
Nortel Networks support
representative.
SIP Provisioning Client User Guide
Page 82
[Standard - Nortel Networks Confidential]
60Chapter 5 Voice Mail Servers
Table 9 PRI Gateway connection parameters
ParameterTypeRangeDefaultDescription
Application
Server
Domain nameString(60)Up to 60
String(60)Up to 60
characters
characters
6Click Save. The Trunk-based voice mail server you added now appears in the
list of voice mail servers (Figure 37).
Figure 37 Voice Mail Servers window (Trunk-based)
ServerHome. With
this default, each SIP
Application Module
will ignore this field
and forward SIP
requests to the voice
mail server instead of
forwarding them to a
"home" Application
Server.
NoneThe domains that will use this
Specifies the SIP Application
Module will host the voice mail
server being provisioned. This is
used in an N+M environment. All
SIP Application Modules that are
not the home SIP Application
Module will forward requests
destined to voice mail to the
address s pecified in this field.
Trunk-based voice mail server.Use
the Ctrl-click key to select multiple
domainstousethesamevoicemail
server.
Provisioning a Line-based voice mail server
Provisioning a Line-based voice mail server allows the administrator to configure
the application so that it can communicate with a voice mail server using a Lines
Gateway. The SIP Application Module is given information on which Lines
Gateway to use and which line numbers to use for sending calls to the gateway
when routing a call to voice mail.
In addition, an SMDI TELNET session is configured to allow the SIP Application
Module to directly communicate call setup information to the voice mail server.
The SMDI link is also used by the SIP Application Module to receiveSMDI MWI
messages.
NN10043-113
Page 83
[Standard - Nortel Networks Confidential]
Adding a Line-based voice mail server
To add a Line-based voice mail server
1Click the Voice Mail > Add Voicemail Server menu option. The Create new
voice mail server window appears (Figure 38).
Figure 38 Create a new voice mail server window (Line-based) - step 1
Chapter 5 Voice Mail Servers61
2Choose Line-Based Server from the drop down and click Next. The second
window of the Create new voice mail server appears (Figure 39).
SIP Provisioning Client User Guide
Page 84
[Standard - Nortel Networks Confidential]
62Chapter 5 Voice Mail Servers
Figure 39 Create new voice mail server window (Line-based) - step 2
NN10043-113
3Enter SMDI parameter information about the Line-based voice mail server.
The following table (Table 10) lists the Line-based voice mail server SMDI
parameters.
Page 85
[Standard - Nortel Networks Confidential]
Table 10 Line-based voice mail server SMDI parameters
ParameterTypeRangeDefaultDescription
Chapter 5 Voice Mail Servers63
AddressString(100) Up to 100
characters
PortIntegerNoneNoneThe port for the SMDI
SMDI VersionFloatNoneNoneThe SMDI version. There
UsernameString(60)Up to 60
characters
PasswordString(20)Up to 20
characters
N/AThe IP address of the
terminal (SMDI) server.
server to TELNET to.
are only 2 versions of the
SMDI protocol: Version 1
and Version 2. (Version 2
is the latest draft and is
supported by most voice
mail servers.)
N/AThe TELNET username
for logging in to the SMDI
TELNET server.
N/AThe TELNET password
for logging in to the SMDI
TELNET server.
4Click Next to enter general information about the Line-based server
(Figure 39).
SIP Provisioning Client User Guide
Page 86
[Standard - Nortel Networks Confidential]
64Chapter 5 Voice Mail Servers
Figure 40 Create new voice mail server window (Line-based) - step 3
NN10043-113
Page 87
[Standard - Nortel Networks Confidential]
Chapter 5 Voice Mail Servers65
5Enter general information about the Line-based voice mail server in the
parameter fields. The following table lists the Line-based parameter
information.
Table 11 Line-based voice mail server general parameter information
ParameterTypeRangeDefaultDescription
DescriptionString(100) Up to 100
characters
Client contactString(100) Up to 100
characters
Application ServerString(60)Up to 60
characters
Maximum Call
Duration
Domain nameString(60)Up to 60
Digit1-99NoneThe period of time that the SIP
characters
NoneThedescriptionforthe server that
identifies the Line-based voice
mail server.
Voice mailThe field used to route voice mail.
In most cases, you will use the
default(voice mail). If you require
a different client contact, contact
your Nortel Networks support
representative.
ServerHome. With
this default, each SIP
Application Module
will ignore this field
and forward SIP
requests to the voice
mail server instead of
forwarding them to a
"home" Application
Server.
NoneThe domains that will use this
Specifies the SIP Application
Module will host the voice mail
server being provisioned. This is
used in an N+M environment. All
SIP Application Modules that are
not the home SIP Application
Module will forward requests
destined to voice mail to the
address specified in this field.
Application Module allows a
caller to stay connected to the
Line-based voice mail server
when someone is trying to leave
a voice mail message.
voice mail server. Use the
Ctrl-click key to select multiple
domains to use the same voice
mail server.
6Click Next to provision the lines for the gateway (Figure 41).
SIP Provisioning Client User Guide
Page 88
[Standard - Nortel Networks Confidential]
66Chapter 5 Voice Mail Servers
Figure 41 Create new voice mail server window (Line-based) - step 4
NN10043-113
7Enter the Line-based parameter information to provision the l ines for the
gateway. The following table (Table 12) lists the Line-based voice mail server
parameters.
Page 89
[Standard - Nortel Networks Confidential]
Table 12 Line-based voice mail server parameters
ParameterTypeRangeDefaultDescription
Chapter 5 Voice Mail Servers67
GatewayString1-100
LineDigit0-38 digitsNoneThe 10-digit telephone
Message
Desk
Position
Number
3 digits 000-999NoneA 3-digit number used by
4 digits 0000-9999NoneA 4-digit number used to
characters
domain.com;
norteltrkgrp=1;ma
ddr=0.0.0.0
The trunk group, domain
name and IP address of
the gateway.
number that identifies the
line from the gateway’s
point of view.
the SMDI protocol to
determine where to store
an incoming message.
determine where to put
an incoming message.
8Click Add Line. To add multiple lines, continue to enter the gateway
parameter information and click Add Line.
9When you are finished adding lines for this gateway, click Set New Line to
have more than one gateway with lines going into the same voice mail server.
10 Click Save. The Line-based voice mail server you added now appears in the
list of voice mail servers (Figure 42).
Figure 42 Voice Mail Servers window (Line-based)
Assigning a user to a provisioned voice mail server
In order for a user to have voice mail, you must associate a voice mail server and
mail box for that user.
SIP Provisioning Client User Guide
Page 90
[Standard - Nortel Networks Confidential]
68Chapter 5 Voice Mail Servers
To associate a user with a voice mail server that has been previously provisioned
1Click the Domains menu option
2Click the domain for the user.
3Click the Users > List Users menu option.
4Click Search at the bottom of the screen to display a list of users in the
domain.
5Click the Details link for the user you want to associate with a voice mail
server.
6Scroll down the screen to the voice mail server field. Select a voice mail
server to use when sending calls for this user to voice mail from the drop
down list of provisioned voice mail servers for this domain.
7Enter the information for the user’s voice mail box in the Voice mail field.
8Click Save.
Listing/modifying/deleting a voice mail server
To view details of a provisioned SIP, Trunk, or Line-based voice mail server
1Click the VoiceMail > List Voice Mail Servers menu option. The V oice Mail
Server window appears (Figure 43).
Figure 43 List of voice mail servers
2To view the details of a voice mail server, click the link of the voice mail
server in the Description column. The Create new voice mail server form
appears where you can modify information.
3Click Save to save your changes or Back to return to the list of voice mail
servers.
NN10043-113
Page 91
[Standard - Nortel Networks Confidential]
4To delete a voice mail server, click the Delete link for the voice mail server
you wish to delete. At the confirmation dialog box, click OK to delete the
voice mail server, or Cancel to cancel the operation.
Using CPL scripts with voice mail
A user will only have voice mail service if there is a Call Processing Language
(CPL) script that specifies a route to sip:voicemail@domain.com (usually the last
route).
To specify a route, you need to provision the following voice mail parameters in
the SIP Provisioning Client:
Voice mail parameterDescription
Client ContactMust match the username in the CPL script and
should always be set to voicemail (unless you are
working with Nortel Networks technical support).
If this parameter is set to something else, properties
in the IPCM and Web Client will require changes.
Chapter 5 Voice Mail Servers69
URI to Query to Find
Gateway
To create a CPL script that has sip:voicemail@domain.com as the last route
1Log in to the SIP Personal Agent.
2Click the Call Manager icon.
3In the Default Behavior window, select the TrytoFindMeoption.
4Click Save
Tip: Unless a user logs into t he SIP Personal Agent and clicks Save in the
Call Manager window, they will not have a CPL Script and thus calls to
them will never route to voice mail as a final route.
Point to a static route, a user with a static route, or
have a number that can be translated by the
Telephony routing to go to the correct gateway.
SIP Provisioning Client User Guide
Page 92
[Standard - Nortel Networks Confidential]
70Chapter 5 Voice Mail Servers
NN10043-113
Page 93
[Standard - Nortel Networks Confidential]
Chapter 6
Defining and Assigning Services
Note: You must have Services provisioning rights to perform the tasks in
this section.
Topics in this section:
•“Defining service parameters” on page 71
•“Assigning services to a domain” on page 75
Defining service parameters
The SIP Provisioning Client allows you to define and assign services to domains.
You can assign all or a subset of the pre-defined services to a domain.
71
When you define the service parameters for service package, you are essentially
defining its contents. Services are set up much like convenience packages for the
domain. The service provider then has the flexibility to set up services and create
a standard set of services for their customers according to their own
specifications.
To define service parameters
1Click the Services > Define Service Parameters menu option.
The list of available services window appears (Figure 44).
SIP Provisioning Client User Guide
Page 94
[Standard - Nortel Networks Confidential]
72Chapter 6 Defining and Assigning Services
Figure 44 List of available services window
NN10043-113
2From the list of available services window, select a value for a service
parameter from the drop down list. The following table (Table 13) lists the
service parameters and options.
Page 95
[Standard - Nortel Networks Confidential]
Chapter 6 Defining and Assigning Services73
Table 13 Services parameters and options
Service Option ParameterDescriptionClient enforced Server enforced
Enable/disable
Voicemail
Enable/disable
Audio
Conference
Enable/disable
Presence
NoneRetrieve voice mail or for other
Maximum
number of
ports
Maximum
size of client
list of
buddies
Maximum
number of
subscriptions
generated
subscribers, to leave a voice mail
message. Voice mail is retrieved
from a network server.Theuser is
aware of deposited voice mail since
their client's MWI (message waiting
indicator) is enabled.
Initiate an audio conference call
utilizing a SIP audio server.The
number of users in the conference
call is limited by the maximum
number of ports assigned. Values
beyond above thirty two are not
allowed.
Specifies the number of people in a
list of buddies. This is the number of
peoplethat a user is subscribing to in
order to view their presence.
Although a user can be logged into
numerousdevices,the list of buddies
is a shared resource. For example, if
the max list of buddies size is set to
10, there can be 10 buddies on each
of the client devices (the same 10
buddies, not 10 per device). The
client has the option of sending any
of the buddies.
Allowsausertobeloggedinto
multiple devices (i2004 Internet
Telephone, SIP Multimedia PC
Client, SIP Multimedia Web Client).
Each such device performs
messaging to determine the
presence (online status) of each of
the buddies in the list. There is a
need for limiting the number of
devicesandbuddies to limitresource
contention issues. The maximum
number of presence subscriptions is
defined by the following formula:
maximum number of subscriptions
generated= (maximum# of clients)*
(maximum number of allowed
buddies).
Yes.Optional.
Enabled through
the SIP
Application
Module.
Yes.Optional.
Enabled through
the SIP
Application
Module.
Yes
Yes.
Mandatory.
SIP Provisioning Client User Guide
Page 96
[Standard - Nortel Networks Confidential]
74Chapter 6 Defining and Assigning Services
Service Option ParameterDescriptionClient enforced Server enforced
Enable/disable
Video
Simultaneous
Network Call
Restriction
Enable/disable
Advanced
Screening
Enable/disable
QoS
Enable/disable
Blended User
NoneUse of point to point video service
Maximum
number of
ringlist
entries
-Enables the ability to perform
QoSDiffServ
Code for
Signalling
QoSDiffServ
Code for
Audio
QoSDiffServ
Code for
Video
QoS 802.1p
Service
Priority
NoneEnables the use of a traditional
between web c lients and PC clients.
Specifies the maximum number of
users that are defined in a route in
the Call Manager portion of the SIP
Personal Agent. The users in the
ringlist are simultaneously rung.
address screening (based on the
user’s current address book entries)
and time screening (time of day, day
of week) in the Call Manager area of
the SIP Personal Agent.
Specifies quality of service for client
signaling, audio and video (up to 64).
phone for voice calls and the SIP
Multimedia PC for multimedia
communicationand collaboration.
Yes.
Yes.
Yes.
Yes.
Yes
NN10043-113
3To create new values for the service parameter, click [Edit].
The Add new parameter values window appears (Figure 45).
Page 97
[Standard - Nortel Networks Confidential]
Figure 45 Add new parameter values window
Chapter 6 Defining and Assigning Services75
4For the selected parameter, select a value from the list, using the UP and
DOWN buttons to set the priority of the value.
5To add a new value, click Add. The new value appears in the list of parameter
values.
6Click Set as Default to set the value in the list as the default value for the
service parameter.
7Click Save to save your service parameter changes.
Assigning services to a domain
Once you add a value for a service parameter, you can select a domain to assign
the services to.
To assign services to a domain
1Click the Services > Assign Services menu option. The Assign Services
window appears (Figure 46).
SIP Provisioning Client User Guide
Page 98
[Standard - Nortel Networks Confidential]
76Chapter 6 Defining and Assigning Services
Figure 46 Assign services window
2Select a domain from the drop down list and click Continue. To assign
services to more than one domain, click the link to assign services to multiple
domains in the Assign Services window. The Assign services to domains
window appears (Figure 47).
NN10043-113
Page 99
[Standard - Nortel Networks Confidential]
Figure 47 Assign services to a domain window
Chapter 6 Defining and Assigning Services77
3Select the services and service parameter values you want to assign to the
selected domain or multiple domains (Use the Ctrl-click key to choose
multiple domains.) To enable all services, check the Enable all Services
checkbox.
4Click Save. A confirmation message displays that your service was assigned
successfully.
Once services have been defined and assigned to domains, you can list all the
services that are available for a domain (or multiple domains) and create and
assign packages accordingly. For a subdomain, services are assigned from the root
domain.
SIP Provisioning Client User Guide
Page 100
[Standard - Nortel Networks Confidential]
78Chapter 6 Defining and Assigning Services
NN10043-113
Loading...
+ hidden pages
You need points to download manuals.
1 point = 1 manual.
You can buy points or you can get point for every manual you upload.