2 Enable the Web GUI for Access

You must enable access to the Web GUI from the Web server before you can log on and the steps vary depending on whether you want to enable a new Oracle® Enterprise Session Router (ESR) or an existing one. To provide secure access, you can enable HTTPS.

Access the Web GUI with HTTPS

To provide secure access to the Web GUI from the Web server, you can enable HTTPS by creating a Transport Layer Security (TLS) profile. The Oracle® Enterprise Session Router (ESR) does not require either the hardware Security Service Module (SSM) or the software TLS license when configuring certificate record, tls-profile, and tls-global for an HTTPS connection to the Web GUI from the Web server.

Note that the ESR requires the TLS license when you configure SIP for TLS.

Note:

Virtual machines require the software TLS license.

Enable the Web GUI for Access

To enable the Web GUI on a new Oracle® Enterprise Session Router installation, use the run setup command from the ACLI command line. After you save and activate the configuration, you can sign on to the Web GUI.

Prerequisites
  • Install the hardware and connect to the Oracle® Enterprise Session Router. See "Getting Started" in the ACLI Configuration Guide"
Context

For new installations, use the following procedure to run the Installation Wizard to configure the primary Oracle® Enterprise Session Router and enable the Web GUI. To set up another Oracle® Enterprise Session Router as the secondary peer in a High Availability pair, see Set Up High Availability.

  1. In Superuser mode, type run setup, and press Enter.
    The system displays the following:
    -----------------------------------------------------------
Thank you for purchasing the Oracle Enterprise Session Router. 
The following short wizard will guide you through the initial setup.
A reboot will be required to save changes.
-----------------------------------------------------------
'?' = Help; '.' = Clear; 'q' = Exit
CONFIGURATION
WARNING: Proceeding with wizard will result in existing configuration being erased.  
Erase config and proceed (yes/no) [no] : yes
Configuration will be backed up as bkup_setup_wizard_<timestamp>.gz
'-' = Previous; '?' = Help; '.' = Clear; 'q' = Exit
  2. For "Enable Web GUI with HTTP Connection", type yes, and press Enter.
    The system displays the following:
    HIGH AVAILABILITY
This SBC may be a standalone or part of a highly available redundant pair.  
SBC mode     
1 - standalone     2 - high availability    
Enter choice [1 - standalone] :
  3. For "SBC mode", type 1 for a standalone installation or type 2 for a High Availability installation.
    The system displays the following:
    SBC SETTINGS  
Unique target name of this SBC [ ]:   
IP address on management interface [ ]:   
Subnet mask [ ]:   
Management interface VLAN (0 - 4095) [0] :   
Gateway IP address [ ]:
  4. Set the values for the Oracle® Enterprise Session Router parameters according to your deployment, and press Enter.
    The system displays the following:
    OC SDM ACCESS SETTINGS
Configure the SBC to allow the OC Session Delivery Manager to access it  
OC SDM access (yes/no) [yes] : no
  5. Set access permission to either allow (yes) or prohibit (no) the Oracle Communications Session Delivery Manager to access the Oracle® Enterprise Session Router, and press Enter.
  6. Save and activate the configuration.

Set Up High Availability

To minimize downtime and service interruptions, you can pair Oracle® Enterprise Session Routers for redundancy to provide High Availability (HA).

Before you begin, configure a primary Oracle® Enterprise Session Router.
Use the following procedure to configure a secondary Oracle® Enterprise Session Router to form an HA pair with a primary Oracle® Enterprise Session Router.
  1. In Superuser mode, type run setup, and press Enter.
    The system displays the following:
    -----------------------------------------------------------
Thank you for purchasing the Oracle Enterprise Session Router. 
The following short wizard will guide you through the initial set-up.
A restart will be required to save changes.
-----------------------------------------------------------
'?' = Help; '.' = Clear; 'q' = Exit
CONFIGURATION
WARNING: Proceeding with wizard will result in existing configuration being erased.  
Erase config and proceed (yes/no) [no] : 
 yes
Configuration will be backed up as bkup_setup_wizard_<timestamp>.gz
'-' = Previous; '?' = Help; '.' = Clear; 'q' = Exit
  2. For "Enable Web GUI with HTTP Connection", type yes, and press Enter.
    The system displays the following:
    HIGH AVAILABILITY
This SBC may be a standalone or part of a highly available redundant pair.  
SBC mode     
1 - standalone     2 - high availability    
Enter choice [<choice>] : 
If this SBC is the primary, enter the configuration.
If this SBC is the secondary, you can import settings from the primary.  
SBC role     1 - primary     2 - secondary    
Enter choice [<choice>] : 
Specify the IP address to set on interface connected for redundancy  
Redundancy interface address [<Redundancy>] :   
Redundancy subnet mask [<YourSubnetMask>] :
  3. For "SBC mode", type 2 for a High Availability installation, and press Enter.
    The system displays the following:
    SBC SETTINGS  
Unique target name of this SBC [<YourSbcName>] :   
IP address on management interface [<YourSbcManagementInterfaceIpAddress>] :   
Subnet mask [<YourSubnetMask>] :   
Management interface VLAN (0 - 4095) [0] :   
Gateway IP address [<YourGatewayIpAddress>] :
  4. Type the necessary Oracle® Enterprise Session Router settings, and press Enter.
    The system displays the following:
    PEER CONFIGURATION  
Peer IP address [<PeerIpAddress>] :   
Peer target name [<PeerTargetName>] :
  5. Type the IP address and target name of the peer and, press Enter.
    The system displays the following:
    OC SDM ACCESS SETTINGS
Configure the SBC to allow the OC Session Delivery Manager to access it.  
OC SDM access (yes/no) [yes] : no
  6. Set access permission to either allow (yes) or prohibit (no) the Oracle Communications Session Delivery Manager to access the Oracle® Enterprise Session Router, and press Enter.
  7. Save and activate the configuration.

Set the Log On Banner Message

When you want to get messaging to your Oracle® Enterprise Session Router (ESR) users, you can put your message into the optional log on banner. The log on banner is a text box that displays before the system asks users for their log on credentials.

To get your message into the log on banner, enter the text you want into the Set Login Banner field. There is no character limit. The the banner field adjusts to the quantity of text.
  1. Access the Systems tab, System Operations, Set Login Banner.
  2. Enter the text you want into the Set login banner field.
  3. Click Complete.

Simultaneous Logons

The Web GUI allows the User and Administrator to log on simultaneously. Session availability to the User and Admin depends on which type of user is logged on to the session. The following illustrations depict and explain the system behavior when a User and an Administrator log on to a Web GUI session.

This illustration and text explain system behavior when either user a or admin a is logged on and either user B or admin B also log on.

Note:

In the illustration where Admin A logged in first, the behavior is as described. If Admin B logs in first, then the system shows the lock message to Admin A. The first Admin to log in acquires the lock.

Up to five users can log onto the same session at the same IP address at the same time. Only one Administrator at a time can have full control of a simultaneous session.

Log on to the Web GUI

You can log on to the ESR as a User or an as Administrator, depending on your permissions.

You need your User name, Password, and optionally your passcode to log on. The system requires your passcode when two factor authentication is enabled. If your system Administrator configured the optional log on page message, the system displays the message after you enter your log on credentials. After reading the message, click Close, and the system displays the GUI. The first time you log on, the GUI displays the Configuration Assistant.

  1. On a PC, open a supported Internet browser. See "Browser Support" in your software version's Release Notes for the list of supported browsers.
  2. Start the GUI with either the HTTP or HTTPS log on. 
    http://<YourEcbManagementInterfaceIpAddress> previously configured.
https://<YourEcbManagementInterfaceIpAddress> previously configured.

    Note:

    Whether you log on using HTTP or HTTPS depends on the settings for your deployment.
  3. In the Sign in dialog, enter your ESR credentials, and click Sign in. The Login banner is displayed. For more information on the Sign in Banner, see Login Banner.

    Figure 2-1 Sign in


    This screen capture shows the Web GUI log on dialog
  4. If your ESR requires two-factor authentication, do the following:
    1. In the log on dialog, enter your passcode.
    2. In the Confirm dialog, acknowledge the Last Log on information. Yes—allows you to login. No—ends the session.
  5. Click log on.

    Note:

    If you want to open another Web GUI tab on the same ESR in a new tab in the same browser, you can do so without logging on again.

Change the Sign In Password

Use the Oracle® Enterprise Session Router ACLI to change a User or Administrator sign in password.

Use the secret command from the ACLI to change the sign in password for a User and the config password command for an Administrator. For more information about setting passwords, see the Oracle Enterprise Session Border Controller ACLI Configuration Guide.

Log Off from the Web GUI

To log off from the Web GUI, open the User menu, and click Log Out.
  1. On the User menu located in the upper right corner of the Web GUI, click Log Out.
    This screen capture shows the user menu with Logout highlighted.
    The Web GUI displays a confirmation message that depends on whether or not unsaved changes exist.
  2. In the Confirm dialog, take the appropriate action.

    Click Yes when no unsaved changes exist.

    This screen capture shows the confirmation dialog that the system displays after you click Log Out when no unsaved changes exist.

    Click the action you want when unsaved changes exist.

    This screen capture shows the confirmation dialog that the system displays after you click Log Out and unsaved changes exist.