Camtech Merchant Server (Java)

[James Bourne]

How To Run The Camtech Merchant Server as a FireDaemon Service

The Camtech Merchant Server is a Java application that acts as a secure payment gateway. This is how you set it up to run as a service under FireDaemon.

1. Install J2SE v1.4.1 or v1.4.2 JRE. You can obtain the downloadable executable from here.

2. Install The Camtech Merchant Server software (v6.2.x). You can obtain the downloadable executable from here.

3. Obtain you merchantserver.config file from Camtech and drop it in your Merchant Server installation directory (eg. C:\Program Files\MerchantServer).

3. Install FireDaemon. FireDaemon can be downloaded here.

4. Start the FireDaemon GUI:



5. Click the New Service Definition button.



Fill out the fields as per below (adjust paths to suit your installation):

Short Name: Camtech
Display Name: Camtech
Description: Camtech Merchant Server
Console Application: Checked
Executable: C:\Program Files\Java\j2re1.4.2_09\bin\java.exe
Working Directory: C:\Program Files\MerchantServer\bin
Parameters: -Xrs -verbose -Xnoclassgc -Dinstall.root="%INSTALL_ROOT%" -DMerchantServer.log="%LOG_FILE%" -cp "%CLASSPATH%" "%JARFILE%" %PORT%

6. Click on the Dependencies tab.



Add lanmanworkstation (the Workstation service) to the section This service depends on the following Services. Introducing this dependency ensures the Camtech Merchant Server starts after TCP/IP and CIFS/SMB has been initialised (assuming you have not disabled the Workstation service!).

7. Click on the Environment tab.



Append the following environment variables in the order below (adjust paths and values to suit your installation):

JAVA_HOME: C:\Program Files\Java\j2re1.4.2_09
INSTALL_ROOT: C:\Program Files\MerchantServer
LOG_FILE: %INSTALL_ROOT%\tcpdaemon.log
CLASSPATH: %INSTALL_ROOT%\jars\iaik_jce.jar;%INSTALL_ROOT%\jars\MerchantServer.jar;%INSTALL_ROOT%\jars\activation.jar;%INSTALL_ROOT%\jars\mail.jar
JARFILE: au.com.camtech.ec.wrappers.tcpdaemon.TcpDaemon
PORT: 1000

8. Click the Install button.



The service will have installed and FireDaemon will have started java.exe (check for the process in Task Manager). Camtech Merchant Server will write a debug log file called tcpdaemon.log to the %INSTALL_ROOT%. Ensure this file is being created (if not then Java is not starting correctly due to a bad parameter or path) and examine the file for any startup errors.

The Camtech / FireDaemon alliance reference can be found here:

http://www.camtech.com.au/support/faqs/firedaemon.htm