Before you install Sentinel IPSMGW, you need to download the SDK package, and get other required software.

You can then either:

  • let the built-in installer install both the Rhino SDK and Sentinel IPSMGW, or

  • install and configure Rhino and the JVM manually, then use the installer to install Sentinel IPSMGW into your Rhino

In both cases you need to get a license.

Allowing the installer to install both the Rhino SDK and Sentinel IPSMGW software is recommended for functional testing or experimentation with Sentinel IPSMGW. For production installs and/or load testing it is recommended to manually install and configure Rhino and the JVM.

A Cassandra database is required for an IPSMGW installation.

An OCSS7 Stack is required for an IPSMGW installation.

Finally, if you are planning to install Sentinel IPSMGW on an existing OpenCloud Rhino installation, it makes sense to refer to other OpenCloud product dependencies

Download the Sentinel IPSMGW SDK package

To get the latest Sentinel IPSMGW SDK package go to https://repo.opencloud.com/artifactory/opencloud-sentinel-ipsmgw-3.1.0/opencloud/sentinel-ipsmgw/3.1.0/ipsmgw-sdk/ Choose the version with the highest release number.

The SDK package contains an installer, that can install Sentinel IPSMGW as an out-of-the-box system. It is also an SDK allowing customisation of the product.

Note You will need OpenCloud-supplied credentials to download the package.

Get required software

You’ll need the following software to run Sentinel IPSMGW:

Software Download Link Documentation Link

Java JDK 8, update 172 or later

http://www.oracle.com/technetwork/java/javase/downloads/jdk8-downloads-2133151.html

Apache Tomcat 7.0.39 or greater (7.0.x series or 8.5.x series, not 9.x.x series)

http://tomcat.apache.org

Rhino 2.7.0.0 or later - optional - to be used when installing and configuring Rhino manually

Rhino 2.7.0 SDK from Artifactory

Rhino Documentation

Rhino Element Manager 2.7.0.0 or later

REM Download Page

REM Documentation

Sentinel IP-SM-GW SDK including out of the box installer

Sentinel IPSMGW SDK, from Artifactory

Sentinel IPSMGW documentation space

Sentinel IP-SM-GW plugin for Rhino Element Manager

Sentinel IPSMGW EM Extension, from Artifactory

Installing the IPSMGW Element Manager Module

Cassandra Database, version 2.1.17 or later version from the 2.1.x series.

http://cassandra.apache.org/download/

http://cassandra.apache.org/doc/latest/getting_started/index.html

OCSS7, version 2.2.0.0 or later

OCSS7 Package from Artifactory

https://docs.opencloud.com/ocdoc/books/ocss7/2.2.0/ocss7-home/index.html

Install and configure Rhino and the JVM

Optionally you can install and configure Rhino and the JVM for use with Sentinel IPSMGW. This is recommended for production deployments, and clustered setups.

Alternatively for Proof of Concept and lab functional testing it is recommended to use the Installer documented in Installing Sentinel IPSMGW Services

Install Rhino

1

Start by choosing a location to extract the contents of the Rhino package.

We’ll refer to this directory as RHINO_HOME.

2

Rhino must be started at least once to generate the necessary configuration files. To start Rhino, in the RHINO_HOME directory, execute:

start-rhino.sh

3

Wait until Rhino is ready. It prints the following message in its log when ready:

SLEE successfully started on node(s) [101]

4

Stop Rhino by executing in the RHINO_HOME directory:

stop-rhino.sh --nice
Tip For more about installing and configuring the Rhino TAS, please see the Rhino Documentation.

Configure Rhino and the JVM

If you want to install Sentinel IPSMGW in top of an already running Rhino then this step must be performed. If you are letting the installer configure the Rhino SDK for you, this step can be skipped.

The following settings are needed:

Setting Configuration

Management database size

For a full Sentinel IPSMGW install, the default Rhino 2.5 management database size is insufficient and should be increased to at least 300MB. To do this, edit RHINO_HOME/config/rhino-config.xml on all nodes, increasing the <committed-size> in the following section:

    <memdb>
      <jndi-name>ManagementDatabase</jndi-name>
      <message-id>10003</message-id>
      <group-name>rhino-db</group-name>
      <committed-size>300M</committed-size>
      <stripe-count>1</stripe-count>
      ...
    </memdb>

JVM

You’ll also need to configure the JVM:

In RHINO_HOME/config/config_variables:

  • The Rhino HEAP_SIZE setting should be set to 2048m at a minimum.

  • The recommended MAX_NEW_SIZE and NEW_SIZE setting for a Rhino node running Sentinel IPSMGW is 1/4th of the total heap size (for example, 512m when the HEAP_SIZE is 2048m).

In RHINO_HOME/config/jvm_args:

  • The MaxPermGen size should be increased from its default, to at least 384MB. To do this in Rhino 2.5, modify the flags -XX:MaxPermSize= and -XX:PermSize=.

  • These JVM settings are recommended for IPSMGW:

    • -XX:MaxTenuringThreshold=2

    • -XX:SurvivorRatio=16

    • -XX:CMSInitiatingOccupancyFraction=60

Socket permissions

You will need to add the host address where the installer is running to the mlet configuration file.

  • For RhinoSDK the configuration file is RHINO_HOME/config/mlet.conf

  • For Rhino Production the configuration file is RHINO_HOME/node-xxx/config/permachine-mlet.conf

  • In the configuration file look for the xmltag <security-permission-spec> and add the following entry, replacing <IP ADDRESS> with your installer’s IP address:

<mlets>
    <mlet enabled="true">
        <classpath>
            <jar-url>$${rhino.dir.base.url}/lib/jmxr-adaptor.jar</jar-url>
            <security-permission-spec>
		.... other entries

		permission java.net.SocketPermission "<IP ADDRESS>", "accept,resolve";

		.... other entries
 	    </security-permission-spec>
        </classpath>
    </mlet>
</mlets>
Important
Start Rhino to load the new configuration

To start Rhino, in the RHINO_HOME directory run start-rhino.sh (or start-rhino.bat on Microsoft Windows).

This applies the Rhino and JVM configuration.

Get a license

Warning To install Sentinel IPSMGW you need a license to run SIS, CGIN, and Sentinel IPSMGW from OpenCloud. In order to obtain a license file, please contact OpenCloud. A full overview of license requirements can be found of this page: License Requirements.

If you allow the installer to install both Rhino SDK and Sentinel IPSMGW for you, it will prompt you for the location of the license file.

If you prefer to set up Rhino manually, then you need to install the license file prior to installing Sentinel IPSMGW.

To install your license file:

1

Make sure Rhino is started and running.

2

Go to the RHINO_HOME/client/bin directory.

3

In this directory, start the Rhino Console with the rhino-console script (or rhino-console.bat in Microsoft Windows).

4

In the Rhino Console execute, this command:

installlicense [PATH_TO_LICENSE_FILE]

([PATH_TO_LICENSE_FILE] should be relative to the RHINO_HOME/client/bin directory.)

Ports

If using the standard configuration, the following ports need to be open on the IPSMGW TAS host’s firewall.

Port Purpose

5060

SIP traffic

5061

Secure SIP traffic

8080

REM GUI

1199-1203

RMI Access

If using other configuration the firewall should be configured for those non-standard ports. Other ports may be opened as needed. For example if ssh is used to administer a node, then port 22 would be opened

Cassandra Database

Install and configure a Cassandra Storage with the opencloud_thirdparty_reg, opencloud_ipsmgw_routing_info, and opencloud_ipsmgw_registration_ownership keyspaces.

OCSS7 Stack

Install and configure an OCSS7 stack. Refer to OCSS7 Quick Start.

OpenCloud product dependencies

Sentinel IPSMGW is built on top of other OpenCloud products. The IPSMGW series depends on the following:

Product Series

Rhino

2.7.0.x

REM

2.7.0.x

SIP

2.7.0.x

CGIN

2.0.0.x

SIS

2.7.0.x

SIS-EM

2.6.1.x

Diameter

3.1.3.x

CDR-RA

2.3.0.x

HTTP-RA

2.5.0.x

DB-Query-RA

1.4.0.x

FSM Tool

1.3.0.x

CQL-RA

1.2.0.x

Previous page Next page
Sentinel IP-SM-GW Version 3.1.0