Installing the SIS

1. Install and start Rhino

Rhino (or the Rhino SDK) must be installed and running before anything else can be installed.

Warning

The deployable units for both SIS and CGIN include a large number of generated classes. It is highly recommended to increase the maximum permanent generation memory size used by Rhino to at least 256Mb to avoid seemingly random JVM hangs caused by garbage collection thrashing, out of memory errors, or other related problems that can be attributed to the JVM having to load this quantity of classes.

  • For Rhino, you need to edit the read-config-variables file in the ${RHINO_HOME}/etc/defaults directory and each ${RHINO_HOME}/node-XXX directory.

  • For the Rhino SDK, you need to edit the ${RHINO_HOME}/config/jvm_args file.

In each file, search for -XX:MaxPermSize and set the value of this option to 256m. Rhino (or the Rhino SDK) needs be to restarted for this change to take effect.

2. Install the CGIN Connectivity Pack

The SIS 2.5.4 depends on the CGIN Connectivity Pack 1.5.4 — you must download and install it before using the SIS.

Warning

See the SIS Compatibility Guide for further information on using CGIN with the SIS.

Note that the 'trial' version of the SIS can only be used in conjunction with the 'trial' version of the CGIN Connectivity Pack. Similarly, the 'full' version of the SIS can only be used in conjunction with the 'full' version of the CGIN Connectivity Pack.

Typically, the CGIN Connectivity Pack will be extracted directly into the Rhino (or Rhino SDK) directory:

$ cd RhinoSDK
$ unzip ~/downloads/cgin-connectivity-full-1.5.4.6.zip
Archive:  ~/downloads/cgin-connectivity-full-1.5.4.6.zip
   creating: cgin-connectivity-full-1.5.4.6/
   creating: cgin-connectivity-full-1.5.4.6/du/
   creating: cgin-connectivity-full-1.5.4.6/examples/
   creating: cgin-connectivity-full-1.5.4.6/examples/META-INF/
   creating: cgin-connectivity-full-1.5.4.6/examples/src/
  ...
Tip The fourth digit of the CGIN Connectivity Pack version indicates the patch release version and may be different from the example shown above.

3. Unpack the SIS

Typically, the SIS (like the CGIN Connectivity Pack) should be extracted directly into the Rhino (or Rhino SDK) directory:

$ cd RhinoSDK
$ unzip ~/downloads/sis-full-2.5.4.10.zip
Archive:  ~/downloads/sis-full-2.5.4.10.zip
   creating: sis/
   creating: sis/2.5.4.10/
   creating: sis/2.5.4.10/admin/
   creating: sis/2.5.4.10/admin/common/
   creating: sis/2.5.4.10/admin/etc/
   creating: sis/2.5.4.10/admin/lib/
   creating: sis/2.5.4.10/admin/lib/extensions/

    ...
Tip The fourth digit of the SIS package version indicates the patch release version and may be different from the example shown above.

4. Configure the SIS

Initial SIS configuration may require modification of the following files:

Directory File What it should contain
sis/2.5.4.x
cgin-connectivity.properties

This file defines a property which specifies the path to the CGIN Connectivity Pack for the SIS, as either an absolute or relative path. If relative, must be relative to the sis/2.5.4.x directory.

The default value for the path is a relative path to the expected CGIN Connectivity Pack, extracted in the Rhino (or Rhino SDK) directory. For example, the full version of the standard SIS install has a default path value of ../../cgin-connectivity-full-1.5.4. Note that the path separator character / used in this file will automatically be converted to the local platform path separator when this file is used by the SIS.

If both the CGIN Connectivity Pack and the SIS have been extracted into the same Rhino (or Rhino SDK) directory, then this configuration file only needs to be modified to append the fourth digit of the specific CGIN Connectivity Pack patch release being used. Otherwise, the entire path will need to be modified as necessary.

sis/2.5.4.x/admin/etc
client.ant.properties

and

client.shell.properties

or in Windows:

client.windows.properties.bat

These files each define a property which specifies the path to the client directory of the Rhino (or Rhino SDK) install, as either an absolute or relative path. If relative, must be relative to the sis/2.5.4.x directory.

If both the CGIN Connectivity Pack and the SIS have been extracted into the same Rhino (or Rhino SDK) directory, then these files should not need to be modified.

5. Install the SIS

To install the SIS into Rhino, run sis/2.5.4.x/admin/install-sis (or install-sis.bat in Windows).

The SIS installation prompts for the following parameters:

Parameter Description
IN Config Profile Table

Name of the profile table to create, to store SIS IN configurations.
Defaults to sis-configs-in

SIP Config Profile Table

Name of the profile table to create, to store SIS SIP configurations.
Defaults to sis-configs-sip

Rhino SIS license

File path to the Rhino license file to use with the SIS (if you have one).

The installer, after confirming values for each parameter, installs the required deployable units from the CGIN Connectivity Pack and the SIS, creates the SIS configuration profile tables, and installs the license file (if specified).

Example install-sis

Below is an example of a SIS installation.

$ cd sis/2.5.4.10/admin
$ ./install-sis
Using client base directory: /home/rhino/RhinoSDK/client
SIS Installer
=============

General
=======
General settings

IN Config Profile Table
-----------------------
The name of the profile table used to store basic SIS instance configuration
information for IN.

IN Config Profile Table [sis-configs-in]:

SIP Config Profile Table
------------------------
The name of the profile table used to store basic SIS instance configuration
information for SIP.

SIP Config Profile Table [sis-configs-sip]:

Rhino SIS license
-----------------
A license may already be installed, or you may choose to install a license at
a later point in time.  If you do not want to install a license at this time
provide an empty response.  If no license is present at the time a SIS
instance is created, however, the SIS instance will need to be activated
manually via the console.

Rhino SIS license []:


*** Confirm settings ***

IN Config Profile Table:  sis-configs-in
SIP Config Profile Table: sis-configs-sip
Rhino SIS license:

Are these settings correct (y/n)? y

Installing /home/rhino/RhinoSDK/cgin-connectivity-full-1.5.4.6/du/oc-common-1.6.1.du.jar as file:cgin/oc-common-1.6.1.du.jar...
Installing /home/rhino/RhinoSDK/cgin-connectivity-full-1.5.4.6/du/cgin-common-1.5.4.6.du.jar as file:cgin/cgin-common-1.5.4.6.du.jar...
Installing /home/rhino/RhinoSDK/cgin-connectivity-full-1.5.4.6/du/in-datatypes-5.1.5.4.6.du.jar as file:cgin/in-datatypes-5.1.5.4.6.du.jar...
Installing /home/rhino/RhinoSDK/cgin-connectivity-full-1.5.4.6/du/callcontrol-1.5.4.6.du.jar as file:cgin/callcontrol-1.5.4.6.du.jar...
Installing /home/rhino/RhinoSDK/cgin-connectivity-full-1.5.4.6/du/map-1.5.4.6.du.jar as file:cgin/map-1.5.4.6.du.jar...
Installing /home/rhino/RhinoSDK/cgin-connectivity-full-1.5.4.6/du/cap_v1-1.5.4.6.du.jar as file:cgin/cap_v1-1.5.4.6.du.jar...
Installing /home/rhino/RhinoSDK/cgin-connectivity-full-1.5.4.6/du/cap_v2-1.5.4.6.du.jar as file:cgin/cap_v2-1.5.4.6.du.jar...
Installing /home/rhino/RhinoSDK/cgin-connectivity-full-1.5.4.6/du/cap_v3-1.5.4.6.du.jar as file:cgin/cap_v3-1.5.4.6.du.jar...
Installing /home/rhino/RhinoSDK/cgin-connectivity-full-1.5.4.6/du/cap_v4-1.5.4.6.du.jar as file:cgin/cap_v4-1.5.4.6.du.jar...
Installing /home/rhino/RhinoSDK/cgin-connectivity-full-1.5.4.6/du/etsi_inap_cs1-1.5.4.6.du.jar as file:cgin/etsi_inap_cs1-1.5.4.6.du.jar...
Installing /home/rhino/RhinoSDK/sis/2.5.4.10/du/jsip-library-1.2.du.jar as file:sip/jsip-library-1.2.du.jar...
Installing /home/rhino/RhinoSDK/sis/2.5.4.10/du/sis-common-2.5.4.10.du.jar as file:sis/sis-common-2.5.4.10.du.jar...
Installing /home/rhino/RhinoSDK/sis/2.5.4.10/du/sis-scs-ratype-2.5.4.10.du.jar as file:sis/sis-scs-ratype-2.5.4.10.du.jar...
Installing /home/rhino/RhinoSDK/sis/2.5.4.10/du/sis-interceptors-ratype-2.5.4.10.du.jar as file:sis/sis-interceptors-ratype-2.5.4.10.du.jar...
Installing /home/rhino/RhinoSDK/sis/2.5.4.10/du/sis-cap-ratype-2.5.4.10.du.jar as file:sis/sis-cap-ratype-2.5.4.10.du.jar...
Installing /home/rhino/RhinoSDK/sis/2.5.4.10/du/cgin-message-utils-common-1.1.0.10.du.jar as file:sis/cgin-message-utils-common-1.1.0.10.du.jar...
Installing /home/rhino/RhinoSDK/sis/2.5.4.10/du/cgin-message-utils-voice-ratype-2.5.4.10.du.jar as file:sis/cgin-message-utils-voice-ratype-2.5.4.10.du.jar...
Installing /home/rhino/RhinoSDK/sis/2.5.4.10/du/cgin-message-utils-sms-ratype-2.5.4.10.du.jar as file:sis/cgin-message-utils-sms-ratype-2.5.4.10.du.jar...
Installing /home/rhino/RhinoSDK/sis/2.5.4.10/du/sis-in-base-full-2.5.4.10.du.jar as file:sis/sis-in-base-full-2.5.4.10.du.jar...
Installing /home/rhino/RhinoSDK/sis/2.5.4.10/du/sis-cgin-unified-ra-full-2.5.4.10.du.jar as file:sis/sis-cgin-unified-ra-full-2.5.4.10.du.jar...
Installing /home/rhino/RhinoSDK/sis/2.5.4.10/du/easysip-ratype-1.4.10.du.jar as file:sip/easysip-ratype-1.4.10.du.jar...
Installing /home/rhino/RhinoSDK/sis/2.5.4.10/du/sis-sip-base-full-2.5.4.10.du.jar as file:sis/sis-sip-base-full-2.5.4.10.du.jar...
Installing /home/rhino/RhinoSDK/sis/2.5.4.10/du/sis-easysip-full-2.5.4.10.du.jar as file:sis/sis-easysip-full-2.5.4.10.du.jar...
Creating profile table sis-configs-in using ProfileSpecificationID[name=SIS-IN Configuration Profile,vendor=OpenCloud,version=2.5.2]...
Creating profile table sis-configs-sip using ProfileSpecificationID[name=SIS-SIP Configuration Profile,vendor=OpenCloud,version=2.5.2]...
Installation successful

Next Steps:
- Create a SIS instance using create-sis-in-instance or
  create-sis-sip-instance.
- Use sis-console or Ant to install triggers and compositions into the SIS.
- Visit the Developer Portal at
  https://developer.opencloud.com/devportal/display/SISD/SIS+Documentation
  for further documentation.
Previous page Next page
SIS Version 2.5.4