Contents
Preparing for Installation
- In release 9.0, all iWD components operate as standalone components.
- JDBC drivers provided along with IPs (iWD History Node, iWD Datamart and iWD SSJE) are only for sample purposes. Customers must provide appropriate JDBC drivers for iWD History Node, iWD Datamart, iWD SSJE and GAX (for iWD Plugin for GAX).
- iWD does not support UCS 9.x.
Prerequisites
Software Environment
- From release 9.0.2, iWD requires:
- Eclipse in order to use the Composer version of the iWD BP.
- ActiveMQ installation with appropriate driver (see Installation Phase Overview).
- For the new iWD Manager user interface, these are the minimum browser requirements (Genesys strongly recommends latest versions at all times):
- Google Chrome (40+)
- Mozilla Firefox (52+)
- Microsoft Internet Explorer 11+
- Apple Safari 9+
- For production deployments, install the Genesys Rules System web applications on a separate instance of the application server.
- A supported database server must be installed, with the database created and accessible for both the iWD Data Mart and the iWD History Node database. Since connection to these databases will be made via JDBC make sure to have in possession suitable JDBC drivers for your database of choice.
Genesys Components
The following procedure applies for iWD Manager, iWD History Node and iWD Runtime Node:
- Under your installation folder, locate the JavaServerStarter.ini file (for Windows) or the iwd_<component_name>.sh file (for Linux, <component_name> is either manager, history or runtime for the corresponding component).
- Remove the -Dfile.encoding=UTF-8 part from the [JavaArgs] section (for Windows) or from JAVA_OPTS (for Linux).
For iWD Manager only, also add the following Java options under the same location as described above to avoid possible localization issues:
- -Duser.language=en
- -Duser.region=EN
However if non-Latin characters are expected, then refer to the following links for more details on how to apply Unicode support:
For instance, Transport Protocol Parameter string-attributes-encoding should be passed in the connection to Configuration Server for non-UTF-8 data processing by iWD components. You can find more details in the links above.
Components List (minimum)
- Management Framework—8.5.1
- Interaction Server—
- 8.5.110 for releases of iWD up to 9.0.008.xx.
- 8.5.3+ for releases of iWD from 9.0.009.23 onwards. DB Server connection is not supported: an ODBC connection must be used.
- Universal Routing Server—8.1.400
- Orchestration Server—8.1.400.48
- Universal Contact Server—8.5.300.09 (Note: iWD does not support UCS 9.x.)
- Genesys Rules Engine—8.5.302
- Genesys Rules Authoring Tool—8.5.302
- GAX:
- 8.5.250.11 for releases of iWD GAX Plug-in up to and including 9.0.002.20.
- 8.5.270.06 for iWD GAX Plug-in 9.0.003.07.
- 8.5.280.06 for releases of iWD GAX Plug-in from 9.0.004 up to and including 9.0.017.01.
- 9.0.103.05 for releases of iWD GAX Plug-in from 9.0.017.10 onwards.
- Stat Server 8.5.107
- Pulse 9.0.0
Support for RHEL 64-bit Platforms
Installers support installation on Red Hat Linux 64-bit platforms but require additional packages to be installed:
- libnsl.so.1
Prior to iWD version 9.0.020.13, installers required standard compatibility packs for 32-bit platforms. These packages have generic names like:
- compat-glibc*
- compat-libstdc++*
- libstdc++*
Java configuration
Depending on what version of Java will be used to run iWD components, you need to set different environment variables:
- For Oracle JDK 8 and OpenJDK 8, set JRE_HOME.
- For OpenJDK 11, set JAVA_HOME.
iWD DVD
This DVD contains the following components:
- iWD Runtime Node—Runs scheduled iWD Data Mart services.
- iWD Manager—A graphical user interface (GUI). iWD Manager is used for real-time management of tasks.
- iWD History Node—Reporting data source for iWD Data Mart and iWD Manager .
- iWD GAX Plugin—Business configuration of the iWD solution.
- iWD Stat Extensions—Stat Server Java Extensions that provide Stat Server clients, such as CCPulse+, the ability to request and display current-day statistics from iWD’s Data Mart.
- iWD Web—A web-based, easy-to-deploy workload management solution.
Installing as Standalone Application
On Windows
To deploy on Windows, find the following files:
- JavaServerStarter.exe—This is the executable binary that is used in Windows service definition and is used to launch the application defined in the JavaServerStarter.ini file.
- JavaServerStarter.ini—This is a configuration file that allows you to define the application and its starting options. Because iWD depends on Java you can define Java options here. For example;
[Service] AppTitle="Genesys iWD Data Mart" AppVersion=9.0.000.xx JVMPath=JRE_PATH\bin\server\jvm.dll MainClass=evo/main/NodeLauncher EventHandlerMethod=stopNode [JavaArgs] -Xms256m -Xmx1536m -XX:MaxPermSize=128m [Djava.class.path] iwd_node.jar
On UNIX
On UNIX there are no JavaServerStarter files. The application uses a regular script, for example; iwd_runtime.sh, where Java with its optional arguments is explicitly called. Then you can simply use the following example:
JAVA_JRE -XX:MaxPermSize=128m -Xms256M -Xmx1536M -host Configuration Server Host -port Configuration Server Port -app Application_Name