DO NOT SHARE THESE DOCS WITH CUSTOMERS!

This is an LA release that will only be provided to a select number of PLM-sanctioned customers (PDFs only). Contact PLM for details.

Overview

Prior to SBC 9.0, the SBC Manager of the EMS is dependent on the REST services provided by the EMA. If the EMA is disabled, you cannot configure the SBC from the EMS using the SBC Manager.

To overcome this problem, the EMA is segregated into three major components:

Independent EMA Components

EMA ComponentFunction
CoreAll of the existing EMA GUI options and functions, except Live Monitor and CDR Viewer options.
TroubleshootingLive Monitoring, CDR Viewer, and the "All" perspective in the SBC main screen.
RESTProvides REST APIs to support SBC Manager in the EMS. When the REST component is disabled, you cannot configure the SBC from the EMS, using the SBC Manager.

Note

If you upgrade the EMA from a pre-9.0 version to 9.0 or higher, all the components are enabled. However, if you upgrade the EMA from 9.0 to higher versions, the state of the components in the upgraded version remains the same as that of the old version.

Note

When you disable the EMA Core/Management and enable the Troubleshooting component, the following restrictions apply to Sign In screens and other user interfaces:

  • For Admin, Operator and Field Service user roles, the Troubleshooting module appears in Classic workspace; the SBC displays the Home/Troubleshooting (excludes Dashboard, but includes Live Monitor), and the All perspective.
  • For user roles such as CALEA and Security Auditor, the SBC displays an error.


Configure EMA Components Using CLI

To disable/enable EMA components from the CLI, the following enhancements are available:

  • The parameter ema is added under system admin. The child parameters of ema, each with the disable/enable options, are as follows:
    • enableCoreEMA
    • enableREST
    • enableTS
  • To display the status of the EMA components, the parameter ema, with its child parameters, are available under system admin of the show commands.

Command Syntax

To disable/enable the EMA components, use the following syntax:

% set system admin <system_name>
  ema
    enableCoreEMA <disabled | enabled>
    enableREST <disabled | enabled>
    enableTS <disabled | enabled>


To display the status of the EMA components, use the following syntax:

  • Within the "configure" mode:

    % show system admin <system_name> ema <enableCoreEMA | enableREST | enableTS>
  • Outside of the "configure" mode:

    > show table system admin <system_name> ema <enableCoreEMA | enableREST | enableTS>
Note

If you do not provide the name of the EMA component, the output displays the status of all the three components.

Command Parameters

Parameter Description Table

ParameterLength/RangeDefaultDescriptionM/O
emaN/AN/AThe object encapsulating the three EMA components.O
enableCoreEMA
N/Aenabled

Use this parameter to disable or enable the Core EMA component.

  • disabled
  • enabled (default)
O
enableREST
N/Aenabled

Use this parameter to disable or enable the REST API services provided by the EMA for SBC configuration (using the SBC Manager of the EMS).

  • disabled
  • enabled (default)
O
enableTS
N/Aenabled

Use this parameter to disable or enable the Troubleshooting component of the EMA.

  • disabled
  • enabled (default)
O

Configuration Examples

Tip

The SBC is enhanced to enable/disable these components independently; the state of one component does not affect the function of the other components. For using the full capabilities of the EMA, Ribbon recommends enabling all the components simultaneously.

You can disable/enable the components during installation, or after the installation. By default, all the components are enabled. For the post-installation changes to take effect, restart the application.


To configure the EMA components, use the following example:

% set system admin REDGRAPE-SA ema enableCoreEMA enabled enableREST disabled enableTS enabled


To display the status of the EMA components, use the following example:

  • Within "configure" mode:

    % show system admin REDGRAPE-SA ema
    enableREST    enabled;
    enableCoreEMA enabled;
    enableTS      enabled;
    [ok][<YYYY-MM-DD HH:MM:SS>]
  • Outside "configure" mode:

    > show table system admin REDGRAPE-SA ema
    enableREST    enabled;
    enableCoreEMA enabled;
    enableTS      enabled;
    [ok][<YYYY-MM-DD HH:MM:SS>]