Installing the SIS
1. Install and start Rhino
|
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.
In each file, search for |
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.
|
|
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/ ...
|
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/
...
|
|
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 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 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 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. |
SIP Config Profile Table |
Name of the profile table to create, to store SIS SIP configurations. |
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.
