Installing Runtime Node
This section describes the procedures that are used to install iWD Runtime Node.
The iWD Runtime Node must be installed as a standalone Java application server before it can run iWD services. When deploying services for multiple solutions, each solution should have its own dedicated Runtime Node and the installation procedure must be repeated for each of them.
- The environment meets the requirements that are described in Installation Prerequisites.
- The computer on which the iWD Runtime Node is going to be installed has network access to the computer that is hosting Genesys Configuration Server, Interaction Server and Message Server databases.
- You have access rights to execute install.sh or setup.exe, depending on the operating system.
- For upgrades from 8.5.1 to 9.0.0:
- iWD Runtime Node is stopped.
- The previous version of iWD Runtime Node is uninstalled.
To install the iWD Runtime Node application on the Windows platform.
Installation of iWD Runtime Node saves the required database scripts and Kettle files in the working directory. For more information about the database go to the Create the Data Mart Database section. The current procedure assumes that the application already exists in Configuration Server. If not, see the required steps in the iWD Runtime Node Application Definition section.
- Locate and double-click setup.exe in the iWD Runtime Node directory of the iWD DVD.
- The iWD Runtime Node Installation Wizard opens. Click Next in the Welcome screen.
- In the Connection Parameters to the Configuration Server screen, enter the login details to connect to Genesys Configuration Server and then click Next:
- Host name—The host of Genesys Configuration Server
- Port—The port that is used by Genesys Configuration Server
- User name—The user name of the Person (or User) as defined in Genesys Configuration Manager or Genesys Administrator.
- Password—The password that is associated with the Person (or User).
- Select application from proposed list. Those selection will provide details for rest of dialog.
- Click Next.
- The installer suggests an installation path. Change it if needed, then accept by clicking Next'.
- In the Ready to Install screen, click Install to begin the installation of iWD Runtime Node.
- When installation has been completed, click Finish.
- The installed JavaServerStarter.ini file should not require any updates but you can review it.
- The appropriate Windows service should be created and should appear on the list of Windows services. This allows you to start/stop it.
- Turn on any of the plug-ins by editing the plugins.properties file, or install localization if needed.
- Start the iWD Runtime Node Windows service.
End of procedure
To install the iWD Runtime Node application on the UNIX platform.
Installation of iWD Runtime Node saves the required database scripts and Kettle files in the working directory. For more information about the database go to the Create the Data Mart Database tab. The current procedure assumes that the application already exists in Configuration Server. If this is not the case, follow the required steps in the iWD Runtime Node Application Definition tab.
- As the iWD Runtime Node user, browse to the install directory and enter ./install.sh.
- When the following output is displayed, enter the required information, as indicated at each prompt.
************************************************** * Welcome to the Genesys 9.0 Installation Script * ************************************************** Installing iWD Runtime Node, version 9.0.XXX.XX Please enter the hostname or press enter for "HOSTNAME" => Please enter the following information about your Configuration Server: Configuration Server Hostname =>CONFIGURATION_SERVER_HOSTNAME Network port =>CONFIGURATION_SERVER_PORT User name =>CONFIGURATION_SERVER_USERNAME Password =>CONFIGURATION_SERVER_PASSWORD Please choose which application to install: 1 : iWD_Runtime_Node =>1 Please enter full path of the destination directory for installation =>/YOUR_PATH/iwd/YOUR_APP_NAME/ Extracting tarfile: data.tar.gz to directory: /YOUR_PATH/iwd/YOUR_APP_NAME/ ... etl/ etl/kettle_mssql.properties etl/aggregate_intraday.kjb etl/kettle_mysql.properties etl/plugins/ etl/plugins/queue/ ... etl/plugins/plugins.properties ... iWD_Data_Mart_Service_Script.sh iWD_Runtime.sh iwd_node.jar lib/ ... sql_scripts/ sql_scripts/mssql/ sql_scripts/mssql/iwd_dm_mssql.sql sql_scripts/oracle/ sql_scripts/oracle/iwd_dm_oracle.sql Installation of iWD Runtime Node, version 9.0.XXX.XX has completed successfully.
3. Turn on any of the plug-ins by editing the plugins.properties file, or install localization if needed.
4. Review and make changes, if needed, to the iwd_runtime.sh or iWD_Runtime_Service.sh file, for example, providing flags to Java. White characters (such as spaces) are not supported in the script variables—for example, DM_APPL=iWD Runtime Node is illegal.
- ImportantPlease note that the path must be provided in the application configuration.
5. Start the iWD Runtime Node process.
To install the iWD Runtime Node application on either Windows or Linux platforms by using the simplified GAX method.
GAX allows you to upload Installation Packages (IPs) and then use them to initiate the installation process. The procedure supports both a fresh install or an upgrade. The upgrade option is only available when you have installed the previous version of the application by using GAX. The upgrade procedure is basically the same as installation except that you are not forced to create a new application but are given the option either to use the old one or to merge them. The upgrade does not remove the previous version of the application before the new installation. Also, the upgrade does not work if you change the application template.
IP Upload Procedure
Click here (new document) for the GAX IP Upload Procedure.
- Navigate to GAX > Administration > Installation Packages.
- Chose the appropriate IP from the list. To install it, click it. Its details appear in a new panel.
- Verify the details of the IP, then click the menu button and select Install. The installation wizard then takes you through the following steps.
- On the Welcome page, click Next.
- On the Host selection page, select the host to deploy to and click Next.
- Complete the application parameters:
- Application Name
- Application Port
- Primary Configuration Server
- Backup Configuration Server
- Click Next.
- On the Installation Parameters page, set the Installation Path and click Next.
- Add some deployment summary information, then start the installation by clicking Finish.
- If you haven't already done so, create a DAP for Runtime Node to connect it to the Data Mart database.
- Navigate to Configuration > Environment > Applications and review the newly added Runtime Node application settings. Some of the settings were not set up by the wizard, so you might need to adjust them manually. To find differences please compare your application with the iWD Runtime Node Application Definition tab.
- Next go to GAX > Configuration > DataMart to provide some additional settings and assign your Runtime Node to your Solution.
- Turn on any of the Kettle plugins by editing the plugins.properties file, or install localization if needed. GAX does not support those actions.
- Start your iWD Runtime Node application by means of either System Dashboard > Applications or the Solution Control Interface, or by using Windows services, or the starting script for a UNIX host.
- Navigate to GAX > Administration > Deployed IPs.
- A list of all installation attempts initiated via GAX is displayed. Choose one that was used previously and finished successfully. Its details appear in a new panel.
- Verify the details of the IP, then click the menu button and select Upgrade.
- The Profile Selection tab is displayed. If you successfully uploaded the latest version of the chosen IP then you should have that version available. Choose it and click Next.
- The installation wizard then takes you through the same steps as for GAX installation. The difference from the installation procedure is that most of the options are pre-selected or pre-populated.
- One decision arises in the Application Parameters tab, which will show you the new proposed application name and the existing one. If you decide to use the new name, remember that you can change the name to the old one and choose the No Merging option. In this case, the recommended option is Merge with Precedence to the New Template, because the new template might provide some new default settings. However if a new application is created, you must perform the procedure in the iWD Runtime Node Application Definition tab. This shows what needs to be reviewed and optionally added.
- The rest of the steps are the same as for installation, unless you have a reason to change any of them. When you are done, click Finish.
The Uninstall procedure (see Prerequisites) removes all localization and other installation customization, such as Kettle plug-in selection. If you need these then you must re-apply them. For the database you can either re-use the old one or create a new one. (A new database will not contain any historical date). Add a DAP in the connections of your new application.
The Upgrade procedure, depending on your choices, could create a new application for iWD Runtime Node in Configuration Server. When you compare the application settings (of the old and new applications) there should be no difference except the version and the new options in the new application (if it was derived from the template) so you can just delete the old one.
iWD Runtime Node Application Definition
- Log into Genesys Administrator or GAX and import the iWD Runtime Node Application template from the iWD DVD.
- Create a new Application object based on the template. For upgrades from 8.5.1 to 9.0.x you can either create a new application in place of the previous one or simply update the application by using the new template. To begin the Create procedure, navigate to Configuration > Environment > Applications and click New.
- On the General tab:
- Enter your chosen name, for example, iWDRuntimeSolutionName. Using spaces is not recommended.
- Select the application Template—Use type iWD Runtime Node.
- Version, Tenant and Is Application Server boxes are pre-selected according to the template type.
- Fill in fields Working Directory, Command Line and Command Line Arguments per the example below:
Attribute name Windows Unix Working Directory C:\Program Files (x86)\GCTI\iWD Runtime Node /IWD_APP_PATH/iWDRuntimeNode/ Command Line JavaServerStarter.exe /INIT_PATH/iwd_runtime.sh Command Line Arguments -host YOUR_CFG_SRV_HOST -port YOUR_CFG_SRV_PORT -app YOUR_APP_NAME -service YOUR_SERVICE_NAME start
- Choose the host where the application will run.
- Optional fields
ImportantThe Load Config service will need to read certain settings from your Tenant and parent tenant (if the latter exists). For example, it needs to have read permission to all applications involved in the Solution, including Capture Points and their application templates. The Statistics Adapter service will need to update the options in Stat Server application, and it does this through the iWD Runtime Node application that has been configured in Configuration Server. For this reason iWD Runtime Node should be configured so that it can make the required changes to the Stat Server application on behalf of a user with appropriate security permissions.
- Certificate—The security certificate value. In Windows, select the certificate value from the list of installed certificates. In UNIX, enter the full path to the <serial_#>_<host_name>_cert.pem file.
- Certificate Description—An optional description of the Certificate.
- Certificate Key—The full path to the <serial_#>_<host_name>_priv_key.pem file of the security certificate key. This field is used only if Genesys Security is deployed on UNIX; otherwise this field is empty.
- State Enabled— If selected, indicates that the object is in regular operating condition and can be used without any restrictions.
- Login As Account— Select a user account that has full access to the relevant Tenant, and to both Applications and Applications Templates. These fields are displayed after the application is created.
- On the Connections tab, add:
- A Data Mart DAP to point at the database that will be used. It should contain the following parameters:
- jdbc / url = "jdbc:sqlserver://<hostname>:<port>;databaseName=<Datamart_DB>" (example for Microsoft SQL)
- History Node—The iWD History Node application defined in Installing iWD History Node.
- Configuration Server—If you have both primary and backup Configuration Servers, add a connection only to the primary.
- A Configuration Server DAP to point to Configuration Server's database. It should contains the following parameters:
- iWD / role = "cfgserver".
- jdbc / url = "jdbc:sqlserver://<hostname>:<port>;databaseName=<config_server_DB>" (example for Microsoft SQL).
- A Data Mart DAP to point at the database that will be used. It should contain the following parameters:
- The Ports tab lists communication ports used by the clients of an application to connect to a server. To support specific high-availability configurations, more than one server can be registered on the same port within the same host. Otherwise, do not assign the port number to any other server on the same host. Click Add to add ports. You need to add two ports:
- webservice—With http connection type. This will be used to communicate between the GAX Data Mart Dashboard and iWD Runtime Node.
- admin—Provides administrative tasks.
- On the Tenants tab choose only one Tenant where your solution is located.
- Ignore the Options tab.
- Ignore the Application Options tab.
- Click Save to save the Application object.
If you have re-created the iWD Runtime Node application you should go to GAX > Configuration > Data Mart section to confirm that the selected application for your solution is correct and has a suitable configuration.
Create the Data Mart Database
- For information about Genesys Interactive Insights (GI2) for iWD, see the GI2 8.0 guides. The functionality in GI2 8.0 is the same as in GI2 8.1—however GI2 8.0 for iWD is powered by SAP BO XI 3.1, whereas GI2 8.1 for iWD is powered by SAP BI 4.1.
- If you will be using the Genesys Interactive Insights for the iWD product for historical reporting based on the iWD Data Mart, you must enable several aggregates that are not enabled by default. Please see the Reading iWD Aggregation section of the Interactive Insights 8.0 Deployment Guide.
This is a general procedure. Work with your enterprise’s database administrator to follow the specific procedure that is required by your database management system and your enterprise policies.
- iWD Runtime Node must be installed.
- A Database Access Point (DAP) application with connection type JDBC needs to created.
- Ensure that the database server is running.
- Log on to the database server’s administrative interface (such as Oracle Enterprise Manager).
- Create a new database user account (for example, iwddatamartuser).
- Create a new database (for example, iwddatamartdb).
- Ensure that there is a user, who has access to the Data Mart database, who has the following permissions:
- CREATE TABLE
- CREAT INDEX
- CREATE VIEW
- CREATE TRIGGER (Oracle)
- CREATE SEQUENCE (Oracle)
- The iWD Data Mart database will be initialized automatically the first time the Database Service and Kettle ETL Service are started. If the Database Service’s Auto Sync option is selected, this initialization is automatic, and the Database Service will also check for updates to the iWD Data Mart database whenever a new version of iWD Data Mart is installed. The Auto Sync option will also initialize ETL plug-ins.