Installing the GRDT Component

Online Installation

Purpose

• To install the Genesys Rules Development Tool (GRDT). The GRDT is an Eclipse plug-in that can be installed either into a stand-alone Eclipse instance or into Genesys Composer.

Prerequisites

• Genesys Composer or Eclipse must be installed. If you want to install the GRDT Eclipse plug-in into a stand-alone Eclipse IDE platform (not Composer), and do not already have Eclipse, you can download it from the following location: http://www.eclipse.org/downloads/
• Ensure your version of Eclipse is version 3.5.0 or higher (but version 4 is not supported). In Eclipse, select Help > Check for Updates.
• Before installing GRDT in Composer, enable the Galileo update site in Composer. This is found in Windows/Preferences, under the Install/Updates/Available Software Sites node. Find or add the entry for http://download.eclipse.org/releases/galileo and enable it.

Start

1. Locate the GRDT installation zip file on the Genesys Rules CD (in the rulesdevelopment folder) and save it locally.
2. Start up Eclipse or Composer.
3. In Eclipse or Composer, select Help > Install New Software.
4. Browse to the GRDT installation zip file and drag it onto the Available Software dialog box. This action adds the location as a "site". When it has been added, it will appear in the drop-down list. It does not have to be added each time. If you get an error when you drag and drop the file, open the drop-down list to see if the site already exists, and select it from the list.
5. Check Genesys Rules System in the list of software and click Next.
6. Check Template Development Tool, accept the license terms, and click Finish.
Important
If you do not check the checkbox, and click Next, you will get an error.
7. Change the perspective so that you can view the GRDT interface. Navigate to Window > Open Perspective > Other > Template Development.You will be prompted to restart Eclipse or Composer in order for the new Template Development perspective to be enabled.
8. Click on Server Preferences, and edit the following information (you can also access these preferences by directly navigating to Window/Preferences/Genesys Rules System/Repository Server):

• Name - The name of the server on which the web container is running that is hosting the GRAT server.

• Port - The listening port for your web container (such as 8080).

• servlet-path: genesys-rules-authoring.

• In the Authentication section, enter the user name and password for a user who is defined in Configuration Server. The user entered here (or an access group to which the user belongs) must have, at a minimum, Read and Execute permissions to the Genesys Rules Authoring client application (in Configuration Server) in order to access the Rules Repository through the GRDT. That is, the user whose name and password is provided here must have Read and Execute permissions or must belong to an access group that has those permissions to the GRAT client Application object. Refer to Role-Based Access Control for more information about roles.

Important

Even after configuring the connection parameters to the GRS repository server as described in Step 8, you will not see a connection to the GRS repository in the GRS Server Explorer view of the Rules Development Tool until you start your application server, so that the GRAT web application is deployed and running.

While still in the Preferences dialog, select Genesys Rules System/Configuration Server, and edit the following information:

• Name - The name of the server on which the Genesys Configuration Server is running.

• Port - The listening port for the Genesys Configuration Server (normally 2020).

• Application - The name, as configured in Genesys Configuration Server, of the GRAT client application that you created, as described earlier in Installing the GRAT Component.

• User name - The name of a Configuration Server user. Note that this user's access control determines which objects can be accessed from the Genesys Rules Development Tool, such as Business Attributes and Transaction objects.

• Password - The password of the Configuration Server user.

If you have a sample to import, navigate to File > Import > General > Existing Projects into Workspace, and click Next.

Browse to the sample, check in the list of projects, and click Finish.

End

Important

If you are working with Genesys Technical Support, you will need to supply the exact version of the GRDT you are using. Refer to Locating the GRDT Version Number for information about how to find the version number.

Offline Installation

For environments where internet access is not available, copy the entire Composer directory to a 'sandbox' where internet is available, then install GRDT and the required dependencies. Once GRDT is working as expected copy the entire directory structure back to the production machine.

Next Steps

• Before using the GRDT, you will need to set up users and various script parameters. See Template Script Objects and Configuring a User for more information.