Diameter Signaling Router Getting Started

46
Oracle ® Communications Diameter Signaling Router Getting Started Release 8.3 E88995 September 2018

Transcript of Diameter Signaling Router Getting Started

Page 1: Diameter Signaling Router Getting Started

Oracle® CommunicationsDiameter Signaling Router Getting Started

Release 8.3

E88995

September 2018

Page 2: Diameter Signaling Router Getting Started

Oracle Communications Diameter Signaling Router Getting Started, Release 8.3

E88995

Copyright © 2015, 2018, Oracle and/or its affiliates. All rights reserved.

This software and related documentation are provided under a license agreement containing restrictions onuse and disclosure and are protected by intellectual property laws. Except as expressly permitted in yourlicense agreement or allowed by law, you may not use, copy, reproduce, translate, broadcast, modify, license,transmit, distribute, exhibit, perform, publish, or display any part, in any form, or by any means. Reverseengineering, disassembly, or decompilation of this software, unless required by law for interoperability, isprohibited.

The information contained herein is subject to change without notice and is not warranted to be error-free. Ifyou find any errors, please report them to us in writing.

If this is software or related documentation that is delivered to the U.S. Government or anyone licensing it onbehalf of the U.S. Government, then the following notice is applicable:

U.S. GOVERNMENT END USERS: Oracle programs, including any operating system, integrated software,any programs installed on the hardware, and/or documentation, delivered to U.S. Government end users are"commercial computer software" pursuant to the applicable Federal Acquisition Regulation and agency-specific supplemental regulations. As such, use, duplication, disclosure, modification, and adaptation of theprograms, including any operating system, integrated software, any programs installed on the hardware,and/or documentation, shall be subject to license terms and license restrictions applicable to the programs.No other rights are granted to the U.S. Government.

This software or hardware is developed for general use in a variety of information management applications.It is not developed or intended for use in any inherently dangerous applications, including applications thatmay create a risk of personal injury. If you use this software or hardware in dangerous applications, then youshall be responsible to take all appropriate fail-safe, backup, redundancy, and other measures to ensure itssafe use. Oracle Corporation and its affiliates disclaim any liability for any damages caused by use of thissoftware or hardware in dangerous applications.

Oracle and Java are registered trademarks of Oracle and/or its affiliates. Other names may be trademarks oftheir respective owners.

Intel and Intel Xeon are trademarks or registered trademarks of Intel Corporation. All SPARC trademarks areused under license and are trademarks or registered trademarks of SPARC International, Inc. AMD, Opteron,the AMD logo, and the AMD Opteron logo are trademarks or registered trademarks of Advanced MicroDevices. UNIX is a registered trademark of The Open Group.

This software or hardware and documentation may provide access to or information about content, products,and services from third parties. Oracle Corporation and its affiliates are not responsible for and expresslydisclaim all warranties of any kind with respect to third-party content, products, and services unlessotherwise set forth in an applicable agreement between you and Oracle. Oracle Corporation and its affiliateswill not be responsible for any loss, costs, or damages incurred due to your access to or use of third-partycontent, products, or services, except as set forth in an applicable agreement between you and Oracle.

This documentation is in preproduction status and is intended for demonstration and preliminary use only. Itmay not be specific to the hardware on which you are using the software. Oracle Corporation and its affiliatesare not responsible for and expressly disclaim all warranties of any kind with respect to this documentationand will not be responsible for any loss, costs, or damages incurred due to the use of this documentation.

The information contained in this document is for informational sharing purposes only and should beconsidered in your capacity as a customer advisory board member or pursuant to your beta trial agreementonly. It is not a commitment to deliver any material, code, or functionality, and should not be relied upon inmaking purchasing decisions. The development, release, and timing of any features or functionalitydescribed in this document remains at the sole discretion of Oracle.

This document in any form, software or printed matter, contains proprietary information that is the exclusiveproperty of Oracle. Your access to and use of this confidential material is subject to the terms and conditionsof your Oracle Master Agreement, Oracle License and Services Agreement, Oracle PartnerNetworkAgreement, Oracle distribution agreement, or other license agreement which has been executed by you andOracle and with which you agree to comply. This document and information contained herein may not bedisclosed, copied, reproduced, or distributed to anyone outside Oracle without prior written consent ofOracle. This document is not part of your license agreement nor can it be incorporated into any contractualagreement with Oracle or its subsidiaries or affiliates.

Page 3: Diameter Signaling Router Getting Started

Contents

1 About the Help

The Online Help System.......................................................................................................................... 1-1

Help Organization .................................................................................................................................... 1-1

Documentation Admonishments ........................................................................................................... 1-4

2 My Oracle Support (MOS)

Emergency Response................................................................................................................................ 2-1

Locate Product Documentation on the Oracle Help Center Site ....................................................... 2-2

3 Introduction to the Diameter Signaling Router

Purpose of the Diameter Signaling Router solution............................................................................ 3-1

Diameter Signaling Router Functions.................................................................................................... 3-1

Diameter Signaling Router Components .............................................................................................. 3-4

OAM Servers..................................................................................................................................... 3-4

Message Processors .......................................................................................................................... 3-4

Integrated Diameter Intelligence Hub (IDIH).............................................................................. 3-5

Oracle Communications Services Gatekeeper (OCSG) .............................................................. 3-5

Virtual Network Functions Manager (VNFM)............................................................................. 3-5

Session Binding Repository (SBR).................................................................................................. 3-5

System Architecture.................................................................................................................................. 3-6

4 User Interface Introduction

User Interface Organization .................................................................................................................... 4-1

User Interface Elements................................................................................................................... 4-2

Main Menu Options ......................................................................................................................... 4-5

Missing Main Menu Options ................................................................................................................ 4-10

Common Graphical User Interface Elements ..................................................................................... 4-10

Supported Browsers....................................................................................................................... 4-10

System Login Page ......................................................................................................................... 4-11

Main Menu Icons............................................................................................................................ 4-12

Work Area Displays ....................................................................................................................... 4-13

Customizing the Splash Page Welcome Message...................................................................... 4-16

iii

Page 4: Diameter Signaling Router Getting Started

Column Headers (Sorting) ............................................................................................................ 4-16

Page Controls .................................................................................................................................. 4-16

Clear Field Control ......................................................................................................................... 4-17

Optional Layout Element Toolbar................................................................................................ 4-17

Filters................................................................................................................................................ 4-18

Pause Updates................................................................................................................................. 4-21

Max Records Per Page Controls ................................................................................................... 4-21

iv

Page 5: Diameter Signaling Router Getting Started

List of Figures

3-1 Diameter Signaling Router Diagram........................................................................................ 3-74-1 Oracle System Login................................................................................................................. 4-114-2 Paginated Table.......................................................................................................................... 4-144-3 Scrollable Table.......................................................................................................................... 4-144-4 Form Page................................................................................................................................... 4-154-5 Tabbed Pages.............................................................................................................................. 4-154-6 Tabbed Pages.............................................................................................................................. 4-154-7 Report Output............................................................................................................................ 4-164-8 Sorting a Table by Column Header......................................................................................... 4-164-9 Clear Field Control X................................................................................................................ 4-174-10 Optional Layout Element Toolbar........................................................................................... 4-184-11 Automatic Error Notification................................................................................................... 4-184-12 Examples of Filter Styles.......................................................................................................... 4-19

v

Page 6: Diameter Signaling Router Getting Started

vi

Page 7: Diameter Signaling Router Getting Started

List of Tables

1-1 Admonishments........................................................................................................................... 1-54-1 User Interface Elements.............................................................................................................. 4-34-2 Main Menu Options.................................................................................................................... 4-64-3 Main Menu Icons....................................................................................................................... 4-124-4 Example Action Buttons........................................................................................................... 4-174-5 Submit Buttons........................................................................................................................... 4-174-6 Filter Control Elements............................................................................................................. 4-19

vii

Page 8: Diameter Signaling Router Getting Started

viii

Page 9: Diameter Signaling Router Getting Started

1About the Help

The online help describes the functions of a diameter signaling router, and providesprocedures and explanations of the GUI used to configure the application components.The online help is updated with each major release of the software.

The Online Help SystemThe online help system:

• Provides a conceptual overview of the application, including its purpose,architecture, and functionality

• Describes the pages and fields on the GUI

• Describes tasks that can be performed using the GUI

• Provides descriptions of and recovery procedures for alarms and events

• Provides descriptions of and procedures for generating reports for measurementsand KPIs

• Explains system configuration and administration

The Getting Started section of the Help provides an overview of the application and adescription of how to use the Help. In this section you can find information about theapplication including a product overview, the system architecture, and functions.Additionally, the Getting Started section describes the common GUI featuresincluding user interface elements, main menu options, supported browsers, andcommon user interface widgets.

Note: Some content may refer to future functionality; if you do not seeinformation on your window that matches the Help contents, please contactyour Oracle Sales Representative or Customer Support.

Help OrganizationThe online help is organized into the following sections, each covering a differentaspect of the application. For a more detailed explanation of each GUI Menu item, see Main Menu Options.

Note: The items and order may vary depending on your installation'sconfiguration.

About the Help 1-1

Page 10: Diameter Signaling Router Getting Started

Getting Started

The Getting Started section of the Help provides an overview of the DSR, including aproduct overview, the system architecture, and functions. Additionally, this sectiondescribes common GUI features, including user interface elements, main menuoptions, supported browsers, and common user interface widgets.

Diameter

The Diameter section of the Help describes GUI pages nested under the Diametermenu. In this section you can find information about how to perform tasks that allowyou to manage the configuration and maintenance of Diameter components, includingLocal and Peer Nodes, Connections, Peer Routing Rules, Application Routing Rules,System and DNS Options, Topology Hiding, and Troubleshooting with IDIH Tracesand Options.

Diameter Common

The Diameter Common section of the Help explains how to use the DiameterCommon GUI pages to configure components used by more than one application,including the Dashboard (Metric Groups, Metric Threshold Configuration Sets,Dashboard network Elements, Dashboard Networks), Network Identifiers (MCCRanges, MCCMNC, and MCCMNC Mapping) , and MPs (Profiles and ProfileAssignments). The Help also describes the use of the Bulk Import and Exportfunctions for exporting Diameter, IPFE, MAP-Diameter Interworking, and applicationconfiguration data on demand and at scheduled intervals; and for importingconfiguration data from exported files.

Communication Agent

The Communication Agent (ComAgent) section of the Help describes GUI pages forCommunication Agent configuration and maintenance. This section containsinformation about configuring Remote Servers, Connection Groups, and RoutedServers; and information about maintaining configured Connections.

IP Front End (IPFE)

The IPFE section of the Help describes GUI pages for the IP Front End application.This section contains information about how to configure IPFE to distribute IPv4 andIPv6 connections from multiple clients to multiple Diameter Agent MessageProcessors (DA-MPs).

Diameter Mediation

The Diameter Mediation section of the Help describes GUI pages for DiameterMediation on how to configure and test Rule Templates, how to use the FormattingValue Wizard, and how to configure Rule Sets.

Policy and Charging Application (PCA)

The Policy and Charging Application section of the Help describes the GUI pages onthe NOAM and the SOAM for Policy DRA (P-DRA) functionality and OnlineCharging DRA (OC-DRA) functionality, as well as the Session Binding Repository.This section includes information about configuring General Options, SBR Databases,Access Point Names, SBR Database Resizing Plans, SBR Data Migration Plans, PCRFs,Binding Key Priority, PCRF Pooling and Sub-Pooling, Policy Clients, Suspect BindingRemoval Rules, Site Options, Network-Wide Options, OCSs, CTFs, OCS SessionsStates, Realms, Error Codes, Alarm Settings, and Congestion Options; viewingmaintenance data for the Session Binding Repository (SBR), SBR Database, and SBRDatabase Reconfiguration; and using the Policy Database Query tool.

Help Organization

1-2 Oracle Communications Diameter Signaling Router Getting Started

Page 11: Diameter Signaling Router Getting Started

The Policy and Charging Application (PCA) supports both Policy DRA (P-DRA)functionality and Online Charging DRA (OC-DRA) functionality. PCA was called P-DRA before the inclusion of OC-DRA functionality

Range-Based Address Resolution (RBAR)

The Range-Based Address Resolution section of the Help describes GUI pages for theRange-Based Address Resolution (RBAR) application. This section containsinformation about how to perform tasks that allow you to route Diameter end-to-endtransactions based on Diameter Application ID, Command Code, Routing Entity Type,and Routing Entity address ranges and individual addresses.

Full-Address Based Resolution (FABR)

The Full-Address Based Resolution section of the Help describes GUI pages for theFull-Address Based Resolution (FABR) application. This section contains informationabout how to perform tasks that allow you to resolve the designated Diameter server(IMS, HSS, LTE HSS, PCRF, OCS, OFCE, and AAA) addresses based on DiameterApplication ID, Command Code, Routing Entity Type, and Routing Entity addresses.

Session Binding Repository (SBR)

The Session Binding Repository Help section of the Help describes GUI pages for theSession Binding Repository (SBR) application. This section contains information abouthow to perform tasks that allow you to configure, edit system options, and elementsfor SBR-related elements. Additionally, on the NOAMP, you can to performmaintenance tasks, edit options, and view elements for SBR-related maintenanceelements.

Integrated Diameter Intelligence Hub (IDIH)

The IDIH section of the Help describes the configuration and use of the IntegratedDiameter Intelligence Hub (IDIH). Detailed information about selected Diametertransactions can be captured and transmitted to IDIH for further analysis and totroubleshoot issues while processing traffic within the routing appilcation.

DSR Administration

The Administration section describes architecture, functions, configuration, and toolsand utilities (IPsec, bulk import and export of configuration data, IDIH, and databasebackups); and provides references to other publications for more detailed information.

Alarms and KPIs

This section provides the details for alarms, events, and KPIs and includes actions youcan take to resolve an alarm or event.

Measurements

This section provides the details for measurements and includes actions you can taketo resolve an unusual Diameter measurement value.

Platform Operations, Administration, and Maintenance (OAM)

The Platform OAM section of the Help describes the Operation, Administration, andMaintenance, and the GUI pages nested under the Administration, Configuration,Alarms & Events, Security Log, Status & Manage, and Measurements menu options.OAM Help explains how to use these GUI pages to view and manage the basicoperation, administration, and maintenance for the application.

Machine to Machine Interface (MMI)

Machine to Machine Interface API describes the Machine to Machine Interface (MMI)for DSR. The DSR MMI is a RESTful (Representational State Transfer) interface

Help Organization

About the Help 1-3

Page 12: Diameter Signaling Router Getting Started

providing access to a broad range of Operations, Administration, and Maintenance(OAM) services that clients use to configure and manage the DSR. Resourcessupported include the Administration, Topology, Monitoring, and Diameter. Thisdocument is the comprehensive API reference guide to the RESTful services the DSRmakes available to clients through the DSR MMI. To access the MMI APIdocumentation through a direct URL access, without login, go to http://<IP addressof NOAM or SOAM>/raml/mmi.html. Or the MMI API documentation can beaccessed directly from the DSR GUI by clicking on the new MMI API Guide menuitem. API documentation can also be accessed by going to the latest DSR release onOHC at https://docs.oracle.com/en/industries/communications/diameter-signaling-router/index.html, downloading the MMI API Specification ZIP file, and accessing thehtml/mmi.html inside the ZIP file.

MMI allows you to access several applications including:

• Virtual Signaling Transfer Point (vSTP)

• Service Capability Exposure Function (SCEF) includes the OracleCommunications Services Gatekeeper (OCSG) sometimes referred to as APIGateway (APIGW)

• Virtual Network Functions Manager (VNFM)

Virtual Signaling Transfer Point (vSTP)

This section of Help describes the Virtual Signaling Transfer Point (vSTP) application,which uses signaling experience from both the Oracle Communication EAGLE STPand the vDSR products to build a common signaling platform for unified signalingsolutions.

Service Capability Exposure Function (SCEF)

This section of Help describes the SCEF application, which interacts with, andimpements control on, Internet of Things (IoT) devices. The SCEF is the key entitywithin the 3GPP architecture for service capability exposure that provides a means tosecurely expose the services and capabilities provided by 3GPP network interfaces.

Oracle Communications Services Gatekeeper (OCSG)

This section of Help is located in the appendix of the SCEF help section. OCSGconfiguration for the OCSG database server, admin server, and an application server isprovided in this section.

Virtual Network Functions Manager (VNFM)

The VNFM automates lifecycle operations for Virtual Network Functions (VNFs)under the control of the NFV Orchestrator. Two VNFs (one for the network OAM VNFand one for the signaling VNF) are required to deploy DSR. The DSR VNFMapplication helps deploy virtual DSRs quickly by automating the deployment process.

Documentation AdmonishmentsAdmonishments are icons and text throughout this manual that alert the reader toassure personal safety, to minimize possible service interruptions, and to warn of thepotential for equipment damage.

Documentation Admonishments

1-4 Oracle Communications Diameter Signaling Router Getting Started

Page 13: Diameter Signaling Router Getting Started

Table 1-1 Admonishments

Icon Description

Danger:

(This icon and text indicate the possibility ofpersonal injury.)

Warning:

(This icon and text indicate the possibility ofequipment damage.)

Caution:

(This icon and text indicate the possibility ofservice interruption.)

Topple:

(This icon and text indicate the possibility ofpersonal injury and equipment damage.)

Documentation Admonishments

About the Help 1-5

Page 14: Diameter Signaling Router Getting Started

Documentation Admonishments

1-6 Diameter Signaling Router Getting Started

Page 15: Diameter Signaling Router Getting Started

2My Oracle Support (MOS)

MOS (https://support.oracle.com) is your initial point of contact for all productsupport and training needs. A representative at Customer Access Support (CAS) canassist you with MOS registration.

Call the CAS main number at 1-800-223-1711 (toll-free in the US), or call the OracleSupport hotline for your local country from the list at http://www.oracle.com/us/support/contact/index.html. When calling, make the selections in the sequenceshown below on the Support telephone menu:

1. Select 2 for New Service Request

2. Select 3 for Hardware, Networking and Solaris Operating System Support

3. Select one of the following options:

• For Technical issues such as creating a new Service Request (SR), Select 1

• For Non-technical issues such as registration or assistance with MOS, Select 2

You will be connected to a live agent who can assist you with MOS registration andopening a support ticket.

MOS is available 24 hours a day, 7 days a week, 365 days a year.

Emergency ResponseIn the event of a critical service situation, emergency response is offered by theCustomer Access Support (CAS) main number at 1-800-223-1711 (toll-free in the US),or by calling the Oracle Support hotline for your local country from the list at http://www.oracle.com/us/support/contact/index.html. The emergency response providesimmediate coverage, automatic escalation, and other features to ensure that the criticalsituation is resolved as rapidly as possible.

A critical situation is defined as a problem with the installed equipment that severelyaffects service, traffic, or maintenance capabilities, and requires immediate correctiveaction. Critical situations affect service and/or system operation resulting in one orseveral of these situations:

• A total system failure that results in loss of all transaction processing capability

• Significant reduction in system capacity or traffic handling capability

• Loss of the system’s ability to perform automatic system reconfiguration

• Inability to restart a processor or the system

• Corruption of system databases that requires service affecting corrective actions

• Loss of access for maintenance or recovery operations

My Oracle Support (MOS) 2-1

Page 16: Diameter Signaling Router Getting Started

• Loss of the system ability to provide any required critical or major troublenotification

Any other problem severely affecting service, capacity/traffic, billing, andmaintenance capabilities may be defined as critical by prior discussion and agreementwith Oracle.

Locate Product Documentation on the Oracle Help Center SiteOracle Communications customer documentation is available on the web at the OracleHelp Center (OHC) site, http://docs.oracle.com. You do not have to register to accessthese documents. Viewing these files requires Adobe Acrobat Reader, which can bedownloaded at http://www.adobe.com.

1. Access the Oracle Help Center site at http://docs.oracle.com.

2. Click Industries.

3. Under the Oracle Communications subheading, click the OracleCommunications documentation link.

The Communications Documentation page appears. Most products covered bythese documentation sets will appear under the headings "Network SessionDelivery and Control Infrastructure" or "Platforms."

4. Click on your Product and then the Release Number.

A list of the entire documentation set for the selected product and release appears.

5. To download a file to your location, right-click the PDF link, select Save targetas (or similar command based on your browser), and save to a local folder.

Locate Product Documentation on the Oracle Help Center Site

2-2 Oracle Communications Diameter Signaling Router Getting Started

Page 17: Diameter Signaling Router Getting Started

3Introduction to the Diameter Signaling

Router

This section describes the purpose, functions, components, and system architecture ofthe Oracle Communications DSR application.

Purpose of the Diameter Signaling Router solutionThe DSR acts as a centralized core Diameter signaling layer that relieves LTE, IMS, and3G Diameter endpoints of routing, traffic management, and load balancing tasks; andprovides a single interconnection point to other networks.

This approach eliminates the Diameter/SCTP (or TCP) mesh that is created by havingdirect signaling connections between each network element. Having one or more hubsthat centralize the connection to all end nodes simplifies interoperability betweendifferent network elements and enhances network scalability. The resultingarchitecture reduces the cost and complexity of the core network and enables IPnetworks to grow incrementally to support increasing service and traffic demands. Italso facilitates network monitoring by providing a centralized vantage point in thesignaling network.

Diameter Signaling Router FunctionsThe Diameter Signaling Router (DSR) provides the following functions:

• Base Diameter Relay Agent: The DSR uses a Diameter Relay Agent to forward amessage to the appropriate destination based on the information contained in themessage.

• Core Routing and Load Balancing: The DSR creates a centralized Diametersignaling core that handles routing, traffic management, and load balancing tasks;and provides a single interconnect point to other networks.

The IP Front End (IPFE) can run in a DSR system to distribute traffic acrossconnections.

• DNS A and AAAA support: The DSR supports resolving host names using DNSA and AAAA queries based on the configured Peer IP address of the connectionwhen the peer IP address is not provisioned.

• Diameter Transport Function: The Diameter Transport Function is responsible formanaging the transport connections only on a single MP and relies on theDiameter Routing Function to perform distributed processing.

– Diameter Connection management: Reporting of Diameter Connection statuschanges.

Introduction to the Diameter Signaling Router 3-1

Page 18: Diameter Signaling Router Getting Started

The DSR supports multiple Diameter Connections to any Peer Node andmultiple Peer Nodes.

– SCTP and TCP transport protocols: The DSR supports both Stream ControlTransmission Protocol (SCTP uni-homing and multi-homing) andTransmission Control Protocol (TCP) based transport Connections.

– Message Processing: Processing of Diameter Peer-to-Peer messages (CER/CEA, DWR/DWA, DPR/DPA), and delivery of Diameter Request andAnswer messages from and to Diameter Peers and the Diameter RoutingFunction.

• Diameter Routing Function:

– Routing of Diameter Request and Answer messages to and from DiameterPeers (through the Diameter Transport Function) and DSR Applications.

‐ Peer Routing Rules: The DSR provides the ability to configure up to 1000Peer Routing Rules, in up to 100 Peer Route Tables, that define where toroute a Diameter message to an upstream Peer based upon Diametermessage content.

‐ Application Routing Rules: The DSR provides the ability to configureApplication Routing Rules, in Application Route Tables that are used bythe Diameter Routing Function to determine whether a receivedDiameter message is routed to a specific DSR application or routed to aDiameter Peer in the network. The Application Routing Rules are rulesbased upon the Diameter message Application ID, Command-Code,Destination-Realm/Host, and Origin-Realm/Host.

‐ Application Chaining: Application Routing Rules can be configured toallow more than one DSR Application to process the same DiameterRequest message. (The same message is not usually processed more thanonce by the same Application.)

‐ Processing of Diameter Connection status from the Diameter TransportFunction and status from DSR Applications for maintaining dynamicrouting configuration data.

‐ Message Rerouting: A Diameter Relay Agent is responsible for makingsure that Request messages are successfully delivered, and to choose analternate route if failures are encountered.

‐ Alternate Implicit Routing: Instead of a message being routeddirectly to an unavailable Peer Node, the message is routed on analternate implicit route that is chosen from a Route List that has beenconfigured for the Peer Node.

‐ Reroute on Answer: The DSR supports alternate routing of a Requestmessage when an Answer response is received with a configurederror code.

– Topology Hiding: Trusted Network Lists, Protected Networks, andConfiguration Sets for specific Diameter applications or any Diameterapplication are used for Diameter Topology Hiding functions.

– Shared Traffic Throttle Groups: Shows all TTGs defined as shared across thediameter routing network. TTGs can be shared between DSR Nodes in the

Diameter Signaling Router Functions

3-2 Oracle Communications Diameter Signaling Router Getting Started

Page 19: Diameter Signaling Router Getting Started

same network managed by a NOAM. Thus, each TTG is uniquely identifiedby its DSR Node.

– Diameter Message Copy: Copying of messages to a DAS can be triggered byPeer Routing Rules, Diameter Mediation, or a DSR Application. MessageCopy Configuration Sets provide the data required Diameter Message Copyfunctions.

– Next Generation Network Priority Service (NGN-PS) that allows NationalSecurity/Emergency Preparedness (NS/EP) users to make priority calls/sessions using public networks.

• Bulk Import and Export: The DSR provides functions for exporting some or all ofthe Diameter, Diameter Common, IPFE, and DSR Application configuration datafrom an NOAM or SOAM to a CSV file, editing the file, and importing the editedfile for inserting new configuration data, updating existing data, or deleting dataon a local OAM, as well as PCA. Exports can be scheduled periodically forspecified configuration data.

• Virtualization on Servers: Virtualization defines and executes virtual machines toallow multiple functional components of the DSR to be deployed on a singleserver, including TVOE, PMAC, SOAM, NOAM, DA-MP, IPFE, SDS (SOAM andNOAM), PCA (including SBR), and SS7 MP.

• Capacity and Congestion Status and Control: Functions are provided forperforming Connection capacity status and control, ingress message MPS control,and egress message throttling; and message processing, Connection, DSRApplication, and DA-MP congestion status.

• Diameter Mediation: The DSR provides configuration and application of rules thatmodify message processing behavior when conditions are met at specified triggerpoints in the message processing.

• Diameter Intelligence Hub: The Diameter Intelligence Hub (DIH) provides theability to troubleshoot Diameter transactions.

• Integrated Diameter Intelligence Hub: The Integrated Diameter Intelligence Hub(IDIH) provides the ability to troubleshoot Diameter transactions.

• DSR Switchover: The DSR servers operate in redundancy mode and supportautomatic failover to the standby server if the active server fails. Automaticfailover does not require manual intervention, but is restricted to NOAM, SOAM,active/standby DA-MPs, and SBRs.

• IPsec Support: The DSR supports transporting messages over Internet Protocolsecurity (IPsec) secure Connections.

• IPv4 and IPv6 Support: The DSR supports IPv6 and IPv4 IP address formats.

• AVP Removal: DSR supports the ability to remove AVPs from messages uponreceipt from a Peer Node and to remove AVPs from messages upon forwarding toa Peer Node via an AVP Removal List that identifies a list of AVPs that must beremoved.

• Static ETR Throttling: Static ETR Throttling allows the operator to limit the rate oftransactions that are forwarded to a particular Peer Node which are addressed toa particular Diameter Application ID. For each (Peer Node, Application ID)

Diameter Signaling Router Functions

Introduction to the Diameter Signaling Router 3-3

Page 20: Diameter Signaling Router Getting Started

ordered pair that you want to throttle, create a Traffic Throttle Point (TTP)attribute and assign it a Maximum ETR value.

• Peer Node reported congestion (DOIC): Supports the ability to modify the rate oftransactions forwarded to a Peer Node based upon Diameter Overload Requests(OLRs) it receives in Answer responses from the Peer Node.

• Dynamic Peer Discovery: Peer Discovery (also know as Dynamic Peer Discovery[DPD]) allows the user to discover remote hosts within user-defined Realms andto configure all required elements for successful routing of diameter trafficbetween the signaling router and those remote hosts. This configuration isdynamic and performs the configuration at the time the routing elements arecreated.

Diameter Signaling Router ComponentsA DSR is a group of signaling network elements (NE) composed of OAM servers andmessage processors. The NE can also contain database processors and the IntegratedDiameter Intelligence Hub (IDIH). See Figure 3-1.

OAM ServersOne or more pairs of Operation, Administration, and Maintenance (OAM) serversmake up the OAM component of the DSR. Each pair of servers has an Active/Standbyrelationship, or three servers in an Active/Standby/Spare relationship. The Activeserver in the pair controls the virtual IP (VIP) addresses that direct XMI and IMItraffic to the Active server.

The role of the OAM server is to provide a central operational interface and all OAMfunctions (for example, user administration, configuration data, databaseadministration, fault management, and upgrade functions) for the DSR under itscontrol. The OAM server replicates configuration data to and collects allmeasurements, events, alarms, and log data from all message processors within theDSR.

The OAM server provides an SNMP interface to an external EMS/NMS. Up to fiveSNMP destinations can be configured at the OAM level.

OAM architecture is described in System Architecture.

Message ProcessorsThe role of the Message Processors (MPs) is to provide the Diameter protocolmessaging interfaces and message processing support for DSR applications. NOAMsand SOAMs replicate configuration and provisioning data to the MPs, whichmeasurements, events, alarms, and log data to the OAM servers. There are two typesof message processors: Diameter Agent Message Processors (DA-MPs) and STP-MPs.

DA-MPs host the following DSR applications:

• Range Based Address Resolution (RBAR)

• Full Address Based Resolution (FABR)

• Policy and Charging Application (PCA)

• Virtual Signaling Transfer Point (vSTP)

• Service Capability Exposure Function (SCEF)

Diameter Signaling Router Components

3-4 Oracle Communications Diameter Signaling Router Getting Started

Page 21: Diameter Signaling Router Getting Started

Machine to Machine Interface (MMI) is a provisioning method that uses a RESTful(Representational State Transfer) interface to access OAM services.

The RBAR and PCA applications can run on the same DA-MP and RD-IWF.

PCA and GLA can run on the same DA-MP or on separate DA-MPs.

FABR and DM-IWF must run on the same DA-MP if both process the same DiameterRequest message (Application Chaining).

RBAR and DM-IWF must run on the same DA-MP if both process the same DiameterRequest message (Application Chaining).

IPFE runs as separate MPs.

Integrated Diameter Intelligence Hub (IDIH)The IDIH:

• Allows the user to create and manage trace filters on DSR to capture messagesneeded for troubleshooting service issues

• Presents traces to the user via the graphical visualization capabilities provided byIDIH

• Allows the user to filter, view, and store the results with IDIH

The IDIH feature allows the user to capture detailed information about selectedDiameter transactions and transmit this information to IDIH for further analysis. Theintegration of troubleshooting capabilities into the DSR product provides a high valueproposition for customers to be able to troubleshoot issues that might be identifiedwith the Diameter traffic transmitted to the DSR.

These troubleshooting capabilities can supplement other network monitoringfunctions provided by the customer's OSS and network support centers to helpquickly pinpoint the root cause of signaling issues associated with connections, peersignaling nodes, or individual subscribers.

Note: IDIH is not a replacement of the features in previous DIH releases.

Oracle Communications Services Gatekeeper (OCSG)Oracle Communications Services Gatekeeper (OCSG) sometimes referred to as APIGateway (APIGW) allows configuration for the OCSG database server, admin server,and an application server.

Virtual Network Functions Manager (VNFM)The VNFM automates lifecycle operations for Virtual Network Functions (VNFs)under the control of the NFV Orchestrator. Two VNFs (one for the network OAM VNFand one for the signaling VNF) are required to deploy DSR. The DSR VNFMapplication helps deploy virtual DSRs quickly by automating the deployment process.

Session Binding Repository (SBR)SBR provides a common database framework to host database solutions for native orcustom applications.

Diameter Signaling Router Components

Introduction to the Diameter Signaling Router 3-5

Page 22: Diameter Signaling Router Getting Started

System ArchitectureThe DSR can be deployed either as a core router that routes traffic between Diameterelements in the home network, or as a gateway router that routes traffic betweenDiameter elements in the visited network and the home network.

In DSR topology, the OAM server function is split into Network OAM (NOAM)servers and System OAM (SOAM) servers. A DSR with a pair of NOAM servers isconnected to multiple DSRs with SOAM servers in the network. Each DSR withNOAM servers is connected to one or more mated pairs of SOAM servers, or a tripletif using Policy Diameter Routing Agent (Policy DRA). The DA-MP servers reside witha pair of SOAM servers that interact directly with the MP servers on that DSR.

The architecture includes the following characteristics:

• A 3-tiered topology.

• A traffic signaling service to and from a collection of Diameter clients, servers, andagents.

• Each DSR supports:

– NOAM and SOAM servers operating in Active/Standby mode, or SOAM astriplet in Active/Standby/Spare mode

– Two Diameter Agent Message Processors (DA-MPs) operating in Active/Standby mode

– Additional MPs providing other functions such as IPFE, SS7, and Policy SBRdatabases

– Charging Session Binding Repository (SBR) databases

• The DA-MPs provide the Diameter message handling functions. A DA-MPcommunicates with all of its DA-MP Peers in the same DSR.

• DSRs are deployed in mated pairs for purposes of geo-redundancy. Properlyengineered systems do not exceed operating at 40% under normal conditions.

• The Integrated Diameter Intelligence Hub (IDIH) provides the ability to filter,access, and troubleshoot Diameter transactions.

Figure 3-1 provides an overview of the DSR architecture.

Diameter Signaling Router Topology

The role of the DSR NOAM server is network scope. The role of the DSR SOAM ismanaging a DSR Signaling NE.

As shown in Figure 3-1, there are NOAM servers, SOAM servers, and MP servers.

GUI screens can be used to configure and manage:

• On a DSR NOAM, network topology data (such as user accounts, networkelements, servers, and server groups) and network-wide DSR Applicationconfiguration data

• On a DSR SOAM, Diameter signaling data (such as Local Nodes, Peer Nodes,Connections, Route Groups, and Route Lists) and site-specific DSR Applicationdata.

System Architecture

3-6 Oracle Communications Diameter Signaling Router Getting Started

Page 23: Diameter Signaling Router Getting Started

Figure 3-1 Diameter Signaling Router Diagram

The MPs process the database updates from NOAM servers and SOAM servers andperform the real-time signaling. The MP servers also supply the Platform MEAL data,Diameter signaling MEAL data, and DSR Application MEAL data to SOAM servers.The SOAM servers retain the Diameter signaling MEAL data and DSR ApplicationMEAL data if it is site specific, and merge the Platform MEAL data to the NOAMservers. Network-scoped MEAL data is forwarded to the NOAM).

Deployment with SDS

DSR deployments that include support for the DSR Full Address Based Resolution(FABR) application must be deployed with the Subscriber Database Server (SDS). TheSDS is used to provision the FABR subscriber data.

The SDS/DP system consists of a Primary Provisioning Site, a Disaster Recovery (DR)Provisioning Site, and DSR Signaling Site servers with redundant DP SOAM serversand DP servers. Each Provisioning Site has an Active/Standby pair of servers in a highavailability (HA) configuration and a third server configured as a Query Server.

The DSR SOAM and the SDS SOAM servers are run on some DSR OAM server usingvirtualization technology. It is assumed that most deployments that support both DSRand SDS deploy the DSR NOAM on servers since this is how the SDS NOAM isdeployed. Small deployments that minimize the amount of hardware investmentrequire the DSR NOAM to be deployed as a virtual server on the OAM server. Thisrequires running three virtual machines (VMs) on the server – DSR NOAM, DSRSOAM, and SDS SOAM.

System Architecture

Introduction to the Diameter Signaling Router 3-7

Page 24: Diameter Signaling Router Getting Started

System Architecture

3-8 Diameter Signaling Router Getting Started

Page 25: Diameter Signaling Router Getting Started

4User Interface Introduction

This section describes the organization and usage of the application's user interface. Init you can find information about how the interface options are organized, how to usewidgets and buttons, and how filtering and other page display options work.

User Interface OrganizationThe user interface is the central point of user interaction within an application. It is aWeb-based graphical user interface (GUI) that enables remote user access over thenetwork to an application and its functions.

The core framework presents a common set of Main Menu options that serve variousapplications. The common Main Menu options are:

• Administration

• Configuration

• Alarms and Events

• Security Log

• Status and Manage

• Measurements

• Help

• Legal Notices

• Logout

Applications build upon this framework to present features and functions. Dependingon your application, some or all of the following Main Menu options may appear onthe Network Operation, Administration, and Maintenance (NOAM) GUI:

• Communication Agent

• Diameter Common

• Diameter

• UDR (User Data Repository)

• SBR (Session Binding Repository)

• Policy and Charging

• DCA (Diameter Custom Application) Framework

User Interface Introduction 4-1

Page 26: Diameter Signaling Router Getting Started

The DSR System OAM GUI may present even more Main Menu options as listedbelow. The end result is a flexible menu structure that changes according to theapplication needs and features activated.

• Transport Manager

• SS7/Sigtran

• RBAR (Range Based Address Resolution)

• FABR (Full Address Based Resolution)

• SBR

• Mediation

• Policy and Charging

• DCA Framework

• IPFE (IP Front End)

Note that the System OAM (SOAM) Main Menu options differ from the NetworkOAM (NOAM) options. Some Main Menu options are configurable from the NOAMserver and view-only from the SOAM (SOAM) server. This remains true for otherapplications.

Machine to Machine Interface

The Machine to Machine Interface API describes the Machine to Machine Interface(MMI) for DSR. The DSR MMI is a RESTful (Representational State Transfer) interfaceproviding access to a broad range of Operations, Administration, and Maintenance(OAM) services that clients use to configure and manage the DSR. This document isthe comprehensive API reference guide to the RESTful services the DSR makesavailable to clients through the DSR MMI. To access the MMI API documentationthrough a direct URL access, without login, go to http://(IP address of NOAM orSOAM)/raml/ mmi.html. Or the MMI API documentation can be accessed directlyfrom the DSR GUI by clicking on the new MMI API Guide menu item.

One of the applications you can access through the MMI is virtual Signaling Transport(vSTP) application. The vSTP application uses signaling experience from both theOracle Communication EAGLE STP and the vDSR products to build a commonsignaling platform for unified signaling solutions. The application is installed onvirtual machines.

Another application you can access through the MMI is the Service CapabilityExposure Function (SCEF) application, which interacts with, and implements controlson, Internet of Things (IoT) devices. SCEF uses the Oracle Communications ServicesGatekeeper (OCSG) for configuration and provisioning.

User Interface ElementsTable 4-1 describes elements of the user interface.

User Interface Organization

4-2 Oracle Communications Diameter Signaling Router Getting Started

Page 27: Diameter Signaling Router Getting Started

Table 4-1 User Interface Elements

Element Location Function

Identification Banner Top bar across the web page The left side of the bannerprovides the followinginformation:• Displays the company

name,• Oracle product name

and version, and• the alarm panel.The right side of the banner:

• Allows you to pause anysoftware updates.

• Links to the online helpfor all software.

• Shows the user name ofthe currently logged-inuser.

• Provides a link to logout of the GUI.

Main Menu Left side of screen, underbanners

A tree-structured menu of alloperations that can beperformed through the userinterface. The plus character(+) indicates a menu itemcontains subfolders.• To display submenu

items, click the pluscharacter, the folder, oranywhere on the sameline.

• To select a menu itemthat does not havesubmenu items, click onthe menu item text or itsassociated symbol.

User Interface Organization

User Interface Introduction 4-3

Page 28: Diameter Signaling Router Getting Started

Table 4-1 (Cont.) User Interface Elements

Element Location Function

Work Area Right side of panel understatus

Consists of three sections:Page Title Area, Page ControlArea (optional), and PageArea.• Page Title Area:

Occupies the top of thework area. It displaysthe title of the currentpage being displayed,date and time, andincludes a link tocontext-sensitive help.

• Page Control Area:Located below the PageTitle Area, this areashows controls for thePage Area (this area isoptional). Whenavailable as an option,filter controls display inthis area. The PageControl Area containsthe optional layoutelement toolbar, whichdisplays differentelements depending onwhich GUI page isselected. For moreinformation, see Optional LayoutElement Toolbar.

• Page Area: Occupies thebottom of the work area.This area is used for alltypes of operations. Itdisplays all options,status, data, file, andquery screens.Information or errormessages are displayedin a message box at thetop of this section. Ahorizontal and/orvertical scroll bar isprovided when thedisplayed informationexceeds the page area ofthe screen. When a userfirst logs in, this areadisplays the application

User Interface Organization

4-4 Oracle Communications Diameter Signaling Router Getting Started

Page 29: Diameter Signaling Router Getting Started

Table 4-1 (Cont.) User Interface Elements

Element Location Function

user interface page. Thepage displays a user-defined welcomemessage. To customizethe message, see Customizing the LoginMessage.

Session Banner Across the bottom of the webpage

The left side of the bannerprovides the followingsession information:• The name of the

machine to which theuser is connected, andwhether the user isconnected via the VIP ordirectly to the machine.

• The HA state of themachine to which theuser is connected.

• The role of the machineto which the user isconnected.

The right side of the bannershows the alarm panel.

Main Menu OptionsTable 4-2 describes all main menu user interface options.

Note: The menu options can differ according to the permissions assigned to auser's log-in account. For example, the Administration menu options do notappear on the screen of a user who does not have administrative privileges.

Note: Some menu items are configurable only on the Network OAM andview-only on the System OAM; and some menu options are configurable onlyon the System OAM.

Note: Some features do not appear in the main menu until the features areactivated.

User Interface Organization

User Interface Introduction 4-5

Page 30: Diameter Signaling Router Getting Started

Table 4-2 Main Menu Options

Menu Item Function

Administration The Administration menu allows the user to:• General Options. Configure options such

as password history and expiration,login message, welcome message, andthe number of failed login attemptsbefore an account is disabled

• Set up and manage user accounts• Configure group permissions• View session information• Manage sign-on certificates• Authorize IP addresses to access the user

interface• Configure SFTP user information• View the software versions report• Upgrade management including backup

and reporting• Authenticate LDAP servers• Configure SNMP trapping services• Configure an export server• Configure DNS elements

Configuration On the NOAM, allows the user to configure:• Network Elements• Network Devices• Network Routes• Services• Servers• Server Groups• Resource Domains• Places• Place Associations• Interface and Port DSCP

Alarms and Events Allows the user to view:• Active alarms and events• Alarm and event history• Trap log

Security Log Allows the user to view, export, and generatereports from security log history.

Status and Manage Allows the user to monitor the individualand collective status of Network Elements,Servers, HA functions, Databases, KPIs,system Processes, and Tasks. The user canperform actions required for servermaintenance, database management, data,and ISO file management.

Measurements Allows the user to view and exportmeasurement data.

User Interface Organization

4-6 Oracle Communications Diameter Signaling Router Getting Started

Page 31: Diameter Signaling Router Getting Started

Table 4-2 (Cont.) Main Menu Options

Menu Item Function

Transport Manager (optional) On the SOAM, allows the user to configureadjacent nodes, configuration sets, ortransports. A maintenance option allows theuser to perform enable, disable, and blockactions on the transport entries. This optiononly appears with the DSR application.

Communication Agent (optional) Allows the user to configure Remote Servers,Connection Groups, and Routed Services.The user can perform actions to enable,disable, and block connections. Also allowsthe user to monitor the status of Connections,Routed Services, and HA Services.

SS7/Sigtran (optional) On the SOAM, allows the user to configurevarious users, groups, remote signalingpoints, links, and other items associated withSS7/Sigtran; perform maintenance andtroubleshooting activities; and provides acommand line interface for bulk loading SS7configuration data. This option only appearswith the DSR application.

Diameter Common (optional) Allows the user to view or configure:• Dashboard, configure on the NOAM;

view on both OAMs• Network Identifiers on the SOAM -

MCC Ranges• Network Identifiers on the NOAM -

MCCMNC and MCCMNC Mapping• MPs (on the SOAM) - editable Profile

parameters and Profile AssignmentsThe DSR Bulk Import and Export functionsare available on both OAMs for the dataconfigured on that OAM.

Diameter (optional) Allows the user to configure, modify, andmonitor Diameter routing:• On the NOAMP, Diameter Topology

Hiding and Egress Throttle Listconfiguration

• On the SOAM, Diameter Configuration,Maintenance, Reports, Troubleshootingwith IDIH, AVP Dictionary, andDiameter Mediation configuration

UDR (User Data Repository) (optional) Allows the user to add, edit, store, andmanage subscriber, pool data, and EIRinformation. The user can also monitor theimport, export, and subscribing client status.This option only appears with the UDRapplication.

User Interface Organization

User Interface Introduction 4-7

Page 32: Diameter Signaling Router Getting Started

Table 4-2 (Cont.) Main Menu Options

Menu Item Function

RBAR (Range-Based Address Resolution)(optional)

Allows the user to configure the followingRange-Based Address Resolution (RBAR)settings:• Applications• Exceptions• Destinations• Address Tables• Addresses• Address Resolutions• System OptionsThis is accessible from the SOAM only. Thisoption only appears with the DSRapplication.

FABR (Full Address Based Resolution)(optional)

Allows the user to configure the followingFull Address Based Resolution (FABR)settings:• Applications• Exceptions• Default Destinations• Address Resolutions• System OptionsThis is accessible from the SOAM only. Thisoption is only available with the DSRapplication.

SBR (Session Binding Repository) (optional) Allows the user to perform configurationtasks, edit system options, and view elementsfor:• SBR Databases• SBR Database Resizing Plans• SBR Data Migration Plans• Database Options

Additionally, on the NOAMP, users areallowed to perform maintenance tasks, editoptions, and view elements for:• Maintenance

– SBR Database Status– SBR Status– SBR Database Reconfiguration

StatusThis option only appears with the DSRapplication.

Mediation Allows the user to make routable decisions toend the reply, drop the message, or set thedestination realm.

User Interface Organization

4-8 Oracle Communications Diameter Signaling Router Getting Started

Page 33: Diameter Signaling Router Getting Started

Table 4-2 (Cont.) Main Menu Options

Menu Item Function

Policy and Charging (optional) On the NOAMP, allows the user to performconfiguration tasks, edit options, and viewelements for:• General Options• Access Point Names• Policy DRA

– PCRF Pools– PCRF Sub-Pool Selection Rules– Network-Wide Options

• Online Charging DRA– OCS Session State– Realms– Network-Wide Options

• Alarm Settings• Congestion OptionsAdditionally on the NOAMP, users areallowed to perform maintenance tasks, editoptions, and view elements for:• Maintenance

– SBR Database Status– SBR Status– SBR Database Reconfiguration

Status– Policy Database Query

On the SOAM, allows the user to performconfiguration tasks, edit options, and viewelements for:• General Options• Access Point Names• Policy DRA

– PCRFs– Binding Key Priority– PCRF Pools– PCRF Pool to PRT Mapping– PCRF Sub-Pool Selection Rules– Policy Clients– Suspect Binding Removal Rules– Site Options

• Online Charging DRA– OCSs– CTFs– OCS Session State– Realms

• Error Codes• Alarm Settings• Congestion OptionsThis option only appears with the DSRapplication.

User Interface Organization

User Interface Introduction 4-9

Page 34: Diameter Signaling Router Getting Started

Table 4-2 (Cont.) Main Menu Options

Menu Item Function

DCA Framework (optional) Allows the user to perform configurationtasks, edit system options, and view elementsfor DCA applications:• Custom MEALs (Measurements, Events,

Alarms, and Logs)• General Options• Trial MPs assignment• Application Control• System Options

IPFE (optional) Allows the user to configure IP Front End(IPFE) options and IP List TSAs.

This is accessible from the SOAM server only.This option only appears with the DSRapplication.

Help Launches the Help system for the userinterface

Legal Notices Product Disclaimers and Notices

Logout Allows the user to log out of the userinterface

Missing Main Menu OptionsPermissions determine which Main Menu options are visible to users. Permissions aredefined through the Group Administration page. The default group, admin, ispermitted access to all GUI options and functionality. Additionally, members of theadmin group set permissions for other users.

Main Menu options vary according to the group permissions assigned to a user'saccount. Depending on your user permissions, some menu options may be missingfrom the Main Menu. For example, Administration menu options do not appear onyour screen if you do not have administrative permissions. For more informationabout user permissions, see Group Administration in the OAM section of the onlinehelp, or contact your system administrator.

Common Graphical User Interface ElementsCommon controls allow you to easily navigate through the system once you becomefamiliar with the GUI. The location of the controls remains static for all pages that usethe controls. For example, after you become familiar with the location of the displayfilter, you no longer need to search for the control on subsequent pages because thelocation is static.

Supported BrowsersThis application supports the use of Microsoft® Internet Explorer 8.0, 9.0, or 10.0.

is designed to work with most modern HTML5 compliant browsers and uses bothJavaScript and cookies. Please refer to the Oracle Software Web Browser SupportPolicy for details

Missing Main Menu Options

4-10 Oracle Communications Diameter Signaling Router Getting Started

Page 35: Diameter Signaling Router Getting Started

System Login PageAccess to the user interface begins at the System Login page. The System Login pageallows users to log in with a username and password and provides the option ofchanging the password upon login. The System Login page also features a date andtime stamp reflecting the time the page was last refreshed. Additionally, acustomizable login message appears just below the Log In button.

The user interface is accessed using HTTPS, a secure form of the HTTP protocol. Whenaccessing a server for the first time, HTTPS examines a web certificate to verify theidentity of the server. The configuration of the user interface uses a self-signed webcertificate to verify the identity of the server. When the server is first accessed, thesupported browser warns the user that the server is using a self-signed certificate. Thebrowser requests confirmation that the server can be trusted. The user is required toconfirm the browser request to gain access.

Customizing the Login Message

Before logging in, the System Login page appears. You can create a login message thatappears just below the Log In button on the System Login page.

Figure 4-1 Oracle System Login

1. From the Main Menu, click Administration > General Options.

The General Options Administration page appears.

2. Locate LoginMessage in the Variable column.

Common Graphical User Interface Elements

User Interface Introduction 4-11

Page 36: Diameter Signaling Router Getting Started

3. Enter the login message text in the Value column.

4. Click OK or Apply to submit the information.

A status message appears at the top of the Configuration Administration page toinform you if the operation was successful.

The next time you log in to the user interface, the login message text displays.

Accessing the DSR Graphical User Interface

In DSR, some configuration is done at the NOAM server, while some is done at theSOAM server. Because of this, you need to access the DSR graphical user interface(GUI) from two servers. Certificate Management (Single Sign-On) can be configured tosimplify accessing the DSR GUI on the NOAM and the SOAM.

For information on configuring Single Sign-On certificates, see OAM >Administration > Access Control > Certificate Management in the DSR online help.

After the certificates have been configured, you can log into the DSR GUI on anyNOAM or SOAM, and access the DSR GUI on other servers (NOAM or other SOAMs)without having to re-enter your login credentials.

1. In the browser URL field, enter the fully qualified hostname of the NOAM server,for example https://dsr-no.yourcompany.com.

When using Single Sign-On, you cannot use the IP address of the server.

2. When prompted by the browser, confirm that the server can be trusted.

The System Login page appears.

3. Enter the Username and Password for your account.

The DSR GUI for the NOAM appears.

4. To access the DSR GUI for the SOAM, open another browser window and enter thefully qualified hostname of the SOAM.

The DSR GUI for the SOAM appears

You can toggle between the DSR GUI on the NOAM and the DSR GUI on the SOAMas you perform configuration tasks.

Main Menu IconsThis table describes the icons used in the Main Menu.

Table 4-3 Main Menu Icons

Icon Name Description

Folder Contains a group ofoperations. If the folder isexpanded by clicking theplus (+) sign, all availableoperations and sub-foldersare displayed. Clicking theminus (-) collapses the folder.

Common Graphical User Interface Elements

4-12 Oracle Communications Diameter Signaling Router Getting Started

Page 37: Diameter Signaling Router Getting Started

Table 4-3 (Cont.) Main Menu Icons

Icon Name Description

Config File Contains operations in anOptions page.

File with Magnifying Glass Contains operations in aStatus View page.

File Contains operations in a DataView page.

Multiple Files Contains operations in a FileView page.

File with Question Mark Contains operations in aQuery page.

User Contains operations relatedto users.

Group Contains operations relatedto groups.

Task Contains operations relatedto Tasks

Help Launches the Online Help.

Logout Logs the user out of the userinterface.

Work Area DisplaysIn the user interface, tables, forms, tabbed pages, and reports are the most commonformats.

Note: Screen shots are provided for reference only and may not exactly matcha specific application's GUI.

Tables

Paginated tables describe the total number of records being displayed at the beginningand end of the table. They provide optional pagination with First|Prev|Next|Lastlinks at both the beginning and end of this table type. Paginated tables also contain

Common Graphical User Interface Elements

User Interface Introduction 4-13

Page 38: Diameter Signaling Router Getting Started

action links on the beginning and end of each row. For more information on actionlinks and other page controls, see Page Controls.

Figure 4-2 Paginated Table

Scrollable tables display all of the records on a single page. The scroll bar, located onthe right side of the table, allows you to view all records in the table. Scrollable tablesalso provide action buttons that operate on selected rows. For more information onbuttons and other page controls, see Page Controls.

Figure 4-3 Scrollable Table

Note: Multiple rows can be selected in a scrollable table. Add rows one at atime using CTRL-click. Add a span of rows using SHIFT-click.

Forms

Forms are pages on which data can be entered. Forms are typically used forconfiguration. Forms contain fields and may also contain a combination of lists,buttons, and links.

Common Graphical User Interface Elements

4-14 Oracle Communications Diameter Signaling Router Getting Started

Page 39: Diameter Signaling Router Getting Started

Figure 4-4 Form Page

Tabbed pages

Tabbed pages provide collections of data in selectable tabs. Click on a tab to see therelevant data on that tab. Tabbed pages also group Retrieve, Add, Update, and Deleteoptions on one page. Click on the relevant tab for the task you want to perform andthe appropriate fields populate on the page. Retrieve is always the default for tabbedpages.

Figure 4-5 Tabbed Pages

Figure 4-6 Tabbed Pages

Reports

Reports provide a formatted display of information. Reports are generated from datatables by clicking Report. Reports can be viewed directly on the user interface, or theycan be printed. Reports can also be saved to a text file.

Common Graphical User Interface Elements

User Interface Introduction 4-15

Page 40: Diameter Signaling Router Getting Started

Figure 4-7 Report Output

Customizing the Splash Page Welcome Message

When you first log in to the user interface, the splash page appears. Located in thecenter of the main work area is a customizable welcome message. Use this procedureto create a message suitable for your needs.

1. From the Main Menu, click Administration > General Options.

2. Locate Welcome Message in the Variable column.

3. Enter the desired welcome message text in the Value column.

4. Click OK to save the change or Cancel to undo the change and return the field tothe previously saved value.

A status message appears at the top of the page to inform you if the operation wassuccessful.

The next time you log in to the user interface, the new welcome message text isdisplayed.

Column Headers (Sorting)You can sort a table by a column by clicking the column header. However, sorting isnot necessarily available on every column. Sorting does not affect filtering.

When you click the header of a column that the table can be sorted by, an indicatorappears in the column header showing the direction of the sort. See Figure 4-8.Clicking the column header again reverses the direction of the sort.

Figure 4-8 Sorting a Table by Column Header

Page ControlsUser interface pages contain controls, such as buttons and links, that perform specifiedfunctions. The functions are described by the text of the links and buttons.

Common Graphical User Interface Elements

4-16 Oracle Communications Diameter Signaling Router Getting Started

Page 41: Diameter Signaling Router Getting Started

Note: Disabled buttons are grayed out. Buttons that are irrelevant to theselection or current system state, or which represent unauthorized actions asdefined in Group Administration, are disabled. For example, Delete isdisabled for users without Global Data Delete permission. Buttons are alsodisabled if, for example, multiple servers are selected for an action that canonly be performed on a single server at a time.

Table 4-4 contains examples of Action buttons.

Table 4-4 Example Action Buttons

Action Button Function

Insert Inserts data into a table.

Edit Edits data within a table.

Delete Deletes data from table.

Change Changes the status of a managed object.

Some Action buttons take you to another page.

Submit buttons, described in Table 4-5, are used to submit information to the server.The buttons are located in the page area and accompanied by a table in which you canenter information. The Submit buttons, except for Cancel, are disabled until you entersome data or select a value for all mandatory fields.

Table 4-5 Submit Buttons

Submit Button Function

OK Submits the information to the server, and ifsuccessful, returns to the View page for thattable.

Apply Submits the information to the server, and ifsuccessful, remains on the current page sothat you can enter additional data.

Cancel Returns to the View page for the tablewithout submitting any information to theserver.

Clear Field ControlThe clear field control allows you to clear the value from a list. The clear field control isavailable only on some lists.

Click the X next to a list to clear the field.

Figure 4-9 Clear Field Control X

Optional Layout Element ToolbarThe optional layout element toolbar appears in the Page Control Area of the GUI.

Common Graphical User Interface Elements

User Interface Introduction 4-17

Page 42: Diameter Signaling Router Getting Started

Figure 4-10 Optional Layout Element Toolbar

The toolbar displays different elements depending on which GUI page is selected. Theelements of the toolbar that can appear include:

• Filter – Allows you to filter data in a table.

• Errors – Displays errors associated with the work area.

• Info – Displays information messages associated with the work area.

• Status – Displays short status updates associated with the main work area.

• Warning – Displays warnings associated with the work area.

Notifications

Some messages require immediate attention, such as errors and status items. Whennew errors occur, the Errors element opens automatically with information about theerror. Similarly, when new status items are added, the Status element opens. If youclose an automatically opened element, the element stays closed until a new,unacknowledged item is added.

Figure 4-11 Automatic Error Notification

Note: Viewing and closing an error does not clear the Errors element. If youreopen the Errors element, previously viewed errors are still in the list.

When new messages are added to Warning or Info, the styling of the element changesto indicate new messages are available. The styling of the Task element changes whena task changes state (such as, a task begins or ends).

Opening an Element in the Toolbar

Use this procedure to open an element in the optional layout element toolbar.

1. Click the text of the element or the triangle icon to open an element.

The selected element opens and overlays the work area.

2. Click X to close the element display.

FiltersFilters are part of the optional layout element toolbar and appear throughout the GUIin the Page Control Area. For more information about optional layout element toolbarfunctionality, see Optional Layout Element Toolbar.

Common Graphical User Interface Elements

4-18 Oracle Communications Diameter Signaling Router Getting Started

Page 43: Diameter Signaling Router Getting Started

Filters allow you to limit the data presented in a table and can specify multiple filtercriteria. By default, table rows appear unfiltered. Three types of filters are supported,however, not all filtering options are available on every page. The types of filterssupported include:

• Network Element – When enabled, the Network Element filter limits the dataviewed to a single Network Element.

Note: Once enabled, the Network Element filter affect all pages that list ordisplay data relating to the Network Element.

• Collection Interval – When enabled, the collection interval filter limits the data toentries collected in a specified time range.

• Display Filter – The display filter limits the data viewed to data matching thespecified criteria.

Once a field is selected, it cannot be selected again. All specified criteria must be met inorder for a row to be displayed.

The style or format of filters may vary depending on which GUI pages the filters aredisplayed. Regardless of appearance, filters of the same type function the same.

Figure 4-12 Examples of Filter Styles

Filter Control Elements

This table describes filter control elements of the user interface.

Table 4-6 Filter Control Elements

Operator Description

= Displays an exact match.

!= Displays all records that do not match thespecified filter parameter value.

> Displays all records with a parameter valuethat is greater than the specified value.

>= Displays all records with a parameter valuethat is greater than or equal to the specifiedvalue.

Common Graphical User Interface Elements

User Interface Introduction 4-19

Page 44: Diameter Signaling Router Getting Started

Table 4-6 (Cont.) Filter Control Elements

Operator Description

< Displays all records with a parameter valuethat is less than the specified value.

<= Displays all records with a parameter valuethat is less than or equal to the specifiedvalue.

Like Enables you to use an asterisk (*) as awildcard as part of the filter parameter value.

Is Null Displays all records that have a value of IsNull in the specified field.

Note: Not all filterable fields support all operators. Only the supportedoperators are available for you to select.

Filtering on the Network Element

The global Network Element filter is a special filter that is enabled on a per-user basis.The global Network Element filter allows a user to limit the data viewed to a singleNetwork Element. Once enabled, the global Network Element filter affects all sub-screens that display data related to Network Elements. This filtering option may notbe available on all pages.

1. Click Filter in the optional layout element toolbar.

2. Select a Network Element from the Network Element list.

3. Click Go to filter on the selection or click Reset to clear the selection.

4. For data tables that support compound filtering, click Add to add another filtercondition and repeat steps 2 through 4.

Multiple filter conditions are joined by an AND operator.

Records are displayed according to the specified criteria.

Filtering on Collection Interval

The Collection Interval filter allows a user to limit the data viewed to a specified timeinterval. This filtering option may not be available on all pages.

1. Click Filter in the optional layout element toolbar.

2. Enter a duration for the Collection Interval filter.

The duration must be a numeric value.

3. Select a unit of time from the list.

The unit of time can be seconds, minutes, hours, or days.

4. Select Beginning or Ending from the list.

Common Graphical User Interface Elements

4-20 Oracle Communications Diameter Signaling Router Getting Started

Page 45: Diameter Signaling Router Getting Started

5. Click Go to filter on the selection, or click Reset to clear the selection.

Records are displayed according to the specified criteria.

Filtering Using the Display Filter

Use this procedure to perform a filtering operation. This procedure assumes you havea data table displayed on your screen with the Display Filter field. This process is thesame for all data tables. However, all filtering operations are not available for alltables.

Note: Display Filter does not support compound filtering. For example, youcannot filter on both severity and a server name. Try to filter on a single filtercriteria, such as the server hostname for server-scoped metric cells; or theapplication name for St- and NE-scoped metric cells. You can also sort bycongestion level (descending) to help improve your filter.

1. Click Filter in the optional layout element toolbar.

2. Select a field name from the Display Filter list.

This selection specifies the field in the table that you want to filter on. The default isNone, which indicates that you want all available data displayed.

3. Select an operator from the operation selector list.

4. Enter a value in the value field.

This value specifies the data that you want to filter on. For example, if you specifyFilter=Severity with the equals (=) operator and a value of MINOR, the table wouldshow only records where Severity=MINOR.

5. Click Go to filter on the selection, or click Reset to clear the selection.

Records are displayed according to the specified criteria.

Note: PCA was known as PDRA and may still be seen in some filtering.

Pause UpdatesSome pages refresh automatically. Updates to these pages can be paused by selectingthe Pause updates checkbox. Uncheck the Pause updates checkbox to resumeautomatic updates. The Pause updates checkbox is available only on some pages.

Max Records Per Page Controls

Max Records Per Page is used to control the maximum number of records displayed inthe page area. If a page uses pagination, the value of Max Records Per Page is used.Use this procedure to change the Max Records Per Page.

1. From the Main Menu, click Administration > General Options.

2. Change the value of the MaxRecordsPerPage variable.

Common Graphical User Interface Elements

User Interface Introduction 4-21

Page 46: Diameter Signaling Router Getting Started

Note: Maximum Records Per Page has a range of values from 10 to 100records. The default value is 20.

3. Click OK or Apply.

OK saves the change and returns to the previous page.

Apply saves the change and remains on the same page.

The maximum number of records displayed is changed.

Common Graphical User Interface Elements

4-22 Oracle Communications Diameter Signaling Router Getting Started