Top Level Category

Table of Contents

  1. Contents of Top Level Category
    1. Activa (Activa Virtual Attendant product line)
      1. Troubleshooting (Techniques for finding and resolving problems.)
      2. Application Configuration (How to configure the Activa application.)
      3. Carwash Interfaces (How to interface with various car wash makes...)
      4. Hardware Installation (How to install the Activa hardware.)
      5. Hardware Maintenance (Maintaining and upgrading hardware components...)
    2. Site Server (Articles about the various Site Servers, Site...)
      1. Application Configuration (How to configure the applications that run on...)
      2. Hardware (Installation and upgrading the Site Server and...)
      3. POS Interface (How to interface Intelio Site Server to...)
      4. Software Installation (Software (operating environment) installation...)
      5. Troubleshooting (Techniques for finding and resolving problems.)
    3. WashMax (Articles about the various WashMax and iConnect...)
      1. Carwash Interfaces (How to interface with various car wash makes...)
      2. Teller Interfaces (How to interface with various teller models)
    4. Support (Articles for use by support personnel. )
      1. Networking (Networking Questions and Answers)

Top Level Category

Parent category to all other categories
There are no articles in this category.

Activa

Activa Virtual Attendant product line

About Activa Models

Activa Virtual Attendant is Intelio's car wash teller. It's node name on the network is teller followed by the device number.

The Image

There are older images based on Windows XP Embedded. These are not PCI compliant though. The latest image runs Windows Embedded for POS 2009 and is carefully crafted to meet PCI DSS requirements.Models

Hardware BIOS Settings Network Locations
Activa1 (aka: model 1, teller1)

Nagasaki motherboard
Intel Celeron CPU @ 2.5 GHz (Benchmark 284)
1 GB RAM
2.5" 40 or 80 GB HDD
Press the DEL key once every few seconds, until you see the CMOS Setup screen.
Cursor to Advanced BIOS Features and press Enter.
-> Set First Boot Device to USB-ZIP.
-> Set Second Boot Device to USB-HDD.
-> Set Third Boot Device to HDD-0.
Press ESC to return to the main screen.
Cursor to Integrated Peripherals and press Enter.
Cursor to SuperIO Device and press Enter.
Set PWRON After PWR-Fail to On.
Press F10, Y and Enter to save and exit.
Local Area Connection: The only Ethernet jack

Auxiliary Connection #1: N/A
Activa2 (aka: model 2, teller2)

Nagasaki PPC-1595PT motherboard
Intel Atom N270 CPU @ 1.6 GHz (Benchmark 305)
1 GB RAM
2.5" 80+ GB HDD

Press the DEL key once every few seconds, until you see the CMOS Setup screen.
Cursor to Load Optimized Defaults, press Enter, and Y for yes.

Cursor to Advanced BIOS Features and press Enter.
Cursor to Hard Disk Boot Priority and press Enter.
If USB Flash isn't the first item, press the Page Down key to swap the devices. Press Esc to exit.
Press Esc to return to the main screen.

Cursor to Integrated Peripherals and press Enter.
Cursor to SuperIO Device and press Enter.
Cursor to PWRON After PWR-FAIL and press Enter.
Cursor to On and press Enter.
Press F10 and Y for yes.
Local Area Connection: Top Ethernet jack.

Auxiliary Connection #1: Bottom Ethernet jack

Activa3 (aka: model 3, teller3)

Nagasaki PPC-????? motherboard
Intel Celeron M 440 CPU @ 1.86 GHz (Benchmark 438)
2 GB RAM
2.5" 160 GB HDD
Press the DEL key once every few seconds, until you see the CMOS Setup screen.
Cursor to Load Optimized Defaults, press Enter, and Y for yes.

Cursor to Advanced BIOS Features and press Enter.
Cursor to Hard Disk Boot Priority and press Enter.
If USB Flash isn't the first item, press the Page Down key to swap the devices. Press Esc to exit.
Press Esc to return to the main screen.

Cursor to Integrated Peripherals and press Enter.
Cursor to SuperIO Device and press Enter.
Cursor to PWRON After PWR-FAIL and press Enter.
Cursor to On and press Enter.
Press F10 and Y for yes.
Local Area Connection: Top Ethernet jack.

Auxiliary Connection #1: Bottom Ethernet jack

Ethernet Adapters

Every Activa has a primary Ethernet port around the middle of the back panel, among the USB ports. This is the network uplink port and is shipped set to automatically obtain a dynamic IP address. It may be reconfigured from within Windows, where it is labeled Local Area Connection. On a model 2 Activa, there is a second Ethernet adapter. The following table describes all of the network connections that you will find in Control Panel / Network Connections on a freshly imaged teller:

Name in Windows
IP Address Netmask Recommended Use
Local Area Connection dynamic
dynamic
uplink
Auxiliary Connection #1 192.168.111.20 255.255.255.0 none
Intelio VPN dynamic dynamic do not alter

See Also

   Activa Flash Imager (PCI)
   How to configure a new Activa
Adam Fanello

Activa Operations Manual

Download the manual below. You need Adobe Acrobat Reader to view it.

Quick Reference Guide

This guide is for store personnel to use.
Ron Salvato

Troubleshooting

Techniques for finding and resolving problems.

Activa is playing a video about a conveyor

Symptom

The Activa tells the customer to wait for the conveyor to move their vehicle through the wash.

Problem

An inappropriate escrow video has been selected.

Solution

The Activa is now ready to sell car washes again.
Adam Fanello

Activa not offering wash code upsells.

An upsell, also called upgrade, is when the customer is offered to upgrade to a higher end wash after they have entered a wash code for a lower end wash. Several conditions must be met for the Activa to present the wash package upgrade screen:
  1. Wash packages are priced from low to high. (Package #1 is the cheapest wash.)
  2. Cash and/or credit card handling is enabled.
  3. Upgrade option is enabled. (Software Settings screen, Options tab.)
  4. The wash code used has identical arming bits to one of the wash packages in the Activa.
  5. The wash code package is not the highest one.
Adam Fanello

Bill Acceptor troubleshooting

The Activa uses the A6 Series bill acceptor from International Currency Technologies (ICT).

Documentation is attached.

For dip switches under front panel of the acceptor must be set to ON OFF OFF OFF.

Dip switches on the side of the acceptor must all be set OFF.
Adam Fanello

Bill Dispenser Maintenance

The Bill Dispensers must have routine maintenance to avoid continuous jams and to speed up the process of switching dispensers. The sensors, belts, and rollers get dirty fast and require cleaning at least once a month. Failure to perform this regular maintenance will void the warranty on the bill dispensers.

Here is what is needed for the cleaning process and what needs to be cleaned:
  1. Q Tips (lint free is a MUST)
  2. Rubbing Alcohol (DO NOT use anything else)

The dispensers will need to be removed from the dispenser tray and the technician will need to remove front cover to access the sensors. Using the Q Tip soaked in the Rubbing Alcohol, wipe all sensors. Using the dry end of the Q-Tip, wipe any access rubbing alcohol from sensors. Visually inspect for any remaining lint or dirt. Repeat as necessary.

The bands and rollers will also need to be cleaned with rubbing alcohol. A lint free rag can be used for the initial cleaning (to remove dirt, lint, and ink that comes from the dollar bills). Q tip and rubbing alcohol will be used for final cleaning of the rollers and bands.

This process will all but eliminate continuous jams and sensor errors, thus eliminate the need to replace the bill dispensers.

Installation Manual

Attached below.
Adam Fanello

Card button is missing

Overview

There are two common reasons for the Card button to be missing from payment selections screens.
  1. The card reader has been disabled in the application.
  2. The card reader driver is on the wrong COM port.

Note: Intelio Technologies prohibits the capture of sensitive authentication data for debugging or troubleshooting purposes. See PA-PCI Implementation Guide for details.

Enable the Card Reader

Set the Card Reader Driver COM Port

This procedure is difficult to perform without a mouse.

Adam Fanello

Card Reader troubleshooting

The Activa uses the MSR280 card reader.  Specifications are attached.

Note: Intelio Technologies prohibits the capture of sensitive authentication data for debugging or troubleshooting purposes. See PA-PCI Implementation Guide for details.
Adam Fanello

Coin Acceptor Troubleshooting

For reference there are three coin acceptor switch settings:

The positions for each switch are identified on the moulded plastic housing.

Reject button can get stuck.   Take button out and smooth edges of metal hole.    Possibly bend top and bottom flanges around hole up to increase margins.   Wd-40 has been used successfully.


It’s reported that tightening bezel of coin acceptor can cause errors.   Apparently the metal plate can be warped and tightening it down makes it worse.   Loosen the bezel to minimize distortion.

 

If the above does not correct the problem, file the inner opening edges of metal sleeve.  Also, loosen the mounting screws of the Acceptor to a snug, but "Not" tight setting.


Coin Dispenser Troubleshooting

Dip settings:    All four dip switches on the bottom of the hopper should be set to “on”.   This selects ICT protocol using the RS-232 interface.

 

 

 

The turret wheel can be removed to look for jams.   Remove the hopper by pressing down on the tab at the back of the unit and slide the plastic hopper forward, and lift off.    The turret wheel lifts out.   There is tapered pin through the motor shaft that is free floating and is only held in place when the turret is on.   It will fall out and get lost if you are not careful.    To replace, just slide the pin into the motor shaft, center it, and drop the turret back over the shaft.  It has a slight taper so it only goes in one way.

 

 

 

Also for jammed conditions, there is what looks like a screw adjustment recessed at the rear of the unit.   This is an extension of the motor shaft, and if a coin is jammed you can rotate this shaft clockwise with a blade screwdriver until the coin is ejected.

 

 

 

As a double check, the turret should be part number A25140 for US and Canadian coins.   There is an additional coin size setting that is accessible through a cover plate at the front of the dispenser…two tabs hold it down.    You will see a metal serrated lever that is held in place by bumps in the plastic housing.    The US adjustment is correct when the lever has been moved three bump positions smaller than the widest setting.   Lift the metal lever up and move it to the new position if necessary…it does not slide from position to position.

 

 

 

 

Custom TG02 printer printing gibberish / wrong baud rate

The Custom TG02 printer can be configured by powering it on while holding both the FEED and REPORT buttons. To do this, login to the Activa, and touch Diagnostics and then Sensors/Relays. Then touch the Outputs/Relays tab. Touch the 12V Printer button to turn the power off. Press and hold the FEED and REPORT buttons and the printer, touch the 12V Printer power button on the screen to power it back on, and then release the printer buttons. You will now be in configuration mode.

It will print a report of current settings. Press FEED to advance through each parameter, and press the REPORT button to change the value of the current parameter. The printer provides feedback to you by printing on the paper. In the end, it prints a final report of the parameters. You must move quickly, as after several seconds of inactivity the printer exits configuration mode and goes back into operation.

The target parameters are:
Baud rate = 38400 bps
Data Length = 8 bit/char
Parity = None
Handshake = xon/xoff
Paper jam sensor= Enabled
speed current = High
Print density = Normal

The most common issue is that everything is correct except baud rate is at 9600 baud. Upon putting the printer in configuration mode, press FEED once (advances to the baud rate parameter), and then press REPORT twice (selects 19200 and then 38400). Press FEED six more times to get the final report.

The attached PDF shows the resulting printout from following this guide. (Strips of paper are laid out left-to-right on the scanned page.)
Adam Fanello

Fujitsu Printer is printing out long streams of paper

First check the printer properties
Start -> Control Panel -> Printers and Faxes
Right click on FTP627(384pixels) and select Properties
Click the ports tab
Highlight COM4 and click on Configure Port...
Port settings should be as follows:
Bits per second: 19200
Data bits: 8
Parity: none
Stop bits: 1
Flow Control: Xon / Xoff

If changing these settings does not solve the problem, then you must reinstall the printer driver. This seems to fix the problem.  After reinstallation, you must set the cut properties of the printer.

Go to: systems.intelio.com/tools/Activa/drivers/printers
Download (and save to C:\Shared) FTP-driver.zip
Extract the zip file

click the microsoft link, and save to disk at C:\WINDOWS\i386 (as type all files)
STDNAMES.GPD
UNIDRV.DLL
UNIDRV.HLP
unidrvui.dll
unires.dll

Start -> Control Panel -> Printers and Faxes
Right click the printer in question -> Properties
On the Advanced tab, click New Driver...
Click through the wizard, selecting C:\Shared\6x7V100\FTP627\FTP.INF as the driver file
If a prompt comes up for any files (such as UNIDRV.DLL), select C:\WINDOWS\i386 as its location
When finished, close all windows.

Now, to set the cut properties:
Start -> Control Panel -> Printers and Faxes
Right click the printer in question -> Properties
On the General tab, click Printing Preferences...
Click the Advanced... button
Expand Document Options -> Expand Printer Features.
Set Paper cut: to Document cut
Set Cutting method: to Partial cut
Click OK thrice.
Done

How to adjust Activa display brightness and contrast

  1. Exit the application, to the O/S.
  2. Right click on the Intel Extreme Graphics icon on the task bar. (Blue trapezoid on the far right.)
  3. Click on Graphics Properties.
  4. Click on the Color Correction tab.
  5. Adjust the settings as desired, clicking the Apply button to see the result.
  6. Click OK when done.
Adam Fanello

Panel PC Not Responding to Touch

If you take a call about the Panel PC not responding to touch, please follow these guidelines:

  1. Verify with tech on site.  VNC in and watch the person physical try and command the touch.
  2. Reboot the Panel PC. If this does resolve the problem, continue to the next step...
  3. Exit or kill the the Activa and Boot applications.
  4. Double-click the Touch Kit icon on the desktop.
  5. Have the tech conduct a draw test first to determine how the calibration is. Click the Quit button to exit.
  6. Click the Hardware tab and then the Hardware Settings button.
  7. Click the Reset all of the control parameters to factory default button. This will take several seconds to complete.
  8. Click the Tools tab and then the Clear and Calibrate button.  This will automatically take you to the 4 point calibration.
  9. Have the tech follow the calibration instructions.  Once the 4 point is complete, have tech do a draw test.
  10. If the lines look good, close Touch Kit and double-click the CbxBoot icon on the desktop. Have the tech try to enter a wash code (make one up) to test.
  11. If still having trouble, go back into the Touch Kit and perform the 25 point calibration as well.
If none of the above resolves the problem, order a Panel PC following RMA protocol.
Ron Salvato

Repair or Restore Activa Database

Sometimes the Activa database goes bad and the Activa will no long start up.

You can detect this problem in the logs in C:\EventLog. The boot log will likely be very large and show repeated:
Failed to open database connection. Will attempt to reconnect.
OpenDBConnection(): Exception - Cannot open database requested in login 'Coinbox'. Login fails
If there's a main Activa log at all, it'll just have the startup file version listings quickly followed by:
FATAL App: EXCEPTION: SenderClass:NULL Addr:005454D2 Module:(null) Line #:0 <Cannot open database requested in login 'Coinbox'. Login fails>
There are six ways by which you can try to fix this. You may wish to try them in the order presented here until one works.

Repair Database:

First thing to try is to simply repair the database. There's a button for this on the CbxBoot display, unfortunately the buttons aren't available when it's failing.
  1. Close or kill Activa.exe.
  2. Close or kill CbxBoot.exe
  3. Press the Start menu and click on Run.... Enter (including quotes): "C:\Program Files\Ryko\Activa\CbxBoot.exe" /menu
  4. Click the Repair Database button.
  5. Click the START button to launch the main app.
If you are unable to get to the buttons, or it still fails, move on to the next solution.

Restore Database:

If could get to the CbxBoot menu above, but repair didn't work, you can follow the same steps but press the Restore Database button instead or repair.  This occasionally even works. Despite the low success rate, it is easy to try.

Restore Local Backup:

The Activa makes a backup copy of the database upon reboot, which usually happens each morning at 2:30 AM. Restoration of this backup is manual, but not difficult.
  1. Close or kill Activa.exe.
  2. Close or kill CbxBoot.exe
  3. Open Windows Explorer. (AKA: My Computer.)
  4. Navigate to C:\Intelio\backup and double-click on Database.zip, which will open it in a new window. (You may wish to note the date on the backup.)
  5. Navigate to C:\Program File\Ryko\Activa\Data.
  6. Double-click on DetachDB.bat. (You may prefer to right-click and then left-click on Open on the menu, as the program runs quickly and you may not see the window quickly flash on the screen with a remote connection.)
  7. Navigate to C:\Program Files\Ryko\SQL DataBases.  Delete or move the two Coinbox* files in that directory. (If the directory is empty already - you probably tried to do a Restore Database...)
  8. Copy the two files from the Database.zip window into the SQL DataBases directory.
  9. Close the windows.
  10. Double-click CbxBoot on the desktop.

Restore Server Backup:

If the database was already bad when the last local backup was made, restoring it won't help. An Intelio server pulls the local backup to the server every couple of days, and you can find it on the SOC in the Files tab. Look for the file name dna/teller###/Database.zip.  If this backup is older than the local one, it may work when the local copy doesn't. The trick is getting it back to the Activa.
  1. Download the Database.zip backup file from the SOC.
  2. Upload the Database.zip file to the Activa. (Windows file share or scp, such as scp Database.zip administrator@<ip address>:/cygdrive/d/  will put it on the D drive.)
  3. Now just follow the same direction as Restore Local Backup above, but using the file you uploaded.

Restore Default Database:

If no backup will restore, then all you can do is restore the default database and reconfigure everything.
  1. Open Internet Explorer on the Activa.
  2. Go to the Intelio Software Repository. (http://repository/repo/) - you should know the login & password.
  3. Click on the Activa folder.
  4. Download the file DefaultDatabase_v2.x.x.x.zip. It's okay if the version is a bit older than what is running on the Activa; it'll auto-update.
  5. Now just follow the same direction as Restore Local Backup above, but using the DefaultDatabase_*.zip file.

Reimage:

When all else fails, reimage the PC.  When bootstrapping the PC, if there is a server backup it'll ask if you want to restore it. This will perform the same process as the Restore Server Backup above. If you know this backup to be bad, don't restore it!  If you do restore it and it turns out to be bad, follow the instructions for Restore Default Database above.
Adam Fanello

Application Configuration

How to configure the Activa application.

Activa Direct Wash Arming

Use Activa Direct arming to control the car wash through a direct wired connection to the Activa's I/O terminals.

To Select Activa Direct:

Log into the Activa using the technician login. (The owner login does not have access to modify this.)
Touch the System Setups button.
Touch the Carwash Options button.
Touch the Arming tab.

Activa Direct Carwash Options

Select Activa Direct as the Arming Option. This reveals four new settings to tune Activa Direct to your specific car wash interface.

Out-Of-Service when

The Out-Of-Service when setting defines what kind of signal from the car wash indicates that it is out of service. The choices are:

Out-Of-Service delay seconds

This is the number of seconds that the Out-Of-Service condition must remain in effect before it takes effect. Some car washes have their Controller Power or fault signal twitch a bit at the beginning or end of a wash. This delay allows for this without indicating that the wash is off line every time.

The recommended value is 10 seconds.

Time in hold Arming Signal (or until wash becomes busy)

Different car washes require that the arming signal be held for different periods of time. The two most common requirements by car washes are a two seconds pulse and “until the car enters the bay” (at which point, it becomes busy). Additionally, a timeout is required should the car never enter the bay.

For a two second pulse, set this to 2.

To hold the signal until the car enters the bay, set this to 900 which is 15 minutes. (You can reach 900 either by pressing the up arrow for a while, or pressing down from 1.) The arming signal will thus be dropped after the car enters the bay or after a 15 minute timeout.

Many other possible values between 1 and 900 are available. The default is 2.

Time to wait for wash to begin

If the car wash does not begin (wash becomes busy) for this long, the Activa will stop waiting for the customer to enter the wash and go back to idle. The customer may loose the wash at this point. If the car wash has a timeout limiting how long it will wait after being armed, set this value to match.

Setting Arming Outputs

Selecting which outputs are activated when a wash package or additional service is armed is very much like any other arming system. When editing a package or additional service, the Wash Options tab displays the list of eight available Activa Direct outputs. (The last two are intended for use by the Additional Services, but that is not required.)

Presently, Output 1 must be included in every wash package if wash codes from the Site Controller are being used. Nothing needs to be wired to this output.

A typical car wash simply sets Output 1 and Output 2 to arm wash package #1 (with Output 2 being wired to the car wash), Output 1 and Output 3 to arm wash package #2 (with Output 3 wired to the car wash), and so on. However, any combination of outputs may be used for a single package.

Edit Wash Package / Wash Options tab

Setting Arming on the Site Controller

The interface on the Site Controller is currently incomplete. It will always show the car wash as being Offline. Additionally, when setting the Wash Key Net Arming, it will show the Ryko names for the arming outputs. Simply ignore these names and all outputs above number 8, and numerically select the same arming outputs as on the Activa.

Activa Direct Wiring Terminals

The “Wash Option” arming outputs and other signals correspond to terminals on the inside back wall of the Activa as shown in the following table:

Output to car wash

Terminal

Arming Output 1

711

Arming Output 2

712

Arming Output 3

713

Arming Output 4

714

Arming Output 5

715

Arming Output 6

716

Arming Output 7 / Option 1

717

Arming Output 8 / Option 2

718

Arming Output Common wire

719

Input from car wash

Terminal

Busy or Wash-in-Use Input

720

Control Power or Fault Input

721

Input Common wire

722



Intelio Technologies

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

  1. If the site's network is actively managed by the operator, then request an IP address to use.
  2. Check the router's DHCP settings. Choose an IP in the same subnet but outside of the range used by DHCP.
  3. 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.
  4. 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:
  1. Bring up the Control Panel.
  2. Double click on Network Connections.
  3. Scroll the window sideways and identify the connection with a Device Name of RealTec.
  4. Right-click on the connection and select Properties.
  5. Scroll down on the item list to Internet Protocol (TCP/IP), and double-click on it.
  6. Click on the bubble to the left of Use the following IP address.
  7. Fill in the IP address (which you choose), Subnet mask (usually 255.255.255.0), and Default gateway (the nearest router).
  8. Fill in the Preferred DNS server. Use the router address again if you don't know of any other.
  9. Click on the OK button. (If you are running this remotely, you will be disconnect and need to VNC back in after some delay.)
  10. 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

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.
Adam Fanello

How to change activa video to "no pump" version

This has been completed.

I had the tech block off the lanes VNC'ed into the tellers.
Next, exited out of the Activa app, and went to internet explorer.
In internet explorer, go to https://systems.intelio.com/tools/Activa/video/.

There are 3 videos in this folder (3a.1, 3d.1, and 3g). Right-click on each video and select "save target as".
Be sure the video files are being placed into C:>Program Files>Ryko>Activa>MPEG2>English
Change the "Save as Type:" to "All Files" by using the down arrow to the right.
Be sure that the file extension is ".mpg", not ".mpeg".
Save the files.
Once all three files are saved, the new video must be renamed to be used.

Go into windows explorer and go to C:>Program Files>Ryko>Activa>MPEG2>English
If the site owner is onsite, play the new videos for them by double clicking on each of the new videos to see which one is preferred.
The current Video used is named "3b IN02 clip.mpg", rename it "3b IN02 clip_DISABLED.mpg".
Rename the desired Video "3x.x IN02 clip_IN_USE.mpg" and make a copy of it once renamed.
Rename the copy from "Copy of 3x.x IN02 clip_IN_USE.mpg" to "3b IN02 clip.mpg"

There are 2 ways to make the new video take effect;
Reboot the machine or open windows explorer, go to B:(ramdisk) and delete "3b IN02 clip.mpg". Then restart the Activa Application. When the app starts, it will copy the new video file to ramdisk and play it from there.

This site used video "3g IN02 clip.mpg". It was changed on both tellers.

How to adjust Activa display brightness and contrast

  1. Exit the application, to the O/S.
  2. Right click on the Intel Extreme Graphics icon on the task bar. (Blue trapezoid on the far right.)
  3. Click on Graphics Properties.
  4. Click on the Color Correction tab.
  5. Adjust the settings as desired, clicking the Apply button to see the result.
  6. Click OK when done.
Adam Fanello

Activa Operations Manual

Download the manual below. You need Adobe Acrobat Reader to view it.

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,
  1. Login to Maintenance mode.
  2. Touch the System Setups button.
  3. Touch the Hardware Setups button.
  4. Touch the Coin Dispenser tab.
  5. Enter 1.00 in the Coin Value field.
  6. Touch Accept.
In the Code-a-Wash application on the Site Controller:
  1. Login to the Code-a-Wash application.
  2. Touch the Setup Menu button.
  3. Touch the Coinbox button.
  4. Touch the Currency tab.
  5. Set Change Value to 1.00.
Adam Fanello

Set Escrow Video

The Escrow Video plays on the Activa screen after a customer has made a purchase and is waiting for a busy car wash to become available.

Supported video files have one of the extensions: MPEG, AVI, WMV, or MOV. (AVI and WMV are video containers, not codecs. Not all possible codecs are supported.)

Steps:
  1. Log into your Activa and touch System Setups followed by Exit to Boot App.
  2. Touch Exit to OS.
  3. Copy the video files(s) from a flash drive or web site to C:\Program Files\Ryko\Activa\MPEG2\English\
  4. Close all windows and double-tap CbxBoot on the desktop.
  5. Log into your Activa and touch System Setups followed by Software Setups.
  6. Touch the Escrow Video tab.
  7. Touch the Play Video button as needed so that it reads ENABLED.
  8. If you want the video to play repeatedly until the car wash is ready, touch the Loop Video button as needed so that it reads ENABLED. Otherwise touch it as needed so that it reads DISABLED.
  9. Select your video file from the list on the right.
  10. Touch the Accept button.
  11. Touch the Close button.
  12. Touch the Close button.
Remember, the escrow video will only play if the customer has completed a purchase but another customer is in the car wash. It will not play if the car wash is not busy when a purchase is completed.
Adam Fanello

Set Escrow Video - ssh method

The Escrow Video plays on the Activa screen after a customer has made a purchase and is waiting for a busy car wash to become available.

Supported video files have one of the extensions: MPEG, AVI, WMV, or MOV. (AVI and WMV are video containers, not codecs. Not all possible codecs are supported.)

Intelio tech support can setup this video remotely and without interrupting operations by using the SSH command-line.

Steps:
  1. Rename your local copy of the video files to something no more than roughly 25 characters in length.
  2. scp the video files(s) to the teller.
  3. ssh into the teller.
  4. mv the video file(s) to /cygdrive/c/Program\ Files/Ryko/Activa/MPEG2/English/
  5. Copy and paste the following command-line, replacing filename.wmv with the actual video file name to use:
  6. If you want the video to play repeatedly until the car wash is ready, copy and paste the following command-line:
  7. If you want the video to play only once while waiting for the car wash, copy and paste the following command-line:
Remember, the escrow video will only play if the customer has completed a purchase but another customer is in the car wash. It will not play if the car wash is not busy when a purchase is completed.
Adam Fanello

How to setup Activa Frequency Code

Introduction:

The Activa has Marketing feature called "Frequency Code" that can generate (issue) a new code to a WashMax Marketing Flex Program and print it on a paper receipt.  This is typically used to offer a discount to customers who return within a certain number of days for another wash. Because it leverages the power of WashMax Marketing though, there are other possibilities.

Only Activas can issue codes, but the resulting code may be redeemed at any car wash with WashMax Market.

Program Creation:

The first step is to login to WashMax, click on Marketing and the Flex Programs. Create a Tracking or Prepaid Wash program as you normally would, or select an existing one. Do not create any keys, these will be generated from the Activa. (There's no harm if using an existing program that already has keys though.)

Examples of what you can do:
Do not set an expiration date on the program. The Activa will set individual expiration dates on each key it generates.

Here's an screen shot of an existing program that donates a portion of purchase to the Red Cross. This picture will be referenced later.

WashMax Flex Program Keys

Configure the Activa(s):

Each Activa that is to issue codes must be configured. Login to the Activa and select System Setups, and then Marketing Setup. Click the DISABLED button to toggle it to ENABLED.

When you set up your WashMax Marketing program, there is a Program ID displayed in the top-right of the window. (See the screen shot above.) Touch the 123... button next to the Marketing Program ID, and enter the number.

The display will look something like below:

Activa Setup Marketing screen

The other options are:
Any of these settings may be changed, and existing codes will continue to function. Changing the Flex Program on WashMax however will change the behavior of existing codes.

Touch the ENABLED button to toggle it to DISABLED any time to stop issuing codes. Alrady issued codes will continue to function.

Code Issuance:

The Activa will issue a code after printing a purchase receipt (if one is to be printed) and before arming the car wash. The Marketing Code receipt is separate from any purchase receipt. The customer must qualify for the code under the conditions mentioned earlier. The Activa must also have an active network connection to the central WashMax Server, as codes are fetched from the server in real time.

Once issued, there is a short delay before the code may be redeemed. It will be available at all sites with active network connections within an hour. Since the purpose of Frequency Codes is to drive repeat business, this delay helps to ensure that the code is used on a later date.

Code Redemption:

Once issued, the code works just like any other WashMax Marketing code. The customer simply enters the code followed by a star, exactly as shown on the receipt, before making their purchase.

Customers may redeem the code at any of your wash sites that the Flex Program is configured to function at. Note however that 8-digit codes cannot be entered at Unitec Wash Select II tellers; this is a limitation of the teller.

Program Maintenance:

As codes are issued and used or expired, they continue to exist in the Flex Program's database of keys on WashMax. This allows for Flex Program Reports to be run. However, if thousands of old codes accumulate, it can impact performance of your marketing programs because codes cannot be reissued so long as they exist in any program. For long running programs, it's beneficial to log into WashMax monthly and click the Delete Expired button on the bottom of the Keys page. (See first screen shot above.)  Upon ending any promotion, use the Delete Expired button to free up the codes.
Adam Fanello

Carwash Interfaces

How to interface with various car wash makes and models

Activa Direct Wash Arming

Use Activa Direct arming to control the car wash through a direct wired connection to the Activa's I/O terminals.

To Select Activa Direct:

Log into the Activa using the technician login. (The owner login does not have access to modify this.)
Touch the System Setups button.
Touch the Carwash Options button.
Touch the Arming tab.

Activa Direct Carwash Options

Select Activa Direct as the Arming Option. This reveals four new settings to tune Activa Direct to your specific car wash interface.

Out-Of-Service when

The Out-Of-Service when setting defines what kind of signal from the car wash indicates that it is out of service. The choices are:

Out-Of-Service delay seconds

This is the number of seconds that the Out-Of-Service condition must remain in effect before it takes effect. Some car washes have their Controller Power or fault signal twitch a bit at the beginning or end of a wash. This delay allows for this without indicating that the wash is off line every time.

The recommended value is 10 seconds.

Time in hold Arming Signal (or until wash becomes busy)

Different car washes require that the arming signal be held for different periods of time. The two most common requirements by car washes are a two seconds pulse and “until the car enters the bay” (at which point, it becomes busy). Additionally, a timeout is required should the car never enter the bay.

For a two second pulse, set this to 2.

To hold the signal until the car enters the bay, set this to 900 which is 15 minutes. (You can reach 900 either by pressing the up arrow for a while, or pressing down from 1.) The arming signal will thus be dropped after the car enters the bay or after a 15 minute timeout.

Many other possible values between 1 and 900 are available. The default is 2.

Time to wait for wash to begin

If the car wash does not begin (wash becomes busy) for this long, the Activa will stop waiting for the customer to enter the wash and go back to idle. The customer may loose the wash at this point. If the car wash has a timeout limiting how long it will wait after being armed, set this value to match.

Setting Arming Outputs

Selecting which outputs are activated when a wash package or additional service is armed is very much like any other arming system. When editing a package or additional service, the Wash Options tab displays the list of eight available Activa Direct outputs. (The last two are intended for use by the Additional Services, but that is not required.)

Presently, Output 1 must be included in every wash package if wash codes from the Site Controller are being used. Nothing needs to be wired to this output.

A typical car wash simply sets Output 1 and Output 2 to arm wash package #1 (with Output 2 being wired to the car wash), Output 1 and Output 3 to arm wash package #2 (with Output 3 wired to the car wash), and so on. However, any combination of outputs may be used for a single package.

Edit Wash Package / Wash Options tab

Setting Arming on the Site Controller

The interface on the Site Controller is currently incomplete. It will always show the car wash as being Offline. Additionally, when setting the Wash Key Net Arming, it will show the Ryko names for the arming outputs. Simply ignore these names and all outputs above number 8, and numerically select the same arming outputs as on the Activa.

Activa Direct Wiring Terminals

The “Wash Option” arming outputs and other signals correspond to terminals on the inside back wall of the Activa as shown in the following table:

Output to car wash

Terminal

Arming Output 1

711

Arming Output 2

712

Arming Output 3

713

Arming Output 4

714

Arming Output 5

715

Arming Output 6

716

Arming Output 7 / Option 1

717

Arming Output 8 / Option 2

718

Arming Output Common wire

719

Input from car wash

Terminal

Busy or Wash-in-Use Input

720

Control Power or Fault Input

721

Input Common wire

722



Intelio Technologies

AUTEC car wash interface

Use Activa Direct Arming for AUTEC car washes.

Activa Direct Settings

In Activa Direct:

Interface Wiring

The AUTEC PLC can only receive one output signal at a time to select a wash package. To handle combination washes on the EV-1 (combination system), a signal decoder is needed. The table below simply shows a basic wiring example.

Interface Name
Activa Terminal
AUTEC Terminal

Arming Output 2

712

Package 1 - Terminal 10

Arming Output 3

713

Package 2 - Terminal 11

Arming Output 4

714

Package 3 - Terminal 12

Arming Output 5

715

Package 4 - Terminal 33

Arming Output 6

716

Package 5 - Terminal 34

Arming Output 7

717

Package 6 - Terminal 35

Arming Output 8

718

Package 7 - Terminal 36


 

Package 8 - Terminal 37

Arming Output Common

719

DC-

Busy/Wash-in-Use Input

720

Terminal 230
(2nd PLC, 3L.0 terminal)

Control Power Input

721

DC+

Input Common

722

DC-


Adam Fanello

Belanger Vector & FreeStyler car wash Interface

Use Activa Direct Arming for the Belanger Vector and FreeStyler car washes.

Activa Direct Settings

In Activa Direct:

Interface Wiring


Interface Name
Activa Terminal
Vector
FreeStyler

Arming Output 2

712

X-20

X-18

Arming Output 3

713

X-21

X-19

Arming Output 4

714

X-22

X-20

Arming Output 5

715

X-23

X-22

Arming Output Common

719

B-338 0VDC

B-338 0VDC

Busy/Wash-in-Use Input

720

B-728

B-728

Control Power Input

721

B-340 24VDC

B-340 24VDC

Input Common

722

B-338 0VDC

B-338 0VDC


Adam Fanello

Futura Car Wash Interface

Use Activa Direct Arming for Futura car washes.

Activa Direct Settings

In Activa Direct:

Interface Wiring


Interface Name
Activa Terminal
Futura Terminal

Arming Output 2

712

Wash Package 1

Arming Output 3

713

Wash Package 2

Arming Output 4

714

Wash Package 3

Arming Output 5

715

Wash Package 4

Arming Output Common

719

Output Common 24VDC

Busy/Wash-in-Use Input

720

Wash in Use

Control Power Input

721

+24VDC

Input Common

722

GND or 24VDC return


Adam Fanello

Istobal car wash configuration

Use Activa Direct Arming for the Istobal car washes.

Activa Direct Settings

In Activa Direct:
Other settings may work as well, this is just one possibility.

Interface Wiring

The table below shows a basic wiring example. Additional services may fire additional relays.

Interface Name
Activa Terminal
Istobal Terminal

Arming Output 2

712

Wash Bit 1

Arming Output 3

713

Wash Bit 2

Arming Output 4

714

Wash Bit 3

Arming Output 5

715

Wash Bit 4

Arming Output Common

719

24 VDC

Busy/Wash-in-Use Input

720

Wash In Use

Control Power Input

721

Alarm

Input Common

722

0 VDC


Adam Fanello

Istobal Interface - Lighthouse Rev E 110V installation instructions


Mark VII AquaJet and GT car wash configuration

Use Activa Direct Arming for the Mark VII car washes.

Activa Direct Settings

In Activa Direct:
Other settings may work as well, this is just one possibility.
Adam Fanello

Mark VII CombiWash configuration

Use Activa Direct Arming for the Mark VII CombiWash.

PLC Settings

Minimum firmware 3.28.

On the PLC:

Activa Direct Settings

In Activa Direct:
Adam Fanello

Nu-Star car wash interface

Use Activa Direct Arming for Nu-Star car washes.

Activa Direct Settings

In Activa Direct:

Interface Wiring

This information is preliminary. More details regarding voltage conversion and Input Common are forthcoming.

Do not make these connections directly!  The native Comet2 power levels are 120 VAC. They must be converted to 24 VDC.

Interface Name
Activa Terminal
Converter
  Comet2 Terminal

Arming Output 2

712

24VDC <=> 120VAC

Terminal #33

Arming Output 3

713

24VDC <=> 120VAC

Terminal #34

Arming Output 4

714

24VDC <=> 120VAC

Terminal #35

Arming Output 5

715

24VDC <=> 120VAC

Terminal #36

Arming Output Common

719

24VDC <=> 120VAC

Terminal #200 (120 VAC)

Busy/Wash-in-Use Input

720

24VDC <=> 120VAC

Terminal #F119

Control Power Input

721

24VDC <=> 120VAC

Terminal #200 (??!??)

Input Common

722

24VDC 120VAC

Neutral

Fault Signal Wiring

The Nu-Star Comet2 provides four fault signals. These are available to the edge via a Kit 108 I/O Relay Board

Do not make these connections directly!  The native Comet2 power levels are 120 VAC. They must be converted to 24 VDC.

Interface Name
I/O Kit Input
Converter
  Comet2 Terminal

Low Oil

1+

24VDC <=> 120VAC

Terminal #F137

Low Water

2+

24VDC <=> 120VAC

Terminal #F138

Travel Fault

3+

24VDC <=> 120VAC

Terminal #F139

Switch - Prox Fault

4+

24VDC <=> 120VAC

Terminal #F140

Fault Common

1- 2- 3- 4-

24VDC <=> 120VAC

Neutral?

Adam Fanello

Hardware Installation

How to install the Activa hardware.

Activa Multi-Gate System

Intelio offers a system whereby multiple gated Activas may lead to a single tunnel car wash, in order to increase the flow of cards into the tunnel.

File Attachments:
Adam Fanello

Activa Site Preparation and Pre-Installation Wiring

The attached drawings describe the proper positioning of Activa relative to the car wash bay, the site wiring required prior to Activa installation, and how that wiring is connected to Activa during the installation process.

 

Approved Wire and Uses

Ethernet (Internet) Wire

Run one Ethernet cable from the network access point (modem, router, switch...etc) to each Activa Virtual Attendant and to the Activa Site Controller.

Use shielded, Stranded CAT5e, any quality brand.

Activa Direct Wire

Activa Direct wire is used between the Activa Virtual Attendant terminals and the car wash PLC.

Use 18 gage shielded, stranded 10 conductor.

Echelon (RykoNet) Wire

Echelon wire is only used at sites with a Ryko car wash. It runs between each car wash PLC and its associated Activa Virtual Attendant, and then front either of those to the Site Controller.

Echelon wire is 18 gauge twisted pair. Only the following are approved for use:
Run wire to each Echelon device, and tie them together in one place using a terminal block or (for just a few wires) two wire caps.
Adam Fanello

CUSTOM TGO2 Printer


CUSTOM TGO2 Printer

The TGO2 printer is 12 volts DC not 24 Volts DC.

There is a crossover adapter sent with each printer.

This goes on CON 10. Unplug CON 10 from I/O and plug the cable

into the adapter then plug adapter into CON 10.

If the printer came through me then it has been set to 38400 baud already.
(If not see the note at bottom.)

Cut power,

On the OLD printer unplug and remove the door and printer. The plug can now be cut off. The “Normal” Wiring is a blue and black set of wires. The black is ground blue or purple is hot. (When I install them in a unit I do not use the pig tail I send with them)

ACTIVA BAUD RATE

Shut down Application, Go to Control Panel

Printers/Faxes. Right click on the FTP627 printer and remove
Make sure the custom Printer is default now. Make sure it is on Com 4 Right click the custom printer to properties, check the port setting and put on com 4 if not there already. Hit configure the port and set at 38400 Baud (New Image sets this already)

After installing the printer and changing the stuff in the control panel I reboot the system and it makes the printer work.

( Because it is the software in the program making the printer change, the app needs to run to print. )

Setting Baud on printer.

They come to us set at 9600 baud. To change this cut power, hold down BOTH buttons on the side of printer. Re connect power and it should start printing a little strip showing the baud . Hit the FEED button to enter set up then hit the report button 3 times. This should have got you to the 3800 baud. If not repeat the steps until 38400 is set. Then hit the feed button7 times this last one should have printed out a slip showing that the baud is now 38400.

(I leave one hanging on all printers I touch) After I have set it in control panel and printer I change in the system set up to be the CUSTOM printer. I then REBOOT and it all works.

When all set it should be:

Baud Rate: 38400 Data Bits: 8 Stop Bits: 1 Parity: None Flow Control: XON/XOFF Print density: Normal Speed: High


Kevin Scott

Replacement Printer MSB-002

MSB-002 is an upgrade for replacement of the Activa printer with a Custom Engineering model TG02 printer.

Download the upgrade instructions below. You will need Adobe Acrobat Reader to view it.
Adam Fanello

Hardware Maintenance

Maintaining and upgrading hardware components on the Activa

Activa Peripheral Device Documentation

Here are manuals for the peripherals in an Activa.

15.0_NL10276BC30-18C_m02.pdf is for the 15" LCD
ActivaDimensions.gif dimensions of an Activa.
ActivaEnclosureDrawing.pdf has the dimensions of the Kiosk.
ActivaEnvironmentalTest.pdf documents the Environmental Testing
ActivaPeripheralThermalRanges.pdf summarizes the thermal and humidity ranges for all the devices listed here.
ActivaTempProfiles.xls has a typical sample of temperature readings from Activas in Warm and Cool Environments.
Activa_Operations_Manual_Rev_2.pdf is the Activa Operations Manual
FCCCertificate.pdf is our FCC Certification
ICT_Bill_Acceptor_A6-V6share.pdf is for the Bill Acceptor
IOModuleTempRange.pd is a statement about the I/O Module Temperature and Humidity Ranges
M2_manual_V1.1___.pdf is for the motherboard of the Panel PC
Mini_Hopper_4.0.pdf is for the Coin Dispenser
MSR280_RS232_USB.pdf  is for the Card Reader
ND-300CM.KM_Installation_Guide(EN).pdf is for the Note Dispenser
TG02_Users_Manual_v1-00_071212_(2).pdf is for the Printer.
27615-000.pdf is the I/O module pin-out.

Activa Printer Paper

Intelio does not resell receipt paper. It is available from most office supply stores.

For an Activa, buy thermal paper, 2 1/4 inches wide with a 1/2 inch x 5/8 inch core.
Adam Fanello

Bill Acceptor troubleshooting

The Activa uses the A6 Series bill acceptor from International Currency Technologies (ICT).

Documentation is attached.

For dip switches under front panel of the acceptor must be set to ON OFF OFF OFF.

Dip switches on the side of the acceptor must all be set OFF.
Adam Fanello

Bill Dispenser Maintenance

The Bill Dispensers must have routine maintenance to avoid continuous jams and to speed up the process of switching dispensers. The sensors, belts, and rollers get dirty fast and require cleaning at least once a month. Failure to perform this regular maintenance will void the warranty on the bill dispensers.

Here is what is needed for the cleaning process and what needs to be cleaned:
  1. Q Tips (lint free is a MUST)
  2. Rubbing Alcohol (DO NOT use anything else)

The dispensers will need to be removed from the dispenser tray and the technician will need to remove front cover to access the sensors. Using the Q Tip soaked in the Rubbing Alcohol, wipe all sensors. Using the dry end of the Q-Tip, wipe any access rubbing alcohol from sensors. Visually inspect for any remaining lint or dirt. Repeat as necessary.

The bands and rollers will also need to be cleaned with rubbing alcohol. A lint free rag can be used for the initial cleaning (to remove dirt, lint, and ink that comes from the dollar bills). Q tip and rubbing alcohol will be used for final cleaning of the rollers and bands.

This process will all but eliminate continuous jams and sensor errors, thus eliminate the need to replace the bill dispensers.

Installation Manual

Attached below.
Adam Fanello

Card Reader troubleshooting

The Activa uses the MSR280 card reader.  Specifications are attached.

Note: Intelio Technologies prohibits the capture of sensitive authentication data for debugging or troubleshooting purposes. See PA-PCI Implementation Guide for details.
Adam Fanello

Coin Acceptor Troubleshooting

For reference there are three coin acceptor switch settings:

The positions for each switch are identified on the moulded plastic housing.

Reject button can get stuck.   Take button out and smooth edges of metal hole.    Possibly bend top and bottom flanges around hole up to increase margins.   Wd-40 has been used successfully.


It’s reported that tightening bezel of coin acceptor can cause errors.   Apparently the metal plate can be warped and tightening it down makes it worse.   Loosen the bezel to minimize distortion.

 

If the above does not correct the problem, file the inner opening edges of metal sleeve.  Also, loosen the mounting screws of the Acceptor to a snug, but "Not" tight setting.


Coin Dispenser Troubleshooting

Dip settings:    All four dip switches on the bottom of the hopper should be set to “on”.   This selects ICT protocol using the RS-232 interface.

 

 

 

The turret wheel can be removed to look for jams.   Remove the hopper by pressing down on the tab at the back of the unit and slide the plastic hopper forward, and lift off.    The turret wheel lifts out.   There is tapered pin through the motor shaft that is free floating and is only held in place when the turret is on.   It will fall out and get lost if you are not careful.    To replace, just slide the pin into the motor shaft, center it, and drop the turret back over the shaft.  It has a slight taper so it only goes in one way.

 

 

 

Also for jammed conditions, there is what looks like a screw adjustment recessed at the rear of the unit.   This is an extension of the motor shaft, and if a coin is jammed you can rotate this shaft clockwise with a blade screwdriver until the coin is ejected.

 

 

 

As a double check, the turret should be part number A25140 for US and Canadian coins.   There is an additional coin size setting that is accessible through a cover plate at the front of the dispenser…two tabs hold it down.    You will see a metal serrated lever that is held in place by bumps in the plastic housing.    The US adjustment is correct when the lever has been moved three bump positions smaller than the widest setting.   Lift the metal lever up and move it to the new position if necessary…it does not slide from position to position.

 

 

 

 

Custom TG02 printer printing gibberish / wrong baud rate

The Custom TG02 printer can be configured by powering it on while holding both the FEED and REPORT buttons. To do this, login to the Activa, and touch Diagnostics and then Sensors/Relays. Then touch the Outputs/Relays tab. Touch the 12V Printer button to turn the power off. Press and hold the FEED and REPORT buttons and the printer, touch the 12V Printer power button on the screen to power it back on, and then release the printer buttons. You will now be in configuration mode.

It will print a report of current settings. Press FEED to advance through each parameter, and press the REPORT button to change the value of the current parameter. The printer provides feedback to you by printing on the paper. In the end, it prints a final report of the parameters. You must move quickly, as after several seconds of inactivity the printer exits configuration mode and goes back into operation.

The target parameters are:
Baud rate = 38400 bps
Data Length = 8 bit/char
Parity = None
Handshake = xon/xoff
Paper jam sensor= Enabled
speed current = High
Print density = Normal

The most common issue is that everything is correct except baud rate is at 9600 baud. Upon putting the printer in configuration mode, press FEED once (advances to the baud rate parameter), and then press REPORT twice (selects 19200 and then 38400). Press FEED six more times to get the final report.

The attached PDF shows the resulting printout from following this guide. (Strips of paper are laid out left-to-right on the scanned page.)
Adam Fanello

Fujitsu FTP627 Printer Quick Reference

See document attached below.
Adam Fanello

How to reprogram an Activa Bill Acceptor

This procedure describes how to reprogram an Activa bill acceptor. It assumes that the FP-001 Programmer device has already been loaded with the desired firmware program to install.

Required parts:
Procedure:
  1. Log in to the Activa maintenance mode. Any account with general Diagnostics access should work.
  2. Go to the Outputs/Relays screen by:
  3. If the Bill Acceptor Power button is red, touch it so that it turns green.
  4. Prepare the programmer.
  5. Connect the ICT FP-001 Programmer to the Bill Acceptor by:
  6. Install the new programming on the bill acceptor by:
  7. Unplug the WEL-RM009-K wire from the bill acceptor and programmer.
  8. Plug the original gray wire back into the bill acceptor.
  9. On the Activa screen, press the Close buttons until you return the system to the idle screen.
  10. Log in again.
  11. Go to the Bill Acceptor Diagnostics screen by:
  12. Test every kind of bill available.
  13. When done, press the Close buttons until you return the system to the idle screen.

The bill accepter from the side with
programmer download line plugged in.



Picture of bill acceptor inside of an Activa.
Cable is circled in red, across from the coin acceptor.

Intelio Technologies

How to upgrade an Activa software to use the TG02 printer


  1. Exit the Activa application and Exit to OS.
  2. Download the files:
  3. Install the driver:
  4. Set the baud rate:
  5. Configure the application:
  6. Test by buying a wash and request a receipt.
Adam Fanello

Site Server

Articles about the various Site Servers, Site Controllers, and Code-a-Washes.

About Cold Card Activation

Cold Card Activation allows you to have WashMax Market cards that are assigned to a marketing program, but not yet functioning. This allows you to have the cards sitting on a display where customers can grab them, but stolen cards will not work. A store clerk must activate the card upon purchase.

Cold Card Activation is driven by a program on the Site Server called Cold Card Activator (CCA). It sits in the tray (a blue card with ice and a check mark) until a card is swiped. The application comes pre-installed on recent Site Server images, and may be added to an existing device. A mag-card reader for the Site Server must be purchased along with a license for the application.

When a card is swiped the input display pops up over the normal Code-a-Wash or EPG display:



The clerk enters information via the touch-screen.

Each of these three input fields may be configured as not shown, shown but not required, or shown and required. They can all be turned off, allowing swiped cards to be activated without any input at all. Here's the settings screen:



If a card is swiped but the back-end WashMax Onsite service, which handles the actual processing, is not connected it shows:



Other failures also show with this red screen. Any error screen can be closed or will go away on its own after several seconds.

Cards are active and available for immediate use on the first bay of the site where activated. Other sites/bays will take a few minutes.

Two WashMax Flex Program Reports are available for card activation. (Sample screen below.) Also, the Key details screen shows when the card was activated, and any other available detail (clerk ID, initial value, initial usage count).



By requiring the clerk to enter their ID at activation, and using the WashMax reports, clerks can be rewarded for signing up customers.

Any number of different marketing programs can be activated. You create the programs on WashMax and pre-assign groups of cards to each program. When the card is swiped for activation, it already "knows" which program it belongs to. Different card art-work or packaging can be used to distinguish the cards on display.
Adam Fanello

About Site Controllers

The Activa Site Controller and WashMax Site Controller is the general name for a device at a car wash location that hosts Intelio (and sometimes Ryko) provided software, other than the Activa itself. It is frequently called an "edge" or a "caw", although these designations no longer fits very well.

These platforms have been replaced by the Site Server for new and replacement installations.

A bit of history...

NEMA/6102

The first Site Controller utilized a Nagasaki 6102 motherboard and was enclosed in a large NEMA rated box. The model is commonly called a NEMA or a 6102. The early versions ran Red Hat Linux 9 (RH9), but replacement hard drives switched to running Fedora Core 5 (FC5). On the SOC, you will thus see the platform for edges running on this model labeled as 6102 RH9 and 6102 FC5.

Minibox

The second generation/model of edge was run an an iTuner MiniBox. It also ran Fedora Core 5 (FC5) as the operating system. These are listed on the SOC as a Minibox FC5 platform.

Here's where things start getting complex...

Sys1 / Sys2 CAW

The third generate of edge does not, in fact, have a hardware platform. This is where the Site Controller name began. Ryko provided a hardware box, produced by Sys Technologies, that was designated a CAW-iC. The CAW-iC runs Windows XP Embedded with Cygwin as the operating system, and Ryko's Code-a-Wash, EPI Server, and other applications. It also runs VMware's VM Player, which can run two virtual machine (VM) edges. This became Intelio's Site Controller platform. Even when the Ryko applications aren't needed, this platform may be used simply to run the edge VMs.  This hardware platform may also be called Sys1 and uses the CAW1 flash imager. (The CAW2 flash imager is known to work on the Sys1 most of the time.) The motherboard is model GA-945GCMX-S2.

Around the beginning of 2009, Ryko began shipping a new revision of the CAW-iC which looked the same as the old one but had a new motherboard model GA-G31M-S2L. This is designated the Sys2 and requires the CAW2 flash imager. (Later CAW flash imagers also work, up to CAW5.)



Sys3 CAW

This model never shipped.

Sys4

Beginning in June 2009, Intelio began working directly with Sys Technologies and has produced the Sys4 box with the latest GA-G31M-ES2L rev 1.x motherboard. It has a different front panel than the older models, no CD-RW drive, and replaces the modem card with two additional Ethernet ports. For the first time, this hardware is a dual-purpose device. It can be imaged with the CAW4 or CAW5 flash imager and operate as such a CAW-iC, with the Ryko applications and edge VMs. Alternatively, it may be imaged with the ehost1 flash imager, whereby it operates as an edge host device.

It is important to understand that the Sys4 box is just a piece of hardware. Intelio has leveraged this same piece of hardware to serve two different functions. The ehost and caw devices run entirely different operating systems, serve different (but overlapping) purposes, and are managed in different ways.  (The ehost platform has been discontinued.)



Back of a Sys4 box

Sys5

In late September 2009, Sys Technologies began delivering a box with GA-G31M-ES2L rev 2.0 motherboard. The main difference is that the on-board Ethernet chip changed from Realtec to Attansic (owned by Atheros). The outside looks identical to a Sys4, but requires the CAW5 flash imager.

In Q2 2010, Ryko began shipping a Sys5 CAW iC, but with a different case. In spite of the case difference, this is still a Sys5.

CAW model Site Controller

The "caw" model Site Controller is also called the Merchandise Site Controller, because it is the only model that can interface with a store Point of Sale (POS) system to issue wash codes. Because it runs the EPI Server, it is also required if the site has a Ryko coinbox (AMTT, AMTT-CS, or Enteract) or multiple Intelio Activa tellers.

Ethernet Adapters

Every caw has a primary Ethernet port around the middle of the back panel, among the USB ports. This is the network uplink port and is shipped set to automatically obtain a dynamic IP address. It may be reconfigured from within Windows XP.

On the Sys4 and Sys5 boxes, there are two additional Ethernet adapters:
These adapters can used to connect other equipment, such as Moxa nPort serial device servers for carwash communication. By convention, a Moxa for bay 1 should have a last octet of .21, bay 2 should have .22, etc. A network switch may be added to support more than one device. The edge(s) must be configured with the address you choose for the Moxas. You may also just place Moxas on the site's network, along with the caw via the primary port, and not use these auxiliary connections.

Ehost model Site Controller

This platform has been discontinued, but there are still a few in service.

The ehost (AKA: ehostess) is a device running the CentOS 5.3 Linux operating system that has been modified by the OpenVZ virtualization system. Unlike the virtual machines (VMs) of WMware on the caw, the ehost runs a single kernel that has been split into multiple operating system instances (all CentOS). Just to confuse matters, an instance is synonymously called a Virtual Private Server (VPS), Virtual Environment (VE), or container. In any case, each VPS runs an Intelio edge. This approach is very light weight, allowing for many edges to run on a singe ehost. (The maximum number of edges is untested, but may be as high as eight.)

The ehost does not run any Windows or Ryko applications. It is simply a hardware host for WashMax edges.

Ethernet Adapters and Moxas

The Sys4 box has three Ethernet ports.

ID Location IP Address Netmask Suggested Use
eth0 Center of back panel among USB ports
dynamic
dynamic
uplink
eth1 Card slot nearest eth0
192.168.111.20 255.255.255.0 teller Moxa
eth2 Card slot nearest outer edge of box
192.168.112.20 255.255.255.0 car wash Moxa

When an edge is running in a VPS, it will default to find a Wash Select II at 192.168.111.21 and an AUTEC, Belanger, or Istobal at 192.168.112.21. This of course only works for a single bay site. The network can be setup in whatever makes sense for the site, including plugging everything into the site network and not using eth1 and eth2, or plugging a network switches into these ports to accommodate multiple devices.

Configure the Ethernet adapters by logging into the ehost as root and using the command:
  nw config [ifc] [static|dhcp] [ipaddr] [netmask] [gateway] [default] [dns]
The parameters in brackets may be left off, in which case the script will prompt for details.

Configure a Moxa nPort by logging into the ehost as root and using the moxaconfig command:
  Usage: moxaconfig <eth-adapter>
  Where: <eth-adapter> is eth0 eth1 or eth2


Bootstrapping

As with all Intelio devices, you configure it by logging in as root and running ./bootstrap.sh.  The script will prompt you for an edge number to add to the host. Enter it, and the scripts will create the new VPS and automatically run its bootstrap. When complete, allow it to reboot as normal; it will return you to the ehost where another edge can be added.

If an edge needs to be added after the initial bootstrap is completed, login to the ehost as root and run
  /home/intelio/script/install/createEdge.sh <edge#>
Replacing <edge#> with the edge number to add.
Adam Fanello

About Site Servers

Activa Site Server and WashMax Site Server are two names for a device at a car wash location that hosts Intelio (and sometimes Ryko) provided software, other than the Activa itself. It's name is sometimes shortened to sserv.  The Ryko iServer and Sheetz Car Wash Server (cws) are variants.

A bit of history...

The Site Server is a direct descendant of the older Site Controller line, and picks up its numbering scheme where the Site Controller left off (at five).

Models


Hardware BIOS Settings Network Locations
Sys1 (same case as Sys2)

Gigabyte GA-945GCMX-S2 motherboard
Intel Celeron CPU @ 2.8 GHz (Benchmark 334)
1 GB RAM
3.5" 80 GB HDD
Dial-up modem
Press DEL at bootup to enter CMOS setup

Power Management Setup

-> AC Back Function = Full-On.

Press F12 at bootup for boot menu.
Select Hard Drives and then USB-HDD0 to boot flash imager.
Local Area Connection: Center of back panel among USB ports.

Auxiliary Connection #1: N/A

Auxiliary Connection #2: N/A

Modem: In expansion card slot. Not used.
Sys2 (same case as Sys1)

Gigabyte GA-G31M-S2L motherboard
Intel Celeron 430 CPU @ 1.8 GHz (Benchmark 529)
1 GB RAM
3.5" 80 GB HDD
Dial-up modem
Press DEL at bootup to enter CMOS setup

Power Management Setup

-> AC Back Function = Full-On.

Press F12 at bootup for boot menu.
Select Hard Drives and then USB-HDD0 to boot flash imager.
Local Area Connection: Center of back panel among USB ports.

Auxiliary Connection #1: N/A

Auxiliary Connection #2: N/A

Modem: In expansion card slot. Not used.
Sys3 (Ryko only)

Biostar G31-M7 TE motherboard
Intel Celeron E3300 @ 2.5 GHz (Benchmark 1676)
1 GB RAM
Press DEL at bootup to enter CMOS setup

Advanced
-> SuperIO Configuration
  -> Restore on AC Power Loss = Power On
Boot
-> Hard Disk Drives
  -> Press '-' to move USB device to the top

Press F10 and Enter to Save & Exit.
Local Area Connection: Center of back panel among USB ports.

Auxiliary Connection #1: N/A

Auxiliary Connection #2: N/A

Modem: In expansion card slot. Not used.
Sys4 (same case as Sys5)
Front of Sys4/5 box
Gigabyte GA-G31M-ES2L rev 1.x motherboard
Intel Celeron 430 CPU @ 1.8 GHz (Benchmark 529)
1 GB RAM
3.5" 80 GB HDD
Two PCI Network Interface Cards
Press DEL at bootup to enter CMOS setup

Power Management Setup

-> AC Back Function = Full-On.

Press F12 at bootup for boot menu.
Select Hard Drives and then USB-HDD0 to boot flash imager.
Local Area Connection: Center of back panel among USB ports.

Auxiliary Connection #1: Add-on card nearest motherboard. (Center of three NICs.)

Auxiliary Connection #2: Add-on card nearest outer edge of case.
Sys5 (same case as Sys4)

Gigabyte GA-G31M-ES2L rev 2.0 motherboard
Intel Celeron 430 CPU @ 1.8 GHz (Benchmark 529)
1 GB RAM
3.5" 80 GB HDD
Two PCI Network Interface Cards
Press DEL at bootup to enter CMOS setup

Power Management Setup

-> AC Back Function = Full-On.

Press F12 at bootup for boot menu.
Select Hard Drives and then USB-HDD0 to boot flash imager.
Local Area Connection: Center of back panel among USB ports.

Auxiliary Connection #1: Add-on card nearest motherboard. (Center of three NICs.)

Auxiliary Connection #2: Add-on card nearest outer edge of case.
Sys6
Intel D945GCLF2D motherboard
Intel Atom 330 CPU
   dual-core @ 1.60 GHz (Benchmark 635)
1 GB RAM
3.5" 80 GB Western Digital HDD
PCI Network Interface Card

Optional external USB Ethernet interface

Press DEL at bootup to enter CMOS setup

Advanced / Peripheral Configuration:
-> Serial Port = Enable
-> Parallel Port Port = Disable
-> Audio = Enable
-> On-board LAN = Enable

Advanced / Drive Configuration:
-> ATA/IDE Mode = Native
-> S.M.A.R.T. = Enable

Power:
-> After Power Failure = Power on
-> Wake on LAN = Power on

Boot
-> Boot to Removable Devices = Enable
-> Boot to Network = Disabled
-> USB Boot = Enable
-> Boot USB Devices First = Enable

Automatically boots a flash imager when inserted.
Local Area Connection: Center of back panel among USB ports.

Auxiliary Connection #1: Sole add-on card.

Auxiliary Connection #2: Blue TrendNet USB device (optional)
Sys7

Jetway NC94-510-LF motherboard
Intel Atom D510 CPU dual-core @ 1.66 GHz (Benchmark 661)
1 GB RAM
3.5" 80 GB Western Digital HDD
Realtec Dual NIC PCIe Network Interface Card
Insert flash drive in USB port.
Press DEL at bootup to enter CMOS setup.

Advanced BIOS Features
- Hard Disk Drives
 - - Page Down to put SATA:WDC below USB FLASH

Integrated Peripherals
- Onboard SATA Function
 - - SATA Run Mode Configuration = Compatible
- Onboard Super IO Function
 - - Onboard Floppy Controller = Disabled
- PWR Status After PWR Failure = Always On
Local Area Connection: Center of back panel among USB ports.

Auxiliary Connection #1: Port labeled CH1 on add-on card.

Auxiliary Connection #2: Port labeled CH2 on add-on card.
Sys8
Intel D525MW motherboard
Intel Atom D525 CPU
   dual-core @ 1.80 GHz (Benchmark 717)
1 GB RAM
3.5" 160 GB Western Digital HDD
PCI Network Interface Card






See Fix Site Server Sys8 Serial Port.
Press F2 at bootup to enter CMOS setup

Advanced / Peripheral Configuration:
-> Serial Port = Enable
-> Parallel Port Port = Disable
-> Audio = Enable
-> On-board LAN = Enable

Advanced / Internal Chipset Drive Configuration:
-> Configure SATA as = IDE
-> S.M.A.R.T. = Enable

Power:
-> After Power Failure = Power on
-> Wake on LAN from S5 = Power on

Boot
-> Boot to Removable Devices = Enable
-> Boot to Network = Disabled
-> USB Boot = Enable
-> Boot USB Devices First = Enable

Automatically boots a flash imager when inserted.
Local Area Connection: Center of back panel among USB ports.

Auxiliary Connection #1: Sole add-on card.

Auxiliary Connection #2: N/A
Sys9

Jetway NC94-525-LF motherboard
Intel Atom D525 CPU dual-core @ 1.80 GHz (Benchmark 717)
2 GB RAM
3.5" 160 GB Western Digital HDD
Intel Gigabit Dual NIC PCIe Network Interface Card
Insert flash drive in USB port.
Press DEL at bootup to enter CMOS setup.

Advanced BIOS Features
- Hard Disk Drives
 - - Page Down to put SATA:WDC below USB FLASH

Integrated Peripherals
- Onboard SATA Function
 - - SATA Run Mode Configuration = Compatible
- Onboard Super IO Function
 - - Onboard Floppy Controller = Disabled
- PWR Status After PWR Failure = Always On
Local Area Connection: Center of back panel among USB ports.

Auxiliary Connection #1: Port labeled CH1 on add-on card.

Auxiliary Connection #2: Port labeled CH2 on add-on card.


Images

Images are snapshots of a hard drive content that is cloned onto each hardware device to act as the starting point. The images have names of the format <image-class><highest model supported><variant><revision> <company> <date>. For example, "sserv7Rh Ryko 2010-08-05".  The fields are:
The master list of all Site Server images is on the SiteServer page of Intelio's internal wiki.

sserv3 image for Sys3

The Sys3 box is the currently shipping hardware from Ryko. It was forked from Intelio's sserv7h image and is PCI compliant.
Note: The iVisor application's reporting service requires login name "reporting" with password "reporting".

sserv6 image for Sys6

The sserv6 image is obsolete because it is not PCI compliant. Only use sserv7.

The sserv6 image was built for the Sys6 hardware platform. It runs Windows XP Professional, VMware Server (replacing VMplayer on caw images) supporting up to three edge virtual machines. It is otherwise equivalent to the CAW images.

sserv7 image for all models

With sserv7, the image has built rebuilt from the ground up to be PCI compliant. It is backwards compatible to the Sys1 hardware platform, runs Windows Embedded for POS 2009, VMware Server, EPG, ClamWin anti-virus, and auto-logins as a non-administrative user. It may also run all of the normal Ryko Code-a-Wash applications. Radiant Epsilon may be installed on it.

sserv8 image for all models

The sserv8 image has updated drivers to work with the Sys8 platform. It is backwards compatible to the Sys1.

Ethernet Adapters

Every Site Server has a primary Ethernet port around the middle of the back panel, among the USB ports. This is the network uplink port and is shipped set to automatically obtain a dynamic IP address. It may be reconfigured from within Windows, where it is labeled Local Area Connection. There are one or two additional Ethernet adapters, depending on configuration. The following table describes all of the network connections that you will find in Control Panel / Network Connections on a freshly imaged sserv:

Name in Windows
IP Address Netmask Recommended Use
Local Area Connection dynamic
dynamic
uplink
Auxiliary Connection #1 192.168.111.20 255.255.255.0 teller Moxa @ 192.168.111.21
Auxiliary Connection #2 192.168.112.20 255.255.255.0 car wash Moxa @ 192.168.112.21
Intelio VPN dynamic dynamic do not alter
VMware vmnet1 192.168.110.1 255.255.255.0 do not alter
VMware vmnet8 192.168.109.1 255.255.255.0 do not alter

The Auxiliary Connections on the add-on cards and/or USB adapter can used to connect other equipment, such as Moxa nPort serial device servers for carwash communication. By convention, a Moxa for bay 1 should have a last octet of .21, bay 2 should have .22, etc. A network switch may be added to support more than one device. The edge(s) must be configured with the address you choose for the Moxas. You may also just place Moxas on the site's network, along with the Site Server via the primary port, and not use these auxiliary connections.

See Also

   Site Server Flash Imager
   How to configure a new Site Server (sserv)
Adam Fanello

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:
Supported payment processors:
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 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:
The following buttons may also be available:
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.

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:

EPI Settings

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

Fields:

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:

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:
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 thekey 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.
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

  1. If the site's network is actively managed by the operator, then request an IP address to use.
  2. Check the router's DHCP settings. Choose an IP in the same subnet but outside of the range used by DHCP.
  3. 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.
  4. 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:
  1. Bring up the Control Panel.
  2. Double click on Network Connections.
  3. Scroll the window sideways and identify the connection with a Device Name of RealTec.
  4. Right-click on the connection and select Properties.
  5. Scroll down on the item list to Internet Protocol (TCP/IP), and double-click on it.
  6. Click on the bubble to the left of Use the following IP address.
  7. Fill in the IP address (which you choose), Subnet mask (usually 255.255.255.0), and Default gateway (the nearest router).
  8. Fill in the Preferred DNS server. Use the router address again if you don't know of any other.
  9. Click on the OK button. (If you are running this remotely, you will be disconnect and need to VNC back in after some delay.)
  10. 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

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.
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,
  1. Login to Maintenance mode.
  2. Touch the System Setups button.
  3. Touch the Hardware Setups button.
  4. Touch the Coin Dispenser tab.
  5. Enter 1.00 in the Coin Value field.
  6. Touch Accept.
In the Code-a-Wash application on the Site Controller:
  1. Login to the Code-a-Wash application.
  2. Touch the Setup Menu button.
  3. Touch the Coinbox button.
  4. Touch the Currency tab.
  5. Set Change Value to 1.00.
Adam Fanello

Hardware

Installation and upgrading the Site Server and Site Controller hardware.

About Site Servers

Activa Site Server and WashMax Site Server are two names for a device at a car wash location that hosts Intelio (and sometimes Ryko) provided software, other than the Activa itself. It's name is sometimes shortened to sserv.  The Ryko iServer and Sheetz Car Wash Server (cws) are variants.

A bit of history...

The Site Server is a direct descendant of the older Site Controller line, and picks up its numbering scheme where the Site Controller left off (at five).

Models


Hardware BIOS Settings Network Locations
Sys1 (same case as Sys2)

Gigabyte GA-945GCMX-S2 motherboard
Intel Celeron CPU @ 2.8 GHz (Benchmark 334)
1 GB RAM
3.5" 80 GB HDD
Dial-up modem
Press DEL at bootup to enter CMOS setup

Power Management Setup

-> AC Back Function = Full-On.

Press F12 at bootup for boot menu.
Select Hard Drives and then USB-HDD0 to boot flash imager.
Local Area Connection: Center of back panel among USB ports.

Auxiliary Connection #1: N/A

Auxiliary Connection #2: N/A

Modem: In expansion card slot. Not used.
Sys2 (same case as Sys1)

Gigabyte GA-G31M-S2L motherboard
Intel Celeron 430 CPU @ 1.8 GHz (Benchmark 529)
1 GB RAM
3.5" 80 GB HDD
Dial-up modem
Press DEL at bootup to enter CMOS setup

Power Management Setup

-> AC Back Function = Full-On.

Press F12 at bootup for boot menu.
Select Hard Drives and then USB-HDD0 to boot flash imager.
Local Area Connection: Center of back panel among USB ports.

Auxiliary Connection #1: N/A

Auxiliary Connection #2: N/A

Modem: In expansion card slot. Not used.
Sys3 (Ryko only)

Biostar G31-M7 TE motherboard
Intel Celeron E3300 @ 2.5 GHz (Benchmark 1676)
1 GB RAM
Press DEL at bootup to enter CMOS setup

Advanced
-> SuperIO Configuration
  -> Restore on AC Power Loss = Power On
Boot
-> Hard Disk Drives
  -> Press '-' to move USB device to the top

Press F10 and Enter to Save & Exit.
Local Area Connection: Center of back panel among USB ports.

Auxiliary Connection #1: N/A

Auxiliary Connection #2: N/A

Modem: In expansion card slot. Not used.
Sys4 (same case as Sys5)
Front of Sys4/5 box
Gigabyte GA-G31M-ES2L rev 1.x motherboard
Intel Celeron 430 CPU @ 1.8 GHz (Benchmark 529)
1 GB RAM
3.5" 80 GB HDD
Two PCI Network Interface Cards
Press DEL at bootup to enter CMOS setup

Power Management Setup

-> AC Back Function = Full-On.

Press F12 at bootup for boot menu.
Select Hard Drives and then USB-HDD0 to boot flash imager.
Local Area Connection: Center of back panel among USB ports.

Auxiliary Connection #1: Add-on card nearest motherboard. (Center of three NICs.)

Auxiliary Connection #2: Add-on card nearest outer edge of case.
Sys5 (same case as Sys4)

Gigabyte GA-G31M-ES2L rev 2.0 motherboard
Intel Celeron 430 CPU @ 1.8 GHz (Benchmark 529)
1 GB RAM
3.5" 80 GB HDD
Two PCI Network Interface Cards
Press DEL at bootup to enter CMOS setup

Power Management Setup

-> AC Back Function = Full-On.

Press F12 at bootup for boot menu.
Select Hard Drives and then USB-HDD0 to boot flash imager.
Local Area Connection: Center of back panel among USB ports.

Auxiliary Connection #1: Add-on card nearest motherboard. (Center of three NICs.)

Auxiliary Connection #2: Add-on card nearest outer edge of case.
Sys6
Intel D945GCLF2D motherboard
Intel Atom 330 CPU
   dual-core @ 1.60 GHz (Benchmark 635)
1 GB RAM
3.5" 80 GB Western Digital HDD
PCI Network Interface Card

Optional external USB Ethernet interface

Press DEL at bootup to enter CMOS setup

Advanced / Peripheral Configuration:
-> Serial Port = Enable
-> Parallel Port Port = Disable
-> Audio = Enable
-> On-board LAN = Enable

Advanced / Drive Configuration:
-> ATA/IDE Mode = Native
-> S.M.A.R.T. = Enable

Power:
-> After Power Failure = Power on
-> Wake on LAN = Power on

Boot
-> Boot to Removable Devices = Enable
-> Boot to Network = Disabled
-> USB Boot = Enable
-> Boot USB Devices First = Enable

Automatically boots a flash imager when inserted.
Local Area Connection: Center of back panel among USB ports.

Auxiliary Connection #1: Sole add-on card.

Auxiliary Connection #2: Blue TrendNet USB device (optional)
Sys7

Jetway NC94-510-LF motherboard
Intel Atom D510 CPU dual-core @ 1.66 GHz (Benchmark 661)
1 GB RAM
3.5" 80 GB Western Digital HDD
Realtec Dual NIC PCIe Network Interface Card
Insert flash drive in USB port.
Press DEL at bootup to enter CMOS setup.

Advanced BIOS Features
- Hard Disk Drives
 - - Page Down to put SATA:WDC below USB FLASH

Integrated Peripherals
- Onboard SATA Function
 - - SATA Run Mode Configuration = Compatible
- Onboard Super IO Function
 - - Onboard Floppy Controller = Disabled
- PWR Status After PWR Failure = Always On
Local Area Connection: Center of back panel among USB ports.

Auxiliary Connection #1: Port labeled CH1 on add-on card.

Auxiliary Connection #2: Port labeled CH2 on add-on card.
Sys8
Intel D525MW motherboard
Intel Atom D525 CPU
   dual-core @ 1.80 GHz (Benchmark 717)
1 GB RAM
3.5" 160 GB Western Digital HDD
PCI Network Interface Card






See Fix Site Server Sys8 Serial Port.
Press F2 at bootup to enter CMOS setup

Advanced / Peripheral Configuration:
-> Serial Port = Enable
-> Parallel Port Port = Disable
-> Audio = Enable
-> On-board LAN = Enable

Advanced / Internal Chipset Drive Configuration:
-> Configure SATA as = IDE
-> S.M.A.R.T. = Enable

Power:
-> After Power Failure = Power on
-> Wake on LAN from S5 = Power on

Boot
-> Boot to Removable Devices = Enable
-> Boot to Network = Disabled
-> USB Boot = Enable
-> Boot USB Devices First = Enable

Automatically boots a flash imager when inserted.
Local Area Connection: Center of back panel among USB ports.

Auxiliary Connection #1: Sole add-on card.

Auxiliary Connection #2: N/A
Sys9

Jetway NC94-525-LF motherboard
Intel Atom D525 CPU dual-core @ 1.80 GHz (Benchmark 717)
2 GB RAM
3.5" 160 GB Western Digital HDD
Intel Gigabit Dual NIC PCIe Network Interface Card
Insert flash drive in USB port.
Press DEL at bootup to enter CMOS setup.

Advanced BIOS Features
- Hard Disk Drives
 - - Page Down to put SATA:WDC below USB FLASH

Integrated Peripherals
- Onboard SATA Function
 - - SATA Run Mode Configuration = Compatible
- Onboard Super IO Function
 - - Onboard Floppy Controller = Disabled
- PWR Status After PWR Failure = Always On
Local Area Connection: Center of back panel among USB ports.

Auxiliary Connection #1: Port labeled CH1 on add-on card.

Auxiliary Connection #2: Port labeled CH2 on add-on card.


Images

Images are snapshots of a hard drive content that is cloned onto each hardware device to act as the starting point. The images have names of the format <image-class><highest model supported><variant><revision> <company> <date>. For example, "sserv7Rh Ryko 2010-08-05".  The fields are:
The master list of all Site Server images is on the SiteServer page of Intelio's internal wiki.

sserv3 image for Sys3

The Sys3 box is the currently shipping hardware from Ryko. It was forked from Intelio's sserv7h image and is PCI compliant.
Note: The iVisor application's reporting service requires login name "reporting" with password "reporting".

sserv6 image for Sys6

The sserv6 image is obsolete because it is not PCI compliant. Only use sserv7.

The sserv6 image was built for the Sys6 hardware platform. It runs Windows XP Professional, VMware Server (replacing VMplayer on caw images) supporting up to three edge virtual machines. It is otherwise equivalent to the CAW images.

sserv7 image for all models

With sserv7, the image has built rebuilt from the ground up to be PCI compliant. It is backwards compatible to the Sys1 hardware platform, runs Windows Embedded for POS 2009, VMware Server, EPG, ClamWin anti-virus, and auto-logins as a non-administrative user. It may also run all of the normal Ryko Code-a-Wash applications. Radiant Epsilon may be installed on it.

sserv8 image for all models

The sserv8 image has updated drivers to work with the Sys8 platform. It is backwards compatible to the Sys1.

Ethernet Adapters

Every Site Server has a primary Ethernet port around the middle of the back panel, among the USB ports. This is the network uplink port and is shipped set to automatically obtain a dynamic IP address. It may be reconfigured from within Windows, where it is labeled Local Area Connection. There are one or two additional Ethernet adapters, depending on configuration. The following table describes all of the network connections that you will find in Control Panel / Network Connections on a freshly imaged sserv:

Name in Windows
IP Address Netmask Recommended Use
Local Area Connection dynamic
dynamic
uplink
Auxiliary Connection #1 192.168.111.20 255.255.255.0 teller Moxa @ 192.168.111.21
Auxiliary Connection #2 192.168.112.20 255.255.255.0 car wash Moxa @ 192.168.112.21
Intelio VPN dynamic dynamic do not alter
VMware vmnet1 192.168.110.1 255.255.255.0 do not alter
VMware vmnet8 192.168.109.1 255.255.255.0 do not alter

The Auxiliary Connections on the add-on cards and/or USB adapter can used to connect other equipment, such as Moxa nPort serial device servers for carwash communication. By convention, a Moxa for bay 1 should have a last octet of .21, bay 2 should have .22, etc. A network switch may be added to support more than one device. The edge(s) must be configured with the address you choose for the Moxas. You may also just place Moxas on the site's network, along with the Site Server via the primary port, and not use these auxiliary connections.

See Also

   Site Server Flash Imager
   How to configure a new Site Server (sserv)
Adam Fanello

Approved Wire and Uses

Ethernet (Internet) Wire

Run one Ethernet cable from the network access point (modem, router, switch...etc) to each Activa Virtual Attendant and to the Activa Site Controller.

Use shielded, Stranded CAT5e, any quality brand.

Activa Direct Wire

Activa Direct wire is used between the Activa Virtual Attendant terminals and the car wash PLC.

Use 18 gage shielded, stranded 10 conductor.

Echelon (RykoNet) Wire

Echelon wire is only used at sites with a Ryko car wash. It runs between each car wash PLC and its associated Activa Virtual Attendant, and then front either of those to the Site Controller.

Echelon wire is 18 gauge twisted pair. Only the following are approved for use:
Run wire to each Echelon device, and tie them together in one place using a terminal block or (for just a few wires) two wire caps.
Adam Fanello

Fix Site Server Sys8 Serial Port

The Sys8 Site Servers have a glitch with serial ports 1 and 2. Here are the instructions on how to change COM2 to COM1.

  1. Log in as Administrator.
  2. Click the Start button, then right click on "My Computer" then left click on "Manage".
  3. Select "Device Manager" on the left.
  4. Double click on "Ports". 
  5. Right click on "Communications Port (COM1) and select "Uninstall".
  6. Right click on "Communications Port (COM2). Select "Properties". Go to "Port Settings" tab.
  7. Click on the "Advanced" button.
  8. Look for the Port Number and click on the drop down arrow. 
  9. Scroll up and select "COM1".
  10. Click "Ok" button(s).
  11. Reboot the sServ.
Once connected to a POS, be sure that the POS bubble (in the Main Screen of Code-A-Wash app) turns green. Ensure that you set the POS configurations to the required protocol.
Adam Fanello

Site Server Flash Imager

The sserv8 Flash Imager drive may be used to initialize a Site Server, Site Controller, or Ryko Code-a-Wash hardware with all of the current software needed for PCI DSS and PA-DSS compliant use of WashMax services. Initialization requires a keyboard (PS/2 is best) and monitor, and a few minutes to start. It will then run to completion, unattended, in about twenty minutes.

Note: Initializing your Site Server will destroy all existing configuration and data on it.

BIOS Setup

If the Site Server fails to boot from the flash drive and run to completion, then the computer's BIOS probably needs to be configured. See About Site Servers for configuration instructions.

Backup Procedure

If you wish to preserve existing Code-a-Wash configuration data and code inventory, follow the procedure below. If not, skip to the Initialization Procedure below.
  1. Begin with the Site Server powered on and in normal operating mode.
  2. Insert the USB flash drive in any USB port.
  3. Touch the Setup Menu button. (Login if necessary.)
  4. Touch the Database Maintenance button.
  5. Touch the Backup Now button.

Initialization Procedure

  1. Begin with the PC powered off, a keyboard plugged in, and the USB Flash Imager drive in any USB port.
  2. Press the PC power button.
  3. On a Sys1, Sys2, Sys4 or Sys5 box:
  4. On a Sys6 or Sys8 box, it will boot from the flash drive without pressing anything.
  5. On a Sys7 box:
  6. The imager will run:
  7. Press the power button to turn the PC off.
  8. Remove the USB Flash drive.
  9. Press the power button to start up the newly imaged Site Server.
  10. When Windows has started up, give it a few minutes to discover new devices. Allow it to reboot if it wants to.
  11. If reimaging an old PC to make it PCI DSS compliant, double-click on Secure Delete on the desktop. This will take about an hour to run.
  12. Double-click the Post-Cloning Fix-Up icon on the Desktop.
  13. Call Intelio tech support to reinitialize your Site Server. (It needs to be given its identity on the network and software initialized.)

Restore Procedure

If you made a backup of your Site Server configuration data, you may restore it once the newly initialized Site Server has started back up. (Ask your Intelio tech, a remote backup may have been restored during the initialization process.)
  1. Begin with the Site Server powered on and in normal operating mode.
  2. Insert the USB flash drive in any USB port.
  3. Touch the Setup Menu button.
  4. Touch the Exit button.
  5. Touch the Repair Backup Restore button.
  6. Touch the Restore Data From Backup button.
  7. Touch the caw.mdb file and touch the OK button.
  8. Touch the OK button.
  9. Touch the next OK button.
  10. Touch the Finished button.
  11. Touch the Start button.

Revision History

The file C:\image.txt on the PC contains the revision date of the Flash Imager used to initialize the PC.
The file image.txt on the USB Flash Imager drive contain the revision date of the image.
Adam Fanello

POS Interface

How to interface Intelio Site Server to different Point-of-Sale systems for wash code issuance.

Allied ANDI

Source: Allied Electronics Online Documents

Code-a-Wash Settings

Setup Menu / Point of Sale:

Cable for most companies and POS

ANDI SSC (CH14) RJ45 adapter to the Intelio Site Server DB9 (Allied Part #HT9352-ADP)
SSC
DB25 Female
Pins
RJ45
Adapter
Pins
  CAT5 Cable
(T568B Spec.
  RJ45
Modular Jack
Pins
Site Server
DB9 Female
Pins
TXD 2 (Blk) 3 ------- Wht/Grn ------- 3 (Blk) 2 RXD
RXD 3 (Wht) 8 ------- Brown ------- 8 (Wht) 3 TXD
RTS 4 tie to CTS 5 -------   -------    
CTS 5 tie to RTS 4 -------   -------    
DSR 6 tie to DTR 11 -------   -------    
DTR 11 tie to DSR 6 -------   -------    
GND 7 (Brn) 7 ------- Wht/Brn ------- 7 (Brn) 5 Gnd

Cable for BP Amoco with Gilbarco

ANDI SSC (CH14) RJ45 adapter to the Intelio Site Server DB9 (Allied Part #HT9352-ADP)
SSC
DB25 Female
Pins
 
  Site Server
DB9 Male
Pins
TXD 2 ------- Black ------- 2 RXD
RXD 3 ------- White ------- 3 TXD
RTS 4 -------  Green -------  8 CTS
CTS 5 -------  Red -------  7 RTS
GND 7
-------  Brown -------  5 GND
DTR 11 -------  Blue -------  6 DSR
DSR 6
------- Orange ------- 4 DTR

 

Adam Fanello

Allied NeXGen

Source: Allied Electronics Online Documents

Code-a-Wash Settings

Setup Menu / Point of Sale:

Cable

NeXGen RJ45 adapter to the Intelio Site Server DB9 (Allied Part #N9352-ADP)
NeXGen
RJ45
Pins
  CAT5 Cable
(T568B Spec.
  RJ45
Modular Jack
Pins
Site Server
DB9 Female
Pins
RXD 3 ------- Wht/Grn ------- 3 (Blk) 3 TXD
TXD 5
------- Wht/Blue ------- 5 (Grn)
2 RXD
GND 8
-------  Brown -------  8 (Wht) 5 GND
Adam Fanello

Software Installation

Software (operating environment) installation and reinitialization instructions and notes for Site Servers and Site Controllers.

Bootstrap a previously Offline Configured device

When a device doesn't have Internet access at installation time, the "Offline Configure" shortcut may be run on the desktop to put the system into operation. This procedure describes how to later bootstrap it when it does come online.

  1. Login to WIndows with the Administrator account and open Cygwin. (Or ssh in as Administrator.)
  2. On an sserv, enter the lines:
  3. On a teller, enter the lines:
  4. Follow normal procedure for bootstrap.
Adam Fanello

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:
Supported payment processors:
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 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:
The following buttons may also be available:
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.

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:

EPI Settings

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

Fields:

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:

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:
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 thekey 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.
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

Fix Site Server Sys8 Serial Port

The Sys8 Site Servers have a glitch with serial ports 1 and 2. Here are the instructions on how to change COM2 to COM1.

  1. Log in as Administrator.
  2. Click the Start button, then right click on "My Computer" then left click on "Manage".
  3. Select "Device Manager" on the left.
  4. Double click on "Ports". 
  5. Right click on "Communications Port (COM1) and select "Uninstall".
  6. Right click on "Communications Port (COM2). Select "Properties". Go to "Port Settings" tab.
  7. Click on the "Advanced" button.
  8. Look for the Port Number and click on the drop down arrow. 
  9. Scroll up and select "COM1".
  10. Click "Ok" button(s).
  11. Reboot the sServ.
Once connected to a POS, be sure that the POS bubble (in the Main Screen of Code-A-Wash app) turns green. Ensure that you set the POS configurations to the required protocol.
Adam Fanello

How to configure a new Site Server (sserv) for Cobra

Assumptions

The Site Server has been imaged by an Intelio sserv flash imager. (Don't forget the Post-Cloning script for an sserv7.)

The Site Server is connected to an IP network which has access to ports 2372 and 2374 at Internet address 209.11.249.195.

See Also

   About Site Servers
   Site Server Flash Imager

Contact the Site Server

A freshly image Site Server will appear as a new sserv_configme on the VPN list.  Confirm that you have the correct site by checking the source of the IP address or by clicking the VNC link and confirming movement on the screen with someone on site.

System Configuration

Via SSH

If the system was just imaged, ask someone locally to double-click the Post-Clone Fix-Up icon on the desktop.

SSH into the Site Server as the user Administrator using a link on the VPN list, with Putty, or from the Linux command line.
The command prompt [Administrator@sserv ~]$ will appear. Type in the command:
./bootstrap.sh 172.16.1.102 cobra
Answer the prompts. While this is running, you may proceed to the next step.

Via VNC or locally

VNC into the Site Server. Double-click the Post-Clone Fix-Up icon on the desktop. (It's safe to do more than once after imaging, but not once you start configuring.)
After several seconds, it will ask if you would like to bootstrap the system now. Enter n for no.
Double click on Cygwin icon on the desktop. The command prompt [Administrator@sserv ~]$ will appear. Type in the command:
./bootstrap.sh 172.16.1.102 cobra
Answer the prompts. While this is running, you may proceed to the next step.

Configure the Edge VMs

An edge is only required if the customer purchase WashMax Manage, Maintain, or Market.
  1. Click the VMs link on the VPN list, point your web browser to http://<sserv IP address>:8222/ui/
  2. Login as Administrator with the default or current password.
  3. With sserv selected on the left, find the Commands block on the right and click on Edit Virtual Machine Startup/Shutdown Settings.
  4. Click on Intelio Edge A and then click the Move Up button to put it in the (Startup Order)  Any Order section.
  5. Repeat as needed for Intelio Edge B and Intelio Edge C to run two or three edges.
  6. Click on Intelio Edge A on the left.
  7. Notes about power on/off from on this page:
    1. Do not power on the edge until the bootstrap/installation scripts complete!
    2. Do not use the red square STOP button or Power Off link. These are like cutting power to the machine.
    3. Do use the Shut Down Guest and Restart Guest links when needed. These do clean shutdowns and reboots.
  8. If the edge VM needs to be on the physical network rather than a virtual network inside of the Site Server:
    1. If the edge is already running, click the Shut Down Guest link and wait for it to shut down.
    2. If Network Adapter 2 isn't listed in the Hardware section:
      1. Click on Add Hardware in the right column.
      2. Click on Network Adapter and then Next.
      3. Click on Next and then Finish.
    3. If the edge had been running, start it back up by clicking the Power On link on the right.
  9. If the edge VM needs to access a device plugged into the 9-pin DIN serial port:
    1. Go to the Hardware section and click the icon next to Serial Port 1.
    2. Click on Edit.
    3. Select Connect at power on.
    4. Click on the OK button.
    5. Note: Do not do this if the Code-a-Wash application is to run. They will conflict!
  10. If the edge VM needs to access a USB Serial adapter:
    1. Note: The adapter must be plugged in as the Site Server is boots up. If it was not, plug it in now and come back to this after a reboot.
    2. Go to the Hardware section and click the icon next to Serial Port 1.
    3. Click on Edit.
    4. Select Connect at power on.
    5. Select the Physical COM port. The one on the motherboard is COM1. The adaptor will show with a higher number.
    6. Click on the OK button.
    7. If you need multiple adapters, only add them one at a time so that you can tell which is which.
  11. Feel free to put comments in the Notes section if you feel a need.
  12. Repeat for Intelio Edge B and Intelio Edge C as needed.
Once complete here and the bootstrap/install scripts have completed, reboot the Site Server. (Use the option at the end of the install script, or press the REBOOT button on the screen.)

Windows User Accounts

After imaging, the server auto logs on with the Administrator account so that you can configure it. After bootstrap, it logs in as the less privileged user name LocalTerminal. This is a PCI DSS requirement. LocalTerminal can run the applications and configure network settings, but cannot install software. Should you need to change the operating system settings, you must do so as Administrator:
  1. Shut down all applications that you can.
  2. Press the Windows key to pop up the START menu, and select Log Out.
  3. At the new logon prompt, enter user name Administrator and the current password. (See the SOC.)
Once done making changes, you must return to the lower privileged LocalTerminal account. Either reboot or log out and back in. The user name for log on is LocalTerminal; leave the password blank.

Do not share the Administrator password if possible. If you must, inform the Director of Development so that the password may be changed. (Globally, for all sites.) This must be done every ninety days regardless.

If an owner wishes to have their own administrator account, this is permitted. Create the new user. The owner is responsible for meeting PCI DSS requirements on that account. (See the WashMax Payments Implementation Guide.)

Edge Configuration

An edge is only required if the customer purchase WashMax Manage, Maintain, or Market.

Identify the edge_configme(s) on the VPN list for the site. They will come from the same public IP address as the sserv.
SSH into each one as root and run ./bootstrap.sh, configuring them as usual.

Note: For a PCI compliant solution, you must run EPG on the Site Server and select the -epg variant when configuring the edge's configuration profile.

Fix Screen Resolution

Sometimes the display resolution after imaging will come up too high and the applications will not occupy the entire screen. If you can see the Windows toolbar and part of the desktop, follow these instructions to fix.
  1. Right click on the desktop and select Properties.
  2. Click the Settings tab.
  3. Click the Advanced button.
  4. Click the Adapter tab.
  5. Click List All Modes.
  6. Scroll the list up and select 640 by 480, True Color (32 bit), 60 Hertz, and click OK.
  7. Click OK.
  8. Click OK.
  9. Click Yes on the dialog box.
  10. Click OK.
Alternatively, on some systems there is a blue trapizoidal icon in the notification tray for the Intel Graphics Media Driver. It may also be used to set the screen resolution.

Application Configuration

VNC into the Site Server. It will now appear on the VPN list under its new name and on the SOC.

Site with Car wash Equipment

Skip this section if no wash equipment is at the site.

Installations without WashMax Merchandise and the sserv7 image (PCI compliant)

  1. Configure startup programs:
    1. On the Booter program, touch the Set Program Options button.
    2. Touch the Startup Options button.
    3. Touch the down arrow next to Configuration one so that it reads Payment Gateway.
    4. Touch the OK button.
    5. Touch the Finished button.
    6. Touch the Start button.
See the article How to configure EPG.

Installations Connected to Ryko or Intelio Tellers and WashMax Merchandise

  1. Configure startup programs:
    1. On the Booter program, touch the Set Program Options button.
    2. Touch the Startup Options button.
    3. Touch the down arrow next to Configuration twice so that it reads Full Function.
    4. Touch the OK button.
    5. Touch the Finished button.
    6. Touch the Start button.
  2. Login to the Code-a-Wash application.
  3. Touch the Setup Menu button.
  4. Touch the Wash Keys button.
  5. Edit each wash package to match the Activa. Touch the Close button when done.
  6. Back at the Setup Menu. The Promo Messages section defines the text printed at the bottom on codes printed out directly from the Code-a-Wash. Edit if desired.
  7. Use of Fleet Account, Discount Keys and Discount Programs are discouraged, as they do not report properly to WashMax. Use WashMax Marketing instead.
  8. Touch the Users button and have the OWNER consider a new password. They may also want additional accounts for other users.
  9. Touch the Site Information button and fill in the fields. This is printed at the top of codes printed directly from the Code-a-Wash.
  10. Touch the Point Of Sale button.
  11. Touch the Coinbox button.
  12. Touch Close to exit the Setup Menu.
  13. Touch the Logout button. Never leave the ENG user logged in once you are done.
For an sserv7 image, see the article How to configure EPG.

Installations Connected to Unitec Tellers and not PCI compliant

Sometimes a Site Server is used just as a host of the edge virtual machines. In these cases, there is no need to run the Ryko applications. The Site Server is shipped already in this Edge Only configuration; there's no need to do anything more on the Site Server.

Remote Site Server

A remote Site Server is at a site that does not have car wash equipment, but does have a POS system that can sell codes.
  1. Give the sserv VPN access to the other sserv or caw device:
  2. Configure startup programs:
  3. Configure application to communicate with master CAW at car wash site.
  4. Once communication is establish with the host CAW and wash keys are setup on the host, copy them:


Adam Fanello

How to configure a new Site Server (sserv) for latest

Assumptions

The Site Server has been imaged by an Intelio sserv flash imager. (Don't forget the Post-Cloning script for an sserv7.)

The Site Server is connected to an IP network which has access to ports 2372 and 2374 at Internet address 209.11.249.195.

See Also

   About Site Servers
   Site Server Flash Imager

Contact the Site Server

A freshly image Site Server will appear as a new sserv_configme on the VPN list.  Confirm that you have the correct site by checking the source of the IP address or by clicking the VNC link and confirming movement on the screen with someone on site.

System Configuration

Via SSH

If the system was just imaged, ask someone locally to double-click the Post-Clone Fix-Up icon on the desktop.

SSH into the Site Server as the user Administrator using a link on the VPN list, with Putty, or from the Linux command line.
The command prompt [Administrator@sserv ~]$ will appear. Type in the command:
./bootstrap.sh
Answer the prompts. Reboot at the end.

Via VNC or locally

VNC into the Site Server. Double-click the Post-Clone Fix-Up icon on the desktop. (It's safe to do more than once after imaging, but not once you start configuring.)
After several seconds, it will ask if you would like to bootstrap the system now. Enter y for yes.
Answer the prompts. Reboot at the end.

Windows User Accounts

After imaging, the server auto logs on with the Administrator account so that you can configure it. After bootstrap, it logs in as the less privileged user name LocalTerminal. This is a PCI DSS requirement. LocalTerminal can run the applications and configure network settings, but cannot install software. Should you need to change the operating system settings, you must do so as Administrator:
  1. Shut down all applications that you can.
  2. Press the Windows key to pop up the START menu, and select Log Out.
  3. At the new logon prompt, enter user name Administrator and the current password. (See the SOC.)
Once done making changes, you must return to the lower privileged LocalTerminal account. Either reboot or log out and back in. The user name for log on is LocalTerminal; leave the password blank.

Do not share the Administrator password if possible. If you must, inform the Director of Development so that the password may be changed. (Globally, for all sites.) This must be done every ninety days regardless.

If an owner wishes to have their own administrator account, this is permitted. Create the new user. The owner is responsible for meeting PCI DSS requirements on that account. (See the WashMax Payments Implementation Guide.)

Fix Screen Resolution

Sometimes the display resolution after imaging will come up too high and the applications will not occupy the entire screen. If you can see the Windows toolbar and part of the desktop, follow these instructions to fix.
  1. Right click on the desktop (or Control Panel / Desktop) and select Properties.
  2. Click the Settings tab.
  3. Click the Advanced button.
  4. Click the Adapter tab.
  5. Click List All Modes.
  6. Scroll the list up and select 640 by 480, True Color (32 bit), 60 Hertz, and click OK.
  7. Click OK.
  8. Click OK.
  9. Click Yes on the dialog box.
  10. Click OK.
Alternatively, on some systems there is a blue trapizoidal icon in the notification tray for the Intel Graphics Media Driver. It may also be used to set the screen resolution.

Application Configuration

VNC into the Site Server. It will now appear on the VPN list under its new name and on the SOC.

Site with Car wash Equipment

Skip this section if no wash equipment is at the site.

Installations without WashMax Merchandise or a Ryko car wash.

  1. Configure startup programs:
    1. On the Booter program, touch the Set Program Options button.
    2. Touch the Startup Options button.
    3. Touch the down arrow next to Configuration one so that it reads Payment Gateway.
    4. Touch the OK button.
    5. Touch the Finished button.
    6. Touch the Start button.
See the article How to configure EPG.

Installations with WashMax Merchandise or a Ryko car wash.

  1. Configure startup programs:
    1. On the Booter program, touch the Set Program Options button.
    2. Touch the Startup Options button.
    3. Touch the down arrow next to Configuration twice so that it reads Full Function.
    4. Touch the OK button.
    5. Touch the Finished button.
    6. Touch the Start button.
  2. Login to the Code-a-Wash application.
  3. Touch the Setup Menu button.
  4. Touch the Wash Keys button.
  5. Edit each wash package to match the Activa. Touch the Close button when done.
  6. Back at the Setup Menu. The Promo Messages section defines the text printed at the bottom on codes printed out directly from the Code-a-Wash. Edit if desired.
  7. Use of Fleet Account, Discount Keys and Discount Programs are discouraged, as they do not report properly to WashMax. Use WashMax Marketing instead.
  8. Touch the Users button and have the OWNER consider a new password. They may also want additional accounts for other users.
  9. Touch the Site Information button and fill in the fields. This is printed at the top of codes printed directly from the Code-a-Wash.
  10. Touch the Point Of Sale button.
  11. Touch the Coinbox button.
  12. Touch Close to exit the Setup Menu.
  13. Touch the Logout button. Never leave the ENG user logged in once you are done.
See the article How to configure EPG.

Configure EPG

Details @ EPG Installation and User Manual

  1. Open EPG Settings window. (Right click on icon near clock.)
  2. From the SOC, determine the Entry Device (teller) interface and payment processor to use.
  3. Read Computer ID from General tab. Edit the site on the SOC and generate the payment processor's product key (EPG-AuthNet or EPG-Epsilon).
  4. Go to that payment processor's setting tab (Authorize.Net or Epsilon). Set key and other options.
  5. If Wash Select II:
    1. Configure Moxa using nPort Search Utility. See Wash Select II interface and configuration.
    2. Configure Unitec settings tab in EPG.
  6. Click OK on the Settings window and OK to the notification.

Remote Site Server

A remote Site Server is at a site that does not have car wash equipment, but does have a POS system that can sell codes.
  1. Give the sserv VPN access to the other sserv or caw device:
  2. Configure startup programs:
  3. Configure application to communicate with master CAW at car wash site.
  4. Once communication is establish with the host CAW and wash keys are setup on the host, copy them:

Configure WashMax Onsite

If the customer has purchased any WashMax features (besides Broadband, which is just EPG, and Merchandise, which is Code-a-Wash), WashMax Onsite must be configured.
  1. Check the SOC comment to ensure that the site has been added to a WashMax Server.
  2. Configure as described by the article: Configure WashMax Onsite.
If this sserv is replacing one that previously ran Cobra (there's an edge node on the SOC), follow the two cleanup steps at the end of the article: How to upgrade from Cobra/edge to Enzo/WashMax Onsite

Test

  1. Bring up EPG Status and see green lights for the configured credit payment processor and Intelio GIIP Payment Processor.
  2. Wash code sale (if applicable)
  3. Wash code redemption (if applicable)
  4. Credit card purchase at teller. (Must activate the wash, not just validate the card.)

Software Updates

Within an hour of configuration, the site server will begin downloading software updates. The time to download all available updates can vary from minutes to hours, depending on the network speed and number of updates. A couple of hours, to no more than a day, after configuring, the site server must be rebooted to allow these updates to install.
Adam Fanello

How to install Cold Card Activator system

Purpose

WashMax Marketing cards are typically assigned to a program and available for immediate use. This is a problem for cards that are sold, as they are then prone to theft. Instead, cards should be assigned to a problem, but inactive - unavailable for immediate use. A stolen card is then worth nor more than the plastic card itself.

Cold Card Activator (CCA) is a way to enable the card. A store clerk swipes the card on the Site Server, and it activates the card. Additional fields can also be set at activation, such as initial value and usage count.

Installation

The sserv and edge must be running at least v4.0-103 of WashMax. Update if needed.

Log in as administrator.

Cold Card Activator comes pre-installed on the images sserv7j and later. For earlier images:

Plug the UIC MSR120 card reader device into an available USB port. The New Hardware Wizard will appear, select to manually specify a location and browse to C:\Program Files\Ryko\CCA\MSR120-driver\.  At the warning, click Continue Anyway and finally Finish.

Login to the (first) edge and add ,coldcard to site.profile in the conf/site.properties file.

Reboot the Site Server.

Configuration

Right-click CCA icon in task bar (blue icy card) and select Settings. Configure options and license key. Click OK and wait for it to restart.

Options:

Testing

Swipe any marketing card. Enter required values and click Activate. If it says the backend server isn't connected, wait a while for the edge to finish coming up and try again. Unknown card or Card already Activated both mean that everything is communicating, it just couldn't activate that specific card.
Adam Fanello

How to re-initialize edge virtual machines (VMs)

Sometimes the virtual hard drive of an edge running on a Site Server (sserv) may become corrupt. You don't have to reimage the entire sserv, you can effectively "reimage" just the edge's virtual hard drive.

First, open the VMware web console, either via the local desktop or remotely at http://sserv###.any:8222/ui/ (substitute the actual sserv number or IP address), and stop each edge that you want to reimage.

Now either ssh into the sserv or open the local Cygwin shell. Switch to the main VM directory:
cd /cygdrive/c/Intelio/vm
Delete the virtual hard drive for each edge you want to reimage. Only enter the commands for the edge(s) you want to reimage:
rm edgeA/*.vmdk
rm edgeB/*.vmdk
rm edgeC/*.vmdk
Now you can re-create the virtual hard drives from the initial template:
./initVMdisks.bat
Only the disks you deleted will be copied. Once the edge's virtual HDD is in place, use the VMware web console to start it up. Give it a couple of minutes to finish booting (you can tell it's done when the IP address fills in on the web console).  Now bootstrap the edge(s) as you normally would. For example:
ssh [email protected]
./bootstrap.sh
Adam Fanello

How to upgrade existing Site Server to WashMax Onsite (Enzo)


The enzo code base includes WashMax Onsite and Intelio Support Scripts. This article explains how to upgrade an existing Site Server to enzo. It could be already running with edges and the cobra code base, or it might be a fresh image not yet bootstrapped.

Note: As of the sserv8b image, WashMax Onsite is pre-installed! Follow the article How to configure a new Site Server (sserv) for latest instead!

Preparation:

Several files need to be copied to the sserv node. There are three ways to do this; do one of the following:
  1. VNC to the sserv, open Internet Explorer, and download the files from http://repository.server/repo/WashMax%20Onsite/ to D:\  
  2. ssh to [email protected] and scp repo/onsite/* [email protected]:/cygdrive/d/   (change sservXXX to the node name)
  3. Copy the files from a USB flash drive plugged into the Site Server to D:\ . (This is necessary at sites with slow networks.)
Through ssh or Windows Explorer, extract enzo-upgrade.zip in place.

Disable Edges:

You can disable VMware from auto-starting the edge VMs, while leaving them running for most of the upgrade process. They edges will continue to run until the reboot.

Install Software:

Software installation must be done with the Administrator account. The easiest way to do this is to log out of LocalTerminal and in as Administrator.

As Administrator:

If you are comfortable at the command-line and minimizing downtime is important, the above programs can be run while logged in as LocalTerminal by clicking the Start Menu / Run and entering runas /user:administrator cmd. Run the programs from the command-line. You cannot do this installation from ssh or Cgywin!

Switch from Cobra to Enzo:

If the sserv is already running Cobra support scripts, it must be upgraded to Enzo's Intelio Support Scripts.

Run Cygwin on the local screen or via ssh to the node.  (If you are logged into Windows as LocalTerminal and run Cygwin, enter ssh administrator@localhost to switch users.)

Enter:  cd; /cygdrive/d/enzo-upgrade/cobra2enzo.sh

Answer prompts and reboot at the end.

Installing on fresh (older) image:

If the sserv has not been bootstrapped yet, but you are following this guide because it's image is older than sserv8b (which includes enzo), then just run the enzo installer instead of bootstrap.sh.

VNC into the Site Server. Double-click the Post-Clone Fix-Up icon on the desktop. After several seconds, it will ask if you would like to bootstrap the system now. Enter n for no!

Double-click the Cygwin icon on the desktop. Enter:  cd; /cygdrive/d/enzo-upgrade/enzo_install.sh

Answer prompts and reboot at the end.

Refer to the article How to configure a new Site Server (sserv) for latest for configuration of the rest of the Site Server.

Configuring WashMax Onsite:

See the article Configure WashMax Onsite.

Verify EPG Status:

Open the EPG Status display (if not showing). Within a minute of restarting WashMax Onsite, you will see the sserv node appear in green under GIIP Server. There should not be any edge nodes. (If there are, the VM is still running.)

Cleanup Alerts on WashMax Server (wms):

Once WashMax Onsite has been running for a few minutes and the old edge has been offline for at least 22 minutes, it'll have reported fresh Operational alerts to the WashMax Server (wms) and have an alert about lost contact with the site. You can verify this with the WashMax tab on the SOC. You can then clean-up old alerts left by the cobra edge:

Cleanup SOC:

On the site's Facts page, click the edit link on the edge node, and then click the DELETE button to remove the old edge node and all of it's events.

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

Site Server Flash Imager

The sserv8 Flash Imager drive may be used to initialize a Site Server, Site Controller, or Ryko Code-a-Wash hardware with all of the current software needed for PCI DSS and PA-DSS compliant use of WashMax services. Initialization requires a keyboard (PS/2 is best) and monitor, and a few minutes to start. It will then run to completion, unattended, in about twenty minutes.

Note: Initializing your Site Server will destroy all existing configuration and data on it.

BIOS Setup

If the Site Server fails to boot from the flash drive and run to completion, then the computer's BIOS probably needs to be configured. See About Site Servers for configuration instructions.

Backup Procedure

If you wish to preserve existing Code-a-Wash configuration data and code inventory, follow the procedure below. If not, skip to the Initialization Procedure below.
  1. Begin with the Site Server powered on and in normal operating mode.
  2. Insert the USB flash drive in any USB port.
  3. Touch the Setup Menu button. (Login if necessary.)
  4. Touch the Database Maintenance button.
  5. Touch the Backup Now button.

Initialization Procedure

  1. Begin with the PC powered off, a keyboard plugged in, and the USB Flash Imager drive in any USB port.
  2. Press the PC power button.
  3. On a Sys1, Sys2, Sys4 or Sys5 box:
  4. On a Sys6 or Sys8 box, it will boot from the flash drive without pressing anything.
  5. On a Sys7 box:
  6. The imager will run:
  7. Press the power button to turn the PC off.
  8. Remove the USB Flash drive.
  9. Press the power button to start up the newly imaged Site Server.
  10. When Windows has started up, give it a few minutes to discover new devices. Allow it to reboot if it wants to.
  11. If reimaging an old PC to make it PCI DSS compliant, double-click on Secure Delete on the desktop. This will take about an hour to run.
  12. Double-click the Post-Cloning Fix-Up icon on the Desktop.
  13. Call Intelio tech support to reinitialize your Site Server. (It needs to be given its identity on the network and software initialized.)

Restore Procedure

If you made a backup of your Site Server configuration data, you may restore it once the newly initialized Site Server has started back up. (Ask your Intelio tech, a remote backup may have been restored during the initialization process.)
  1. Begin with the Site Server powered on and in normal operating mode.
  2. Insert the USB flash drive in any USB port.
  3. Touch the Setup Menu button.
  4. Touch the Exit button.
  5. Touch the Repair Backup Restore button.
  6. Touch the Restore Data From Backup button.
  7. Touch the caw.mdb file and touch the OK button.
  8. Touch the OK button.
  9. Touch the next OK button.
  10. Touch the Finished button.
  11. Touch the Start button.

Revision History

The file C:\image.txt on the PC contains the revision date of the Flash Imager used to initialize the PC.
The file image.txt on the USB Flash Imager drive contain the revision date of the image.
Adam Fanello

Troubleshooting

Techniques for finding and resolving problems.

Code-a-Wash Reports show incorrect change

The Code-a-Wash application has settings indicating the monetary denomination of change given by the Activa. These values must match the Activa configuration, otherwise reports will be incorrect.
  1. Login to the Code-a-Wash application.
  2. Touch the Setup Menu button.
  3. Touch the Coinbox button.
  4. Touch the Currency tab.
  5. Set Coin 1 Value to match the Coin Acceptor value on the Activa.
  6. Set Change Value to match the Coin Dispenser value on the Activa.
  7. If there is more than one Activa, touch the right arrow at the top of the screen to configure the next bay.
Adam Fanello

Fix Site Server Sys8 Serial Port

The Sys8 Site Servers have a glitch with serial ports 1 and 2. Here are the instructions on how to change COM2 to COM1.

  1. Log in as Administrator.
  2. Click the Start button, then right click on "My Computer" then left click on "Manage".
  3. Select "Device Manager" on the left.
  4. Double click on "Ports". 
  5. Right click on "Communications Port (COM1) and select "Uninstall".
  6. Right click on "Communications Port (COM2). Select "Properties". Go to "Port Settings" tab.
  7. Click on the "Advanced" button.
  8. Look for the Port Number and click on the drop down arrow. 
  9. Scroll up and select "COM1".
  10. Click "Ok" button(s).
  11. Reboot the sServ.
Once connected to a POS, be sure that the POS bubble (in the Main Screen of Code-A-Wash app) turns green. Ensure that you set the POS configurations to the required protocol.
Adam Fanello

Missing Printer Driver for Star TSP100

If the CAW or Site Server complains about the printer driver for a Star TSP 100 printer -- it will actually say it needs file "smjt100res.dll" and offer  a browse option.

Select Browse, and starting with "My Computer", select "Drive C:\" and then navigate to this directory:
C:\Windows\system32\spool\drivers\W32X86\startsp113__str_t_008447\
You will find the driver there.  Highlight it, and click "Open".  It will go back to the Need File screen.  Click OK and the printer will be installed.

WashMax

Articles about the various WashMax and iConnect Online products and services.

About Cold Card Activation

Cold Card Activation allows you to have WashMax Market cards that are assigned to a marketing program, but not yet functioning. This allows you to have the cards sitting on a display where customers can grab them, but stolen cards will not work. A store clerk must activate the card upon purchase.

Cold Card Activation is driven by a program on the Site Server called Cold Card Activator (CCA). It sits in the tray (a blue card with ice and a check mark) until a card is swiped. The application comes pre-installed on recent Site Server images, and may be added to an existing device. A mag-card reader for the Site Server must be purchased along with a license for the application.

When a card is swiped the input display pops up over the normal Code-a-Wash or EPG display:



The clerk enters information via the touch-screen.

Each of these three input fields may be configured as not shown, shown but not required, or shown and required. They can all be turned off, allowing swiped cards to be activated without any input at all. Here's the settings screen:



If a card is swiped but the back-end WashMax Onsite service, which handles the actual processing, is not connected it shows:



Other failures also show with this red screen. Any error screen can be closed or will go away on its own after several seconds.

Cards are active and available for immediate use on the first bay of the site where activated. Other sites/bays will take a few minutes.

Two WashMax Flex Program Reports are available for card activation. (Sample screen below.) Also, the Key details screen shows when the card was activated, and any other available detail (clerk ID, initial value, initial usage count).



By requiring the clerk to enter their ID at activation, and using the WashMax reports, clerks can be rewarded for signing up customers.

Any number of different marketing programs can be activated. You create the programs on WashMax and pre-assign groups of cards to each program. When the card is swiped for activation, it already "knows" which program it belongs to. Different card art-work or packaging can be used to distinguish the cards on display.
Adam Fanello

About Site Controllers

The Activa Site Controller and WashMax Site Controller is the general name for a device at a car wash location that hosts Intelio (and sometimes Ryko) provided software, other than the Activa itself. It is frequently called an "edge" or a "caw", although these designations no longer fits very well.

These platforms have been replaced by the Site Server for new and replacement installations.

A bit of history...

NEMA/6102

The first Site Controller utilized a Nagasaki 6102 motherboard and was enclosed in a large NEMA rated box. The model is commonly called a NEMA or a 6102. The early versions ran Red Hat Linux 9 (RH9), but replacement hard drives switched to running Fedora Core 5 (FC5). On the SOC, you will thus see the platform for edges running on this model labeled as 6102 RH9 and 6102 FC5.

Minibox

The second generation/model of edge was run an an iTuner MiniBox. It also ran Fedora Core 5 (FC5) as the operating system. These are listed on the SOC as a Minibox FC5 platform.

Here's where things start getting complex...

Sys1 / Sys2 CAW

The third generate of edge does not, in fact, have a hardware platform. This is where the Site Controller name began. Ryko provided a hardware box, produced by Sys Technologies, that was designated a CAW-iC. The CAW-iC runs Windows XP Embedded with Cygwin as the operating system, and Ryko's Code-a-Wash, EPI Server, and other applications. It also runs VMware's VM Player, which can run two virtual machine (VM) edges. This became Intelio's Site Controller platform. Even when the Ryko applications aren't needed, this platform may be used simply to run the edge VMs.  This hardware platform may also be called Sys1 and uses the CAW1 flash imager. (The CAW2 flash imager is known to work on the Sys1 most of the time.) The motherboard is model GA-945GCMX-S2.

Around the beginning of 2009, Ryko began shipping a new revision of the CAW-iC which looked the same as the old one but had a new motherboard model GA-G31M-S2L. This is designated the Sys2 and requires the CAW2 flash imager. (Later CAW flash imagers also work, up to CAW5.)



Sys3 CAW

This model never shipped.

Sys4

Beginning in June 2009, Intelio began working directly with Sys Technologies and has produced the Sys4 box with the latest GA-G31M-ES2L rev 1.x motherboard. It has a different front panel than the older models, no CD-RW drive, and replaces the modem card with two additional Ethernet ports. For the first time, this hardware is a dual-purpose device. It can be imaged with the CAW4 or CAW5 flash imager and operate as such a CAW-iC, with the Ryko applications and edge VMs. Alternatively, it may be imaged with the ehost1 flash imager, whereby it operates as an edge host device.

It is important to understand that the Sys4 box is just a piece of hardware. Intelio has leveraged this same piece of hardware to serve two different functions. The ehost and caw devices run entirely different operating systems, serve different (but overlapping) purposes, and are managed in different ways.  (The ehost platform has been discontinued.)



Back of a Sys4 box

Sys5

In late September 2009, Sys Technologies began delivering a box with GA-G31M-ES2L rev 2.0 motherboard. The main difference is that the on-board Ethernet chip changed from Realtec to Attansic (owned by Atheros). The outside looks identical to a Sys4, but requires the CAW5 flash imager.

In Q2 2010, Ryko began shipping a Sys5 CAW iC, but with a different case. In spite of the case difference, this is still a Sys5.

CAW model Site Controller

The "caw" model Site Controller is also called the Merchandise Site Controller, because it is the only model that can interface with a store Point of Sale (POS) system to issue wash codes. Because it runs the EPI Server, it is also required if the site has a Ryko coinbox (AMTT, AMTT-CS, or Enteract) or multiple Intelio Activa tellers.

Ethernet Adapters

Every caw has a primary Ethernet port around the middle of the back panel, among the USB ports. This is the network uplink port and is shipped set to automatically obtain a dynamic IP address. It may be reconfigured from within Windows XP.

On the Sys4 and Sys5 boxes, there are two additional Ethernet adapters:
These adapters can used to connect other equipment, such as Moxa nPort serial device servers for carwash communication. By convention, a Moxa for bay 1 should have a last octet of .21, bay 2 should have .22, etc. A network switch may be added to support more than one device. The edge(s) must be configured with the address you choose for the Moxas. You may also just place Moxas on the site's network, along with the caw via the primary port, and not use these auxiliary connections.

Ehost model Site Controller

This platform has been discontinued, but there are still a few in service.

The ehost (AKA: ehostess) is a device running the CentOS 5.3 Linux operating system that has been modified by the OpenVZ virtualization system. Unlike the virtual machines (VMs) of WMware on the caw, the ehost runs a single kernel that has been split into multiple operating system instances (all CentOS). Just to confuse matters, an instance is synonymously called a Virtual Private Server (VPS), Virtual Environment (VE), or container. In any case, each VPS runs an Intelio edge. This approach is very light weight, allowing for many edges to run on a singe ehost. (The maximum number of edges is untested, but may be as high as eight.)

The ehost does not run any Windows or Ryko applications. It is simply a hardware host for WashMax edges.

Ethernet Adapters and Moxas

The Sys4 box has three Ethernet ports.

ID Location IP Address Netmask Suggested Use
eth0 Center of back panel among USB ports
dynamic
dynamic
uplink
eth1 Card slot nearest eth0
192.168.111.20 255.255.255.0 teller Moxa
eth2 Card slot nearest outer edge of box
192.168.112.20 255.255.255.0 car wash Moxa

When an edge is running in a VPS, it will default to find a Wash Select II at 192.168.111.21 and an AUTEC, Belanger, or Istobal at 192.168.112.21. This of course only works for a single bay site. The network can be setup in whatever makes sense for the site, including plugging everything into the site network and not using eth1 and eth2, or plugging a network switches into these ports to accommodate multiple devices.

Configure the Ethernet adapters by logging into the ehost as root and using the command:
  nw config [ifc] [static|dhcp] [ipaddr] [netmask] [gateway] [default] [dns]
The parameters in brackets may be left off, in which case the script will prompt for details.

Configure a Moxa nPort by logging into the ehost as root and using the moxaconfig command:
  Usage: moxaconfig <eth-adapter>
  Where: <eth-adapter> is eth0 eth1 or eth2


Bootstrapping

As with all Intelio devices, you configure it by logging in as root and running ./bootstrap.sh.  The script will prompt you for an edge number to add to the host. Enter it, and the scripts will create the new VPS and automatically run its bootstrap. When complete, allow it to reboot as normal; it will return you to the ehost where another edge can be added.

If an edge needs to be added after the initial bootstrap is completed, login to the ehost as root and run
  /home/intelio/script/install/createEdge.sh <edge#>
Replacing <edge#> with the edge number to add.
Adam Fanello

About Site Servers

Activa Site Server and WashMax Site Server are two names for a device at a car wash location that hosts Intelio (and sometimes Ryko) provided software, other than the Activa itself. It's name is sometimes shortened to sserv.  The Ryko iServer and Sheetz Car Wash Server (cws) are variants.

A bit of history...

The Site Server is a direct descendant of the older Site Controller line, and picks up its numbering scheme where the Site Controller left off (at five).

Models


Hardware BIOS Settings Network Locations
Sys1 (same case as Sys2)

Gigabyte GA-945GCMX-S2 motherboard
Intel Celeron CPU @ 2.8 GHz (Benchmark 334)
1 GB RAM
3.5" 80 GB HDD
Dial-up modem
Press DEL at bootup to enter CMOS setup

Power Management Setup

-> AC Back Function = Full-On.

Press F12 at bootup for boot menu.
Select Hard Drives and then USB-HDD0 to boot flash imager.
Local Area Connection: Center of back panel among USB ports.

Auxiliary Connection #1: N/A

Auxiliary Connection #2: N/A

Modem: In expansion card slot. Not used.
Sys2 (same case as Sys1)

Gigabyte GA-G31M-S2L motherboard
Intel Celeron 430 CPU @ 1.8 GHz (Benchmark 529)
1 GB RAM
3.5" 80 GB HDD
Dial-up modem
Press DEL at bootup to enter CMOS setup

Power Management Setup

-> AC Back Function = Full-On.

Press F12 at bootup for boot menu.
Select Hard Drives and then USB-HDD0 to boot flash imager.
Local Area Connection: Center of back panel among USB ports.

Auxiliary Connection #1: N/A

Auxiliary Connection #2: N/A

Modem: In expansion card slot. Not used.
Sys3 (Ryko only)

Biostar G31-M7 TE motherboard
Intel Celeron E3300 @ 2.5 GHz (Benchmark 1676)
1 GB RAM
Press DEL at bootup to enter CMOS setup

Advanced
-> SuperIO Configuration
  -> Restore on AC Power Loss = Power On
Boot
-> Hard Disk Drives
  -> Press '-' to move USB device to the top

Press F10 and Enter to Save & Exit.
Local Area Connection: Center of back panel among USB ports.

Auxiliary Connection #1: N/A

Auxiliary Connection #2: N/A

Modem: In expansion card slot. Not used.
Sys4 (same case as Sys5)
Front of Sys4/5 box
Gigabyte GA-G31M-ES2L rev 1.x motherboard
Intel Celeron 430 CPU @ 1.8 GHz (Benchmark 529)
1 GB RAM
3.5" 80 GB HDD
Two PCI Network Interface Cards
Press DEL at bootup to enter CMOS setup

Power Management Setup

-> AC Back Function = Full-On.

Press F12 at bootup for boot menu.
Select Hard Drives and then USB-HDD0 to boot flash imager.
Local Area Connection: Center of back panel among USB ports.

Auxiliary Connection #1: Add-on card nearest motherboard. (Center of three NICs.)

Auxiliary Connection #2: Add-on card nearest outer edge of case.
Sys5 (same case as Sys4)

Gigabyte GA-G31M-ES2L rev 2.0 motherboard
Intel Celeron 430 CPU @ 1.8 GHz (Benchmark 529)
1 GB RAM
3.5" 80 GB HDD
Two PCI Network Interface Cards
Press DEL at bootup to enter CMOS setup

Power Management Setup

-> AC Back Function = Full-On.

Press F12 at bootup for boot menu.
Select Hard Drives and then USB-HDD0 to boot flash imager.
Local Area Connection: Center of back panel among USB ports.

Auxiliary Connection #1: Add-on card nearest motherboard. (Center of three NICs.)

Auxiliary Connection #2: Add-on card nearest outer edge of case.
Sys6
Intel D945GCLF2D motherboard
Intel Atom 330 CPU
   dual-core @ 1.60 GHz (Benchmark 635)
1 GB RAM
3.5" 80 GB Western Digital HDD
PCI Network Interface Card

Optional external USB Ethernet interface

Press DEL at bootup to enter CMOS setup

Advanced / Peripheral Configuration:
-> Serial Port = Enable
-> Parallel Port Port = Disable
-> Audio = Enable
-> On-board LAN = Enable

Advanced / Drive Configuration:
-> ATA/IDE Mode = Native
-> S.M.A.R.T. = Enable

Power:
-> After Power Failure = Power on
-> Wake on LAN = Power on

Boot
-> Boot to Removable Devices = Enable
-> Boot to Network = Disabled
-> USB Boot = Enable
-> Boot USB Devices First = Enable

Automatically boots a flash imager when inserted.
Local Area Connection: Center of back panel among USB ports.

Auxiliary Connection #1: Sole add-on card.

Auxiliary Connection #2: Blue TrendNet USB device (optional)
Sys7

Jetway NC94-510-LF motherboard
Intel Atom D510 CPU dual-core @ 1.66 GHz (Benchmark 661)
1 GB RAM
3.5" 80 GB Western Digital HDD
Realtec Dual NIC PCIe Network Interface Card
Insert flash drive in USB port.
Press DEL at bootup to enter CMOS setup.

Advanced BIOS Features
- Hard Disk Drives
 - - Page Down to put SATA:WDC below USB FLASH

Integrated Peripherals
- Onboard SATA Function
 - - SATA Run Mode Configuration = Compatible
- Onboard Super IO Function
 - - Onboard Floppy Controller = Disabled
- PWR Status After PWR Failure = Always On
Local Area Connection: Center of back panel among USB ports.

Auxiliary Connection #1: Port labeled CH1 on add-on card.

Auxiliary Connection #2: Port labeled CH2 on add-on card.
Sys8
Intel D525MW motherboard
Intel Atom D525 CPU
   dual-core @ 1.80 GHz (Benchmark 717)
1 GB RAM
3.5" 160 GB Western Digital HDD
PCI Network Interface Card






See Fix Site Server Sys8 Serial Port.
Press F2 at bootup to enter CMOS setup

Advanced / Peripheral Configuration:
-> Serial Port = Enable
-> Parallel Port Port = Disable
-> Audio = Enable
-> On-board LAN = Enable

Advanced / Internal Chipset Drive Configuration:
-> Configure SATA as = IDE
-> S.M.A.R.T. = Enable

Power:
-> After Power Failure = Power on
-> Wake on LAN from S5 = Power on

Boot
-> Boot to Removable Devices = Enable
-> Boot to Network = Disabled
-> USB Boot = Enable
-> Boot USB Devices First = Enable

Automatically boots a flash imager when inserted.
Local Area Connection: Center of back panel among USB ports.

Auxiliary Connection #1: Sole add-on card.

Auxiliary Connection #2: N/A
Sys9

Jetway NC94-525-LF motherboard
Intel Atom D525 CPU dual-core @ 1.80 GHz (Benchmark 717)
2 GB RAM
3.5" 160 GB Western Digital HDD
Intel Gigabit Dual NIC PCIe Network Interface Card
Insert flash drive in USB port.
Press DEL at bootup to enter CMOS setup.

Advanced BIOS Features
- Hard Disk Drives
 - - Page Down to put SATA:WDC below USB FLASH

Integrated Peripherals
- Onboard SATA Function
 - - SATA Run Mode Configuration = Compatible
- Onboard Super IO Function
 - - Onboard Floppy Controller = Disabled
- PWR Status After PWR Failure = Always On
Local Area Connection: Center of back panel among USB ports.

Auxiliary Connection #1: Port labeled CH1 on add-on card.

Auxiliary Connection #2: Port labeled CH2 on add-on card.


Images

Images are snapshots of a hard drive content that is cloned onto each hardware device to act as the starting point. The images have names of the format <image-class><highest model supported><variant><revision> <company> <date>. For example, "sserv7Rh Ryko 2010-08-05".  The fields are:
The master list of all Site Server images is on the SiteServer page of Intelio's internal wiki.

sserv3 image for Sys3

The Sys3 box is the currently shipping hardware from Ryko. It was forked from Intelio's sserv7h image and is PCI compliant.
Note: The iVisor application's reporting service requires login name "reporting" with password "reporting".

sserv6 image for Sys6

The sserv6 image is obsolete because it is not PCI compliant. Only use sserv7.

The sserv6 image was built for the Sys6 hardware platform. It runs Windows XP Professional, VMware Server (replacing VMplayer on caw images) supporting up to three edge virtual machines. It is otherwise equivalent to the CAW images.

sserv7 image for all models

With sserv7, the image has built rebuilt from the ground up to be PCI compliant. It is backwards compatible to the Sys1 hardware platform, runs Windows Embedded for POS 2009, VMware Server, EPG, ClamWin anti-virus, and auto-logins as a non-administrative user. It may also run all of the normal Ryko Code-a-Wash applications. Radiant Epsilon may be installed on it.

sserv8 image for all models

The sserv8 image has updated drivers to work with the Sys8 platform. It is backwards compatible to the Sys1.

Ethernet Adapters

Every Site Server has a primary Ethernet port around the middle of the back panel, among the USB ports. This is the network uplink port and is shipped set to automatically obtain a dynamic IP address. It may be reconfigured from within Windows, where it is labeled Local Area Connection. There are one or two additional Ethernet adapters, depending on configuration. The following table describes all of the network connections that you will find in Control Panel / Network Connections on a freshly imaged sserv:

Name in Windows
IP Address Netmask Recommended Use
Local Area Connection dynamic
dynamic
uplink
Auxiliary Connection #1 192.168.111.20 255.255.255.0 teller Moxa @ 192.168.111.21
Auxiliary Connection #2 192.168.112.20 255.255.255.0 car wash Moxa @ 192.168.112.21
Intelio VPN dynamic dynamic do not alter
VMware vmnet1 192.168.110.1 255.255.255.0 do not alter
VMware vmnet8 192.168.109.1 255.255.255.0 do not alter

The Auxiliary Connections on the add-on cards and/or USB adapter can used to connect other equipment, such as Moxa nPort serial device servers for carwash communication. By convention, a Moxa for bay 1 should have a last octet of .21, bay 2 should have .22, etc. A network switch may be added to support more than one device. The edge(s) must be configured with the address you choose for the Moxas. You may also just place Moxas on the site's network, along with the Site Server via the primary port, and not use these auxiliary connections.

See Also

   Site Server Flash Imager
   How to configure a new Site Server (sserv)
Adam Fanello

Alerts (Comprehensive list)

Attached below is the official comprehensive list of alert produced by WashMax and details about them.
Each device is listed on a different tab of the spreadsheet.
Adam Fanello

Production of Intelio Marketing Cards

Below are the instructions for a magnetic card producer who wishes to work with Intelio.



The technical details for the cards are straight forward. Cards have a two-track magnetic stripe with normal encoding. The first track contains the letters WP followed by fifteen digits. The second track contains the same fifteen digits. The fifteen digits are also printed on the card for human reading.

The procedure to obtain the exact track data is to send email to [email protected] with the following information:
  1. The WashMax.com or RykoNet.com login name of the customer ordering the cards. No password, we just need their login name so that we can make the cards available in their account.
  2. The number of cards to produce.
You will receive a response with a csv file containing three fields per line:
  1. The card number to print somewhere on the plastic card itself. (fifteen digits)
  2. The data to encode on the first track. (WP followed by fifteen digits)
  3. The data to encode on the second track. (fifteen digits)
A small sample file is attached. We highly recommend that you produce at least one card and send it to Intelio for verification before producing cards en mass for customers. You accept sole responsibility for incorrectly manufactured cards. Send test cards and your contact information to:
Intelio Technologies, Inc.
Attn: Adam Fanello
3185 Airway Ave #D2
Costa Mesa, CA 92626
(949) 567-9950
Note: Do not use Excel! Please open the file in a text editor, not a spreadsheet application. The text must be used exactly as given in the file, and spreadsheet programs try to parse the fields and in doing so often change the data.
Adam Fanello

Carwash Interfaces

How to interface with various car wash makes and models

AUTEC interface with WashMax

The WashMax site controller connects with an AUTEC car wash PLC via an adapter called a PPI MultiMaster. This adapter converts the RS-485 signals used by the car wash's PLCs to RS-232. The RS-232 end may be connected directly to an Intelio Site Server, directly to the serial port or via a Serial Device Server (ex: Moxa nPort 5110).

PPI MultiMaster Switch Settings:

The PPI MultiMaster has eight dip switches on the side. Hold the device so that you can read the labels on the LED. To the left of the dip switches, on the case, it is labelled 1 on top and 0 below.
Set switch #5 up, in the direction of the 1 label on the case. Set all other switches down, in the direction of the 0 label on the case.

Configuration with a Moxa:

For a Moxa nPort 5110, use a null-modem adapter.

Moxa settings:
Set the IP address to something that works on the network. If connected into the Site Server's Auxiliary Connection #2, the car wash's IP is typically 192.168.112.21. Set this same IP in WashMax Onsite.

Configuration via COM1 Serial Port

See How to communicate to car wash through COM1 serial port.
Adam Fanello

Belanger interface with WashMax

Overview

The Belanger Vector and FreeStyler car wash models offer limited capability to report faults to WashMax.
Older WashMax site controller models may connect directly to a Belanger controller via an RS-232 cable. This is out of favor due to limitations however. The favored hardware configuration involves connecting a serial device server, such as a Moxa nPort, to the Belanger controller and to the site's Ethernet network or a Site Server's Auxiliary Connection #2.

Hardware connections

Mount the Moxa nPort near the Belanger controller and connect it to the site's Ethernet network. Use a standard serial cable to connect to Moxa to port ??? on the Belanger controller. Depending on the Belanger controller model, a null-modem adapter may be needed:

Model Null-Modem
Adapter with
nPort DE-311
Null-Modem
Adapter with
nPort 5110
E-300 yes no
E-410 yes no
E-1063 no yes

Serial Device Server configuration

When using a device server, it must be configured as:

Edge Settings

The edge should find the Moxa if it's at one of the normal IP addresses for a Belanger Moxa. (As specified above.) If something else is used, you must edit /home/intelio/conf/site.properties and set belanger.ip.host to the IP address. The edge app must be restarted for it to take effect.
Adam Fanello

Istobal interface with WashMax

Overview

The Istobal M series car wash models offer the capability to report faults to WashMax.

Hardware connections

Mount a serial device server, such as the Moxa nPort, inside the Istobal controller. Connect  it to the site's Ethernet network and to via serial cable to Istobal board A9 connector X9. Depending on the device server used, a null-modem adapter may be needed. (The Moxa nPort DE-311 requires it, the nPort 5110 does not.)

Detailed instructions are in attached at the end of this article.

Serial Device Server configuration

When using a device server, it must be configured as:

Edge Settings

The edge should find the Moxa if it's at one of the normal IP addresses for an Istobal Moxa. (As specified above.) If something else is used, you must edit /home/intelio/conf/site.properties and set istobal.ip.host to the IP address. The edge app must be restarted for it to take effect.

Configure the Istobal Controller

  1. Turn power on to A9 (controller board)
  2. Wait for it to boot up.
  3. Press the 0 button twice.
  4. On the "Enter access code" screen shown, enter 2003.
  5. On the Main menu screen:
  6. Press 7.
  7. The next screen shows: 1 - local connexion, 2 - remote connexion, etc
  8. Press 1.
  9. The next screen shows: 1.1 serie connexion // NOT installed
  10. Press E. The next screen shows 1- printer, 2 - computer, 3 - not installed
  11. Press 2.
  12. To return, press C repeatedly to back up to the top screen.
Adam Fanello

Nu-Star interface with WashMax

Overview

The Nu-Star Comet II model can report a few faults to WashMax via simple relays.

Hardware

The hardware needed is a  Kit 108 I/O Relay Board connected to a Serial Device Server such as the Moxa NPort. These can be mounted in an Activa base along with a network switch.  A diagram at the end of this article shows how to wire the I/O relay board to the Nu-Star PLC.

Serial Device Server configuration

When using a device server (ex: Moxa nPort), it must be configured as:
Adam Fanello

PDQ car wash interface with WashMax

Overview

The PDQ LaserWash, G5, M5, and Tantem car wash models have an optional PC for the PDQ Site Management System. This can send status to Intelio's edge.

Hardware Connections

The PDQ SMS computer must be connected to the same LAN as the Intelio Site Server. It aught to have a static IP address so that it can be found and configure, but this does not appear to be required.

WashMax Server Configuration

Intelio support personnel only: Login to the customer account at www.washmax.com, click on Management, and Edit the site. Set the correct car wash make and model and Save.

Edge (v4) Configuration

Configure the edge eth1 network to a static IP address. (Login as root, and run the command: nw config eth1

Select the correct configuration profile. If you need to reselect, login as intelio and run script/install/select_profile.sh
The correct car wash model must be selected, otherwise the wrong alerts will be generated.

WashMax Onsite (v5) Configuration

Open the web UI, click Configure, and select correct PDQ car wash model for the appropriate bay(s). Then Restart the service.

PDQ SMS Configuration

  1. From the Site Server, open Internet Explorer and enter the IP address of the PDQ server.
  2. Login. owner - 12345, or PDQ Eng - 83340.
  3. Enter the Site Management System setup page. (Click Setup ->SMS links.)
    1. Set the Pulse Time to 10 minutes.
    2. Set the URL to the static IP address for the edge VM (if using one, v4) or the site server (v5).
    3. Set the port to 8790.
    4. Click the Test SMS Server button. You should see a message received in the edge's log.
    5. Upon success:
      • Check the Enable Site Management System checkbox.
      • Click the Submit button.
Adam Fanello

Teller Interfaces

How to interface with various teller models

Activa interface and configuration

The Intelio Activa Virtual Attendant has a dedicated section in this knowledge base. Please read the Activa category for information.
Adam Fanello

Enteract interface and configuration

The Ryko Enteract Virtual Attendant is nearly identical to the Intelio Activa. Most of the information in the Activa category of this knowledge base applies to the Enteract as well. Please reference the Activa category for information about the Enteract.
Adam Fanello

Wash Select II interface and configuration

WashMax can work with the Unitec Wash Select II teller.
The Wash Select II and POS 4000 manuals are attached to the end of this article.

Hardware Interface

Configuration a Moxa:

For a Moxa nPort 5110, use a null-modem adapter.

Moxa settings:
Set the IP address to something that works on the network. If connected into the Site Server's Auxiliary Connection #1, the teller's IP is typically 192.168.111.21. Set this same IP in EPG on the setting's Unitec tab.

Teller Configuration

Setup Generic Terminal Mode with extensions enabled.
Enable "Accept Proprietary".

Works best when washes are defined with the lowest end wash as wash type 1, with prices increasing with higher wash types.
Adam Fanello

Support

Articles for use by support personnel.

Authorize.Net Response Codes

Authorize.Net returns a Response Code and Error Code with each request. Often the tables below will offer more detail than the Error Text that is returned.

(The information below is also available in PDF form at the end of this article.)

Where To Find the Codes?

In the EPG log, a line such as this will be logged:
10:03:52,577 INFO AuthNet: Response: Code=2 Reason=#2 "This transaction has been declined.", Auth Code=, Trans ID=2808425044

Response Codes:


RESPONSE          DESCRIPTION
  CODE
  1                 This transaction has been approved.
  2                 This transaction has been declined.
  3                 There has been an error processing this transaction.
  4                 This transaction is being held for review.

Response and Error Codes:


 RESPONSE       RESPONSE          REASON TEXT                             NOTES
 CODE            ERROR
                 CODE
 1               1               This transaction has been
                                 approved.
 2               2               This transaction has been
                                 declined.
 2               3               This transaction has been          This code indicates a referral response.
                                 declined.
 2               4               This transaction has been          The code returned from the processor indicating
                                 declined.                          that the card used needs to be picked up.
 3               5               A valid amount is required.        The value submitted in the amount field did not
                                                                    pass validation for a number.
 3               6               The credit card number is invalid.
 3               7               The credit card expiration date is The format of the date submitted was incorrect.
                                 invalid.
 3               8               The credit card has expired.
 3               9               This reason code is reserved or
                                 not applicable to this API.
 3               10              This reason code is reserved or
                                 not applicable to this API.
 3               11          A duplicate transaction has been    A transaction with identical amount and credit
                             submitted.                          card information was submitted two minutes
                                                                 prior.
 3               12          An authorization code is required   A transaction that required x_auth_code to be
                             but not present.                    present was submitted without a value.
 3               13          The merchant API login ID is
                             invalid or the account is inactive.
 3               14          This reason code is reserved or
                             not applicable to this API.
 3               15          The transaction ID is invalid.      The transaction ID value is non-numeric or was
                                                                 not present for a transaction that requires it (i.e.,
                                                                 VOID, PRIOR_AUTH_CAPTURE, and CREDIT).
 3               16          The transaction was not found.      The transaction ID sent in was properly formatted
                                                                 but the gateway had no record of the transaction.
 3               17          The merchant does not accept        The merchant was not configured to accept the
                             this type of credit card.           credit card submitted in the transaction.
 3               18          This reason code is reserved or
                             not applicable to this API.
 3               19          An error occurred during
                             processing. Please try again in 5
                             minutes.
 3               20          An error occurred during
                             processing. Please try again in 5
                             minutes.
 3               21          An error occurred during
                             processing. Please try again in 5
                             minutes.
 3               22          An error occurred during
                             processing. Please try again in 5
                             minutes.
 3               23          An error occurred during
                             processing. Please try again in 5
                             minutes.
 3               24          This reason code is reserved or
                             not applicable to this API.
 3               25          An error occurred during
                             processing. Please try again in 5
                             minutes.
 3               26          An error occurred during
                             processing. Please try again in 5
                             minutes.
 2               27          The transaction resulted in an
                             AVS mismatch. The address
                             provided does not match billing
                             address of cardholder.
 2               28          The merchant does not accept        The Merchant ID at the processor was not
                             this type of credit card.           configured to accept this card type.
 2               29          This reason code is reserved or
                             not applicable to this API.
 2               30          The configuration with the
                             processor is invalid. Call
                             Merchant Service Provider.
 2               31          This reason code is reserved or
                             not applicable to this API.
 3               32          This reason code is reserved or
                             not applicable to this API.
3               33          FIELD cannot be left blank.           The word FIELD will be replaced by an actual
                                                                   field name. This error indicates that a field the
                                                                   merchant specified as required was not filled in.
 2               34          The VITAL identification numbers      The merchant was incorrectly set up at the
                             are incorrect. Call Merchant          processor.
                             Service Provider.
 2               35          An error occurred during              The merchant was incorrectly set up at the
                             processing. Call Merchant Service     processor.
                             Provider.
 3               36          The authorization was approved,
                             but settlement failed.
 2               37          The credit card number is invalid.
 2               38          This reason code is reserved or
                             not applicable to this API.
 3               39          The supplied currency code is
                             either invalid, not supported, not
                             allowed for this merchant or
                             doesn’t have an exchange rate.
 3               40          This transaction must be
                             encrypted.
 2               41          This reason code is reserved or
                             not applicable to this API.
 3               42          This reason code is reserved or
                             not applicable to this API.
 3               43          This reason code is reserved or
                             not applicable to this API.
 2               44          This reason code is reserved or
                             not applicable to this API.
 2               45          This reason code is reserved or
                             not applicable to this API.
 3               46          This reason code is reserved or
                             not applicable to this API.
 3               47          The amount requested for              This occurs if the merchant tries to capture funds
                             settlement may not be greater         greater than the amount of the original
                             than the original amount              authorization-only transaction.
                             authorized.
 3               48          This processor does not accept        The merchant attempted to settle for less than
                             partial reversals.                    the originally authorized amount.
 3               49          A transaction amount greater than     The transaction amount submitted was greater
                             $[amount] will not be accepted.       than the maximum amount allowed.
 3               50          This transaction is awaiting          Credits or refunds may only be performed
                             settlement and cannot be              against settled transactions. The transaction
                             refunded.                             against which the credit/refund was submitted
                                                                   has not been settled, so a credit cannot be
                                                                   issued.
 3               51          The sum of all credits against this
                             transaction is greater than the
                             original transaction amount.
 3               52          The transaction was authorized,
                             but the client could not be notified;
                             the transaction will not be settled.
 3               53          This reason code is reserved or
                             not applicable to this API.
 3               54          The referenced transaction does
                             not meet the criteria for issuing a
                             credit.
3               55          The sum of credits against the     The transaction is rejected if the sum of this
                             referenced transaction would       credit and prior credits exceeds the original debit
                             exceed the original debit amount.  amount.
 3               56          This reason code is reserved or
                             not applicable to this API.
 3               57          An error occurred in processing.
                             Please try again in 5 minutes.
 3               58          An error occurred in processing.
                             Please try again in 5 minutes.
 3               59          An error occurred in processing.
                             Please try again in 5 minutes.
 3               60          An error occurred in processing.
                             Please try again in 5 minutes.
 3               61          An error occurred in processing.
                             Please try again in 5 minutes.
 3               62          An error occurred in processing.
                             Please try again in 5 minutes.
 3               63          An error occurred in processing.
                             Please try again in 5 minutes.
 3               64          This reason code is reserved or
                             not applicable to this API.
 2               65          This reason code is reserved or
                             not applicable to this API.
 3               66          This transaction cannot be         The transaction did not meet gateway security
                             accepted for processing.           guidelines.
 3               67          This reason code is reserved or
                             not applicable to this API.
 3               68          The version parameter is invalid.  The value submitted in x_cpversion was invalid.
 3               69          The transaction type is invalid.   The value submitted in x_type was invalid.
 3               70          The transaction method is invalid. The value submitted in x_method was invalid.
 3               71          This reason code is reserved or
                             not applicable to this API.
 3               72          The authorization code is invalid. The value submitted in x_auth_code was more
                                                                than six characters in length.
 3               73          This reason code is reserved or
                             not applicable to this API.
 3               74          The duty amount is invalid.        The value submitted in x_duty failed format
                                                                validation.
 3               75          The freight amount is invalid.     The value submitted in x_freight failed format
                                                                validation.
 3               76          The tax amount is invalid.         The value submitted in x_tax failed format
                                                                validation.
 3               77          This reason code is reserved or
                             not applicable to this API.
 3               78          The Card Code                      The value submitted in x_card_code failed format
                             (CVV2/CVC2/CID) is invalid.        validation.
 3               79          This reason code is reserved or
                             not applicable to this API.
 3               80          This reason code is reserved or
                             not applicable to this API.
 3               81          This reason code is reserved or
                             not applicable to this API.
 3               82          This reason code is reserved or
                             not applicable to this API.
 3               83          This reason code is reserved or
                             not applicable to this API.
 3               84          The device type is invalid.          The value submitted in x_device_type did not
                                                                  match the configured value.
 3               85          The market type is invalid.          The value submitted in x_market_type did not
                                                                  match the configured value.
 3               86          The response format is invalid.      The value submitted in x_response_format was
                                                                  not equal to “0” or “1.”
 3               87          This market type is not supported.
 3               88          The Track1 data is invalid.
 3               89          The Track2 data is invalid.
 3               90          ACH transactions cannot be           ACH transactions cannot be processed by the
                             processed.                           card-present system.
 3               91          This reason code is reserved or
                             not applicable to this API.
 3               92          This reason code is reserved or
                             not applicable to this API.
 3               93          This reason code is reserved or
                             not applicable to this API.
 3               94          This reason code is reserved or
                             not applicable to this API.
 3               95          This reason code is reserved or
                             not applicable to this API.
 3               96          This reason code is reserved or
                             not applicable to this API.
 3               97          This reason code is reserved or
                             not applicable to this API.
 3               98          This reason code is reserved or
                             not applicable to this API.
 3               99          This reason code is reserved or
                             not applicable to this API.
 3               100         This reason code is reserved or
                             not applicable to this API.
 3               101         This reason code is reserved or
                             not applicable to this API.
 3               102         This reason code is reserved or
                             not applicable to this API.
 3               103         This transaction cannot be           A valid fingerprint, transaction key, or password
                             accepted.                            is required for this transaction.
 3               104         This reason code is reserved or
                             not applicable to this API.
 3               105         This reason code is reserved or
                             not applicable to this API.
 3               106         This reason code is reserved or
                             not applicable to this API.
 3               107         This reason code is reserved or
                             not applicable to this API.
 3               108         This reason code is reserved or
                             not applicable to this API.
 3               109         This reason code is reserved or
                             not applicable to this API.
 3               110         This reason code is reserved or
                             not applicable to this API.
 3               111         A valid billing country is required. This code is applicable to Wells Fargo
                                                                                  SM
                                                                  SecureSource merchants only.
 3               112         A valid billing state/province is    This code is applicable to Wells Fargo
                             required.                             SecureSourceSM merchants only.
 3               120         An error occurred during              The system-generated void for the original timed-
                             processing. Please try again.         out transaction failed. (The original transaction
                                                                   timed out while waiting for a response from the
                                                                   authorizer.)
 3               121         An error occurred during              The system-generated void for the original
                             processing. Please try again.         errored transaction failed. (The original
                                                                   transaction experienced a database error.)
 3               122         An error occurred during              The system-generated void for the original
                             processing. Please try again.         errored transaction failed. (The original
                                                                   transaction experienced a processing error.)
 3               123         This account has not been             The transaction request must include the
                             given the permission(s)               API login ID associated with the payment
                             required for this request.            gateway account.
 2               127         The transaction resulted in an        The system-generated void for the original AVS-
                             AVS mismatch. The address             rejected transaction failed.
                             provided does not match billing
                             address of cardholder.
 3               128         This transaction cannot be            The customer’s financial institution does not
                             processed.                            currently allow transactions for this account.
 3               130         This payment gateway account          IFT: The payment gateway account status is
                             has been closed.                      Blacklisted.
 3               131         This transaction cannot be            IFT: The payment gateway account status is
                             accepted at this time.                Suspended-STA.
 3               132         This transaction cannot be            IFT: The payment gateway account status is
                             accepted at this time.                Suspended-Blacklist.
 2               141         This transaction has been             The system-generated void for the original
                             declined.                             FraudScreen-rejected transaction failed.
 2               145         This transaction has been             The system-generated void for the original card
                             declined.                             code-rejected and AVS-rejected transaction
                                                                   failed.
 3               152         The transaction was authorized,       The system-generated void for the original
                             but the client could not be notified; transaction failed. The response for the original
                             the transaction will not be settled. transaction could not be communicated to the
                                                                   client.
 2               165         This transaction has been             The system-generated void for the original card
                             declined.                             code-rejected transaction failed.
 3               170         An error occurred during              Concord EFS – Provisioning at the processor
                             processing. Please contact the        has not been completed.
                             merchant.
 2               171         An error occurred during              Concord EFS – This request is invalid.
                             processing. Please contact the
                             merchant.
 2               172         An error occurred during              Concord EFS – The store ID is invalid.
                             processing. Please contact the
                             merchant.
 3               173         An error occurred during              Concord EFS – The store key is invalid.
                             processing. Please contact the
                             merchant.
 2               174         The transaction type is invalid.      Concord EFS – This transaction type is not
                             Please contact the merchant.          accepted by the processor.
 3               175         The processor does not allow          Concord EFS – This transaction is not allowed.
                             voiding of credits.                   The Concord EFS processing platform does not
                                                                   support voiding credit transactions. Please debit
                                                                   the credit card instead of voiding the credit.
 3               180         An error occurred during              The processor response format is invalid.
                             processing. Please try again.
 3               181         An error occurred during        The system-generated void for the original invalid
                             processing. Please try again.   transaction failed. (The original transaction
                                                             included an invalid processor response format.)
 3               185         This transaction cannot be      Merchant is not configured for VPOS.
                             processed.
 4               193         This reason code is reserved or
                             not applicable to this API.
 2               201         This transaction has been       This error code applies only to merchants on
                             declined.                       FDC Omaha. The expiration date is invalid.
 2               202         This transaction has been       This error code applies only to merchants on
                             declined.                       FDC Omaha. The transaction type is invalid.
 2               203         This transaction has been       This error code applies only to merchants on
                             declined.                       FDC Omaha. The value submitted in the amount
                                                             field is invalid.
 2               204         This transaction has been       This error code applies only to merchants on
                             declined.                       FDC Omaha. The department code is invalid.
 2               205         This transaction has been       This error code applies only to merchants on
                             declined.                       FDC Omaha. The value submitted in the
                                                             merchant number field is invalid.
 2               206         This transaction has been       This error code applies only to merchants on
                             declined.                       FDC Omaha. The merchant is not on file.
 2               207         This transaction has been       This error code applies only to merchants on
                             declined.                       FDC Omaha. The merchant account is closed.
 2               208         This transaction has been       This error code applies only to merchants on
                             declined.                       FDC Omaha. The merchant is not on file.
 2               209         This transaction has been       This error code applies only to merchants on
                             declined.                       FDC Omaha. Communication with the processor
                                                             could not be established.
 2               210         This transaction has been       This error code applies only to merchants on
                             declined.                       FDC Omaha. The merchant type is incorrect.
 2               211         This transaction has been       This error code applies only to merchants on
                             declined.                       FDC Omaha. The cardholder is not on file.
 2               212         This transaction has been       This error code applies only to merchants on
                             declined.                       FDC Omaha. The bank configuration is not on
                                                             file
 2               213         This transaction has been       This error code applies only to merchants on
                             declined.                       FDC Omaha. The merchant assessment code is
                                                             incorrect.
 2               214         This transaction has been       This error code applies only to merchants on
                             declined.                       FDC Omaha. This function is currently
                                                             unavailable.
 2               215         This transaction has been       This error code applies only to merchants on
                             declined.                       FDC Omaha. The encrypted PIN field format is
                                                             invalid.
 2               216         This transaction has been       This error code applies only to merchants on
                             declined.                       FDC Omaha. The ATM term ID is invalid.
 2               217         This transaction has been       This error code applies only to merchants on
                             declined.                       FDC Omaha. This transaction experienced a
                                                             general message format problem.
 2               218         This transaction has been       This error code applies only to merchants on
                             declined.                       FDC Omaha. The PIN block format or PIN
                                                             availability value is invalid.
 2               219         This transaction has been       This error code applies only to merchants on
                             declined.                       FDC Omaha. The ETC void is unmatched.
 2               220         This transaction has been       This error code applies only to merchants on
                               declined.                          FDC Omaha. The primary CPU is not available.
 2               221           This transaction has been          This error code applies only to merchants on
                               declined.                          FDC Omaha. The SE number is invalid.
 2               222           This transaction has been          This error code applies only to merchants on
                               declined.                          FDC Omaha. Duplicate auth request (from
                                                                  INAS).
 2               223           This transaction has been          This error code applies only to merchants on
                               declined.                          FDC Omaha. This transaction experienced an
                                                                  unspecified error.
 2               224           This transaction has been          This error code applies only to merchants on
                               declined.                          FDC Omaha. Please re-enter the transaction.
 3               270           The line item [item number] is     A value submitted in x_line_item for the item
                               invalid.                           referenced is invalid.
 3               271           The number of line items           The number of line items submitted in
                               submitted is not allowed. A        x_line_item exceeds the allowed maximum of 30.
                               maximum of 30 line items can be
                               submitted.
 2               315           The credit card number is invalid. This is a processor-issued decline.
 2               316           The credit card expiration date is This is a processor-issued decline.
                               invalid.
 2               317           The credit card has expired.       This is a processor-issued decline.
 2               318           A duplicate transaction has been   This is a processor-issued decline.
                               submitted.
 2               319           The transaction cannot be found.   This is a processor-issued decline.

Adam Fanello

Configuring WashMax EPG Reports

Reports provided to EPG from a payment processor (currently only Radiant Epsilon) are accessible from customers WashMax.com account, but you have to link each site on WashMax to the Site Server holding the report.

Setup

  1. Login to WashMax.com using the super- variant of the customer's login.
  2. Click on the Management tab.
  3. Click the Edit button next to the site to link.
  4. On the bottom left of the Site Setup screen, ensure that the Entry Device Model selection is correct and ends with "EPG".
  5. Near the bottom right , find the field Electronic Payment Gateway address.
  6. Enter the full domain qualified name or IP address of the Site Server hosting the EPG instance to link to.
Repeat for each site.

Verify

Click the Reports tab, and then Payment Processor Reports below that. Each site should be listed. Select each one and verify that content can be pulled. (The Site Server must be online to access content from it.)
Adam Fanello

Disable Windows Update

If Windows Update is interfering with operation, it can be disabled by ssh'ing into the device and executing the commands:
sc config wuauserv start= disabled
sc stop wuauserv
regtool set '\machine\SOFTWARE\Microsoft\Security Center\UpdatesDisableNotify' 1
This will not only disable updates, but also prevents nagging pop-ups complaining about Windows Update being disabled.

Note: This change technically takes the device out of PCI DSS compliance!

You might also disable other Security Center pop-up notifications:
regtool set '\machine\SOFTWARE\Microsoft\Security Center\AntiVirusDisableNotify' 1
regtool set '\machine\SOFTWARE\Microsoft\Security Center\FirewallDisableNotify' 1
Adam Fanello

How to add owner or manager Windows account to a Site Server

Some car wash owners or store managers want to have their own administrator account on a Site Server, for their own PCI DSS needs. This is permitted upon request.

You can create such an account by either through the Windows UI, or on the command line via ssh.
(This can also be done on an Activa.)

Creating user account with Windows UI:

While logged in as the Administrator user:
  1. Click the Start menu and then click "Control Panel".
  2. Double click on "User Accounts".
  3. Click the "Create a new account" link.
  4. Enter a name for the account, such as "owner", and click the "Next" button.
  5. Select "Computer administrator", if not already, and then click the "Create Account" button.
  6. Click on the new account name.
  7. Click the "Charge the password" link.
  8. Have the owner or manager enter the password and password hint, and then click the "Change Password" button.  The password must be at least seven characters long, and contain at least three of the four classes of characters: lower case letters, upper case letters, digits, and symbols.
  9. Close the windows.

Creating user account on Command-Line:

While logged into Command prompt, Cygwin, or via ssh as the Administrator user, enter:
net user owner 'ChangeMe!' /ADD
net localgroup administrators owner /ADD
The user name owner may be different if desired. The password may be different, but must be at least seven characters long, and contain at least three of the four classes of characters: lower case letters, upper case letters, digits, and symbols.
Adam Fanello

How to adjust Activa display brightness and contrast

  1. Exit the application, to the O/S.
  2. Right click on the Intel Extreme Graphics icon on the task bar. (Blue trapezoid on the far right.)
  3. Click on Graphics Properties.
  4. Click on the Color Correction tab.
  5. Adjust the settings as desired, clicking the Apply button to see the result.
  6. Click OK when done.
Adam Fanello

How to clear a stuck Belanger alert

Most alerts from the Balanger car wash can be cleared by simulating the clear button being pressed on the controller.

Log into the edge with the intelio account and enter:

  echo "AlertEvent input=255 sourcePrefix=belanger.fault" | script/driverClient.sh

That final command (s status) will show the application status, including any alerts that remain.


How To Configure a Windows Computer for Remote Management

Introduction

Some select Intelio partners are granted limited access to Intelio support capabilities. These include the Support Operations Center and remote management of Activas (teller nodes), Site Controllers (caw nodes), and Site Servers (sserv nodes) through the Intelio VPN using VNC.

These instructions describe how to configure a Windows XP or Windows Vista computer for access to these systems.

Software Setup

VPN Setup

Download and install the latest release from OpenVPN.net. Select the Windows Service option during installation if you want the computer to be connected to the VPN all the time.

You will have received a VPN key zip file from Intelio. Double-click on this file, and the folder inside of it to show the files. Copy all of the files to C:\Program Files\OpenVPN\config\

Use OpenVPN GUI to start the VPN. (Must run as Administrator in Windows Vista and Windows 7.)  [Details needed.]

VNC Setup

Download and install the RealVNC from RealVNC's website. (Any other VNC client may also be used, but .bat file for VNC links would need to be modified.) You do not need to install or setup the VNC Server component; only the viewer is necessary.

If you are using RealVNC and wish to be able to click on web links to launch VNC Viewer, then download the .zip file for your O/S version attached to the end of this article:
  1. Copy all the files in the .zip to the C:\Program Files\RealVNC\ folder on your computer
  2. Double-click on  Register-VNC-protocol.reg to register the VNC protocol handler.

Support Operations Center

Open your preferred web browser (i.e. Internet Explorer) and enter the Address: https://support.intelio.com:8443/soc/index.jsp. Add this page to your favorites (bookmark it).

Use the login name and password provided to you. If this is your first time logging in, the system will ask you to set a permanent password.

On each site's Status page, the Network block will have a VNC link for the teller, caw, and sserv nodes. Click on this link and enter the password when prompted. You will see the same thing that is showing on the local screen (although not as colorful). Any action that you take will be seen on the site.

VNC Tips

To disconnect, simply close the VNC window. The remote computer will continue running as you left it.
Adam Fanello

How to Register a Jabber/XMMP account.

First step, download the free chat program called Pidgin. It works on Windows,Linux and MAC. The great thing about Pidgin is that it also works with Yahoo Chat and MSN Messenger so you can login to many chat systems at the same time.

Download - Windows - http://sourceforge.net/projects/pidgin/files/Pidgin/2.7.11/pidgin-2.7.11.exe

After you have installed Pidgin, launch the program and go to the following option on the main menu: Accounts > Add/Edit. You can also use the keyboard shortcut Ctrl-a to add a new chat account.

Here is what the screen looks like in Linux:



The important settings are:
Protocol: XMPP (same as "Jabber")
Screen name: [you choose]
Domain: im.washmax.com
Resource: n/a
Password: [you choose]
Create this new account on the server? [check this box]


After you click the "Save" button. Within a few seconds you should get a message like the one below confirming that you want to create the Jabber account:



Click the "Register" button to confirm, and you should see a message like the following one:

How to reset VNC password

If VNCing into a remote Windows computer fails due to bad authentication, then someone may have changed the password.

Regaining remote access. (AKA, Hacking VNC)

If you can't VNC in but can ssh, then you're set. SSH into the computer and then run the following commands to turn off authentication and restart VNC Server:

regtool set '\machine\SOFTWARE\RealVNC\WinVNC4\SecurityTypes' None
net stop WinVNC4
net start WinVNC4

Now VNC in; you will not be prompted for a password.

Resetting the password

  1. Press the Windows key to pop up the toolbar.
  2. Right-click on the VNC icon in the tools bar.
  3. Select Options... on the pop-up menu.
  4. Select VNC Password Authentication (if not already selected)
  5. Click on the Configure button.
  6. Enter the new password in both fields.
    • BE VERY CAREFUL! If you make a typo, you won't be able to get back in!
  7. Click the OK button.
  8. Click the OK button.
Adam Fanello

Networking

Networking Questions and Answers

Activa or CAW not using VPN DNS

Under some circumstances Microsoft Windows will continue to use your primary connection's DNS server. This is first noticeable when the teller or caw is online, but not reporting to the SOC.  From the command-line, run ping soc to see what it is resolving to. If it does not resolve to the correct server, then follow the directions below to force it to use the Intelio VPN's DNS server.

Correct VPN DNS IP addresses for each VPN segment:


IntelioEdge 172.16.1.254
Sheetz 172.16.1.254
SegmentTen 10.16.1.254


  1. Open the Control Panel.
  2. Double-click on Network Connections.
  3. Right-click on Intelio VPN.
  4. Left-click on Properties.
  5. Scroll Internet Protocol (TCP/IP), left-click it, then click on the Properties button.
  6. Click the radio button next to Use the following DNS server addresses.
  7. Enter the IP address from the table above into the Preferred DNS server field.
  8. Click the OK button, click the next OK button, and close the Network Connections window.
The effect should be immediate.
Adam Fanello

Internet Service Q&A

Intelio products and services require an always-on secure connection to the Internet from your car wash locations. There are several options, and this article provides some guidance in the form of questions and answers.

Why is Internet access required?

The Internet connection is used to:
  • Process credit cards.
  • Report wash activity and status. (For WashMax Maintain, Manage, and Market products.)
  • Process marketing programs. (For WashMax Market.)
  • Provide software updates with security patches, bug fixes, and new features. This help you meet your PCI-DSS compliance requirements.
  • Provide technical support. Our technicians can remotely assist you and fix problems.

Is it secure?

Yes! Each Intelio provided computer has a unique key that it uses to connect to our Virtual Private Network (VPN) over an encrypted connection. Each system can only communicate with our servers, which are also secured, and not other locations. Our servers and network meets or exceeds all PCI requirements.

Please see the WashMax PCI Implementation Guide for details on how to implement your car wash site in a secure, compliant way.

Can I use a DSL connection?

Yes, this is the most popular option. Any speed DSL line will do, although a faster connection will allow for quicker software updates and technical support. The line may be "dry", meaning that it only includes Internet access and not a phone line.

Make sure that you receive or buy a quality DSL modem. Some low-end modems are not reliable and you'll find yourself frequently having to reset them to restore service. You do not need a static IP address, although there is no harm if that is the only option. Whether dynamic or static though, the public IP may only be held by the router and not be assigned to equipment. PCI-DSS compliance requires that a hardware firewall be used, including placing of all devices on a Local Area Network (LAN) behind a router.

Can I use a cable connection?

Yes, this is an excellent option due to it's high bandwidth and reliability. You do not need any special options like a business line or static IPs. However, you must add a network router behind the cable modem to provide a secure Local Area Network (LAN) for the equipment.

Can I use a satellite connection?

Yes, although this is not the optimal choice. Satellite Internet has a high latency and low upstream bandwidth, which makes for slow credit card processing and technical support services. Satellite dishes are also easily knocked out of alignment by weather, causing loss of service. That said, several Intelio customers do successfully use satellite services 

Can I use Hughes Satellite service?

Hughes Satellite internet services block Intelio's VPN, and so have to be dealt with differently. Instead of the Intelio equipment connecting to Intelio's network, our servers must connect to your Hughes provided network. This requires that you provide Intelio with a special network client hardware device (similar to the one in your stores) to be installed in our server farm. Due to the complexity, overhead, and cost of this solution, it is subject to a minimum order with Intelio. Please consult with your sales representative.

Can I use a cellular data connection?

Yes, although it is sometimes tricky to make it work reliably. You must use a cellular router, which provides a Local Area Connection (LAN) behind the cellular data connection. A simple USB device intended for a single computer is not acceptable, as it does not provide a hardware firewall (routers have built-in firewalls). A cellular hot-spot (Wi-Fi) is also unacceptable due to weaker security of Wi-Fi.

That said, a cellular data router, in a location with a strong signal and an unlimited data plan, is a workable option. If you suffer from frequent loss of service or long credit card authorization delays, you may need to explore another option. Technical support may also be a frustrating experience due to the low bandwidth of most cellular plans.

Can I use a dial-up connection?

Although Intelio strongly recommends a broadband (DSL or cable) connection, this is simply not available in some rural locations. What is truly required is an always-on connection that multiple systems can use (router) and firewall. This can be achieved with a dial-up connection (still available throughout the U.S. from Earthlink, AT&T, and a few others) and a 3Com OfficeConnect 56k LAN Modem (model 3C886A-US). Other hardware may also be available, but this 3Com model is known to work with Intelio's network.

Can I share my Internet connection with other equipment?

Yes, but please make sure that you have sufficient bandwidth with your service to run all the equipment that you have on it, and ensure that you are not compromising the security of your network. Sharing with the store manager's office computer is generally fine, as this system is physically secure and bandwidth use is low. Sharing with a public Wi-Fi for customers is not an option, as this compromises the security of your network and makes it not PCI-DSS compliant.

A popular device, which sometimes causes trouble, is a video security system. These are also called DVRs, although unlike the DVR on your home TV, it records from security cameras. These can share an Internet connection with Intelio equipment, provided that you have a high-bandwidth connection. Often times people will stream video from a store's DVR over a low-speed DSL connection. This will use up all available bandwidth leaving nothing for your car wash operations. Tips:

  • Check with your DVR and Internet providers; ensure that the maximum bandwidth used when streaming video is well less than the the guaranteed minimum level of service of your Internet connection.
  • Place your car wash related devices on their own router, connected to the store's main router. This ensures that the car wash devices can communicate with each other without competing with DVR data.
Adam Fanello

Updating Distributor VPN key with IP for new Data Center

Intelio has moved servers to a new data center. In order to connect to the Intelio VPN, you must modify the key on your computer.

Short instructions:

Edit the file C:\Program Files\OpenVPN\config\*.ovpn. Find 64.79.169.197 and change it to 209.11.249.195.

Long instructions:
  1. Click on the START button and then click My Computer.
  2. Double-click on the C: drive.
  3. Double-click on the Program Files folder.
  4. Double-click on the OpenVPN folder.
  5. Double-click on the config folder.
  6. Right-click on the file OpenVPN Config File (your name.ovpn)
    1. Select Open With...
    2. Click on WordPad.
      1. If WordPad isn't shown, click on Choose Program and select WordPad from there.
  7. On the 7th line, you'll find the line starting with "remote 64.79.169.197".
    1. Change the numbers to 209.11.249.195. Leave "remote" and the number at the end of the line in place.
  8. Close WordPad and save the change.
Restart your OpenVPN connection. On some systems, you may need to reboot your computer.
Note for Windows Vista/7:

You may not be able to save the changes in place with WordPad. In this case, drag the *.ovpn file to the desktop, edit it there, and then drag it back to the OpenVPN\config folder.
Adam Fanello

Updating node VPN key with IP for new Data Center

Intelio moved servers to a new data center on July 11, 2011. Any system that was offline for the few days leading up to the migration does not have the new IP needed to connect to the Intelio VPN, you must modify by someone on site.

Short instructions:

Edit the file C:\Program Files\OpenVPN\config\*.ovpn. Find 64.79.169.197 and change it to 209.11.249.195.

Long instructions:

  1. Click on the START button and then click My Computer.
  2. Double-click on the C: drive.
  3. Double-click on the Program Files folder.
  4. Double-click on the OpenVPN folder.
  5. Double-click on the config folder.
  6. Right-click on the file OpenVPN Config File (<node name>.ovpn or <node-type>_configme.ovpn)
    1. Select Open With...
    2. Click on WordPad.
      1. If WordPad isn't shown, click on Choose Program and select WordPad from there.
  7. On the 7th line, you'll find the line starting with "remote 64.79.169.197".
    1. Change the numbers to 209.11.249.195. Leave "remote" and the number at the end of the line in place.
  8. Close WordPad and save the change.
Restart the OpenVPN connection by rebooting or restarting the Windows Service.

To restart the OpenVPN service:
  1. Click on the START button and then click Control Panel.
  2. Double click on Administration Tools.
  3. Double click on Services.
  4. Scroll down and click on the OpenVPN Service line.
  5. Click the Restart button on the control panel. (Looks like a square followed by a triangle.)
 
Adam Fanello

What IP and port do I need to allow my firewall to route for Intelio products?

All Intelio products deployed to customer sites communicate with Intelio servers via a VPN tunneled through the Internet. In order to do this, they need to be connected to an IP network that has access to the VPN server. The connection is always established from the car wash site to the VPN server; no inbound connections are used.

Simply put, the car wash site's network needs access to:
Additionally, sites that use Intelio to process credit cards need to have access to the credit card processing gateway or host. The most common gateway is Authorize.Net. In this case, the network also needs access to:

More Details:


Source: Intelio node
Destination: 209.11.249.195
Port: 2372
Protocol: UDP
Reason: OpenVPN connection for 172.18.x.x network.

Source: Intelio node
Destination: 209.11.249.195
Port: 2373
Protocol: UDP
Reason: OpenVPN connection for 172.19.x.x network.

Source: Intelio node
Destination: 209.11.249.195
Port: 2374
Protocol: UDP
Reason: OpenVPN connection for initial configuration (172.30.x.x)

Source: Intelio node
Destination: 209.11.249.195
Port: 2375
Protocol: UDP
Reason: OpenVPN connection for 10.0.x.x network. (For customers that use a 172.x.x.x network internally.)

Source: Intelio node
Destination: Credit Card Authorizer - 64.94.118.65 for Authorize.net
Port: 443
Protocol: SSL/HTTP (aka:https)
Reason: Processing credit cards.

Adam Fanello

Powered by KnowledgeBuilder