Feedback
Contents
Cisco Media Services Proxy
media-proxy services
To configure a Media Proxy Services (MSP) profile and associate the corresponding service parameters, use the media-proxy services command in global configuration mode. To remove the MSP profile for a given flow, use the no form of this command.
Usage Guidelines
You can use the media-proxy services command to configure MSP profiles that can then be attached to the flow. Attaching an MSP profile to a flow determines the services that have to be applied to a given flow. You can configure a maximum of 1024 MSP profiles on any device. Each profile can have corresponding service parameters associated with each service.
- metadata--Enters media proxy services metadata configuration mode, where the params metadata-param-name keyword-argument pair allows you to associate the metadata attributes configured in the specified template with the flow.
- rsvp--Enters media proxy services RSVP configuration mode, where the params rsvp -param-name keyword-argument pair allows you to associate the RSVP parameters configured in the specified template with the flow.
MSP profiles can be attached to the media flow either globally or per interface. If you attach a profile globally, RSVP and metadata attributes in the MSP profile are associated to all the flows identified. If you attach a profile to an interface, RSVP and metadata attributes that are configured in the profile are associated with each unique flow identified on that interface. Use the media-proxy services profile profile-name command in global configuration mode to attach the MSP profile globally. Use the media-proxy services profile profile-name command in interface configuration mode to attach the MSP profile on a per-interface basis.
Examples
The following example shows how to configure an MSP profile and associate the metadata and RSVP parameters with it:
Device(config)# media-proxy services profile p1 Device(config-ms)# metadata Device(config-ms-md)# params m1 Device(config-ms-md)# exit Device(config-ms)# rsvp Device(config-ms-rsvp)# params rs1 Device(config-ms-rsvp)# exit
Related Commands
| Command | Description |
|---|---|
|
media-proxy services metadata |
Configures metadata attributes that can be applied to a flow that has been automatically identified by MSP. |
|
media-proxy services rsvp |
Configures RSVP parameters that can be applied to a flow that has been automatically identified by MSP. |
|
profile flow |
Enables MSP. |
media-proxy services metadata
To manually configure metadata attributes that can be applied to a flow that has been automatically identified by Media Services Proxy (MSP), use the media services metadata command in global configuration mode. To remove the metadata attributes that are configured manually, use the no form of this command.
Usage Guidelines
By default, metadata attributes are automatically gleaned with the device and flow identification. You can use the media-proxy services metadata command to manually configure metadata attributes. Any metadata attribute configured manually overrides the automatic method of identification.
- application name application-name [vendor vendor-name version version-number]--Configures the name of the application, the vendor, and the version number.
- bandwidth bw-kbps--Configures the bandwidth of the flow, in kb/s.
- clock-frequency bp/s--Sets the desired clock rate, in bits per second (bp/s).
- cname name--Configures the cannonical name. Consists of the user and domain name in one of the following formats: user@example.domain.com or user@10.10.10.1.
- default parameter--Sets the specified parameter to its default value.
- domain-name domain--Configures the domain name of the application.
- email email-id--Configures the email ID of the user.
- mime-type type--Configures the Multipurpose Internet Mail Extensions (MIME) type of the flow.
- payload-type type--Configures the payload type for a given flow.
- session-id id--Configures an identifier for the established session.
- ssrc value--Configures the synchronization source (SSRC) value for a given flow. Valid range is from 0 to 4294967295.
- username name--Configures the user name.
Examples
The following example shows how to manually configure metadata attributes that can be applied to a flow:
Device> enable Device# configure terminal Device(config)# media-proxy services metadata mt1 Device(config-ms-md)# application name app1 Device(config-ms-md)# bandwidth 10000 Device(config-ms-md)# payload-type 7 Device(config-ms-md)# session-id 23
media-proxy services rsvp
To manually configure Resource Reservation Protocol (RSVP) parameters that can be applied to a flow that has been automatically identified by Media Services Proxy (MSP), use themedia-proxy services rsvp command in global configuration mode. To remove the manually configured RSVP parameters, use the no form of this command.
Usage Guidelines
By default, RSVP parameters are automatically gleaned with the device and flow identification. You can use the media-proxy services rsvp command to manually configure RSVP parameters. The RSVP parameters that are signaled from the endpoints are overridden by the manually configured RSVP parameters.
Configuring the media-proxy services rsvp command places the device in media proxy services RSVP configuration mode. You can enter the following commands for configuring RSVP parameters, as required:
- bandwidth bw--Configures the bandwidth, in kilobits per second (kb/s).
- max-burst burst-rate--Configures the largest amount of data allowed in a flow, in kilobytes (KB). Valid range is from 1 to 65535.
- peak-rate rate--Configures the peak rate, in kbps, for a given flow.
- priority {defending defend-value | premption prempt-value}--Configures the defending and the preemption priority for the flow.
Defending priority is the priority that overtakes the preemption priority. After a flow has been admitted, the preemption priority becomes irrelevant. Instead, the defending priority of the flow is compared with with the preemption priority of new flows. The valid range is from 1 to 7.
Preemption priority is the priority of the new flow that is compared with the defending priority of previously admitted flows. Higher values represent higher priority. The valid range is from 1 to 7.
profile flow
To enable Media Services Proxy (MSP), use the profile flow command in global configuration mode. To disable MSP, use the no form of this command.
Syntax Description
Usage Guidelines
Enabling MSP facilitates the automatic identification of media endpoints. If you configure the profile flow command without any keywords, all protocols are enabled by default. To enable an individual protocol, use the profile flow command with the required protocol in the protocol-name argument.
profile flow port-map
To configure user-defined port numbers for flow and device identification protocols in Media Services Proxy (MSP), use the profile flow port-map command in global configuration mode. command in global configuration mode. To disable user-defined port numbers for flow and device identification protocols in MSP, use the no form of this command.
Syntax Description
Usage Guidelines
The port-number argument is either a UDP or TCP port number depending on the protocol specified in the command. You can specify up to 16 port numbers in one command line.
show profile device
To display details pertaining to endpoints that are automatically identified by Media Services Profile (MSP), use the show profile device command in privileged EXEC mode.
Examples
The following is sample output from the show profile device command:
Device# show profile device MAC Address Interface Device class Device Name Device Vendor ============== ========== ================== ============ ============== 0040.8ca7.bfb6 Gi2/23 Surveillance-Camera AXIS-Camera AXIS COMMUNICATIONS =========================================================================================
The table below describes the significant fields shown in the display.
show profile flow
To display information pertaining to media flow that has been automatically identified by Media Services Proxy (MSP), use the show profile flow command in privileged EXEC mode.
Examples
The following is sample output from the show profile flow command:
Device# show profile flow
Source-IP sPort Dest-IP dPort protocol Media Services profile
10.1.1.1 2000 10.2.2.2 2001 UDP msp_service_A
10.1.1.4 3000 10.2.2.4 2001 UDP msp_service_B
Device# show profile flow statistics Input Packets: SIP : 0 RTSP : 0 H323 : 0 H245 : 0
Table below describes significant fields in the display:
| Table 2 | show profile flow Field Descriptions |
|
Field |
Description |
|---|---|
|
Source-IP |
IP address of the device from where the flow is identified. |
|
sPort |
Source port of the device from where the flow is identified. |
|
Dest-IP |
Destination IP address of the device to where the flow is targeted. |
|
dPort |
Destination port of the device to where the flow is targeted. |
|
protocol |
Transport protocol in use-TCP or UDP. |
|
Media Services Profile |
MSP profile associated with the flow. |
|
Input Packets |
Number of input packets for each protocol. |