Application Configuration Category

Contents of Application Configuration

Application Configuration

How to configure the applications that run on Site Servers and Controllers.

EPG Installation and User Manual

Introduction

The Electronic Payment Gateway (EPG) is a program that runs on a Site Server (sserv7 image) and handles the interfaces with tellers and payment processors. It also reports status of these tellers and Ryko car washes on the General Intelio Interoperability Protocol (GIIP) for systems that wish to monitor and report activity.

Supported tellers:

Intelio Activa Virtual Attendant
Ryko AMTT coinbox
Ryko AMTT-CS coinbox
Ryko Enteract Virtual Attendant
Ryko Bay Pay
Ryko Touch-n-Go
Unitec Wash Select II

Supported payment processors:

Authorize.Net
Radiant Epsilon
WashMax Market

EPG is a replacement for non-PCI compliant EPI Server application.

Installation and Startup

EPG should operate on any Windows XP based system. However, it's only supported by Intelio as pre-installed on an Intelio Site Server. See the Application Configuration section at How to configure a new Site Server for details.

Taskbar Icon and Menu

When running, EPG has an icon in the Windows taskbar notification area that looks like this:

Right click on it for a menu of windows and actions:

Status displays the Status window showing current status of the system.
Settings displays the Settings window which allows you to configure EPG.
About displays version and copyright information.
Exit shuts down the EPG application.

Status Window

The Electronic Payment Gateway Status window shows the current state of things in EPG. It may be brought up from the taskbar icon menu, or it may be displayed full screen on a Site Server that is configured solely as a Payment Gateway system (via CAW Booter configuration profile).

Items that may be appear in the status:

HTTP Server

EPG has a reports interface via the HTTP protocol. When it is being accessed, connections will be shown under this heading.

GIIP Server

EPG includes a General Intelio Interoperability Protocol server used for communication on this protocol. Connections to this server are shown below this heading.

EPI Server

EPI is the interface with Ryko and Intelio tellers. A connection with one of these tellers will appear under this heading. The connection will show an icon indicating the type of device and whether it is currently communicating or not (crossed out icon).

Unitec Tellers

If configured, this heading will appear with a line below it for each wash bay. The icon and text indicate the current state of the Wash Select II.

Authorize.Net Payment Processor

If configured, this heading will appear. The icon color and text below it indicate the state of the communication with Authorize.Net.

Intelio GIIP Payment Processor

If an Intelio edge VM is running, it will appear here as well as under GIIP Server. The icon color and text below it indicate the state of communication with WashMax Market's payment processor.

Radiant Epsilon Payment Processor

If configured, this heading will appear. The icon color and text below it indicate the state of the communication with Epsilon.

The following buttons may also be available:

EPI Diagnostics

This button is only available when a device under EPI Server is selected. Press it to view communication information with the device.

View Log

EPG maintains a detailed daily log of activity, useful for debugging. Press this button to view the current day's log.
Previous day's logs can be found in the directory C:\Program Files\Ryko\EPG\EventLog\

Closes the Status window. (Only available when not running full screen.

When a Site Server is configured as a Payment Gateway, EPG runs with the Status Window full screen and adds buttons to Exit to Boot Aplication, Reboot Server, and Shutdown Server. It also displays the program version and copyright.

Settings Window

The EPG Settings window provides an interface to configure options, interfaces, and payment processing. Each area of configuration appears as a separate tab, each of which is detailed below. If the OK button is clicked, your changes are saved and EPG exits. On a Site Server, the boot application will automatically launch a new instance running the new configuration.

General Settings

This tab contains settings that are not tied to a particular interface.

Keep reports for 30 days

Some payment processors may provide reports to EPG as part of its interface. (Epsilon is one such processor.) These reports will be purged after the designated number of days.
To access the reports, login to WashMax.com, click on the Reports tab, and then Payment Processor Reports below that.

Release pre-authorization hold after 4 hours

When used with a self-serve car wash teller, this is how long a customer has to complete their purchase before the transaction closes.
It also designates how long some reference information about the transaction may be stored on the hard drive.
Sensitive Authentication Data, as defined by PCI PA-DSS, is never to be stored, in any form, by EPG.

Your Computer ID: xxxx xxxx

This read-only field has a unique hash defining this computer. Upon installation, you must provide this value to Intelio Customer Support to generate a license key for EPG's interface with your payment processor.

Authorize.Net Settings

Authorize.Net is an online credit card processor gateway. A merchant account must be setup by your provider (not Intelio). The Authorize.Net account must be setup as Merchant Type "Retail". Device type should be set to Self-Service Terminal. Once the account is created, login to Authorize.Net, go to Settings, and generate an API login and transaction key.

Fields:

Authorize.Net Server name or address: cardpresent.authorize.net

If DNS is not functioning on the Site Server, try entering 64.94.118.65 here.

Account API Login

Enter the API Login ID generated from the Authorize.Net web site.

Account Transaction Key

Enter the Transaction Key generated from the Authorize.Net web site.

Device Type: 3: Self Service Terminal

Should not change, but some account are mistakenly set to 2: Unattended Terminal, and you can select that here.

Product License Key

The Authorize.Net functionality in EPG requires a license key from Intelio.
If you are installing without the assistance of Intelio, call 800-874-6099 to obtain a license key.

EPI Settings

Electronic Payment Interface (EPI) is the protocol used to communicate with Ryko coinboxes and car washes, and Intelio tellers.

Fields:

RykoNet Host: localhost

Rarely is there reason to change this field.
If communicating with a single Virtual Attendant over Ethernet/IP, it occasionally works to enter that device's name or IP address here.

Terminals

List of terminals (coinboxes, tellers) to communicate with.
Use the Edit Terminals button to add terminals.

Epsilon Settings

Radiant Epsilon is credit and fleet card processor that is customized to each customer. The Epsilon service may be installed on the Site Server itself, or on a Radiant server on site. Contact your Intelio or Radiant sales representative for more information.

Fields:

Location ID: POS000000000100

Base value of point of sale terminal's ID. The last digit will be changed to the teller/coinbox number.

End of Day Batch time

At the designated time each day, the current batch will be closed and a report will be generated.

Product Code

Product Code that car washes will appear as in the Point of Sale system.

Product License Key

The Epsilon functionality in EPG requires a license key from Intelio.
If you are installing without the assistance of Intelio, call 800-874-6099 to obtain a license key.

GIIP Settings

The lone field in this tab defines the port on which the General Intelio Interoperability Protocol (GIIP) server will listen for connection.
There is currently no reason to change this.

HTTP Settings

The lone field in this tab defines the port on which a basic HTTP server will listen for connection. This server is used to access reports provided to EPG from the Epsilon interface. To access the reports, login to WashMax.com, click on the Reports tab, and then Payment Processor Reports below that.

There is currently no reason to change this setting.

Unitec Settings

EPG can process payments for and monitor up to four Unitec Wash Select II bays at a single site. The interface in a Wash Select II is serial, so a serial device server is installed within the teller to provide an Ethernet interface. Enter the IP address and listening port for the TCP Server for each bay you wish to connect to.

Configuring the Serial Device Server

A serial device server must be connected to the site's IP network or directly to the Site Server via an Auxiliary Connection and a cross-over cable. Configured the device to:

An IP address compatible with its subnet.

For a direct connection to Auxiliary Connection #1 on a Site Server, use IP 192.168.111.21.

Set to run as a TCP Server
Set the serial port to 9600 baud, 8 data bits, 1 stop bit, no parity, no flow control.

If using a Moxa nPort serial device server, a search utility from Moxa is pre-installed on the Site Server. Find it in the Start / All Programs menu and use it to configure the Moxa(s).

Configuring the Wash Select II

The Wash Select II (WSII) must be configured to communicate correctly with EPG. Open the teller and flip the toggle switch on top of the motherboard to Setup mode. (Refer to your WSII Operations Manual, "Setup and Operate Modes".) Use the 1 key on the keypad to go backwards in a menu and also to answer Yes. Use the 3 key to go forward and to answer No. The * key is used for selection, or as an Enter key.

Press 3 twice to advance the menu to Credit System, and then press * to select it.
The menu item Credit Mode is displayed; press * to select it.
Press 3 and then * to select Generic Terminal Mode.
Press 1 and then * to answer Yes to the Use extensions question.
Press 3 several times to advance to the menu item Accept Propriety, and then press * to select it.
Press 1 and then * to answer Yes to the question.

Now flip the motherboard toggle switch back to Operation mode.

WashMax Reports

Reports provided to EPG from the Epsilon interface are accessible from your WashMax.com account. To access the reports, login to WashMax.com, click on the Reports tab, and then Payment Processor Reports below that. If your site does not appear there, contact Intelio Customer Support at 800-874-6099 to have it enabled.

(Instructions for Intelio Customer Support: Configure WashMax EPG Reports.)

Adam Fanello

How to setup RykoNet over IP

Introduction

The Activa Virtual Attendant and Site Controller communicate with each other over over a protocol known as RykoNet. This software protocol can be physically transmitted Echelon or Ethernet (IP). At a site running a Ryko car wash, Echelon is typically used because that is the only connection possible with the Ryko car washes. (A mixed environment is possible, but unusual.)

For site with car washes from all other manufacturers, RykoNet over IP is the physical transmission method of choice.

Choose the RykoNet Server Computer

One of the computers, either the Virtual Attendant or the Site Controller, must be select to be the server computer. This choice is not trivial, as the server computer becomes a single point of failure for RykoNet. That is, if that one computer is offline, then no other device using it as the server can communicate via RykoNet. Use the following decision table to make a choice.

Scenario	Server Computer
Does the site have just one Virtual Attendant and one Site Controller using RykoNet?	Site Controller
Does the site have a Ryko car wash, and you need to use RykoNet over IP?	Virtual Attendant
Does the site use the Intelio gate system?	Site Controller
Does the site have multiple car wash bays?	Site Controller

Set Static IP on the server

The server computer must be assigned a static IP address on the LAN.

Selecting a Static IP

If the site's network is actively managed by the operator, then request an IP address to use.
Check the router's DHCP settings. Choose an IP in the same subnet but outside of the range used by DHCP.
Do not assign the computer to statically use the IP that it was given dynamically! The router could give that IP to another device, resulting in a conflict.
Ping the IP that you plan to use, to ensure that nothing is already there.

Setting a Static IP on Windows XP

Ao the selected server computer:

Bring up the Control Panel.
Double click on Network Connections.
Scroll the window sideways and identify the connection with a Device Name of RealTec.
Right-click on the connection and select Properties.
Scroll down on the item list to Internet Protocol (TCP/IP), and double-click on it.
Click on the bubble to the left of Use the following IP address.
Fill in the IP address (which you choose), Subnet mask (usually 255.255.255.0), and Default gateway (the nearest router).
Fill in the Preferred DNS server. Use the router address again if you don't know of any other.
Click on the OK button. (If you are running this remotely, you will be disconnect and need to VNC back in after some delay.)
Click on the next OK button.

Configure the non-server device

If you selected the Site Controller as the server computer, then the Activa must now be configured to use it as the server. See the next section.
Otherwise, the section after the next describes how to configure the Site Controller to use the Virtual Attendant as the server.

Configure the Activa Virtual Attendant to use the Site Controller as the server

Log in to the Activa maintenance mode.
Go to the RykoNet tab by:

Touch the System Setups button.
Touch the Software Setups button.
Touch the RykoNet tab.

Use a keyboard (real or on screen by pressing the ABC button) to change the Connect To field to the static IP of the Site Controller.
Touch the Accept button.
Touch the Close buttons until the system returns to the idle screen.

Configure the Site Controller to use the Virtual Attendant as the server

Configuring the Site Controller requires changes in three places, including editing files on the file system. It is not for the non-technical.

From the main application screen, touch the Setup Menu button.

If the Setup Menu button is grayed out, you will need to Login first.

Touch the RykoNet button.
Touch the Setup tab.
Use a keyboard (real or on screen by pressing the ABC button) to change the Connection field to the static IP of the Virtual Attendant.
Touch the Accept button.
Hold down the Windows key (it looks like a four-sectioned waving flag), press the e key, and then release the Windows key.

Windows Explorer should appear, showing My Computer.

Stop the EPI Server and WashTrax:

In the notification area on the bottom right of the screen, next to the clock, are small icons of programs running.
EPI Server looks like a red notebook with a hand holding a pen.

Right click on the EPI Server icon and click on Exit.

WashTrax looks like a blue-handled magnifying glass over two tire tracks.

Right click on the WashTrax icon and click on Exit.

Use the tree view on the left pane to navigate to C:\Program Files\Ryko\EPI Server\Setups
Right click on the EPIServerSettingns.xml file, and click on Edit.
Find the part that says <RykoNetHost>localhost</RykoNetHost> and change the localhost part to the static IP of the Virtual Attendant.
Save the file and exit Notepad.
Use the tree view on the left pane to navigate to C:\Program Files\Ryko\WashTrax
Double-click on the WashTrax.ini file.
On the ninth line it says Host=localhost . Change the localhost part to the static IP of the Virtual Attendant.
Save the file and exit Notepad.
Close the Windows Explorer window.

You should be returned to the Setup Menu.

Touch the red Exit button.
On the next screen, touch the green Start button.

Adam Fanello

Select VMware Server Bridged Network Adapter

When setting up an edge VM to bridge to the physical network, you usually only need to configure eth1 on the edge and VMware on the host will automatically select the correct adapter to bridge to the uplink. This works best if the uplink is working before you start the edge. If not, VMware may choose the wrong adapter to bridge.

You can manually tell VMware which adapter to use by following these steps:

Run the Manage Virtual Networks program.

If running under the LocalTerminal account (or other non-administrator account), you must run this application as Administrator by right-clicking on "Manage Virtual Networks" and selecting "Run As"

... and then select "The following user:". Make sure the local Administrator account is selected, enter the password, and click OK.

Now click to the "Automatic Bridging" tab and uncheck it.

On the "Host Virtual Networking Mapping" tab, drop down the list for VMnet0 and select the adapter that provides the uplink. You can cross-reference this on the Control Panel / Network Connections window. In the example below, it's the Realtek Gigabit. On Sys6 and Sys7 Site Servers, it'll be the only Intel adapter.

Click OK, and you're done.

Adam Fanello

Update Manager Usage Manual

Intelio provides software updates to Site Servers and Activas on its network through its own system specially designed for the Intelio and Ryko products and network. The Intelio Support Scripts running on each device automatically download these updates and can install them during Windows shutdown or reboot. On the Site Server, this behavior can be monitored and controlled through the Update Manager application.

Update Manager is launched by CAW Boot and appears in the taskbar. Normally the icon is , but when an update is waiting, it changes to . Right-click on the icon to trigger a reboot, show the waiting updates, or configure update manager.

Update Processing Mode:
Fully Automated is recommended, as it ensures that the Site Server always installs the latest updates on a timely basis. Updates are automatically downloaded and installed upon the next reboot, as scheduled or sooner based on the urgency of the update.

When set to Manually Initated, updates are still automatically downloaded. Rare emergency security fixes may cause an immediate reboot and install, but normally updates will not install until manually initiated by right-clicking on the Update Manager icon and selecting the reboot option. This ensures that updates are only installed when someone is ready for them, and allows for the list of updates to be reviewed. However, it's important that someone remembers to follow this procedure and initiate the install & reboot at least once a month!

When set to Offline, updates are never downloaded or installed. When selected, the customer is taking responsibility for all application and operating system updates. Using this option may break PCI compliance and void the site's support contract.

Updates Provider:
Select the provider of your updates. Intelio Site Server default to Intelio, while Ryko devices default to Ryko.

Auto-Reboot Schedule:
Setting a reboot schedule is highly recommended when using Fully Automated processing, as it allows for the reboots to be scheduled during a known slow period. If disabled, a reboot will typically be triggered exactly eight days after the older pending update was downloaded, which could be during a busy time of day! Setting a weekly schedule is preferred.

Intelio recommends scheduling reboot every Tuesday at 2:30:00 AM.

Warn before reboot:
Before any automated reboot, whether scheduled or driven by pending updates, a warning will be displayed on the screen. This warning provides the option to delay the reboot for some time.

Adam Fanello

Use $1 Coins

To use $1 coins in the Activa coin dispenser, rather than quarters, you must change settings in two different places.

On the Activa,

Login to Maintenance mode.
Touch the System Setups button.
Touch the Hardware Setups button.
Touch the Coin Dispenser tab.
Enter 1.00 in the Coin Value field.
Touch Accept.

In the Code-a-Wash application on the Site Controller:

Login to the Code-a-Wash application.
Touch the Setup Menu button.
Touch the Coinbox button.
Touch the Currency tab.
Set Change Value to 1.00.

Adam Fanello

Application Configuration Category

Table of Contents

Application Configuration

EPG Installation and User Manual

Introduction

Installation and Startup

Taskbar Icon and Menu

Status Window

Settings Window

General Settings

Authorize.Net Settings

EPI Settings

Epsilon Settings

GIIP Settings

HTTP Settings

Unitec Settings

Configuring the Serial Device Server

Configuring the Wash Select II

WashMax Reports

How to setup RykoNet over IP

Introduction

Choose the RykoNet Server Computer

Set Static IP on the server

Selecting a Static IP

Setting a Static IP on Windows XP

Configure the non-server device

Configure the Activa Virtual Attendant to use the Site Controller as the server

Configure the Site Controller to use the Virtual Attendant as the server

Select VMware Server Bridged Network Adapter

Run the Manage Virtual Networks program.

If running under the LocalTerminal account (or other non-administrator account), you must run this application as Administrator by right-clicking on "Manage Virtual Networks" and selecting "Run As"

... and then select "The following user:". Make sure the local Administrator account is selected, enter the password, and click OK.

Now click to the "Automatic Bridging" tab and uncheck it.

Click OK, and you're done.

Update Manager Usage Manual

Use $1 Coins