Hospitality configuration

YESEFT folder contents

By default, the YESEFT folder is created in the C:\ drive of the system after running the installer.

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, also known as the EMBOSS MID

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

Run 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.

  • StartHospitalityServer: a batch file used to initialise the Hospitality application (EVTInterfaceServer and HospitalityServer) after configuring the application.

  • YESEFTConfig: a batch file used to start the YESEFTConfig utility to configure the Hospitality application. A complete description is provided in Terminal Configuration.

  • Conf: This folder mainly contains seven XML files.

    • YESEFTConfiguration.xml

    • YESEFTTransactionLog.xml

    • YESEFTTransactionLog-tmp.xml

    • YESEFTTransactionLogEmpty.xml

    • EFTAcquirerDataset.xml

    • EFTIssuerDataset.xml

    • EFTMerchantDataset.xml

    • EVTInterfaceTransaction.xml

    • EVTInterfaceTransactionTemp.xml

    • EVTInstanceStatus.xml

During initialisation of the application, the three dataset files EFTAcquirerDataset.xml, EFTIssuerDataset.xml and EFTMerchantDataset.xml are downloaded from the Worldpay Total central service and YESEFTTransactionLog-tmp.xml is generated by Hospitality. These files are not present by default.

  • Logs: Mainly contains the audit logs used for the analysis and diagnosis of any issue. This folder (YESEFT/INSTANCE_xx/logs) 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 Hospitality can be configured from 20 to 999 and once the maximum number is reached the oldest log file is overwritten.

The evt-interface.wrapper.log and jvt.wrapper.log.log in the YESEFT/Log folder mainly contains communication and functionality flow between the HospitalityServer and the EVTInterfaceServer.

  • Common Files: This folder contains two sub folders, conf and properties.

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

Hospitality uses both of these folders when new instance 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 file used by the application for specific purposes. These are some important files:

    • eftdataset-api-client.properties: Contains the URL of the WPT services used by Hospitality to download above mentioned dataset files.

    • epos-api-client.properties: Contains the URLs used by Hospitality to communicate with the WPT services.