5 Installing WebRTC Session Controller Signaling Engine

This chapter describes how to install Oracle Communications WebRTC Session Controller Signaling Engine (Signaling Engine).

Before you install Signaling Engine, you must complete all pre-installation tasks described in "WebRTC Session Controller Pre-Installation Tasks".

About the GUI Installation and Silent Installation

You can install Signaling Engine by using the GUI installation or the silent installation. The silent installation procedure enables you to perform a non-interactive installation of Signaling Engine. You can use the silent installation to install Signaling Engine quickly on multiple systems.

The silent installer uses a response file in which you specify installation settings. To obtain the response file, you first run the GUI installation, and choose to save a response file.

For installation instructions, see the following sections:

Installing Signaling Engine Using the GUI Installation
Installing Signaling Engine Using the Silent Installation

Installing Signaling Engine Using the GUI Installation

To install Signaling Engine:

If you have not done so already, download and unzip the WebRTC Session Controller software. See "General Pre-Installation Tasks" for instructions.
Log in to the system on which you want to install Signaling Engine.
The installer requires that a certified JDK already exists on your system. For more information, see "Install a Java Development Kit".
Go to the directory where you downloaded the installation program.
Launch the installation program by invoking java -jar from the JDK directory on your system, as shown in the example below:
```
java -jar wsc_generic.jar
```
If no other Oracle products are installed on the system, the Installation Inventory screen appears. Specify the location where you want to create your central inventory. Make sure that the operating system group name selected on this screen has write permissions to the central inventory location.

For more information about the central inventory, see "Understanding the Oracle Central Inventory" in Installing Software with the Oracle Universal Installer.

If an Installation Inventory already exists, the WebRTC Session Controller Installation Welcome window appears.
Click Next.

The WebRTC Session Controller Oracle Installation Location window appears.

Use this screen to specify the location of your Oracle home directory.

For more information about Oracle Fusion Middleware directory structure, see "Selecting Directories for Installation and Configuration" in Planning an Installation of Oracle Fusion Middleware.
Click Next.

The Installation Type window appears.

There is only one installation type for WebRTC Session Controller, "WebRTC Session Controller Installation," and it is selected by default.
Click Next.

The Prerequisite Checks window appears.

This screen verifies that your system meets the minimum necessary requirements.

If there are any warnings or errors, make sure that your environment meets all the necessary prerequisites. See "WebRTC Session Controller System Requirements" for more information.
Click Next.

The Security Updates window appears.

If you already have an Oracle Support account, use this screen to indicate how you would like to receive security updates.

If you do not have one and are sure you want to skip this step, clear the check box and verify your selection in the follow-up dialog box.
Click Next.

The Installation Options screen appears.

Use this screen to verify the installation options you selected. If you want to save these options to a response file, click Save Response File and provide a location and name for the response file. Response files can be used later in a silent installation situation.

Note:
If you only want to save a response file, you can exit the installation at this time.

For more information about silent mode installation, see "Installing Signaling Engine Using the Silent Installation".
Review the selections you have made, and click Install.

The Installation Progress window appears and the installation begins.

Note:
After the installation begins, if you click Cancel, the installation process stops but the files that are already copied are not removed.
When the installation is completed, click Next.

The Installation Complete window appears.

The next step is to launch the configuration wizard to create your WebLogic domain. There are two ways to do this:
- Select Automatically Launch the Configuration Wizard on this screen. After you click Finish to close the installer, the configuration wizard is started and you can begin to configure your domain. If you choose to do this, proceed to "Configuring a WebRTC Session Controller Domain".
- Do not select Automatically Launch the Configuration Wizard on this screen. After you click Finish to close the installer, you must manually start the configuration wizard to begin configuring your domain. If you choose to do this, proceed to "Starting the Configuration Wizard".

Installing Signaling Engine Using the Silent Installation

The silent installation uses a response file in which you have set installation information. To obtain the response file, you run the GUI installer up until the Installation Options pane appears. You can then save a response file that contains the key and values pairs based on the values that you specify during the GUI installation. You can then copy and edit the response file to create additional response files for installing Signaling Engine on additional machines.

Creating a Response File

The response file must contain the key and value pairs for the mandatory parameters the installer must use for the Signaling software component you install. All information prompted in the GUI installation is associated with mandatory parameters.

To create a response file:

Run the GUI installation for Signaling Engine. See "Installing Signaling Engine Using the GUI Installation" for instructions.
When the Installation Options screen appears, click Save Response File and provide the location and name for the response file.
Modify the response file you copied by specifying the key and value information for the parameters you want in your installation.
Save and close the response file.

Note:

For information on response file key and value pairs, see "Using the Oracle Universal Installer in Silent Mode" in Installing Software with the Oracle Universal Installer.

Performing a Silent Installation

To perform a silent installation:

Create a response file. See "Creating a Response File" for instructions.
Download and unzip the WebRTC Session Controller software on the machine on which you will run the silent installation. See "General Pre-Installation Tasks" for instructions.
Copy the response file you created to the machine on which you will run the silent installation.
On the machine on which you will run the silent installation, run the following command:
```
java -jar wsc_generic.jar -silent -responseFile fullpathtoresponsefile
```
Where fullpathtoresponsefile is the full path including the filename of your response file

For example:
```
java -jar wsc_generic.jar -silent -responseFile /home/user/responsefile.txt
```

The WebRTC Session Controller Installer checks for all required software and writes errors to a log file if it detects any missing or unavailable components, or if there are any connectivity-related issues.

See "Troubleshooting a Signaling Engine Installation" for information about WebRTC Session Controller Signaling Engine installer logs.

Next Steps

After you install Signaling Engine, you must configure a Signaling Engine domain. See "Creating and Configuring a WebRTC Session Controller Signaling Engine Domain" for instructions.

Note:

To uninstall Signaling Engine, you run the command Oracle_home/oui/bin/desinstall.sh and click Next and then click Deinstall. See "Oracle Universal Installer Deinstallation Screens" in Oracle Fusion Middleware Installing with the Oracle Universal Installer for more information.

You will have to remove the Oracle_home directory before you can reinstall the software.