BroadWorks System Administration

Module 7: Media Server Release 12 Version 1

May 2005

213

Module 7 Objectives
At the end of this module, you will be able to:
Configure the Media Server basic system Enable RFC 2833 Add codecs for IVR and conferencing functions

214

2005 BroadSoft, Inc. Proprietary and Confidential; Do Not Copy, Duplicate, or Distribute

214

Media Server
Management CLI Telnet/SSH

Media Devices

RTP MS1
SIP

RTP

Media Devices

AS1

SIP

AS2

215

2005 BroadSoft, Inc. Proprietary and Confidential; Do Not Copy, Duplicate, or Distribute

Media Server
Functions -DTMF detection -Prompt play -Media recording -Media conferencing Resource selection -Centralized allocation -Pooled Media Servers -Usable by multiple servers -Geographic selection Media control -Application Server control -MCP = device control protocol -Software-only solution -Integrated management Media transport -IP/RTP-based -G.711, 729 and G.726 32 kb/s codecs -RFC 2833 support -Packet loss algorithm

215

Media Server Features

Redundancy
Deployed in an N+1 configuration for redundancy Provides IP interface redundancy (Solaris multipathing)

Capacity
Based on number of simultaneously active ports (IVR, Three-Way Conferencing)

Media Server provides specialized media resources

Media mixing and conferencing Announcement recording and playback DTMF digit detection

216

2005 BroadSoft, Inc. Proprietary and Confidential; Do Not Copy, Duplicate, or Distribute

216

Media Server Features

Media Server services
Voice messaging Voice messaging to e-mail Dial-up voice message retrieval Auto attendant Three-way conferencing Instant conferencing Account codes and authorization codes (digit detection) System announcements and tones Communication assistance for the law enforcement act (CALEA)

217

2005 BroadSoft, Inc. Proprietary and Confidential; Do Not Copy, Duplicate, or Distribute

217

Voice Messaging Deposit

13. CHECK jc@j.com 10. E-MAIL TO jc@j.com

POP3
SMTP/POP3

POP3

AS1

2. <- SETUP RTP CONNECTION -> 3. PLAY BUSY GREETING -> 4. RECORD MSG -> 7. STOP RECORDING -> 8. <- RECORDING MADE 9. SEND WAV IN E-MAIL TO jc@j.com -> 11. <- E-MAIL SENT

1. INVITE JC

MS1

12. MWI

6. BYE

SIP RTP
5. <- Hi Im busy leave a message This is Bob call me ->

JC
218

BOB
2005 BroadSoft, Inc. Proprietary and Confidential; Do Not Copy, Duplicate, or Distribute

Voice Messaging Deposit

1. User Bob INVITES user JC who is busy. 2. AS1 tells the MS1 to setup an RTP connection with user Bob. 3. AS1 sends to the MS1 the .wav file busy greeting to play to user Bob. 4. AS1 also tells the MS1 to record the message left by user Bob as a .wav file. 5. MS1 plays busy greeting .wav file and records the message left by user Bob. 6. User Bob hangs up sending BYE to AS1. 7. AS1 tells MS1 to stop recording. 8. MS1 tells AS1 recording made. 9. AS1 sends the MS1 the e-mail account to which the recorded .wav file is sent as an attachment. 10. MS1 sends e-mail to SMTP server who acknowledges e-mail. 11. MS1 tells AS1 that the e-mail was sent. 12. AS1 send Message Waiting Indicator (MWI) to user JC. 13. Five seconds later, the AS1 uses a list command to check the e-mail account of user JC to determine if there is enough space to leave more voice messages.

218

Voice Messaging Retrieval

4. LOG IN TO JC@J.COM& GET FIRST E-MAIL

POP3
SMTP/POP3

AS1
2. <- SET UP RTP CONNECTION -> 3. PLAY LOGIN PROMPT & COLLECT DIGITS -> 6. <- SEND DIGITS 1234

SIP
1. INVITE Voice portal

MS1

RTP
JC 5. <- PLEASE ENTER PIN 1234 ->

219

2005 BroadSoft, Inc. Proprietary and Confidential; Do Not Copy, Duplicate, or Distribute

Log in to Voice Mail

1. User JC calls voice portal to get voice mail. 2. Application Server1 tells Media Server1 to se tup an RTP connection with user JC. 3. Application Server1 sends login prompt WAV to Media Server1 to play and collect digits from user JC. 4. Application Server1 logs in to jc@j.com e-mail account and retrieves the first voice mail. 5. Media Server1 plays login prompt .wav file and collects digits 1234 from user JC. 6. Media Server1 sends digit information 1234 to AS1.

219

Voice Messaging Retrieval (cont.)

11.GET SECOND E-MAIL 19. DELETE MSG & CHECK ACCOUNT jc@j.com

POP3
SMTP/POP3

AS1

7. PLAY WELCOME & COLLECT DIGITS -> 9. <- SEND DIGITS 1 10. PLAY PROMPT & WAV & COLLECT DIGITS -> 13. <- SEND DIGITS 7 14. PLAY DELETE PROMPT -> 17. STOP -> 18. MWI Off

SIP

MS1

16. BYE

JC

8. <- YOU HAVE 2 MESS PRESS 1 1 -> 12. <- Vmail This is Bob call me 7 -> 15. <- Message deleted
2005 BroadSoft, Inc. Proprietary and Confidential; Do Not Copy, Duplicate, or Distribute

RTP

220

Message Retrieval
7. 8. 9. Application Server1 tells the Media Server1 to play the WELCOME WAV it sends and to collect digits. Media Server1 plays WELCOME .WAV and collects digits 1 from user JC. Media Server1 sends the play digit 1 to the Application Server1 .

10. Application Server1 sends the voice prompt and voice mail .WAV to the Media Server1 to play for user JC and collect digits. 11. Application Server1 gets a second e-mail from the POP3 server. 12. Media Server1 plays the voice mail .WAV file and prompts, collects the delete 7 digit. 13. Media Server1 sends delete digit to Application Server1 . 14. Application Server1 sends delete prompt to Media Server1 to play for user JC. 15. Media Server1 plays message deleted to user JC. 16. User JC hangs up sends a BYE to Application Server1 . 17. Application Server1 tells Media Server1 to stop. 18. MWI is turned off. 19. Application Server1 tells account jc@j.com to delete e-mails.

220

Media Server Configuration Steps

Configuration
The Media Server does not require any post-installation configuration to function Certain default parameters can be configured on Configuration steps are:
1. 2. 3. 4. Debug logging level Enable RFC 2833 Set G.726 as a valid codec Add video codec H.263

221

2005 BroadSoft, Inc. Proprietary and Confidential; Do Not Copy, Duplicate, or Distribute

221

Media Server Configuration

MS_CLI/System> set logLevel 1 MS_CLI/System> get logLevel = 1 smtpTimeout = 30 MXRecordLookup = N maxCacheFiles = 50

222

2005 BroadSoft, Inc. Proprietary and Confidential; Do Not Copy, Duplicate, or Distribute

Media Server Configuration

Logging Level Set the debug logging level. Logs are dumped into /var/broadworks/logs/mediaserver0 file ms.syslog. The set command and the following fields are used to set the logging level, as well as other system-related attributes: logLevel smtpTimeOut maxCacheFiles Controls logging of debug messages to terminal and/or system log file. Number of seconds to wait for a response from the SMTP server. Sets the maximum number of cache files.

MXRecordLookup Controls the MX record lookup.

222

Media Server Configuration

MS_CLI/Interface/RTP> set enableRfc2833 true MS_CLI/Interface/RTP> get ipAddress = localhost portRange = 10000 16000 enableRfc2833 = true typeOfService = 47 NegotiateFromG729ToAnotherCodec = true

223

2005 BroadSoft, Inc. Proprietary and Confidential; Do Not Copy, Duplicate, or Distribute

Media Server Configuration

Enable RFC 2833 Enable RFC 2833 for the Media Server for both video and audio streaming. This supports RFC 2833 out-of-band DTMF digits. The set command and the following fields are used to enable RFC 2833, as well as other Real Time Protocol (RTP) attributes: portRange Start Range of UDP port numbers to be reserved for RTP streaming. Firewalls should be configured to let RTP packets pass in this range. Stop range of UDP port numbers to be reserved for RTP streaming. Firewalls should be configured to let RTP packets pass in this range. Enable separation of DTMF tones from voice, as defined in standard RFC 2833. Specifies value of IP field TOS in outgoing RTP packets. The main use for this field is to specify a DiffServ value (DS field, also known as differentiated services codepoint), as defined in RFC 2474. True, False The default is false. If true, the Media Server allows the call to terminate, but it negotiates to some other codec. If false, the Media Server does not allow the call to terminate, and provides a busy response to the caller. NOTE: Changes to the port range, IP address, and type of service take effect after the Media Server has been restarted.

Stop

enableRFC28 typeOfService

NegotiateFromG720 ToAnotherCodec

223

Media Server Configuration

MS_CLI/Service/Conferencing/Codec> add ulaw MS_CLI/Service/Conferencing/Codec> add g726-32 MS_CLI/Service/Conferencing/Codec> get Codec ========= ulaw g726-32 MS_CLI/Service/IVR/Codec> add ulaw MS_CLI/Service/IVR/Codec> add g726-32 MS_CLI/Service/IVR/Codec> get Codec ========= ulaw g726-32 MS_CLI/Service/LIVEAUDIO/Codec> add ulaw MS_CLI/Service/LIVEAUDIO/Codec> add g726-32 MS_CLI/Service/LIVEAUDIO/Codec> get Codec ========= ulaw g726-32
224
2005 BroadSoft, Inc. Proprietary and Confidential; Do Not Copy, Duplicate, or Distribute

Media Server Configuration

Codec Setting Media Server provides for the G.711, G.726-32, and G.729 codecs. Codecs are supported on a per-service basis that is, IVR or Conferencing. The Media Server returns the codec list in the order it was entered.

224

Media Server Configuration

Add <codec>, Choice = {h263-1998, h263-2000} MS_CLI/Service/IVR/VideoCodec>get Codec ====== H263-1998

225

2005 BroadSoft, Inc. Proprietary and Confidential; Do Not Copy, Duplicate, or Distribute

Media Server Configuration

Video This activity extends the BroadWorks media server to allow for playing back and recording video in addition to audio for video-enabled phones. The video codec H.263 is supported, along with the .MOV file format for storing audio and video.

225

SIP SDP For Video RTP

v=0 o=- 1038469523 1038469523 IN IP4 155.69.223.61 s=Optional title c=IN IP4 155.69.223.61 t=0 0 m=audio 5002 RTP/AVP 0 96 RTP Audio settings a=rtpmap:96 G726-32/8000 m=video 5004 RTP/AVP 97 98 a=rtpmap:97 H263-1998/90000 a=rtpmap:98 H263-2000/90000 RTP Video settings a=fmtp:98 profile=3;level=20

226

2005 BroadSoft, Inc. Proprietary and Confidential; Do Not Copy, Duplicate, or Distribute

226

Questions

227

2005 BroadSoft, Inc. Proprietary and Confidential; Do Not Copy, Duplicate, or Distribute

227