Table of Contents

Solution Prerequisites

Include Page

	Prerequisites
	Prerequisites

Deployment Modes

Include Page

	Generic Connector Deployment Models
	Generic Connector Deployment Models

Installation

Info
Note that the screenshots in this guide may not be up-to-date and may show older version. Please make sure that the file you download is of the desired version, i.e. 4.0.

...

Info

Note

Note that after installing Generic-Connector4.0.exe successfully, you must need to upgrade the Software to version 4.4

Upgrade Software

Click here to upgrade the software

EF Service Manager

EF Service Manager is a mini management console to:

...

Run Service Manager from the desktop (if it is not running). You can locate Service Manager from system tray
Run both Services, one after the other.
To validate if ActiveMQ is running, login to the web-console via http://broker-[x]-ip:[web-console-port] with the default credentials [admin/admin] or as per your configured credentials. Reference ActiveMQ Web Console Configuration
In the Queue section, you should find a Queue name Connector1 created.
You can also verify ActiveMQ and GenericConnector from their log files by clicking on the Logs button in both Sections.

ActiveMQ Configuration (Redundant Deployment Only)

...

Create a new Object in Active Directory with a class of type ‘GroupOfUniqueNames’ in any group and give it any name. This name should match with the roles attribute of SecurityConstraint in the <EF Connector Home>\conf\jetty.xml, which is explained here. For illustration purposes, we have created an empty group with type ‘Container’ called AdminTestGroup. In this container we have created an object of type ‘GroupOfUniqueNames’ called AdminRoles.
In the next step, add the user you want to give access to as a unique member of AdminRoles. Here we have added the distinguished name of the user called djtest.

You can find a user’s distinguished name from User’s Properties > Attribute Editor > distinguishedName.
After adding the members to the group you should be able to see them in the group

Jetty/ActiveMQ Configuration
In <EF Connector Home>\conf\jetty.xml,
Modify the securityConstraint bean in the jetty.xml file and change the value of the roles to the name that you provided to the group you created above with the type ‘GroupOfUniqueNames’ in our case this is AdminRoles.
Modify the securityHandler bean in jetty.xml and change the ref of property name ‘loginService’ to ‘ldapLoginService’ as shown below

Also uncomment the following property ‘identityService’ in securityHandler bean

You will find the ldap.config file on this path <EF Connector Home>\conf\ldap.config.
You will have to update this file according to your Active Directory settings.
Note: Please do not change this string “amqLdapLoginModule“