IPC Configuration

YESEFT folder contents

By default, the YESEFT folder is created in the C:\ drive (Windows) or /home (Linux) of the system after running the installer.

YESEFT contents screenshot

These are brief descriptions of some of the important folders and files:

  • EMBOSS-Setup: A batch file used to set the MID and TID for a terminal

  • MID: A merchant identification number (1 to 5 digits maximum) provided by Worldpay.

  • TID: A unique terminal identification number (8 digits) provided by Worldpay specifically for a terminal.

Run the EMBOSS-Setup.bat file. You will be prompted to enter the instance number. You can either enter ‘0’ or leave it blank and press Enter to continue.

On the prompt to enter MID, enter the Worldpay provided MID and press Enter. On the TID prompt, enter the Worldpay provided TID for the terminal.

  • StartPOSServer: A batch file used to initialise the IPC application after configuring the application.

  • YESEFTConfig: A batch file used to configure the IPC application. A complete description is provided in the next section.

  • Conf: This folder mainly contains seven XML files:

    • YESEFTConfiguration.xml

    • YESEFTTransactionLog.xml

    • YESEFTTransactionLog-tmp.xml

    • YESEFTTransactionLogEmpty.xml

    • EFTAcquirerDataset.xml

    • EFTIssuerDataset.xml

    • EFTMerchantDataset.xml

During initialisation of the application for the first time, the three dataset files EFTAcquirerDataset.xml, EFTIssuerDataset.xml and EFTMerchantDataset.xml are downloaded from the WPH server and YESEFTTransactionLog-tmp.xml is generated by IPC. These files are not present by default.

  • Logs: Mainly contains the audit logs used for the analysis and diagnosis of any issue. This folder contains a number of simple text yescps.log files of up to 1 MB file each. All log files are in simple text format. The current log files are named as yescps.log and TerminalInitializer.log. Yescps.log contains transaction and control flow information and TerminalInitializer.log contains commands sent and responses received from the PED.

If the yescps.log reaches 1MB then it is renamed automatically as yescps.log.1 and the file prior to that as yescps.log.2 and so on. The number of log files kept by IPC can be configured from 20 to 999 and once the maximum number is reached, the oldest log file is overwritten.

If the TerminalInitializer.log reaches to 1MB then it is renamed automatically as TerminalInitializer.log.1 and the file prior to that as TerminalInitializer.log.2 and so on. The number of log files kept by IPC can be configured from 20 to 999 and once the maximum number is reached, the oldest log file is overwritten.

  • Common Files: Contains two sub folders, conf and properties, and one brand.txt file.

The conf folder contains YESEFTTransaction.log.xml and the properties folder, containing the required files for the keychange process.

IPC uses both these folders when new instances are created as every new instance is set for a new TID, requiring the keychange process to be completed with WPH.

  • Properties: Contains most of the important properties files used by the application for specific purposes. These are some important files:

    • eftdataset-api-client.properties: Contains the URL of the WPH server used by IPC to download above mentioned dataset files.

    • epos-api-client.properties: Contains the URLs used by IPC to communicate with the WPH server.