0 Votes

Signaling Engine

Last modified by Jeff McDonald on 2021/09/26 20:55

These are instructions for version 7.2.1

See Installing WebRTC Session Controller Signaling Engine for official instructions.

Download WSC Signaling Engine from 'edelivery.oracle.com'.

Download latest patches from 'support.oracle.com'.

Don't forget to download the latest OCCAS and WebLogic patches.

Graphical Install

To install WSC, type:

java -d64 -jar wsc_generic.jar

Follow the installation wizard. Choices include:

  • Choose the "Central Inventory" directory. Example: /home/oracle/oraInventory
  • Choose the "Oracle Home" directory. Example: /home/oracle/wsc72
  • Choose the "Installation Type". Example: "Complete Installation"
  • Analyze "Prerequisite Checks". Ignore warnings about "operating system certification".
  • Register for security updates. Example: "wish to remain uninformed of critical security issues".
  • Review "Installation Summary".
  • After "Installation Complete", uncheck "Automatically Launch the Configuration Wizard" before clicking "Finish".

Silent Install

Silent install is tricky. The best way to do it is to run the Graphical Install first and use the generated log files.

More details coming...

Apply Patches

Follow the instructions on Applying WebLogic Patches.

For the Signaling Engine, install these patches:

Domain Configuration

Run the "Domain Configuration" wizard:

cd $ORACLE_HOME
cd wlserver/common/bin
./config.sh

The Configuration Wizard will offer you two main choices:

  • Basic Domain, a standalone configuration suitable for development
  • Replicated Domain, a clustered domain with multiple engines controlled by an admin server

Create Domain

Choose an appropriate directory location and name.

Examples:

/home/oracle/wsc72/user_projects/domains/base_domain
/home/oracle/wsc72/user_projects/domains/replicated_domain

Templates

For Basic, choose:

  • Basic WebLogic Server Domain
  • Oracle Communications WebRTC Session Controller Basic Domain
  • WebLogic Coherence Cluster Extension

For Replicated, choose:

  • Basic WebLogic Server Domain
  • Oracle Communications WebRTC Session Controller Replicated Domain
  • WebLogic Coherence Cluster Extension

The other choices are optional. It doesn't hurt to install them too.

  • WebLogic Advanced Web Services for JAX-RPC Extension
  • WebLogic Advanced Web Services for JAX-WS Extension
  • WebLogic JAX-WS SOAP/JMS Extension

Administrator Account

Create a username and password.

Domain Mode and JDK

For Basic, choose "Development".

For Replicated, choose "Production".

Verify the JDK is correct.

Advanced Configuration

Do not make any modifications to the default values. Just click 'Next' to continue.

Configuration Summary

Click 'Create' to continue.

Check out Troubleshooting if the Configuration Wizard seems to hang at 33% completion.

Modify Listen Address

The WSC-SE Replicated Domain Configuration Wizard leaves the server's "listen address" blank, which defaults to 'localhost'. That only works with the "Basic Domain". You will get a startup error with a Replicated Domain. To correct this, modify the /config/config.xml file and change the <listenAddress>.

Example:

<listen-address>wsc-admin</listen-address>

Do this for the AdminServer, engine1 and engine2 servers.

Start Admin Console

To start the Signaling Engine's Admin console, navigate to the newly created domain and run 'startWebLogic.sh'.

Example:

cd /home/oracle/wsc72/user_projects/domains/base_domain/bin
./startWebLogic.sh

Verify the WebLogic console is running by navigating to:

https://<host>:7002/console

Enable DNS Lookup.

  1. In the Domain Structure pane, select SipServer.
  2. Select the Configuration tab and then select the General sub tab.
  3. In the General sub tab, scroll down and select the Enable DNS Server Lookup option.
  4. Click Save.

Disable SSL Hostname Verification.

  1. In the Domain Structure pane, expand Environment, and select Servers.
  2. In the Summary of Servers pane, select the Configuration tab.
  3. For each of your servers in the Servers table, do the following:

    1. Click the server name in the table, for example, AdminServer.
    2. In the Settings for ServerName pane, select the SSL tab.
    3. Expand the Advanced settings at the bottom of the pane.
    4. From the Hostname Verification list box entries, select None.
    5. Click Save.

If clustered, configure the Coherence Security Framework:
http://www.oracle.com/pls/topic/lookup?ctx=wsc72&amp;id=COHSG5495

Verify the WSC console is running by navigating to:

https://<host>:7002/wsc-console
  1. From the Home tab, select Signaling Engine.
  2. Click Edit.
  3. In the Proxy Registrar URI field, enter the URI of the proxy registrar, as sip:/hostname:port.
  4. Click Save to save your changes.

Post Installation

In the WebLogic Console, set