Reference > How to Define a New Port

How to Define a New Port

Edit the portNumberToPortName.xml file to define a new port:

  1. In the Adapter Management window (Managers > Data Flow Management > Adapter Management), search for the portNumberToPortName.xml file: click the Find resource button and enter portNumberToPortName.xml in the Name box. Click Find Next, then click Close.

    The file is selected in the Resources pane and the file contents are displayed in the View pane.

    For details about this file, see portNumberToPortName.xml File.

  2. Add another row to the file and make changes to the parameters:

    <portInfo portProtocol="xxx" portNumber="xxx" portName="xxx" discover="0" cpVersion="xx"/>

    Parameter Description
    portProtocol The network protocol used for discovery (udp or tcp).

    The port number to be discovered.

    This attribute may be a number or a range. Ranges may be separated by commas or dashes or both. For example: "10, 21, 45", "10-21", or "10-21, 45, 110".

    portName The name that is to be displayed for this port.

    1. This port must be discovered.

    0: This port should not be discovered.


    Use this parameter when you want to export the portNumberToPortName.xml file to another UCMDB system with the Package Manager. If the portNumberToPortName.xml file on the other system includes ports for this application but does not include the new port you want to add, the cpVersion attribute ensures that the new port information is copied to the file on the other system.

    The cpVersion value must be greater than the value that appears in the root of the portNumberToPortName.xml file.

    For example, if the root cpVersion value is 3:

    <portList parserClassName="com.hp.ucmdb.discovery. library.communication.downloader.cfgfiles. KnownPortsConfigFile" cpVersion="3">

    the new port entry must include a cpVersion value of 4:

    <portInfo portProtocol="udp" portNumber="1" portName="A1" discover="0" cpVersion="4"/>

    Note If the root cpVersion value is missing, you can add any non-negative number to the new port entry.

    This parameter is also needed during Content Pack upgrade. For details, see How to Use the cpVersion Attribute to Verify Content Update.