2 Oracle ESBC Service Chaining

The Oracle Enterprise Session Border Controller (ESBC) can be deployed as a guest VM on the E100 appliance. The ESBC is instantiated as a small-footprint VM using 4GB RAM, 2 cores, and 2 Virtio-based media ports. This section covers how to install the VM through initial sign-on, as well as configure it.

Install ESBC VM on E100

Before installing ESBC on the E100, you must do the following:

  • ESBC VM should be installed on the LAN side. The port used to bridge ESBC should not be part of a bypass pair.
  • VLANs cannot be configured on the port connecting the ESBC.
  • You can find the XML file in this release's software zip file for the Oracle Talari E100 platform. Then, download the ESBC KVM image file from OSDC or MOS.
  • Disable service on this Oracle Talari E100 appliance.
  • Navigate to Configure, Service Chaining page.
  • Stop any running VMs, and then uninstall them. Refer to the VM Management section for details.
  • Click on the Restore Interfaces option. If the previous install failed due to unsupported installs, you may need to clean up using the factory default option.
To install:
  1. On the Service Chaining page, select ESBC from the VM drop-down.
  2. Select LAN side.
  3. Select the Interface number used by this guest VM.
  4. Upload the esbc.xml file you downloaded from MOS by doing the following:
    1. Select the esbc.xml file from the file browser
    2. Click on OK.
    3. Click on Upload.
  5. Upload the ESBC image file in qcow2 format with a qcow2 file extension by doing the following:
    1. Select the file from the file browser.
    2. Click on OK.
    3. Click on Upload.
  6. Click on Install.
The ESBC VM should be running now. Any errors will be reported in /home/talariuser/log/APN_webconsole.log

Access ESBC VM

After installing, follow these steps to sign into the ESBC VM from your local system. This procedure explains how to use vncviewer to access the ESBC VM.

  1. SSH into the E100 Appliance as talariuser.
    ssh  -X talariuser@10.75.134.24
    password
  2. Enter the following command to find the vncviewer connector:
     sudo virsh vncdisplay esbc
    127.0.0.1:0
  3. Enter the following command to start the vncviewer:
    vncviewer 127.0.0.1:0
    Note: Use <Shift>PageUp or <Shift>PageDown to scroll up or down in vncviewer
    esbc password:acme 
    Enter new Password: <ESBC Password>
    Confirm new Password: <ESBC Password>
    enable password: packet
    Enter new Password: <ESBC Password>
    Confirm new Password: <ESBC Password>
    Command to enable debug and get in to shell
    debug-enable
    Password: <ESBC Password>
    shellPassword: <ESBC Password>
    exit

Interface Mapping Corrections on ESBC VM

This section explains how to make corrections to interface mapping on ESBC VM.

Use the following command to show the current interface mapping on the ESBC

show interfaces mapping

Example:

ESBC1# show interfaces mapping
Interface Mapping Info
-------------------------------------------
Eth-IF MAC-Addr Label
wancom0 52:54:00:32:F4:65 #generic
wancom1 52:54:00:56:7C:31 #generic
s0p0 52:54:00:B2:E7:C6 #generic
wancom2 FF:FF:FF:FF:FF:FF #dummy
spare FF:FF:FF:FF:FF:FF #dummy
s1p0 FF:FF:FF:FF:FF:FF #dummy
s0p1 FF:FF:FF:FF:FF:FF #dummy
s1p1 FF:FF:FF:FF:FF:FF #dummy
s0p2 FF:FF:FF:FF:FF:FF #dummy
s1p2 FF:FF:FF:FF:FF:FF #dummy
s0p3 FF:FF:FF:FF:FF:FF #dummy
s1p3 FF:FF:FF:FF:FF:FF #dummy

Note:

Note that s1p0 does not show any valid MAC Address.

Find the sbWAN MAC interface name (wancom1 in this example) in the mapping. You can swap that interface with s1p0 with the following commands:

interface-mapping
 swap wancom1 s1p0

Example:

SBC1# interface-mapping 
ESBC1(interface-mapping)# 
ESBC1(interface-mapping)# swap wancom1 s1p0
Interface Mapping Info after swapping
-------------------------------------------
Eth-IF MAC-Addr Label
wancom0 52:54:00:32:F4:65 #generic
wancom1 FF:FF:FF:FF:FF:FF #dummy
s0p0 52:54:00:B2:E7:C6 #generic
wancom2 FF:FF:FF:FF:FF:FF #dummy
spare FF:FF:FF:FF:FF:FF #dummy
s1p0 52:54:00:56:7C:31 #generic
s0p1 FF:FF:FF:FF:FF:FF #dummy
s1p1 FF:FF:FF:FF:FF:FF #dummy
s0p2 FF:FF:FF:FF:FF:FF #dummy
s1p2 FF:FF:FF:FF:FF:FF #dummy
s0p3 FF:FF:FF:FF:FF:FF #dummy
s1p3 FF:FF:FF:FF:FF:FF #dummy
Changes could affect service, and Requires Reboot to become effective.
Continue [y/n]?: y
WARNING: This change requires a reboot to become effective.
reboot