media_server

Media server streaming control interface configuration.

Format

• [-v] -c --name [--host ] [-l ] [--port ] [--symbolic-name] [--service-name [ ]]
• [-v] -e --name [-l ]
• [-v] -i --host [--name ] [-l ] [--port ] [--symbolic-name] [--service-name [ ]]
• [-v] -p

Function

The media_server command will define how to connect to a media server SIP control interface for streaming, and print the configuration.

The Media Server Control Markup Language (MSCML) and protocol according to RFC 5022 is used.

Parameters

• -c, --change

  Change some settings; that is, reconfiguration of an item (or several items)

  The switch takes no arguments.

• -e, --erase

  Erase some settings; that is, deconfiguration of an item (or several items).

  The switch takes no arguments.

• --host

  States a computer name. Examples of valid syntaxes: 203.0.113.10, 2001:db8:2164:2006::10, mx-design.se.aastra.com.

  The switch requires an argument. The argument is single-valued.

• -i, --initiate

  Initiate some settings; that is, make initial configuration of an item (or several items).

  The switch takes no arguments.

• -l, --lim

  LIM number (Service node server number). The LIM numbers that are allowed are 1-124.

  Examples of valid syntax: 2 or 1,3..5,124

  The switch requires an argument. The argument can be single, comma-separated list or sequence.

• --name

  Name or denomination of a Media server resource. Accepted argument length is 1 to 20 characters. If omitted, the default will be the identity set in the --media-gateway parameter of the media_gateway_config command, ; for example, 1A or 14B.

  The switch requires an argument. The argument is single-valued.

• --port

  Port number. Default port number is 5090.

  The switch requires an argument. The argument is single-valued.

• -p, --print

  Print all or some settings; that is, print configuration of an item, several items, or all items. The switch takes no arguments.

• --service-name

  The parameter controls activation of a SIP/MSCML based interface to the Media Server, for a specific streaming audible message service. Service name of the service supported by the Media Server. Allowed values are SOI, RVA, MOH or TS.

  SOI is Streaming On Idle,

  RVA is Recorded Voice Announcement (and Music On Wait),

  MOH is Music On Hold,

  TS is Tone Sending, but is not supported (only for test).

  Accepted argument length is 2 to 3 characters. The switch takes an optional argument. The argument can be a comma-separated sequence.

• --symbolic-name

  Symbolic name of the resource. Optional description or identity of a media server.

  It is recommended to only use one word for symbolic name, but if the symbolic name contains more than one word, and the words are separated by space characters, quote characters (“...“) MUST be used to surround the complete symbolic name. One reason is Regeneration functions.

  Accepted argument length is 1 to 20 characters.

  The switch requires an argument. The argument is single-valued.

• -v, --verbose

  Turn on verbose output (that is,. progress information) to standard error.

  The switch takes no arguments.

Examples

• Print out all configured media servers.

  media_server -p

• Specify media server for use in lim 1.

  media_server -i -l 1 --host lim1.site.com --service-name SOI

• Specify media server for use in lim 1.

  media_server -i -l 1 --name ms_john --host 203.0.113.53 --service-name SOI

• Specify a media server for use in lim 1, using the SIP/MSCML interface for the service Streaming On Idle service.

  media_server -i -l 1 --name strms --host 203.0.113.53 --service-name soi

• Specify media server for use in lim 1, 2 and 3 with the service Streaming On Idle.

  media_server -i -l 1..3 --name ms_james --host 203.0.113.55 --service-name SOI

• Specify media server for use in all lims, with services Music On Hold and RVA, that is,. the -l parameter shall be omitted. IPv4 addresses shall be used.

  media_server -i --name ms_james --host 203.0.113.55 --service-name MOH,RVA

• Specify media server (the same as in previous example) for use in all LIMs, with services Music On Hold and RVA, that is,. the -l parameter shall be omitted. IPv6 addresses shall be used.

  media_server -i --name ms_james --host 2001:db8:2164:2006::1 --service-name MOH,RVA

• Specify media server for use in lim 2 with the service Streaming On Idle.

  media_server -i -l 2--name ms_otto --host mediaserver.company.com --port 5090 --symbolic-name "MS Otto in Oslo” --service-name SOI

• Change symbolic name of media server ms_john

  media_server -c --name ms_john --symbolic-name Stockholm

• End the media server ms_john

  media_server -e --name ms_john