Working with the interface-mapping branch

Interface identification on the Oracle Communications Session Border Controller is based on a system-level file called MACTAB that maps interface MAC addresses to interface naming that can be applied within Oracle Communications Session Border Controller configuration. In most cases, users retain the default mapping. The interface-mapping, show command provide access to commands that allow the user see, change and even locate each interface based on this mapping. The MACTAB file is stored in the /boot folder. The MACTAB file ensures that interface mapping is persistent, and therefore usable, by your configuration regardless of changes to the system.

The interface-mapping, show command displays the current mapping. An example of a MACTAB file that a user has configured is provided below.

ORACLE(interface-mapping)#show
Interface Mapping Info
============================================================
Eth-IF       MAC-Addr                Label
wancom0      00:16:3E:30:00:2A    # ctrl port, onboard MAC
wancom1      00:16:3E:30:00:2B    # 2nd ctrl port, onboard MAC
s0p0         00:16:3E:30:00:2C    # First media interface
s1p0         00:16:3E:30:00:2D    # Second media interrface
============================================================

interface-mapping

The following table lists the interface-mapping commands along with their descriptions.

Command	Description
interface-mapping show	Display the existing content of /boot/mactab file, with the mapping information of all the available Ethernet Interface Names versus Physical Interface MAC addresses, along with any customer provided label information.
interface-mapping locate <ethernet if name> <seconds>	Lets you visually locate the Ethernet media interface. One way to achieve this is to flash the LED of the physical interface when its device name is located. This parameter indicates, in seconds, when the flashing occurs on the LED.
interface-mapping label <ethernet if name> labeling text	Lets you label the Ethernet interface identified by <eth-if-name> with a text string you define. For example, you can use a label that is meaningful for your network layout. This label is stored and then displayed as # string after the MAC address for the Ethernet interface in the /boot/mactab file.
interface-mapping delete <ethernet if name>	Delete an unused Ethernet interface. The unused Ethernet interface could be result of changing network configuration. For example, if you replace an old NIC with a new one, the system writes the new one into mactab file, but does not delete the old one. A confirmation step appears with warning message. When you confirm the action, this entry is deleted from /boot/mactab file.
interface-mapping swap <ethernet if name1> <ethernet if name2>	Swap the mapping of Ethernet interface names against the available MAC physical interfaces. For example, you can first execute the interface-mapping show command to display the current information. interface-mapping show wancom0 00:16:3E:30:00:2A # control port, onboard MAC wancom1 00:16:3E:30:00:2B # 2nd control port, onboard MAC s0p0 00:16:3E:30:00:2C # PCI left side s1p0 00:16:3E:30:00:2D # PCI right side Then you can execute the interface-mapping swap command. interface-mapping swap s0p0 s1p0 wancom0 00:16:3E:30:00:2A # control port, onboard MAC wancom1 00:16:3E:30:00:2B # 2nd control port, onboard MAC s0p0 00:16:3E:30:00:2D # PCI right side s1p0 00:16:3E:30:00:2C # PCI left side A warning message appears. Once you confirm the action, the MAC addresses and their corresponding labels are swapped in the /boot/mactab/file.

Note:

The delete and swap commands require a reboot to activate the new MACTAB.