MAS Music on Hold Fundamentals - Avaya Support

Nortel Media Application Server

MAS Music on HoldFundamentals

NN42020-129.

Document status: StandardDocument version: 01.04Document date: 27 July 2007

Copyright © 2007, Nortel NetworksAll Rights Reserved.

The information in this document is subject to change without notice. The statements, configurations, technicaldata, and recommendations in this document are believed to be accurate and reliable, but are presented withoutexpress or implied warranty. Users must take full responsibility for their applications of any products specified in thisdocument. The information in this document is proprietary to Nortel Networks.

Nortel, the Nortel logo, and the Globemark are trademarks of Nortel Networks.

IBM, Lotus, Lotus Notes, BladeCenter, and BladeCenter T are trademarks of IBM Corporation.

Microsoft, Microsoft Office, Outlook, and Windows are trademarks of Microsoft Corporation.

All other trademarks are the property of their respective owners.

3

Revision history

July 2007Standard 01.04. This document is up-issued to support the IBM x3550hardware platform for MAS.

May 2007Standard 01.02. This document is up-issued to support multiapplicationMAS deployment.

January 2007Standard 01.01. This document is issued to support MultimediaCommunication Server 5100 Release 4.0. This document containsinformation previously contained in the following legacy document, nowretired: MAS Music on Hold Service Guide (NN10378-113).

December 2006Standard 6.0. This document is up-issued for MCS 5100 Release 3.5. Itaddresses CR Q01392457.

May 2006Standard 5.0. This document is up-issued for MCS 5100 Release 3.5. Itaddresses CR Q01277506 and the MAS RoHS project.

January 2006Standard 4.0. This document is up-issued for MCS 5100 Release 3.5. Itaddresses CR Q01276947.

November 2005Standard 3.0. This document is up-issued for MCS 5100 Release 3.5.

November 2005Standard 2.0. This document is up-issued for MCS 5100 Release 3.5.

October 2005Standard 1.0. This document is up-issued for MCS 5100 Release 3.5.

Nortel Media Application ServerMAS Music on Hold FundamentalsNN42020-129 01.04 Standard

4.0 27 July 2007Copyright © 2007, Nortel Networks

.

4 Revision history



.

5

Contents

New in this release 7Features 7

BCT for MAS 7IBM x3550 7

Other changes 7

How to get help 9Finding the latest updates on the Nortel Web site 9Getting help from the Nortel web site 9Getting help over the phone from a Nortel Solutions Center 9Getting help from a specialist by using an Express Routing Code 10Getting help through a Nortel distributor or reseller 10

Music on Hold basics 11Overview 11Related documents 12Hardware platform and OS 13Services and features 13

Quality of Service support 14System scalability 14OAMP 20

Installation and upgrades 23Multiapplication MAS 23General information relating to MAS software upgrades 23

Fault management 25Fault management strategy 25

Configuration management 27

Accounting 29

Performance management 31

Security and administration 33Security strategy overview 33Administration 33



.

6 Contents

Establish the managed environment 33Starting the Client Connection Manager 34Use the Terminal Services Manager program group icons 34Use the Terminal Services Manager to manually connect to the MAS 35Start the MAS Console 35Access the MAS Console help files 35MAS subcomponents 36Control the MAS subcomponents from the MAS Console 36Refresh a subcomponent status on the MAS Console 37System and platform management 38Data backup and restore 38

Appendix A Message flows 49



.

7

New in this release

The following sections detail what is new in MAS Music on HoldFundamentals (NN42020-129) for Release 4.0.

• "Features" (page 7)

• "Other changes" (page 7)

FeaturesSee the following sections for information about feature changes:

• "BCT for MAS" (page 7)

• "IBM x3550" (page 7)

BCT for MASThis feature provides the evolution of the Media Application Server to theIBM BladeCenter T chassis that is NEBS-3-/ETSI-compliant. NetworkEquipment Building System 3 (NEBS-3) compliant hardware adheres tostrict requirements for withstanding high temperatures, violent shaking,lightning strikes, airborne contaminants, fires, and electrostatic discharge.

For more information, see Media Application Server Planning andEngineering (NN42020-201).

IBM x3550The MAS platform is now supported on the IBM x3550 server. The IBMx3550 is a direct replacement for the IBM x336 and comes with WindowsServer 2003 preloaded.

Other changesThis document was renamed and renumbered from MAS Music on HoldService Guide (NN10378-113) to MAS Music on Hold Fundamentals(NN42020-129).

The installation and upgrade procedures moved to MAS Installation andCommissioning (NN42020-307).



.

8 New in this release

This document was updated to adhere to the Nortel CustomerDocumentation Standards.



.

9

How to get help

This chapter explains how to get help for Nortel products and services.

Finding the latest updates on the Nortel Web siteThe content of this documentation was current at the time the product wasreleased. To check for updates to the latest documentation for MultimediaCommunication System (MCS) 5100, go to www.nortel.com and navigate tothe Technical Documentation page for MCS 5100.

Getting help from the Nortel web siteThe best way to get technical support for Nortel products is from the NortelTechnical Support Web site:

www.nortel.com/support

This site provides access to software, documentation, bulletins, and tools toaddress issues with Nortel products. From this site, you can:

• download software, documentation, and product bulletins

• search the Technical Support Web site and the Nortel Knowledge Basefor answers to technical issues

• arrange for automatic notification of new software and documentationfor Nortel equipment

• open and manage technical support cases

Getting help over the phone from a Nortel Solutions CenterIf you do not find the information you require on the Nortel Technical SupportWeb site, and you have a Nortel support contract, you can also get helpover the telephone from a Nortel Solutions Center.

In North America, call 1-800-4NORTEL (1-800-466-7835).

Outside North America, go to the following Web site to obtain the telephonenumber for your region:

www.nortel.com/callus



.

http://www.avaya.com

http://www.avaya.com/support

http://www.avaya.com/callus

10 How to get help

Getting help from a specialist by using an Express Routing CodeTo access some Nortel Technical Solutions Centers, you can use an ExpressRouting Code (ERC) to quickly route your call to a specialist in your Nortelproduct or service. To locate the ERC for your product or service, go to:

www.nortel.com/erc

Getting help through a Nortel distributor or resellerIf you purchased a service contract for your Nortel product from a distributoror authorized reseller, contact the technical support staff for that distributoror reseller.



.

http://www.avaya.com/erc

11

Music on Hold basics

This chapter contains the following sections:

• "Overview" (page 11)

• "Related documents" (page 12)

• "Hardware platform and OS" (page 13)

• "Services and features" (page 13)

• "System scalability" (page 14)

• "OAMP" (page 20)

OverviewWith the Media Application Server (MAS) Music on Hold service, a user canreceive a call, place that call on hold, and play music to the person on holduntil they retrieve the call. The purpose of the music is to reassure theperson on hold that the call was not disconnected or dropped.

To activate this service, you (the system administrator) must provision musicfolders containing audio files, and configure the MAS to play this music tocallers of users at either the domain or subdomain levels.

Note: Nortel does not supply any default audio files with the Music onHold service software. It is the responsibility of the system administratorto obtain and provision the music files.

Music On Hold is enabled through the user’s service package. If a user hasMusic On Hold enabled and puts a caller on hold (end-user hold, transferhold, or call park hold), the caller on hold hears music. The music that thecaller hears is the music that is assigned to the domain or subdomain ofthe called party.

If the user does not have Music On Hold enabled through their servicepackage and places a call on hold, the person on hold does not hear music.This is true even if music is assigned to the domain or subdomain of thecalled party.



.

12 Music on Hold basics

ATTENTIONYou (the system administrator) can disable the Music on Hold service for a userwho typically connects to non-Multimedia Communication System (MCS) hostedconferences (time division multiplex or third-party Session Initiation Protocolconferences).

The Music on Hold service software can detect when an MCS user is connectedto a MAS-based conference. In this case, the Music on Hold service does notplay music to a caller who is placed on hold by one of the conference participants.

However, if an MCP user dials into a non-MCP hosted conference, that usercan place one of these Time Division Multiplex or third-party SIP conferenceparticipants on hold, thus triggering music to be played to the on-hold participant(as well as everyone else on the conference bridge). In this case, the Music onHold service does not automatically determine that music should not be played.

WARNINGInstallation of NetBIOS Extended User Interface (NetBEUI)protocol on a running MAS with Windows 2000 can cause theaddition of perfmon counters and corrupt the registry. NetBEUI isnot a supported configuration.

Related documentsThe MCS documentation suite includes the following:

• MAS components

— MAS Ad Hoc Conferencing Fundamentals (NN42020-116)

— MAS Announcements Fundamentals (NN42020-130)

— MAS IM Chat Fundamentals (NN42020-131)

— MAS Meet Me Conferencing Fundamentals (NN42020-120)

— MAS Meet Me Web Collaboration Fundamentals (NN42020-114)

• Engineering guides

— MCS 5100 Planning and Engineering (NN42020-200)

— Media Application Server Planning and Engineering (NN42020-201)

• Installation, commissioning, and upgrade guides

— MAS Installation and Commissioning (NN42020-307)

• Operation, administration, maintenance and performance guides

— Alarm and Log Reference (NN42020-703)

— Operational Measurements Reference (NN42020-704)



.

Services and features 13

Hardware platform and OSFor the Music on Hold service, the MAS hardware platform varies, dependingon the individual requirements of the network. For smaller deployments,the MAS platform is an IBM xSeries x3550, x336, or x335 rack-optimizedserver. For larger deployments, the platform is an IBM eServer BladeCenteror BladeCenter T chassis with the IBM HS20 blade servers.

CAUTIONInstall only Nortel-certified software on the IBM BladeCenter T. Donot install software updates obtained directly from IBM.

Note 1: The IBM xSeries x3550 server replaces the IBM xSeries x336server (which replaced the IBM xSeries x335 server); however the x336and x335 servers are still supported and you can consider these serversto be interchangeable as MAS platforms.

Note 2: Use the IBM xSeries x3550, x336, or x335 for multiapplicationMAS deployment.

For more detailed information about hardware platforms, see MediaApplication Server Planning and Engineering (NN42020-201).

Services and featuresThe Music on Hold service offers the following features:

• is available for calls on End-User Hold, Transfer Hold, and Call Park Hold

• supports continuous music—the music does not restart from the samepoint for each new call on hold.

• allows for chained music files—you can specify more than one musicfile to play.

• can be configured to operate at the domain or subdomain levels

• is enabled through service packages

• supports the Microsoft Wave file audio format (single channel (mono)linear 16-bit pulse code modulation (PCM) sampled at 8 kHz)

• automatically normalizes the amplitude of the media (music files) toraise or lower the amplitude as soon as the files are placed on the Musicon Hold Media Application Server

• does not support external media sources—all media source files mustbe resident on the Music on Hold Media Application Server.

• generates accounting information consisting of the duration and typeof media file that is played



.


• allows an administrator to swap the standard in-service media files withmedia files that are in reserve on the MAS, by means of the ProvisioningClient

• supports a redundant configuration

Note: For the multiapplication MAS deployment, only the simplexarchitecture is supported.

• supports the streaming of music through a gateway to an on-hold callerwho is on the public switched telephone network (PSTN) or on a privatebranch exchange (PBX)

• generates performance data

Real-Time Transport Control Protocol SupportThe Music on Hold service supports reception and generation of Real-TimeTransport Control Protocol (RTCP) Sender reports.

The Music on Hold service transmits RTCP packets to each participant,detailing the perceived quality of the session from its perspective.

Quality of Service supportThe Music on Hold service supports Differentiated Service (DiffServ)packet marking on outgoing Real-Time Transport Protocol (RTP) streams.The MAS framework sets the DiffServ Control Point (DSCP) to expeditedforwarding (EF), that is a widely supported indicator for Quality of Service(QoS) enabled networks. Network routers that are QoS-enabled examinethe DSCP information in a packet and provide priority (with respect torouting and handling) to those packets marked with expedited forwarding.When routers are overloaded, they drop generic data packets before theydrop DiffServ marked packets. The Music on Hold service strategy followsRFC 2598, which designates the EF bit pattern.

The MAS platform uses QoS packet scheduling to reserve 70 percent ofall available network bandwidth to voice traffic and gives a higher priority tovoice traffic packets, delivering them to the network first.

System scalabilityThere are currently two hardware platforms for the Music on Hold service:

• IBM xSeries x3550, x336, or x335

• IBM HS20 BladeServers (dual slot) in an IBM eServer BladeCenter orBladeCenter T



.

System scalability 15

For smaller deployments, use the IBM xSeries x3550, x336, or x335platform. You have two deployment options for this platform:

• the single application deployment consisting of the Music on Holdservice and (optionally) the Announcements service

• the multiapplication MAS deployment consisting of up to five MASservices (Music on Hold, Ad Hoc Audio Conferencing, Meet MeAudio Conferencing or Meet Me Premium Audio Conferencing,Announcements and IM Chat)

Note: The multiapplication MAS configuration supports up to 250subscribers (in a domain or subdomain). This configuration isstand-alone only, and does not support pooling of ports across otherMAS.

Table 1 "Port limits for Multiapplication MAS services" (page 15) shows thedefined port limits for the five MAS services in the multiapplication MASdeployment. These port restrictions are fixed and do not change if, forexample, you only install three of the five services.

Table 1Port limits for Multiapplication MAS services

Service Number of ports

Music on Hold 20 (G711 or G.729)

Ad Hoc Audio Conferencing 20 (G711 or G.729)

Meet Me Audio Conferencing or Meet MePremium Audio Conferencing

60 (G711 or G.729)

Announcements 20 (G711 or G.729)

IM Chat 30

For the high density deployments of the Music on Hold service, use the IBMHS20 BladeServers within the IBM eServer BladeCenter or BladeCenter Tchassis.



.


Several variants of the HS20 blade server exist. The NTVW01CG bladessupport the Dual SCSI expansion unit, which is required for additionalstorage in duplex mode. The NTVW01CH and NTBW01CV HS20 blades donot require additional storage and can be used for simplex or duplex mode.The requirements are shown in the following table.

HS20 Blade Mode Requires theexpansion unit?

Number of slots

NTVW01CG simplex yes 2

NTVW01CG duplex yes 4

NTVW01CH orNTVW01CV

simplex no 1

NTVW01CH orNTVW01CV

duplex no 2

For the single-application deployment of the IBM xSeries x3550, x336,or x335, and for the IBM HS20 blade server, the maximum numberof simultaneous Music On Hold users is limited only by the number ofchannel licenses purchased and the capacity of the scaled system. Portsare allocated on a first-come, first-served basis until the license keys areexhausted or available capacity is exceeded.

The Music on Hold service takes advantage of the scalable, multiple servercapabilities of the MAS platform and makes use of the MAS replicatedpersistent content storage for storing media source files for Music on Hold.A maximum of two active content storage components can exist in Music onHold service instance (pooled entity).

Note: The multiapplication MAS deployment is a simplex stand-alonearchitecture that does not support pooling of ports across more thanone MAS.

The MAS platform can scale from a small single-server solution to a largemultiserver cluster. The Media Application Server provides scalability acrossmultiple machines through system-level replication. New Media ApplicationServers can be added to the pool of servers at any time to meet expandingcapacity requirements. Each new server must be added to the Pooled Entityusing the Provisioning Client before user traffic can be routed to the server.

The available Media Application Server scaling options are

• Simplex: One Media Application Server within one service instance.There is one active content storage component for the media sourcefiles. See Figure 1 "Simplex Media Application Server configuration"(page 17).

Note: You must use the simplex architecture for the multiapplicationMAS deployment.



.


• Duplex: Two Media Application Servers in one service instance. Thereare two active content storage components, which are active reflectionsof each other. These two content storage components provide storageredundancy for the media source files. See Figure 2 "Duplex MediaApplication Server configuration" (page 17).

The following figures show network diagrams for the various MediaApplication Server scaled configurations.

Figure 1Simplex Media Application Server configuration

Figure 2Duplex Media Application Server configuration

For the Music on Hold service, a pooled entity is made up of one to twoMedia Application Servers. This Pooled Entity is considered one serviceinstance (when the Session Managers are included).



.


You can increase the capacity of a service instance by adding more MediaApplication Servers to the pooled entity. You can add a maximum of twoMedia Application Servers for each Music on Hold pooled entity. You canalso increase the capacity of a service by increasing the number of pooledentities in the network. This type of scaling is required when you requiremore capacity (storage or processing) than can be achieved using onepooled entity.

Note: You cannot increase the capacity of the multiapplication MAS byadding more servers (MAS) to the pooled entity. For the multiapplicationMAS deployment you must use only one server (simplex).

Your network can contain multiple service instances of the Music on Holdservice that are separated by considerable distance. If this is true, avoidthe cost of backhauling to a remote service instance when one is availablelocally. You can ensure that local service instances are always used byassigning service packages to subdomains.

Note 1: For more information about setting up subdomains andassigning service packages to subdomains, see Provisioning ManagerFundamentals (NN42020-111).

Note 2: For the multiapplication MAS deployment, multiple serviceinstances are not supported.

Figure 3 "Using subdomains to map users to local service instances" (page19) gives a high-level view of how to map a subdomain to a group of usersand to a local service instance (pooled entity).



.


Figure 3Using subdomains to map users to local service instances

Figure 4 "Multiple service instances" (page 20) shows a network diagramfor a scaled Media Application Server configuration using multiple serviceinstances.



.


Figure 4Multiple service instances

OAMPThe Media Application Server builds directly into the Microsoft ManagementFramework (Windows 2000 or Windows NT5 platform) to expose logs andoperational measurements, using built-in features of the operating system.The Microsoft Management Console (MMC) provides access to componentsand utilities (called snap-ins) embedded in the operating system that canbe used to build a custom management console.

The Media Application Server integrates seamlessly with the MMC toprovide logs, alarms, operational measurements, monitoring, reporting,and service management.

You use the MAS Console to manage the MAS. The MAS Console softwareruns on the MAS platform. You access the MAS Console software remotelyfrom your own PC using the Remote Desktop Connection.



.

OAMP 21

You can optionally send MAS alarms to a third-party management consolefor viewing. You can also choose to view MAS logs on one or more remoteSysLog servers.



.




.

23

Installation and upgrades

This chapter provides information about Music on Hold service upgradeprocedures. For complete information about installing and configuring theMusic on Hold service on a Media Application Server (MAS), see MASInstallation and Commissioning (NN42020-307).

Multiapplication MASPrevious to this capability, each application on the MAS had to reside onits own separate hardware computing platform. This restriction is lifted fora special case of MAS applications running on the IBM x3550, x336, orx335 platform. A single MAS hardware platform solves customer needs forcost-effective small implementations of multiple MAS services. The multipleapplication MAS can work with the Enterprise micro system to delivermultiple services for up to 250 subscribers (maximum). It can also be usedas a service evaluation platform in 4-server and 8-server configurations.

The following applications can reside on the same Media Application Serverhardware platform:

• Ad Hoc Conferencing

• Announcements

• Meet Me Conferencing or Meet Me Premium Conferencing

• Music on Hold

• IM Chat

For more information about the engineering requirements formultiapplication MAS, see Media Application Server Planning andEngineering (NN42020-201). For more information about installing andconfiguring the Music on Hold service as part of a multiapplication MASdeployment, see MAS Installation and Commissioning (NN42020-307).

General information relating to MAS software upgradesUpgrades are performed by using many of the same procedures as thoseused during installation. However, the order of the procedures is slightlydifferent for upgrades.



.

24 Installation and upgrades

Note: Configuration data is preserved during the upgrade.

The Music on Hold service is installed using an intuitive InstallShieldinstallation program. For every new release, or patch release of the Musicon Hold service executable, a new installation program is created. Duringan upgrade, the installation program stops the current Music on Holdservice instance, replace its executable, and restart the Music on Holdservice instance again.

Note: Patch releases are cumulative; the latest patch bundle installationprogram contains all previous patches.

During a MAS framework upgrade, the Music on Hold service running onthe targeted MAS becomes temporarily unavailable on the network. ThisMusic on Hold service becomes available after the service is restarted(upon successful restarting of the Media Application Server framework).

In scaled networks, continuous access to the Music on Hold service duringupgrades is achieved by performing Media Application Server upgrades oneserver at a time. Before you upgrade an instance of the Music on Holdservice, or of the Media Application Server that instance is running on, theservice is set to Pending Lock. While the service is in the pending lockstate, all new Music on Hold service requests are rejected by this instance,and are routed to one of the remaining in-service Music on Hold serviceinstances (located on different Media Application Servers). Existing Musicon Hold traffic on the Media Application Server to be upgraded can beallowed time to clear on its own, as Music on Hold sessions end.

After the target Media Application Server has no more (or an acceptableminimal amount of) active traffic on it, the service is set to Lock. After it islocked, the Music on Hold service (and or the Media Application Serverhosting that service) can be upgraded. After the upgrade is complete,the service can be restarted and unlocked. After the service is unlocked,incoming Music on Hold service requests can be handled by the MediaApplication Server, instead of being routed to another Music on Hold servicerunning on a different Media Application Server.

Nortel recommends that you perform upgrades during the maintenancewindow, or at some other off-peak usage time. Locking the upgrade targetservice instance several hours prior to the actual maintenance windowhelps ensure that a minimum number of Music on Hold sessions, if any,are present on the upgrade target when the service is actually upgradedduring the maintenance window.

For more information about installation and upgrade procedures, see MASInstallation and Commissioning (NN42020-307).



.

25

Fault management

This chapter provides information about "MAS fault management strategy"(page 25)

Fault management strategyThe Media Application Server (MAS) platform software is configured as anoperating system service (NT service) that is started and monitored bythe operating system (OS) automatically. If any MAS platform softwaresubcomponent fails, the OS restarts the component immediately andgenerates a log. An alarm is also raised to report this condition until thecomponent is registered with the remainder of the system, at which pointthe alarm is cleared.

The MAS generates alarms in response to fault conditions that degrade orinterrupt operation of the service. In general, MAS alarms can require youto take action to correct the fault condition. MAS services rely on the MASplatform software to provide alarm generation mechanisms.

After you, or the system, correct a fault, the MAS software automaticallyclears the alarm condition. All alarms are logged and a second log isgenerated to record the new status after an alarm is cleared.

The MAS platform software also provides an event logging mechanism. Theevent logging mechanism is a standardized and centralized way to reportrelevant software and hardware events.

For more information about Fault Management, see Alarm and LogReference (NN42020-703).



.

26 Fault management



.

27

Configuration management

This section describes the tasks (from a high-level viewpoint) that youmust perform to configure the Music on Hold service to run on a MediaApplication Server.

For complete information about installing and configuring the MediaApplication Server platform, and the Music on Hold service software, seeMAS Installation and Commissioning (NN42020-307).



.

28 Configuration management



.

29

Accounting

Internet Protocol Detail Records (IPDR) are collected for the Music onHold service. Table 2 "Connect Egress record field descriptions" (page29) shows the connect Egress record and field descriptions for the Musicon Hold service IPDR.

Table 2Connect Egress record field descriptions

Field Name XML tagRecordtype

Elementfoundwithin Description

SupplementaryService

supplementaryService Egress UE Indicates the servicename

Main Folder serviceURI Egress UE, supplementaryService

Gives the URIcontaining thedetailed parametersof the service (forexample, foldername, file name, andlocale).

Figure 5 "Connect Egress record for Music on Hold" (page 30) shows aconnect Egress record for Music on Hold.



.

30 Accounting

Figure 5Connect Egress record for Music on Hold

For more information about accounting, see MCS 5100 Accounting ManagerFundamentals (NN42020-144).



.

31

Performance management

You use the Media Application Server (MAS) Console to manage theperformance of the Media Application Server (MAS) platform and the Musicon Hold service.

For more information about performance management, see OperationalMeasurements Reference (NN42020-704).



.

32 Performance management



.

33

Security and administration

The Media Application Server platform provides security and administrationfor the Music on Hold service. These procedures are performed primarilythrough the Media Application Server Console (MAS Console).

You use the MAS Console to perform security and administration proceduresrelating to the IM Chat service. The MAS platform uses a hardenedWindows 2000 operating system.

Note: The MAS supports the encryption of instant messages (IM).

Security strategy overviewFor more information about the Media Application Server security strategy,see MAS Installation and Commissioning (NN42020-307).

AdministrationYou use the MAS Console to monitor and manage the Media ApplicationServer. You access the MAS Console by means of the Remote DesktopProtocol (RDP). RDP provides remote access capabilities to the MASplatform where the MAS Console application is running. You access thisclient using the administrator’s PC. Click Start > Programs > Accessories >Communications > Remote Desktop Connection and type the IP addressfor the MAS server you want to connect to. You are prompted for the username and password to log on to the server.

Establish the managed environmentThe process for establishing the managed environment on the MAS involvesstarting a remote access session to each of the Media Application Serversin the site and starting the Media Application Server Console within thecontext of those sessions.

All available remote access connections to Media Application Servers in thesite are visible in the Client Connection Manager and the Terminal ServicesManager program group. You can use either of these to initiate remotesessions with the target Media Application Server.



.

34 Security and administration

Starting the Client Connection ManagerAt the system administrator’s PC, select Start > Programs > Admin Tools> Terminal Services Configuration.

The Client Connection Manager appears, showing all available remoteaccess connections to Media Application Servers in the site.

Procedure 1Creating new remote access connection icons

Step Action

From the Client Connection Manager

1 Select Action > Create New Connection.

2 This starts a simple wizard. Follow the steps to create a connectionicon for a remote Media Application Server.

Note: You can enable a connection in a number of ways. Forexample, you can double-click the entry in the Client ConnectionManager display or you can right-click an entry (for example,NORTEL-X49) in the Client Connection Manager window todisplay a shortcut menu, and select Connect from the shortcutmenu.

—End—

Use the Terminal Services Manager program group iconsAll available remote access connections are visible in the Terminal ServicesManager program group.

Procedure 2Using the Terminal Services Manager program group icons

Step Action

At the system administrator’s PC

1 Select Start > Programs > Admin Tools > Terminal ServicesManager.

2 Select the Media Application Server connection you want.

—End—



.

Administration 35

Use the Terminal Services Manager to manually connect to the MASFrom the Terminal Services Manager window, you can manually connect to,or disconnect from, the MAS server.

Procedure 3Using the Terminal Services Manager to manually connect to the MAS

Step Action

At the system administrator’s PC

1 Select Start > Programs > Administrative Tools > TerminalServices Manager .

The Terminal Services Manager window appears.

2 Right-click on the MAS server you want to connect to (or disconnectfrom).

3 Click Connect to start a connection or click Disconnect todisconnect from the server.

—End—

Start the MAS ConsoleAny of the methods previously discussed starts an RDP session fromthe system administrator’s PC to the Media Application Server. TheRDP attempts to automatically log on to the Media Application Server onconnecting (according to the configuration) and, if successful, displays theactively running remote desktop for this user.

After general access is gained through RDP, you can start the local MASConsole for this Media Application Server.

From the RDP window that displays the remote MAS desktop, select Start> Programs > Nortel Media Application Server > Media ApplicationServer Console.

The MAS Console opens in the RDP window.

Access the MAS Console help filesThe MAS Console Help menu includes information about the console aswell as the native OS snap-ins used to build the MAS Console.



.


Procedure 4Viewing MAS Console help files

Step Action

From the MAS Console

1 Click the Help menu item.

2 Select Help Topics to open the MAS Console help display. Thisdisplay contains help topics for the Microsoft Management Console(MMC), as well as the native operating system snap-ins used tobuild the MAS Console.

3 Select Microsoft on the Web to access the Microsoft Web site orselect About Microsoft Management Console to view the softwareversion.

—End—

MAS subcomponentsThe MAS platform consists of six subcomponents. Each internalsubcomponent executes a simple-state machine. The overall state of theMAS is an aggregation of the individual states of the seven subcomponents.The MAS Console allows the system administrator to display and controlthe MAS platform and subcomponents.

Control the MAS subcomponents from the MAS ConsoleSubcomponents are not individually controllable. The MAS platform serviceis a collection of subcomponents that are responsible for a specific area ofMAS platform functionality. Stopping one subcomponent affects the others.As such, control operations are performed on the entire MAS platformservice and not on an individual subcomponent basis.

There are six control commands that you can issue to the MAS platform:

• Unlock

• Pending Lock

• Lock

• Start

• Stop

• Restart

Note: Not all control operation commands are available at any instant.Only valid operations are enabled for the administrator. For example, ifthe MAS stops, the Stop operation is no longer available.



.

Administration 37

The Stop and Restart commands are service-affecting operations and takedown all existing Music on Hold service sessions. New incoming Music onHold service requests are route advanced to other MAS servers (providedthat you installed a duplex architecture).

The Lock operation is also a service-affecting operation and takes downany existing Music on Hold service sessions. However, in this case, anemergency maintenance announcement is streamed to the active sessions(where applicable). New incoming Music on Hold service requests areroute advanced to other MAS servers (provided that you installed a duplexarchitecture).

The Pending Lock operation preserves existing Music on Hold servicesessions. However, all new incoming Music on Hold service requests areroute advanced to other servers (provided that you installed a duplexarchitecture). In the case of planned maintenance, this gives existingsessions time to disconnect naturally (without service interruption) beforethe MAS platform is stopped.

Use the following procedure to access the available control operations forthe MAS.

Procedure 5Controlling the MAS platform

Step Action

From the Media Application Server Console

1 Right-click the Control Panel snap-in icon in the Console tree todisplay the shortcut menu.

2 Use the Operations submenu to access the appropriate operationalcommand to perform on the MAS platform.

—End—

Refresh a subcomponent status on the MAS ConsoleThe status of subcomponents automatically refreshes periodically. Use thefollowing procedure to initiate an immediate refresh of the subcomponentstatus.

Procedure 6Refreshing a subcomponent status on the MAS Console

Step Action




.


1 In the Details panel, right-click one of the subcomponents to displaythe Component shortcut menu.

2 Select Refresh to update the status of the subcomponent.

—End—

System and platform managementThe MAS Console is preconfigured with a disk management snap-inprovided by the operating system (see Figure 6 "Disk Management snap-indisplay" (page 38)).

Figure 6Disk Management snap-in display

Preconfiguring the Disk Management snap-in is provided as a conveniencefor managing the hard disks and volumes on the Media Application Server.For more information about using the disk management snap-in, refer to theoperating-system resident help, accessible by clicking the Help drop-downmenu in the MAS Console and clicking the HelpTopics item. The Helpwindow appears.

Data backup and restoreThe Media Application Server can mirror customer data (managed by theMultimedia Content Store subcomponent) on different MAS nodes. It isfrequently convenient to be able to do a complete node restoration fromoutside the system. You use the MAS Console to perform backup andrestore of system configuration data, as well as service data.



.

Administration 39

System dataSystem data includes all configuration parameters that are visible in theMAS Console Services folder and stored in the Windows Registry.

Note: You can perform a system data backup and restore with thesystem online and unlocked; however, you must restart the MAS afterrestoration for the configuration parameter changes to take effect.

Service dataService data includes user data that resides in the Multimedia ContentStore subcomponent. A partial service backup archives all data exceptmultimedia files. A full service backup includes all data included in a partialbackup in addition to the multimedia files.

Note: For both service data archive types, the MAS must be in alocked or shutdown state to perform a restore. During the restorationprocess, all user files in the Multimedia Content Store subcomponentare removed prior to archive extraction.

Access the MAS backup and restore functionsYou can access the backup and restore functionality provided by the MASConsole using the Control Panel icon shortcut menu. Right-click theControl Panel snap-in icon in the Console tree to access the Backup orRestore submenu.

The Backup/Restore submenu contains selections to create backup archivefiles for system data and service data (full or partial). For each of thesetypes of backups, a submenu is provided to allow you (the administrator) toperform specific backup and restore-related functions for that backup type.

Create the backup archivesYou use the Backup/Restore > Create Backup Archive menu command tocreate backup archives for system data and service data (full or partial). Thefollowing procedures describe how to create backup archives for systemdata and service data (full and partial) on the Media Application Server.

Procedure 7Creating a System Data backup

Step Action


1 Right-click the Control Panel snap-in icon in the Console tree toaccess the Backup/Restore submenu.

2 Select Backup/Restore > System Data > Create Backup Archiveto display the Create System Backup Archive file browser window.



.


3 Use the file browser window to select the name and location of whereto store the backup archive on the computer. A default archive filename is automatically generated that specifies the type of backup,the host name of the MAS where the backup was created, and thedate and time the backup was created.

Note: Nortel recommends that you use the automaticallygenerated filename to ensure consistent naming of all backuparchives and make it easier to find specific archive files when arestore procedure is required.

4 Click Save to create the system data archive file.

—End—

Procedure 8Creating a Full Service Data backup

Step Action



2 Select Backup/Restore > Service Data (Full) > Create BackupArchive to display the Create Service Backup Archive file browserwindow.

3 Use the file browser window to select the name and location ofwhere to store the backup archive on the computer. A defaultarchive filename is automatically generated that specifies the type ofbackup, the host name of the MAS where the backup was created,and the date and time the backup was created.


4 Click Save to create the full service data archive file.

—End—



.

Administration 41

Procedure 9Creating a Partial Service Data backup

Step Action



2 Select Backup/Restore > Service Data (Partial) > Create BackupArchive to display the Create Service Backup Archive file browserwindow.

3 Use the file browser window to select the name and location ofwhere to store the backup archive on the computer. A defaultarchive filename is automatically generated that specifies the type ofbackup, the host name of the MAS where the backup was created,and the date and time the backup was created.


4 Click Save to create the partial service data archive file.

—End—

Restore from backup archivesYou use the Backup/Restore > Restore menu command to restore froma previously created backup archive of system data or service data (full orpartial). The following procedures describe how to restore from backuparchives.

Procedure 10Restoring a system data backup archive

Step Action



2 Select Backup/Restore > System Data > Restore to display theRestore System Backup Archive file browser window.

3 Use the file browser window to select the system data backuparchive to use to restore the system data.



.


Note: If you used the default automatically generated filenamewhen you created the system data backup, the backup archivefilename begins with MASSYS.

4 Click Open to restore the system data from the archive file.

After the restore is complete, you must restart the Media ApplicationServer.

5 Right-click the Control Panel snap-in icon in the Console tree toaccess the Operations submenu.

6 Select Operations > Restart to restart the Media Application Server.

—End—

Before you restore service data, you must take the Media Application Serverout of service (locked and offline). The MAS can be immediately locked andstopped, however, if there are active service sessions on the MAS whenit is locked, the sessions are immediately taken down as well. Because ofthis, Nortel recommends that you first place the MAS in the Pending Lockstate, to allow existing service sessions to end naturally over time. After theactive sessions end, place the MAS in the Locked state and then stop theMAS. For more information, see "Controlling MAS subcomponents from theMAS Console" (page 36).

Procedure 11Restoring a full service data backup archive

Step Action



2 Select Operations > Pending Lock to prevent the Media ApplicationServer from accepting new service requests and to allow existingservice sessions to end.

Allow all existing service sessions to end naturally or wait until anacceptable low number of existing service sessions remain.

3 Right-click the Control Panel icon and select Operations > Lock toend any remaining service sessions.

4 Right-click the Control Panel icon and select Operations > Stop toplace the Media Application Server offline.



.

Administration 43


6 Select Backup/Restore > Service Data (Full) > Restore to displaythe Restore Service Backup Archive file browser window:


Note: If you used the default automatically generated filenamewhen you created the system data backup, the backup archivefilename begins with MASSVC_FULL.

8 Click Open to restore the full service data from the archive file.

After the restore is complete, you must return the Media ApplicationServer to service.

9 Right-click the Control Panel icon and select Operations > Start toactivate the Media Application Server.

After the Media Application Server starts, it returns to the previouslylocked state. You must unlock the MAS before it can accept newservice requests.

10 Right-click the Control Panel icon and select Operations > Unlock.

The Media Application Server is now online and accepts new servicerequests.

—End—

Procedure 12Restoring a partial service data backup archive

Step Action



2 Select Operations > Pending Lock to prevent the Media ApplicationServer from accepting new service requests and to allow existingservice sessions to end.

Allow all existing service sessions to end naturally or wait until anacceptable low number of existing service sessions remain.

3 Right-click the Control Panel icon and select Operations > Lock toend any remaining service sessions.



.


4 Right-click the Control Panel icon and select Operations > Stop toplace the Media Application Server offline.


6 Select Backup/Restore > Service Data (Partial) > Restore todisplay the Restore Service Backup Archive file browser window.


Note: If you used the default automatically generated filenamewhen you created the system data backup, the backup archivefilename begins with MASSVC_PARTIAL.

8 Click Open to restore the partial service data from the archive file.

After the restore is complete, you must return the Media ApplicationServer to service.

9 Right-click the Control Panel icon and select Operations > Start toactivate the Media Application Server.

After the Media Application Server starts, it returns to the previouslylocked state. You must unlock the MAS before it accepts new servicerequests.

10 Right-click the Control Panel icon and select Operations > Unlock.

The Media Application Server is now online and accepts new servicerequests.

—End—

Use the automatic backup tasksYou use the Backup/Restore > Automatic Backup Task menu command tocreate backup archives for system data and service data (full or partial) atregularly scheduled intervals (for example, daily or weekly). An automaticbackup task can store archives locally on the Media Application Server orcan be configured to push the archive to a remote server, using File TransferProtocol (FTP).

The following procedures describe how to create, schedule, and removeautomatic backup tasks on the Media Application Server.



.

Administration 45

Procedure 13Creating an Automatic Backup Task (local backup)

Step Action



2 Select Backup/Restore > System Data > Automatic Backup Task> Create to display the System Backup Task window.

3 In the Local Destination Folder field, enter the folder name forwhere you want to store the automatic backup archive.

ExampleD:\MASBackup

4 Click Create to save the new backup task.

—End—

Procedure 14Creating an Automatic Backup Task (remote backup)

Step Action


1 Right-click the Control Panel snap-in icon and selectBackup/Restore > System Data > Automatic Backup Task >Create to display the System Back Task window.

2 In the Local Destination Folder field, enter the folder name forwhere you want to store the automatic backup archive.

ExampleD:\MASBackup

3 Select Enable FTP.

4 In the Hostname field, enter the host name or IP address of theremote FTP service machine where the backup task sends thegenerated backup archive.

Exampleftpserver1

5 In the Username field, enter the user name the backup task uses toconnect to the FTP service of the remote computer.



.


Examplemasftpuser

6 In the Password field, enter the password the backup task uses toconnect to the FTP service of the remote computer.

Examplemasftppword

7 In the Destination Path field, enter the folder for where you wantto store the automatic backup archive on the remote FTP servicemachine.

Example/export/home/masftpuser

8 By default, the backup task keeps a copy of the backup archive onthe local machine (in the folder specified in step 2 above). Optionally,you can select Remove local file after transfer to have the backuptask remove the local copy.


—End—

Procedure 15Scheduling an Automatic Backup Task

Step Action



2 Select Backup/Restore > System Data > Automatic Backup Task> Schedule/Run to display the Task tab of the selected automaticbackup task window.

ATTENTIONDo not modify the Run field. This field is automatically generated whenthe backup task is created and altering it can prevent the task fromrunning correctly.

3 The Run as field shows the user account that is used when thebackup task runs. Verify that the user account is NortelMASAdmin.

4 Click Set password to assign the password for the NortelMASAdminaccount.



.

Administration 47

5 Select Enabled (scheduled task runs at specified time) to activatethe backup task.

6 Select the Schedule tab to display scheduling information for thebackup task.

7 Click New to create a new schedule for the task.

8 Use the Schedule Task, Start time, and Schedule Task Dailyfields to define when and how often the backup task runs.

9 Select the Settings tab to display additional settings informationfor the backup task.

The Settings tab is automatically configured when the backup taskis created.

Note: Changing the Settings tab properties improperly canprevent the backup task from running correctly.


—End—

Procedure 16Deleting an Automatic Backup Task

Step Action



2 Select Backup/Restore > System Data > Automatic Backup Task> Remove to remove the backup task.

—End—



.




.

49

Appendix AMessage flows

This appendix contains the following high-level message flow diagrams forthe Music On Hold Service:

• Figure 7 "Music On Hold message flow (without the Border ControlPoint)" (page 50)

• Figure 8 "Retrieving a call from Music On Hold (without Border ControlPoint)" (page 51)

• Figure 9 "Music On Hold failure (without the Border Control Point)"(page 52)

• Figure 10 "Music On Hold message flow (with the Border Control Point)"(page 53)

• Figure 11 "Retrieving a call from Music On Hold (with the Border ControlPoint)" (page 54)

• Figure 12 "Music On Hold failure (using the Border Control Point)" (page55)

• Figure 13 "Both parties placing each other on hold (using Border ControlPoint)" (page 57)

• Figure 14 "Both parties retrieve each other from hold (with BorderControl Point)" (page 58)

• Figure 15 "Both parties place each other on hold (without the BorderControl Point)" (page 59)

• Figure 16 "Both parties retrieve each other from hold (without BorderControl Point)" (page 60)

To view a message flow for Music On Hold without the Border Control Point,see Figure 7 "Music On Hold message flow (without the Border ControlPoint)" (page 50).



.

50 Appendix A Message flows

Figure 7Music On Hold message flow (without the Border Control Point)

Figure 8 "Retrieving a call from Music On Hold (without Border ControlPoint)" (page 51) shows the message flow when the terminating partyretrieves a call from Music On Hold.



.


Figure 8Retrieving a call from Music On Hold (without Border Control Point)

Figure 9 "Music On Hold failure (without the Border Control Point)" (page52) shows a failed attempt to use Music On Hold. In the message flow,the originating party is placed on hold by the terminating party but cannothear any music.



.


Figure 9Music On Hold failure (without the Border Control Point)

Figure 10 "Music On Hold message flow (with the Border Control Point)"(page 53) shows the Music On Hold message flow when the Border ControlPoint is used to route signaling and media stream information.



.


Figure 10Music On Hold message flow (with the Border Control Point)



.


Figure 11 "Retrieving a call from Music On Hold (with the Border ControlPoint)" (page 54) shows the message flow when the terminating partyretrieves a call from Music On Hold. In this message flow, the BorderControl Point is used to route signaling and media stream information.

Figure 11Retrieving a call from Music On Hold (with the Border Control Point)

Figure 12 "Music On Hold failure (using the Border Control Point)" (page 55)shows a failed attempt to use Music On Hold. In this scenario, the originatingparty is placed on hold by the terminating party but cannot hear any music.



.


Figure 12Music On Hold failure (using the Border Control Point)



.


Figure 13 "Both parties placing each other on hold (using Border ControlPoint)" (page 57) shows a Music On Hold message flow where both partiesplace each other on hold. In this message flow the Border Control Point isused to route signaling and media stream information.



.


Figure 13Both parties placing each other on hold (using Border Control Point)



.


Figure 14 "Both parties retrieve each other from hold (with Border ControlPoint)" (page 58) shows a Music On Hold message flow where both partiesretrieve each other from a hold state. In this message flow the BorderControl Point is used to route signaling and media stream information.

Figure 14Both parties retrieve each other from hold (with Border Control Point)



.


Figure 15 "Both parties place each other on hold (without the Border ControlPoint)" (page 59) shows a Music On Hold message flow where both partiesplace each other on hold. In this scenario, the Border Control Point is notused to route signaling and media stream information.

Figure 15Both parties place each other on hold (without the Border Control Point)



.


Figure 16 "Both parties retrieve each other from hold (without BorderControl Point)" (page 60) shows a scenario involving Music On Hold whereboth parties retrieve each other from a hold state. In this message flow,the Border Control Point is not used to route signaling and media streaminformation.

Figure 16Both parties retrieve each other from hold (without Border Control Point)



.

Nortel Media Application Server

MAS Music on Hold FundamentalsCopyright © 2007, Nortel NetworksAll Rights Reserved.

Publication: NN42020-129Document status: StandardDocument version: 01.04Document date: 27 July 2007

The information in this document is subject to change without notice. The statements, configurations, technical data, andrecommendations in this document are believed to be accurate and reliable, but are presented without express or impliedwarranty. Users must take full responsibility for their applications of any products specified in this document. The information inthis document is proprietary to Nortel Networks.

Nortel, the Nortel logo, and the Globemark are trademarks of Nortel Networks.

IBM, Lotus, Lotus Notes, BladeCenter, and BladeCenter T are trademarks of International Business Machines.

Microsoft and Windows are trademarks of Microsoft.

All other trademarks are the property of their respective owners.

Sourced in Canada.

To provide feedback or report a problem in this document, go to www.nortel.com/documentfeedback.

http://www.avaya.com/documentfeedback

MAS Music on Hold Fundamentals - Avaya Support

Documents