Professional Documents
Culture Documents
Table of Contents
Introduction .................................................................................................................................................. 2
Prerequisite ................................................................................................................................................... 2
How to Install the FCC Client ........................................................................................................................ 4
Download the Certificates from the FCC Listener Server ......................................................................... 6
Update the TermReg.ini ............................................................................................................................ 8
Install the FCC Client ............................................................................................................................... 10
Verify the FCC Client Installation ............................................................................................................ 12
How to Upgrade the FCC Client .................................................................................................................. 14
Check the Version of the FCC Client on the Workstation ....................................................................... 15
Download the Latest FCC Client Installer from MGS .............................................................................. 18
Upgrade to the New FCC Client Version ................................................................................................. 20
Verify the FCC Client Upgrade Completed .............................................................................................. 22
Update the Certificate and Servers.xml .................................................................................................. 25
Install Marriott PAL Packages ..................................................................................................................... 28
Appendix I: How to Restart the FCC Client ................................................................................................. 29
Appendix II: Device Management Portal Reactivation ............................................................................... 30
Appendix III: Ensure the CcHttpLibCert.dll is in the Correct Locations ....................................................... 32
Appendix IV: How to Uninstall the FCC Client ............................................................................................ 33
Verify the FCC Client Uninstallation ........................................................................................................ 35
Uninstall the FCC Client Through Windows Operating System .............................................................. 38
Appendix V: Add or Change the FCC Listener ............................................................................................. 43
Appendix VI: How to Manually Install Microsoft .NET Framework 4.6.2 ................................................... 48
Support ....................................................................................................................................................... 56
FreedomPay Technical Support .............................................................................................................. 56
Oracle Support ........................................................................................................................................ 56
Document Change Log ................................................................................................................................ 57
Introduction
The FreeWay Commerce Connect (FCC) consists of two services: the FCC Listener Service and the FCC
Client Service. The FCC Listener is a database-implemented application that integrates with the PMS. It is
a multi-threaded service that listens and responds to payment requests, passing the request straight
through to FreeWay or to the FCC client.
This document provides instructions for installing the FCC Client on the workstations for OPERA v5.6.
If the FCC Client needs to be upgraded, refer to the How to Upgrade the FCC Client section.
Prerequisite
The following will be required to perform the tasks outlined in this document:
• Windows administrator level login credentials to the workstations where the FCC Client will be
installed on
• The IP address of the server where the FCC Listener is installed
Operating system and hardware requirements are based on Microsoft .NET Framework 4.6.2
requirements.
• Full requirements for Microsoft .NET Framework 4.6.2 can be found here (under the System
Requirements section): https://www.microsoft.com/en-us/download/details.aspx?id=53344
The following program(s) should be installed prior to installing the FCC Client:
• Microsoft .NET Framework 4.6.2 (reference the Appendix VI: How to Manually Install Microsoft
.NET Framework 4.6.2 for assistance installing)
2. Download the latest approved version of the OPERA v5.6 FCC Client Installer (ZIP)
from the Chip and Pin Resources page on Marriott Global Source (MGS):
https://mgscloud.marriott.com/common/lodging-operations/guest-property-technology/chip-
and-pin/resources.html?tab=1
A different program can be used to unzip/extract the folder if WinZip is not available.
2. A Command Prompt window will open asking for the IP address of the server where The FCC
Listener is installed → Enter the IP address → Hit [Enter]
If the workstation needs to connect to multiple the FCC Listener servers, enter the IP
addresses of all the FCC Listener servers as a comma separated list with no spaces.
I.E. – 10.100.8.123,10.100.9.132,162.105.10.8
Note: The OPERA version at the hotels for all the FCC Listeners must be the same (as in all are on
OPERA v5.6 or all are on OPERA v5.04). The FCC Client must be able to access the network of all FCC
Listeners that it needs to connect to.
Open the FCCCertLoadTool.log specified in the Log Location to check the status. If the FCC
Listener was installed correctly and the certificate was downloaded and installed on the
workstation successfully, the log will show:
Address ###.###.###.### has a valid certificate.
Configuration successful.: 1 of 1 servers valid and configured
• Where ###.###.###.### is the IP address of the FCC Listener server(s) entered in Step 2
• The number of servers will depend on the number of IP addresses entered in Step 2
If the OPERA Registered Terminal has changed, make sure to update the configuration in OPERA
related to the workstation's name, such as: print tasks, key encoders, credit card reader device
attached, barcode scanner attached, etc...
This process can take anywhere from 5 to 60+ minutes depending on the hardware.
For example, workstations with older hardware (like a hard disk drive instead of a solid state drive,
less RAM) and/or the workstation has many users or files (which will result in a larger file structure)
will take longer for this update to the TermReg.ini to complete.
DO NOT CLOSE THE WINDOW as it will close on its own once the update has completed.
Status of the update can be viewed in the log file at:
C:\ProgramData\Oracle\Opera\TermRegUpdate.log
If no one at the property is able to assist with these configuration changes in OPERA, please
contact Oracle Support or the appropriate vendor or dealer that supports the hotel’s OPERA
system (reference the Support section for Oracle Support contact information).
1. Open the FCC_Client folder → Open the Data folder → Open the Logs folder → Open the
FCC_Client_Install.log file
4. The program will scroll down the file and highlight the text that was searched for. The text that
was searched for should appear near the bottom of the text file and there should be a status of
the installation to the right of the highlighted text.
5. If the install log shows the installation was not successful, uninstall the FCC Client, then try
reinstalling
To uninstall the FCC Client, see the Appendix IV: How to Uninstall the FCC Client section.
At this point, the FCC Client install has been completed. The
following additional task(s) can be performed, if necessary:
• Install Marriott PAL Packages
1. Click on the Search menu button (usually located in the bottom left of the screen)
2. In the textbox, type “Control Panel” → Select the Control Panel option
If the Control Panel window is displaying icons, select the Programs and Features option
2. Download the latest approved version of the OPERA v5.6 FCC Client Installer (ZIP)
from the Chip and Pin Resources page on Marriott Global Source (MGS):
https://mgscloud.marriott.com/common/lodging-operations/guest-property-technology/chip-
and-pin/resources.html?tab=1
A different program can be used to unzip/extract the folder if WinZip is not available.
1. Open the FCC_Client folder → Data folder → Logs folder → Open the
FCC_Client_Install.log file
4. The program will scroll down the file and highlight the text that was searched for. The text that
was searched for should appear near the bottom of the text file and there should be a status of
the installation to the right of the highlighted text.
If the install log shows the installation was not successful, uninstall the FCC Client, then try
reinstalling. To uninstall the FCC Client, see the Appendix IV: How to Uninstall the FCC Client
section.
6. The program will scroll down the file and highlight the text that was searched for and the
version of the FCC Client that was installed will display next to it
Product Version: #.#.##.#
Where #.#.##.# is a series of numbers that indicates the version of the FCC client.
The Product Version listed in the log should be the same as the latest FCC Client version for
OPERA v5.6 listed on the Chip and Pin Resources page on Marriott Global Source (MGS).
If the workstation needs to connect to multiple the FCC Listener servers, enter the IP
addresses of all the FCC Listener servers as a comma separated list with no spaces.
I.E. – 10.100.8.123,10.100.9.132,162.105.10.8
Note: The OPERA version at the hotels for all the FCC Listeners must be the same (as in all are on
OPERA v5.6 or all are on OPERA v5.04). The FCC Client must be able to access the network of all FCC
Listeners that it needs to connect to.
Open the UpdateFCCCertLoadTool.log specified in the Log Location to check the status.
The operations were successfully, the log will show:
Removing all certificates on the machine which contain the FreedomPay OID.
[a line for each certificate removed and the thumbprint]
Address ###.###.###.### has a valid certificate.
Configuration successful.: 1 of 1 servers valid and configured
• Where ###.###.###.### is the IP address of the FCC Listener server(s) entered in Step 2
• The number of servers will depend on the number of IP addresses entered in Step 2
If there are any errors, check the network between the FCC Client and the FCC Listener IP
address that had an error.
At this point, the FCC Client upgrade has been completed. The
following additional task(s) can be performed, if necessary:
• Install Marriott PAL Packages
https://mgscloud.marriott.com/common/lodging-operations/guest-property-technology/chip-and-
pin/resources.html?tab=1
1. Click on the Search Windows icon (the magnifying glass) on the task bar → Type "Services"
into the textbox → Click on Services in the list of results → Select Run as administrator
1. Open the FCC_Client folder → Select the DMP_Activation.bat file → Right-click → Select
Run as administrator
2. A Command Prompt window will open stating the DMP activation has been initiated
Press any key to close the Command Prompt window
4. The log should show the status of the activation and if it was successful it will show:
Successfully registered with DMP.
This configuration needs to be set on ALL workstations that have a credit card reader
attached, regardless if the credit card reader is a Lane 8000 or an IDTech device.
The CcHttpLibCert.dll can be found on the OPERA v5.6 Single Server at:
For 32-bit OS = D:\MICROS\opera\tools\Vault\CcHttpLibCert.dll
For 64-bit OS = D:\MICROS\opera\tools\Vault\x64\CcHttpLibCert.dll
It is recommended that a copy of this file be saved somewhere that user workstations can access in case
it needs to be transferred over.
On the workstation(s) where a credit card device (Lane 8000 or IDTech) is attached, the
CcHttpLibCert.dll file needs to be in the following location:
%USERPROFILE%\OPERA_56_Server\Oracle\Opera\JinitCtrl\bin
Where OPERA_56_Server is the hostname the OPERA v5.6 Single Server (the OPERA
application server) or OPERA v5.6 login URL
If a CcHttpLibCert.dll already exists at the location, rename the existing CcHttpLibCert.dll to
CcHttpLibCert_old.dll, and then copy over the CcHttpLibCert.dll from the OPERA v5.6 Single Server.
3. A Command Prompt window will open stating the uninstall of the FCC Client has been initiated
and will take several minutes to complete (will take approximately 3 minutes).
Press any key to close the Command Prompt window
5. The program will scroll down the file and highlight the text that was searched for. The text that
was searched for should appear near the bottom of the text file and there should be a status of
the installation to the right of the highlighted text.
Uninstalling the FCC Client through the computer’s OS may require the user to enter in a Windows
administrator’s login credentials.
1. Click on the Search menu button (usually located in the bottom left of the screen)
2. In the textbox, type “Control Panel” → Select the Control Panel option
If the Control Panel window is displaying icons, select the Programs and Features option
5. Click [Uninstall]
7. A prompt may appear for applications that should be closed before uninstalling the FCC Client
Click [OK] to automatically close the listed applications and continue with the uninstall
10. The Program and Features window can be closed (click the [X] in the top right corner)
11. With Freeway Commerce Connect uninstalled, the FCC Client can now be installed again
2. Download the latest approved version of the OPERA v5.6 FCC Client Installer (ZIP)
from the Chip and Pin Resources page on Marriott Global Source (MGS):
https://mgscloud.marriott.com/common/lodging-operations/guest-property-technology/chip-
and-pin/resources.html?tab=1
A different program can be used to unzip/extract the folder if WinZip is not available.
If the workstation needs to connect to multiple the FCC Listener servers, enter the IP
addresses of all the FCC Listener servers as a comma separated list with no spaces.
I.E. – 10.100.8.123,10.100.9.132,162.105.10.8
Note: The OPERA version at the hotels for all the FCC Listeners must be the same (as in all are on
OPERA v5.6 or all are on OPERA v5.04). The FCC Client must be able to access the network of all FCC
Listeners that it needs to connect to.
A log is also generated with the status information: Open the FCC_Client folder → Data
folder → Logs folder → Open the UpdateFCCCertLoadTool.log file
If there are any errors, check the network between the FCC Client and the FCC Listener IP
address that had an error.
8. Once the files have finished extracting the Microsoft .NET logo will appear then open to the
license terms window
12. Make sure any other programs opened on the server are saved and closed
Click [Restart Now]
Support
This section provides support contact information for FreedomPay and Oracle.
Oracle Support
For issues with the OPERA application or assistance with configuration in OPERA, please contact Oracle
support:
International hotels should continue to contact their local Oracle support office or local dealer as first
point of contact.
International MICROS Regional Contact List:
http://www.micros.com/ServicesAndSupport/CustomerSupport/
MARCAS contact number for APO hotels: +44 - (0) 1582 343999