Adding Application Recognition Modules

Native and Nonnative PDLMs

A native PDLM is a PDLM that is embedded within the Cisco IOS software. You receive it automatically along with the Cisco IOS software.

A nonnative PDLM is not embedded within the Cisco IOS software. You can download it individually from Cisco.com.

Separate Version Numbers

There are separate version numbers associated with the NBAR software and the Cisco IOS software. These version numbers are used together to maintain the PDLM version.

• PDLM version--This is the version of the PDLM (either native or nonnative).
• Cisco IOS NBAR software version--This is the version of NBAR that resides with the Cisco IOS software.

Note	Each nonnative PDLM also contains the Cisco IOS NBAR software version in which the PDLM was created.

Internal Module Names

Both the native and nonnative PDLMs contain internal module names. These internal module names are unique and independent. They are used to indicate the protocol that the PDLM module represents (for example, BitTorrent or DirectConnect), and they are used to control the module version number (for example, module version 3).

Required Conditions

In order for a PDLM (either native or nonnative) to be downloaded or overridden, both of the following conditions much be met:

• The module version of the PDLM being downloaded must be higher than the module version currently installed.

For example, if a PDLM called BitTorrent.pdlm (with the internal module name "bittorrent") is currently at version 3, the resident PDLM (either native or nonnative) with the same internal module name ("bittorrent) is overridden as long as the module version is either 1 or 2.

• The Cisco IOS NBAR software version of the PDLM must be less than or equal to the Cisco IOS NBAR software version of the Cisco IOS image.

Note	To display the Cisco IOS NBAR software version (of the Cisco IOS image), use the show ip nbar version command. For more information about the show ip nbar version command, see the Cisco IOS Quality of Service Solutions Command Reference.

A PDLM is used to add support for a protocol that is currently not available as part of the Cisco IOS software. A PDLM extends the functionality of NBAR by enabling NBAR to recognize additional protocols on the network.

To download (install) a PDLM, perform the following steps.

Each PDLM has specific Cisco IOS release requirements and specific restrictions that you need to consider before you download a PDLM. These requirements and restrictions, and other helpful information for installing a particular PDLM, are described in a series of PDLM readme files.

To view a list of currently available PDLMs, or to view the readme files for each PDLM, go to the following URL (Cisco login required):

http://www.cisco.com/pcgi-bin/tablebuild.pl/pdlm

Note	Use the PDLM readme files in conjunction with the information included in this module.

After you download the PDLM, you may want to verify that the PDLM is now on your network. You may also want to check if there are earlier versions of the PDLM already on your network.

To display information about the downloaded PDLMs, perform the following steps.

In the following example. the Citrix PDLM is downloaded to the router from flash memory:

Router> enable

Router# configure terminal

Router(config)# ip nbar pdlm flash://citrix.pdlm

Router(config)# end

You can use the output of the show ip nbar pdlm command and the show ip nbar versioncommand to verify information about the downloaded PDLMs on your network.

Sample show ip nbar pdlm Command Output

In this example of the show ip nbar pdlm command, the Citrix PDLM has been loaded from flash memory:

Router# show ip nbar pdlm
 
The following PDLMs have been loaded:
flash://citrix.pdlm

Sample show ip nbar version Command Output

The following is sample output from the show ip nbar versioncommand:

Router# show ip nbar version
NBAR software version:  3
1   base                 Mv: 2
2   ftp                  Mv: 2
3   http                 Mv: 7, Nv: 3; slot1:http_vers.pdlm
4   static-port          Mv: 6
5   tftp                 Mv: 1
6   exchange             Mv: 1
7   vdolive              Mv: 1
8   sqlnet               Mv: 1
9   rcmd                 Mv: 1
10  netshow              Mv: 1
11  sunrpc               Mv: 2
12  streamwork           Mv: 1
13  citrix               Mv: 5
14  napster              Mv: 2
15  fasttrack            Mv: 2
16  gnutella             Mv: 1
17  kazaa                Mv: 6, Nv: 3; slot1:kazaa2_vers.pdlm
18  custom-protocols     Mv: 1
19  rtsp                 Mv: 1
20  rtp                  Mv: 2
21  mgcp                 Mv: 1
22  skinny               Mv: 1
23  h323                 Mv: 1
24  sip                  Mv: 1
25  rtcp                 Mv: 1

The table below describes the fields shown in the display.