The OpenEdge Remote Client Manager (RCM) software handles the communication between the credit card reader and OpenEdge.

How does the communication work?

Here is an outline of the communication steps that take place when processing a transaction.

  1. Evosus requests an OpenEdge payment form.
  2. The OpenEdge payment form wakes up the RCM.
  3. RCM communicates with the card reader terminal to capture the payment card information.
  4. RCM submits the transaction to the OpenEdge Gateway.
  5. OpenEdge Gateway returns a response to the RCM.
  6. RCM notifies the OpenEdge payment form that the transaction is completed.
  7. Evosus retrieves the transaction response from the OpenEdge Gateway.

Install RCM on a MS Terminal Server

Follow the steps below to install Remote Client Manager (RCM) on MS Terminal Server.

Step 1: Install Microsoft Message Queuing (MSMQ) (All options, including HTTP Support)

Perform this step prior to installing RCM.

  1. Open Windows Server 2012 R2.
  2. Launch Server Manager.
  3. Navigate to Manage > Add Roles and Features.
  4. Click Next in the Before You Begin screen.
  5. Select Role-based or feature-based installation and click Next.
  6. Select the server where you want to install the feature and click Next.
  7. Do not select any server roles. Click Next.
  8. In “Features”, expand Message Queuing > Message Queuing Services and select Message Queuing Server.
  9. Continue through the wizard adding any other roles required by MSMQ (if applicable).
  10. Click Install to start installation.
  11. The setup may require a system restart. Click OK to complete the installation.

Step 2: Enable Windows Installer RDS Compatibility

Perform this step prior to installing RCM.

  1. Open Windows Server 2012 R2.
  2. From Command Prompt run gpedit.   (Group Policies).
  3. Navigate to: Local Computer Policy > Computer Configuration > Administrative Templates > Windows Components > Remote Desktop Services > Remote Desktop Session Host > Application Compatibility.
  4. Double-click Turn off Windows Installer RDS Compatibility and set to Enabled.

Step 3: Install RCM on Terminal Server (Run as administrator)

Only use the .exe installer since the .msi installer is an alpha version and has some issues.

On Shared User Settings Configuration screen, select User Specific …

Step 4: Start RCM

  1. Under the drive to which RCM was installed, go to the folder named: \ProgramData\XpressLink2.  
    • This folder is hidden by default so you may need to enable Show hidden files.
  2. Right click on RCM and select Run as administrator.
  3. Once the RCM is started, you can access the RCM help for more detailed information about these steps. Right click on the RCM icon (rcm) in the system tray, and select Help from the menu that appears.  

Step 5: Device configuration

  1. Right click on the RCM icon (rcm) in the system tray.
  2. Select Device Configuration from the menu that appears.
  3. Select Ingenico iPP320 in the PIN Pad Device drop down.
  4. COM Port - Select the COM port used by the device. The selected COM port must be unique to this device  (it cannot be shared with multiple devices).
  5. Default Message - Message that appears on the credit card terminal. This must be 30 characters or less.
  6. Click Test. This tests the communication between the RCM and the card reader terminal.
  7. Click Load Forms to Device. Loading the forms to the device can take several minutes and the process should not interrupted.
  8. Click Load Settings to Device. Loading the settings to the device can take several minutes and the process should not be interrupted.
  9. Click OK when complete.

Step 6: Configure the port

This step needs to be performed on every workstation that accesses the terminal server.

  1. In the system tray, right click on RCM and select Port Configuration.
  2. Set the Port Range large enough to provide port numbers for all of the terminals that will be connected to this terminal server. For example, if you have 20 terminals to set up, you need to set the port range from 20113 to 20132.

Step 7: Configure USB devices to always be powered on

Complete this step prior to the setting up the card reader on the terminal server. This step only needs to be performed on the terminal server.

  1. Open Device Manager.
  2. Expand Universal Serial Bus controllers.
  3. For each USB Root Hub device listed:
    • Right-click on USB Root Hub.
    • Select Properties.
    • Under the Power Management tab, uncheck Allow the computer to turn off this device to save power.
    • Click OK. Repeat for ALL USB Root Hubs listed.
  4. Open Control Panel.
  5. Select Power Options.
  6. Select Choose when to turn off the display.
  7. Select Change advanced power settings.
  8. In the Power Options window:
    • Expand USB settings.
    • Expand USB selective suspend setting.
    • Click on Setting: Enabled.
    • Select Disabled in the drop down menu.
    • Click Apply.
    • Click OK.
    • On the Edit Plan Settings screen, click Save changes.

Step 8: Install drivers on Windows workstation (Required to do for ALL workstations.)

Complete this step prior to setting up the card reader on the terminal server.

  1. The device driver installer/setup file is located in the \ProgramData\XpressLink2\PinPadDevice\Ingenico USB Drivers folder.
  2. Run the Ingenico USB Drivers Package Setup.
  3. On the Usb Driver parameters screen, under Product ID (PID), use the drop-down menu to select “0060 (Ingenico iPP3xx/iPP4xx)”.
  4. Click Next.
  5. Continue.  Click Next until finished.

Step 9: Install Microsoft Message Queuing (MSMQ) (All options, including HTTP Support)

For local installations, MSMQ needs to be installed on every machine where the RCM is directly installed. See the Microsoft documentation for information on installing MSMQ on workstations.

Step 10: Connect the PINPad terminal to a USB port on the local workstation

Step 11: Set the COM port for the PINPad on the local workstation

Complete this step prior to the PINPad terminal setup. These must be the same setting for ALL PINPads connected to this terminal server.

  1. Open Device Manager.
  2. Expand Ports (COM & LPT).
  3. Right click on the Ingenico iPP3xx/iPP4xx Comm Port and select Properties.
  4. Under the Port Settings tab, Click Advanced.
  5. Using the COMM Port Number drop-down, select a COMx value above COM4.  You want to choose a number that will not be in use on any of the Remote Desktop workstations.
  6. Click OK.

Step 12: Verify that the COM ports are passed to the terminal server through the Remote Desktop session

Complete this step prior to the PINPad terminal setup.

  1. Start a Microsoft Terminal Server Client.  From command prompt, run mstsc.
  2. On the Remote Desktop Connection client startup screen, select the Show Options down arrow.
  3. Under the Local Resources tab, select More at the bottom.
  4. Make sure that Ports is selected.
  5. Click OK.
  6. Back on the Remote Desktop Connection screen, click Connect.
  7. If prompted, enter your login credentials.

Step 13: If this is not the first PINPad that is connected to this terminal server, increment the RCM User Port number

  1. In the System Tray, right-click RCM and select Port Configuration.
  2. Increment the User Port number to the next value.

Step 14: Configure card reader/PIN Pad device

  1. On the Terminal Server, in the System Tray, right-click RCM and select Device Configure.
  2. Select the Ingenico iPP320 (US EMV) from the PIN Pad Device drop down menu.
  3. Enter the COM Port number used by this device.
    • This should be the same COM port number for ALL devices connected to this terminal server.
  4. If desired, set the Default Message for this device.  This is the message displayed on the device screen when the device is idle.
  5. Click Load Forms to Device. This may take several minutes and should not be interrupted.
  6. Click Load Settings to Device from the Device Setup window.  This may take several minutes and should not be interrupted.
  7. Click Test to initialize the device, then follow the prompts on the screen of the PIN Pad terminal to complete the test.
  8. Click OK.