This chapter describes the steps required to create your WebRTC Session Controller Signaling Engine (Signaling Engine) domain after your software has been successfully installed.
After you install the Signaling Engine software, you must create a domain for your deployment. Before continuing in this chapter, you need to understand WebLogic domains and clustering, and the domain topologies available for use with WebRTC Session Controller Signaling Engine
To learn about WebLogic domains and clustering, see "WebLogic Server Domains" and "WebLogic Server Clustering" in Understanding Oracle WebLogic Server.
To learn about the domain topologies available for use with WebRTC Session Controller Signaling Engine, see "Understanding Signaling Engine Installation Topologies".
This section provides instructions for creating a WebRTC Session Controller domain using the configuration wizard. For more information on other methods available for domain creation, see "Additional Tools for Creating, Extending, and Managing WebLogic Domains" in Creating Domains Using the Configuration Wizard.
The following topics are covered in this section:
There are a selection of domain templates to choose from but only two are relevant to Signaling Engine:
Oracle Communications WebRTC Session Controller Replicated Domain
The Replicated Domain template enables you to create a replicated WebRTC Session Controller Signaling Engine domain. The Replicated Domain topology is designed for use with WebRTC applications that require high levels of scalability, availability, and performance.
Oracle Communications WebRTC Session Controller Basic Domain
The Basic Domain template enables you to create a simple Signaling Engine domain. Such a domain configuration can be used during development where it is more convenient to deploy and test applications on a single server.
In addition, each domain type can be extended to add Diameter support. For more information, see the discussion of WebRTC Session Controller Diameter Rx to Policy Charging and Rules (PCRF) configuration in the Oracle Communications WebRTC Session Controller System Administrator's Guide.
If you are configuring a Signaling Engine replicated domain, keep the following tips in mind for ease of deployment:
Keep the directory structures the same on each machine in the cluster to simplify deployment.
Install the Signaling Engine binaries on each machine in the cluster.
Install any required patches manually on each machine in the cluster; they are not distributed automatically.
Synchronize the file Domain_home/security/SerializedSystemIni.dat between each managed server residing on separate machines before starting the managed servers.
Create the replicated domain on your admin server, and copy that domain to each of your cluster machines.
Note:
If the administration server is already started before you copy its domain to the cluster servers, delete the existing domains on each cluster server:
rm -rf Domain_home/servers/
To begin domain configuration, navigate to the Oracle_home/wlserver/common/bin directory and start the Fusion Middleware Configuration Wizard:
./config.sh
Note:
If, while installing Signaling Engine using the GUI installation wizard, you checked the Automatically Launch the Configuration Wizard check box, the Domain Configuration wizard will already be running.Follow the instructions in this section to configure the domain using the Configuration Wizard.
On the Configuration Type screen, select Create a New Domain.
In the Domain Location field, specify your Domain home directory.
It is recommended that you locate your Domain outside the Oracle home directory. This directory structure will help you avoid issues when you need to upgrade or re-install your software.
Tip:
More information about the Domain home directory can be found in "Choosing a Domain Home" in Planning an Installation of Oracle Fusion Middleware.More information about the other options on this screen can be found in "Configuration Type" in Creating Domains Using the Configuration Wizard.
Click Next.
The Templates window appears.
On the Templates screen select one of the following templates:
Oracle Communications WebRTC Session Controller Replicated Domain
Oracle Communications WebRTC Session Controller Basic Domain
Selecting this template also selects WebLogic Coherence Cluster Extension.
Note:
The template Basic WebLogic Server Domain is selected by default and cannot be deselected.More information about the options on this screen can be found in "Templates" in Creating Domains Using the Configuration Wizard.
Click Next.
The Administrator Account screen appears.
On the Administrator Account screen, specify the user name and password for the default WebLogic Administrator account for the domain. This account is used to connect to the domain's Administration Server.
Tip:
You must make a note of the user name and password you choose to enter here; you will need this in order to be able to start and access the Administration Server.Click Next.
The Domain Mode and JDK screen appears.
On the Domain Mode and JDK screen:
Select Development or Production in the Domain Mode field.
Select Oracle Hotspot JDK in the JDK field or choose a different supported JDK.
See "Signaling Engine Software Requirements" for information on supported JDKs.
Selecting Production Mode on this screen gives your environment a higher degree of security, requiring a user name and password to deploy applications and to start the Administration Server.
Tip:
In production mode, a boot identity file can be created to bypass the need to provide a user name and password when starting the Administration Server. For more information, see "Creating a Boot Identity File for an Administration Server" in Administering Server Startup and Shutdown for Oracle WebLogic Server.Click Next.
There are several advanced options you can choose to configure on the Advanced Configuration screen:
Administration Server
Checking this option lets you configure the listen address of the Administration Server.
Node Manager
Checking this option lets you configure Node Manager. For more information on Node Manager, see "Node Manager Overview" in Oracle Fusion Middleware Administering Node Manager for Oracle WebLogic Server.
Managed Servers, Clusters and Coherence
Checking this option lets you configure the Managed Servers, Clusters, and also lets you configure the machine and assign Managed Servers to the machine.
Tip:
If you want to configure dynamic clusters, see the following:"Overview of Dynamic Clusters" in Understanding Oracle WebLogic Server.
"Creating Dynamic Clusters" in Administering Clusters for Oracle WebLogic Server.
Deployments and Services
Checking this option lets you customize how application deployments and services are targeted to servers and clusters.
Check the advanced options you wish to configure.
Note:
If you are configuring a Oracle Communications WebRTC Session Controller Replicated Domain in Production Mode, you must select the following advanced options:Administration Server
Managed Servers, Clusters and Coherence
If those options are not configured the WebLogic server will not start.
If you have not checked any advance options, click Next and continue to step 8. Otherwise, click Next and follow this sub procedure:
If you have chosen the Administration Server advanced option, the Administration Server screen appears.
For more information on the options available on this screen, click the Help button and refer to the Wizard's online help. You can also refer to "Administration Server" in Oracle Fusion Middleware Creating WebLogic Domains Using the Configuration Wizard.
Note:
If you are configuring a Oracle Communications WebRTC Session Controller Replicated Domain in Production Mode, you must enter the Listen Address for the Administration Server.Make any updates required and click Next.
If you have chosen the Node Manager advanced option, the Node Manager screen appears.
For more information on the options available on this screen, click the Help button and refer to the Wizard's online help. You can also refer to "Node Manager" in Oracle Fusion Middleware Creating WebLogic Domains Using the Configuration Wizard.
Make any updates required and click Next.
If you have chosen the Managed Servers, Clusters and Coherence advanced option, the Managed Server screen appears. Otherwise, skip to step 8.
For more information on the options available on this screen, click the Help button and refer to the Wizard's online help. You can also refer to "Managed Servers" in Oracle Fusion Middleware Creating WebLogic Domains Using the Configuration Wizard.
Note:
If you are configuring a Oracle Communications WebRTC Session Controller Replicated Domain in Production Mode, you must select or enter the Listen Address for each engine in the Managed Servers screen.Make any updates required and click Next.
The Clusters screen appears.
For more information on the options available on the Clusters screens, click the Help button and refer to the online help. You can also refer to "Clusters" in Oracle Fusion Middleware Creating WebLogic Domains Using the Configuration Wizard.
Note:
You must also enter the Cluster Address for the engine cluster.Make any updates required and click Next.
The Assign Servers to Clusters screen appears.
For more information on the options available on the Assign Servers to Clusters screen, click the Help button and refer to the online help. You can also refer to "Assign Servers to Clusters" in Oracle Fusion Middleware Creating WebLogic Domains Using the Configuration Wizard.
Note:
You must also enter the Cluster Address for the engine cluster.Make any updates required and click Next.
If you have included Coherence in the WebRTC Session Controller Installation, the Coherence Clusters screen appears. If you have not included Coherence, this screen will be skipped.
For more information on the options available on the Coherence Clusters screens, click the Help button and refer to the online help. You can also refer to "Coherence Clusters" in Oracle Fusion Middleware Creating WebLogic Domains Using the Configuration Wizard.
Make any updates required and click Next.
The Machines screen appears.
For more information on the options available on the Machines screen, click the Help button and refer to the online help. You can also refer to "Machines" in Oracle Fusion Middleware Creating WebLogic Domains Using the Configuration Wizard.
Make any updates required and click Next.
The Assign Servers to Machines screen appears.
For more information on the options available on the Machines screen, click the Help button and refer to the online help. You can also refer to "Assign Servers to Machines" in Oracle Fusion Middleware Creating WebLogic Domains Using the Configuration Wizard.
Make any updates required and click Next.
The Configuration Summary screen appears.
The Configuration Summary screen contains the detailed configuration information for the domain you are about to create. Review the details of each item on the screen and verify that the information is correct.
You can go back to any previous screen if you need to make any changes, either by using the Back button or by selecting the screen in the navigation pane.
Domain creation will not begin until you click Create.
The Configuration Success screen will show the following items about the domain you just configured:
Domain Location
Administration Server URL
You must make a note of both items as you will need them to start the servers and access the Administration Server.
Click Finish to close the configuration wizard.
After configuration is complete, in order to access the tools with which you can manage your domain, you must start the necessary servers. See the following topics for more information:
To start your per-domain Node Manager, go to the Domain_home/bin directory.
Start Node Manager as shown below, using nohup and nm.out as an example output file:
nohup ./startNodeManager.sh > nm.out&
Note:
It is recommended that you install Node Manager to run as a startup service. This allows Node Manager to start up automatically each time the system is restarted.For more information, see "Running Node Manager as a Startup Service" in Administering Node Manager for Oracle WebLogic Server.
To start the Administration Server, go the Domain_home/bin directory and run:
./startWebLogic.sh
If you selected Production Mode on the Domain Mode and JDK screen in step 5, you will be prompted for the login credentials of the Administrator user as provided on the Administrator Account screen in step 4.
Tip:
For more information about starting the Administration Server, see "Starting and Stopping Administration Servers" in Administering Oracle Fusion Middleware.In production mode, a boot identity file can be created to bypass the need to provide a user name and password when starting the Administration Server. For more information, see "Creating a Boot Identity File for an Administration Server" in Administering Server Startup and Shutdown for Oracle WebLogic Server.
Note:
Before starting WebRTC Session Controller Managed Servers, copy domain_home/security/SerializedSystemIni.dat file from the Admin server to same directory on the managed server.To start the Managed Servers, go the Domain_home/bin directory and run the following command:
./startManagedWebLogic.sh managed_server_name admin_server_url
Replace managed_server_name with the name of the Managed Server you want to start.
Replace admin_server_url with the full URL of the Administration Server, as provided on the Configuration Success screen in step 9.
Below are sample commands used to start wsc-se_server_1 and wse-se_server_2 on UNIX operating systems:
./startManagedWebLogic.sh wsc-se_server_1 t3://host.example.com:7001 & ./startManagedWebLogic.sh wsc-se_server_2 t3://host.example.com:7001 &
Tip:
For more information about starting Managed Servers, see "Starting and Stopping Managed Servers" in Administering Oracle Fusion Middleware.The following example shows how to start a Signaling Engine replicated domain. For this example, the deployment model consists of three machines:
An Admin server with the IP address 10.1.1.1
A clustered machine with the IP address 10.1.1.2, hosting an engine, engine1.
A second clustered machine with the IP address 10.1.1.3, hosting an engine, engine2.
To start the example replicated domain:
On the Admin server, 10.1.1.1 execute
cd Domain_home/bin
./startWeblogic.sh
On the first clustered machine, execute:
cd Domain_home/bin
./startManagedWebogic.sh engine1 t3://10.1.1.1:7001
On the second clustered machine, execute:
cd Domain_home/bin
./startManagedWebogic.sh engine2 t3://10.1.1.1:7001
After you have configured the Signaling Engine domain, you must complete Signaling Engine post-installation tasks. See "WebRTC Session Controller Signaling Engine Post-Installation Tasks" for instructions.