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:
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
At the Activa, log in to maintenance mode.
Touch the screen.
Touch the Skip button to skip the greeting video, or wait for it.
Touch the Code button.
Enter the code: #2723*
Enter your user name and password, and touch the Login button.
From the Maintenance Menu, touch the System Setups button.
Touch the Software Setups button.
Touch the Escrow Video tab.
From here, either:
select a different video to play to the customer while waiting for the car wash, or
touch the green Play Video - ENABLED so that it turns red and shows Play Video - DISABLED.
Touch the Accept button.
On the System Setups Menu, touch the Close button.
On the Maintenance Menu, touch the Close button.
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:
Wash packages are priced from low to high. (Package #1 is the cheapest wash.)
Cash and/or credit card handling is enabled.
Upgrade option is enabled. (Software Settings screen, Options tab.)
The wash code used has identical arming bits to one of the wash packages in the Activa.
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:
Q Tips (lint free is a MUST)
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.
The card reader has been disabled in the application.
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
Log into the Activa maintenance mode
From the Idle screen:
Proceed forward to enter a code.
Enter the code #2723*
Log in.
From the Carwash Is Closed screen:
Double-click the top left corner of the screen.
Log in.
Click the System Setups button.
Click the Hardware Setups button.
Ensure that the Reader Type is set to Credit Card (UIC) and that the button to the right shows ENABLED.
Click the Accept button.
Click the Close button on each of the next two screens to return to the idle screen.
Set the Card Reader Driver COM Port
This procedure is difficult to perform without a mouse.
Exit to the Operating System
Log into the Activa maintenance mode
From the Idle screen:
Proceed forward to enter a code.
Enter the code #2723*
Log in.
From the Carwash Is Closed screen:
Double-click the top left corner of the screen.
Log in.
Click the System Setups button.
Click the Exit To Boot App button.
Click the Exit To OS button.
Open the Control Panel
Click on the START menu on the lower-left of the screen.
Click on Control Panel.
Double-click the Systems icon. (You may need to scroll down to it.)
Click the Hardware tab.
Click the Device Manager button.
Click the plus sign to the right of Ports (COM & LPT) to expand the list.
If the line that reads MSR280 Card Reader (COM7) shows a number other than COM7, then proceed:
Double-click on the line.
Click the Port Settings tab.
Click the Advanced button.
Set COM Port Number to COM7.
A dialog will likely pop up indicating that the COM port is being used by another device.
Click the Yes button.
Click the OK button.
Close the Device Manager window.
Click the OK button on System Properties.
Close the Control Panel.
Double-click on the CbxBoot icon on the desktop.
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.
Switch 1: set to MAX
Switch 2: set to NO
Switch 3: set to 25ms
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.
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
Exit the application, to the O/S.
Right click on the Intel Extreme Graphics icon on the task bar. (Blue trapezoid on the far right.)
Click on Graphics Properties.
Click on the Color Correction tab.
Adjust the settings as desired, clicking the Apply button to see the result.
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:
Verify with tech on site. VNC in and watch the person physical try and command the touch.
Reboot the Panel PC. If this does resolve the problem, continue to the next step...
Exit or kill the the Activa and Boot applications.
You can exit by clicking through the normal buttons, login, System Setups, Exit to Boot App, Exit to OS.
You can kill the apps by pressing the Windows key and clicking the Kill Activa icon next to the START button.
Double-click the Touch Kit icon on the desktop.
Have the tech conduct a draw test first to determine how the calibration is. Click the Quit button to exit.
Click the Hardware tab and then the Hardware Settings button.
Click the Reset all of the control parameters to factory default button. This will take several seconds to complete.
Click the Tools tab and then the Clear and Calibrate button. This will automatically take you to the 4 point calibration.
Have the tech follow the calibration instructions. Once the 4 point is complete, have tech do a draw test.
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.
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.
Close or kill Activa.exe.
Close or kill CbxBoot.exe
Press the Start menu and click on Run.... Enter (including quotes): "C:\Program Files\Ryko\Activa\CbxBoot.exe" /menu
Click the Repair Database button.
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.
Close or kill Activa.exe.
Close or kill CbxBoot.exe
Open Windows Explorer. (AKA: My Computer.)
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.)
Navigate to C:\Program File\Ryko\Activa\Data.
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.)
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...)
Copy the two files from the Database.zip window into the SQL DataBases directory.
Close the windows.
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.
Download the Database.zip backup file from the SOC.
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.)
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.
Open Internet Explorer on the Activa.
Go to the Intelio Software Repository. (http://repository/repo/) - you should know the login & password.
Click on the Activa folder.
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.
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.
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:
Controller Power Off The Controller Power signal is also called “Control Power Input”, “fault”, or “trouble” by various car washes. Select this option if the absence of this signal from the car wash indicates that it is out of service. (This is the recommended setting.)
Controller Power On As with above, but in this case an active signal from the car wash indicates that it is out of service. This is often called a “fault” signal from the car wash.
Busy Signal Blink Some car washes don't have a separate fault signal, but instead generate a pattern on the wash busy (or in-use) signal of off, on, off, and stay-on in one second transitions. The signal then remains on until the fault condition clears.
Busy Signal Blink or Power Off Combination option. The busy signal blink indicates a fault, while a signal must be received on the Controller Power input to indicate that the car wash is turned on.
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.
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
If the site's network is actively managed by the operator, then request an IP address to use.
Check the router's DHCP settings. Choose an IP in the same subnet but outside of the range used by DHCP.
Do not assign the computer to statically use the IP that it was given dynamically! The router could give that IP to another device, resulting in a conflict.
Ping the IP that you plan to use, to ensure that nothing is already there.
Setting a Static IP on Windows XP
Ao the selected server computer:
Bring up the Control Panel.
Double click on Network Connections.
Scroll the window sideways and identify the connection with a Device Name of RealTec.
Right-click on the connection and select Properties.
Scroll down on the item list to Internet Protocol (TCP/IP), and double-click on it.
Click on the bubble to the left of Use the following IP address.
Fill in the IP address (which you choose), Subnet mask (usually 255.255.255.0), and Default gateway (the nearest router).
Fill in the Preferred DNS server. Use the router address again if you don't know of any other.
Click on the OK button. (If you are running this remotely, you will be disconnect and need to VNC back in after some delay.)
Click on the next OK button.
Configure the non-server device
If you selected the Site Controller as the server computer, then the Activa must now be configured to use it as the server. See the next section. Otherwise, the section after the next describes how to configure the Site Controller to use the Virtual Attendant as the server.
Configure the Activa Virtual Attendant to use the Site Controller as the server
Log in to the Activa maintenance mode.
Go to the RykoNet tab by:
Touch the System Setups button.
Touch the Software Setups button.
Touch the RykoNet tab.
Use a keyboard (real or on screen by pressing the ABC button) to change the Connect To field to the static IP of the Site Controller.
Touch the Accept button.
Touch the Close buttons until the system returns to the idle screen.
Configure the Site Controller to use the Virtual Attendant as the server
Configuring the Site Controller requires changes in three places, including editing files on the file system. It is not for the non-technical.
From the main application screen, touch the Setup Menu button.
If the Setup Menu button is grayed out, you will need to Login first.
Touch the RykoNet button.
Touch the Setup tab.
Use a keyboard (real or on screen by pressing the ABC button) to change the Connection field to the static IP of the Virtual Attendant.
Touch the Accept button.
Hold down the Windows key (it looks like a four-sectioned waving flag), press the e key, and then release the Windows key.
Windows Explorer should appear, showing My Computer.
Stop the EPI Server and WashTrax:
In the notification area on the bottom right of the screen, next to the clock, are small icons of programs running.
EPI Server looks like a red notebook with a hand holding a pen.
Right click on the EPI Server icon and click on Exit.
WashTrax looks like a blue-handled magnifying glass over two tire tracks.
Right click on the WashTrax icon and click on Exit.
Use the tree view on the left pane to navigate to C:\Program Files\Ryko\EPI Server\Setups
Right click on the EPIServerSettingns.xml file, and click on Edit.
Find the part that says <RykoNetHost>localhost</RykoNetHost> and change the localhost part to the static IP of the Virtual Attendant.
Save the file and exit Notepad.
Use the tree view on the left pane to navigate to C:\Program Files\Ryko\WashTrax
Double-click on the WashTrax.ini file.
On the ninth line it says Host=localhost . Change the localhost part to the static IP of the Virtual Attendant.
Save the file and exit Notepad.
Close the Windows Explorer window.
You should be returned to the Setup Menu.
Touch the red Exit button.
On the next screen, touch the green Start button.
Adam Fanello
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
Exit the application, to the O/S.
Right click on the Intel Extreme Graphics icon on the task bar. (Blue trapezoid on the far right.)
Click on Graphics Properties.
Click on the Color Correction tab.
Adjust the settings as desired, clicking the Apply button to see the result.
To use $1 coins in the Activa coin dispenser, rather than quarters, you must change settings in two different places.
On the Activa,
Login to Maintenance mode.
Touch the System Setups button.
Touch the Hardware Setups button.
Touch the Coin Dispenser tab.
Enter 1.00 in the Coin Value field.
Touch Accept.
In the Code-a-Wash application on the Site Controller:
Login to the Code-a-Wash application.
Touch the Setup Menu button.
Touch the Coinbox button.
Touch the Currency tab.
Set Change Value to 1.00.
Adam Fanello
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:
Log into your Activa and touch System Setups followed by Exit to Boot App.
Touch Exit to OS.
Copy the video files(s) from a flash drive or web site to C:\Program Files\Ryko\Activa\MPEG2\English\
Close all windows and double-tap CbxBoot on the desktop.
Log into your Activa and touch System Setups followed by Software Setups.
Touch the Escrow Video tab.
Touch the Play Video button as needed so that it reads ENABLED.
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.
Select your video file from the list on the right.
Touch the Accept button.
Touch the Close button.
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:
Rename your local copy of the video files to something no more than roughly 25 characters in length.
scp the video files(s) to the teller.
ssh into the teller.
mv the video file(s) to /cygdrive/c/Program\ Files/Ryko/Activa/MPEG2/English/
Copy and paste the following command-line, replacing filename.wmv with the actual video file name to use:
osql -U sa -P rykosa -d Coinbox -Q "UPDATE TAB_Setups SET EscrowVideoName='filename.wmv',PlayVideoInEscrow=1 "
If you want the video to play repeatedly until the car wash is ready, copy and paste the following command-line:
osql -U sa -P rykosa -d Coinbox -Q "UPDATE TAB_Setups SET LoopEscrowVideo=1"
If you want the video to play only once while waiting for the car wash, copy and paste the following command-line:
osql -U sa -P rykosa -d Coinbox -Q "UPDATE TAB_Setups SET LoopEscrowVideo=0"
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:
Offer a one-time use discount to customers who return soon.
Setup a Tracking program with a discount on one or more wash packages.
Set the Total Use limit to 1. (Or more!)
Provide a loyalty code.
Setup a Tracking program that offers a free wash after x purchases with the code.
Set the Total Use limit to x + 1, so that the code only works for one free wash in the end.
Provide a donation to a charity when customers return soon.
Setup a Tracking program with a donation on one or more wash packages.
Set the Total Use limit as desired.
Buy one, get one free.
Setup a Prepaid Wash program with a single wash package designated.
Set the Total Use limit to 1.
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.
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:
The other options are:
Minimum Purchase
Codes will only be issued to customers who purchase a wash with cash, credit, WashMax Value card, or a wash code whose value is at least this amount.
Set it to at least $1.00 to prevent issuing codes to customers who are receiving a free wash. (This includes those redeeming other Marketing programs.)
Set it higher to only issue a code to customers who choose higher value washes.
Days until code Expires
Every code issued with the Frequency Code feature is assigned an expiration date this many days beyond the current day.
The code is good until the end of the expiration date. This date will be printed on the code receipt.
Use the up/down arrows to select any number between 1 and 93.
Odds of Receiving
Set this to 100% to issue the code to all qualifying customers.
Lower the odds to randomly issue the code.
An example is to set this to 20% and pair it with a Prepaid Wash program to run a "One out of five gets a free Works wash!" promotion.
Code Length
The code issued may be between 4 and 8 digits long.
Shorter codes are easier for customers to enter, but if you issue many codes and/or they have long expiration periods, it can become easy to randomly enter short codes and find a valid one.
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.
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:
Controller Power Off The Controller Power signal is also called “Control Power Input”, “fault”, or “trouble” by various car washes. Select this option if the absence of this signal from the car wash indicates that it is out of service. (This is the recommended setting.)
Controller Power On As with above, but in this case an active signal from the car wash indicates that it is out of service. This is often called a “fault” signal from the car wash.
Busy Signal Blink Some car washes don't have a separate fault signal, but instead generate a pattern on the wash busy (or in-use) signal of off, on, off, and stay-on in one second transitions. The signal then remains on until the fault condition clears.
Busy Signal Blink or Power Off Combination option. The busy signal blink indicates a fault, while a signal must be received on the Controller Power input to indicate that the car wash is turned on.
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.
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:
Set "Out-Of-Service when" to "Busy Signal Blink or Power Off"
Set "Time to hold Arming Signal" to "5 mins" (recommended). As little as "2 secs" will work.
Set "Time to wait for wash to begin" to "5 mins"
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:
Set "Out-Of-Service when" to "Busy Signal Blink or Power Off"
Set "Time to hold Arming Signal" to "15 mins".
Set "Time to wait for wash to begin" to "15 mins"
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:
Set "Out-Of-Service when" to "Busy Signal Blink or Power Off"
Set "Time to hold Arming Signal" to "15 mins".
Set "Time to wait for wash to begin" to "15 mins"
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:
Set "Out-Of-Service when" to "Controller Power Off"
Set "Time to hold Arming Signal" to "15 mins".
Set "Time to wait for wash to begin" to "15 mins"
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:
Set "Out-Of-Service when" to "Controller Power Off"
Set "Time to hold Arming Signal" to "4 secs".
Set "Time to wait for wash to begin" to "15 mins"
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:
set module 60 (Entry System), parameter 13 to 002 - Wash in use - Extended - Unitec
set module 70 (Special Function Menu), parameter 9 to 104 - Off when fault.
Activa Direct Settings
In Activa Direct:
Set "Out-Of-Service when" to "Busy Signal Blink or Power Off"
Set "Time to hold Arming Signal" to "15 minutes".
Set "Time to wait for wash to begin" to "15 minutes"
Adam Fanello
Nu-Star car wash interface
Use Activa Direct Arming for Nu-Star car washes.
Activa Direct Settings
In Activa Direct:
Set "Out-Of-Service when" to "Control Power Off"
Set "Out-Of-Service delay" to "10 secs"
Set "Time to hold Arming Signal" to "3 secs".
Set "Time to wait for wash to begin" to "4 mins"
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.
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:
Belden 8760 (top choice)
Belden 9318
Belden 88760
Carol C2521
Carol C2534
Alpha 2421C
Manhattan 13242
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:
Q Tips (lint free is a MUST)
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.
Switch 1: set to MAX
Switch 2: set to NO
Switch 3: set to 25ms
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.
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:
An operational Activa with an ICT A6 bill acceptor.
An ICT FP-001 Programmer, preprogrammed with firmware.
A WEL-RM009-K download line. (Black wire with RJ-45 connector on either end.)
Procedure:
Log in to the Activa maintenance mode. Any account with general Diagnostics access should work.
Go to the Outputs/Relays screen by:
Touch the Diagnostics button.
Touch the Sensors/Relays button.
Touch the Outputs/Relays tab.
If the Bill Acceptor Power button is red, touch it so that it turns green.
Prepare the programmer.
Set the switches to L1 and Normal.
Connect the ICT FP-001 Programmer to the Bill Acceptor by:
Disconnect the gray cable with the RJ-45 connection from the side of the bill acceptor.
It is on the side next to the coin acceptor. If you cannot reach in and squeeze the release tab on the far side, you may need to unmount the bill acceptor. Be sure to leave the wires connected and support the device.
Plug one end of the WEL-RM009-K wire to the programmer, and the other into the vacated port on the side of the bill acceptor.
On the programmer, the L1 light should be solid green, the L4 light should blink green.
If it is not, disconnect the cable. Check the switch settings, and try again.
Install the new programming on the bill acceptor by:
Click the Browse button and navigate to where you extracted the driver and down to the TG02-driver\Driver\TG02\Tg02.inf file.
Click the Open button.
Click the OK button.
Click on the printer Custom TG02 and then click the Next button.
Click the Next button.
Click the Next button.
Click the Next button.
Click the Finish button.
Click the Continue Anyway button.
If it requests additional files from the Windows XP CD-ROM...
Click the Browse button.
Navigate to where you extracted the driver and down to the TG02-driver\Microsoft directory, where you will find these files.
You may need to do this a few times for various files.
Set the baud rate:
Right click on Custom TG02 in the Printers and Faxes window, and click on Properties.
Click on the Ports tab.
Click the Configure Port button.
Set the Bits per second to 38400.
Click the OK button.
Click the Close button.
Configure the application:
The Activa must be running v2.0.10.0 or greater.
Close all windows.
Double-click CbxBoot on the desktop.
Log into Maintenance mode.
Touch System Setups.
Touch Hardware Setups.
Touch the Printer tab.
Select Printer Type of TG02 (Custom) and ensure that it is Enabled.
Touch Accept.
Touch Close.
Touch Close.
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.)
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:
Auxiliary Connection 1 is located nearest the primary port and is preconfigured to IP 192.168.111.20.
Auxiliary Connection 2 is located nearest the outer edge of the box and is preconfigured to IP 192.168.112.20.
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).
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
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:
<image-class> is usually sserv for a Site Server, although Sheetz's is cws, which stands for Car Wash Server.
<highest model support> the highest hardware model number that the image works on. Images are usually backwards compatible.
<variant> is optional. If none is given, then the image is Intelio's baseline. "R" is used for Ryko Code-a-Wash, "S" is Ryko iServer.
<revision> each time the image is updated, the image letter is increased.
<company> is the company that produces the image.
<date> is the date that this revision was released.
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.
How to configure the applications that run on Site Servers and Controllers.
EPG Installation and User Manual
Introduction
The Electronic Payment Gateway (EPG) is a program that runs on a Site Server (sserv7 image) and handles the interfaces with tellers and payment processors. It also reports status of these tellers and Ryko car washes on the General Intelio Interoperability Protocol (GIIP) for systems that wish to monitor and report activity.
Supported tellers:
Intelio Activa Virtual Attendant
Ryko AMTT coinbox
Ryko AMTT-CS coinbox
Ryko Enteract Virtual Attendant
Ryko Bay Pay
Ryko Touch-n-Go
Unitec Wash Select II
Supported payment processors:
Authorize.Net
Radiant Epsilon
WashMax Market
EPG is a replacement for non-PCI compliant EPI Server application.
Installation and Startup
EPG should operate on any Windows XP based system. However, it's only supported by Intelio as pre-installed on an Intelio Site Server. See the Application Configuration section at How to configure a new Site Server for details.
Taskbar Icon and Menu
When running, EPG has an icon in the Windows taskbar notification area that looks like this: Right click on it for a menu of windows and actions:
Status displays the Status window showing current status of the system.
Settings displays the Settings window which allows you to configure EPG.
About displays version and copyright information.
Exit shuts down the EPG application.
Status Window
The Electronic Payment Gateway Status window shows the current state of things in EPG. It may be brought up from the taskbar icon menu, or it may be displayed full screen on a Site Server that is configured solely as a Payment Gateway system (via CAW Booter configuration profile).
Items that may be appear in the status:
HTTP Server
EPG has a reports interface via the HTTP protocol. When it is being accessed, connections will be shown under this heading.
GIIP Server
EPG includes a General Intelio Interoperability Protocol server used for communication on this protocol. Connections to this server are shown below this heading.
EPI Server
EPI is the interface with Ryko and Intelio tellers. A connection with one of these tellers will appear under this heading. The connection will show an icon indicating the type of device and whether it is currently communicating or not (crossed out icon).
Unitec Tellers
If configured, this heading will appear with a line below it for each wash bay. The icon and text indicate the current state of the Wash Select II.
Authorize.Net Payment Processor
If configured, this heading will appear. The icon color and text below it indicate the state of the communication with Authorize.Net.
Intelio GIIP Payment Processor
If an Intelio edge VM is running, it will appear here as well as under GIIP Server. The icon color and text below it indicate the state of communication with WashMax Market's payment processor.
Radiant Epsilon Payment Processor
If configured, this heading will appear. The icon color and text below it indicate the state of the communication with Epsilon.
The following buttons may also be available:
EPI Diagnostics
This button is only available when a device under EPI Server is selected. Press it to view communication information with the device.
View Log
EPG maintains a detailed daily log of activity, useful for debugging. Press this button to view the current day's log.
Previous day's logs can be found in the directory C:\Program Files\Ryko\EPG\EventLog\
Close
Closes the Status window. (Only available when not running full screen.
When a Site Server is configured as a Payment Gateway, EPG runs with the Status Window full screen and adds buttons to Exit to Boot Aplication, Reboot Server, and Shutdown Server. It also displays the program version and copyright.
Settings Window
The EPG Settings window provides an interface to configure options, interfaces, and payment processing. Each area of configuration appears as a separate tab, each of which is detailed below. If the OK button is clicked, your changes are saved and EPG exits. On a Site Server, the boot application will automatically launch a new instance running the new configuration.
General Settings
This tab contains settings that are not tied to a particular interface.
Keep reports for 30 days
Some payment processors may provide reports to EPG as part of its interface. (Epsilon is one such processor.) These reports will be purged after the designated number of days.
To access the reports, login to WashMax.com, click on the Reports tab, and then Payment Processor Reports below that.
Release pre-authorization hold after 4 hours
When used with a self-serve car wash teller, this is how long a customer has to complete their purchase before the transaction closes.
It also designates how long some reference information about the transaction may be stored on the hard drive.
Sensitive Authentication Data, as defined by PCI PA-DSS, is never to be stored, in any form, by EPG.
Your Computer ID: xxxx xxxx
This read-only field has a unique hash defining this computer. Upon installation, you must provide this value to Intelio Customer Support to generate a license key for EPG's interface with your payment processor.
Authorize.Net Settings
Authorize.Net is an online credit card processor gateway. A merchant account must be setup by your provider (not Intelio). The Authorize.Net account must be setup as Merchant Type "Retail". Device type should be set to Self-Service Terminal. Once the account is created, login to Authorize.Net, go to Settings, and generate an API login and transaction key.
Fields:
Authorize.Net Server name or address: cardpresent.authorize.net
If DNS is not functioning on the Site Server, try entering 64.94.118.65 here.
Account API Login
Enter the API Login ID generated from the Authorize.Net web site.
Account Transaction Key
Enter the Transaction Key generated from the Authorize.Net web site.
Device Type: 3: Self Service Terminal
Should not change, but some account are mistakenly set to 2: Unattended Terminal, and you can select that here.
Product License Key
The Authorize.Net functionality in EPG requires a license key from Intelio.
If you are installing without the assistance of Intelio, call 800-874-6099 to obtain a license key.
EPI Settings
Electronic Payment Interface (EPI) is the protocol used to communicate with Ryko coinboxes and car washes, and Intelio tellers.
Fields:
RykoNet Host: localhost
Rarely is there reason to change this field.
If communicating with a single Virtual Attendant over Ethernet/IP, it occasionally works to enter that device's name or IP address here.
Terminals
List of terminals (coinboxes, tellers) to communicate with.
Use the Edit Terminals button to add terminals.
Epsilon Settings
Radiant Epsilon is credit and fleet card processor that is customized to each customer. The Epsilon service may be installed on the Site Server itself, or on a Radiant server on site. Contact your Intelio or Radiant sales representative for more information.
Fields:
Location ID: POS000000000100
Base value of point of sale terminal's ID. The last digit will be changed to the teller/coinbox number.
End of Day Batch time
At the designated time each day, the current batch will be closed and a report will be generated.
Product Code
Product Code that car washes will appear as in the Point of Sale system.
Product License Key
The Epsilon functionality in EPG requires a license key from Intelio.
If you are installing without the assistance of Intelio, call 800-874-6099 to obtain a license key.
GIIP Settings
The lone field in this tab defines the port on which the General Intelio Interoperability Protocol (GIIP) server will listen for connection. There is currently no reason to change this.
HTTP Settings
The lone field in this tab defines the port on which a basic HTTP server will listen for connection. This server is used to access reports provided to EPG from the Epsilon interface. To access the reports, login to WashMax.com, click on the Reports tab, and then Payment Processor Reports below that.
There is currently no reason to change this setting.
Unitec Settings
EPG can process payments for and monitor up to four Unitec Wash Select II bays at a single site. The interface in a Wash Select II is serial, so a serial device server is installed within the teller to provide an Ethernet interface. Enter the IP address and listening port for the TCP Server for each bay you wish to connect to.
Configuring the Serial Device Server
A serial device server must be connected to the site's IP network or directly to the Site Server via an Auxiliary Connection and a cross-over cable. Configured the device to:
An IP address compatible with its subnet.
For a direct connection to Auxiliary Connection #1 on a Site Server, use IP 192.168.111.21.
Set to run as a TCP Server
Set the serial port to 9600 baud, 8 data bits, 1 stop bit, no parity, no flow control.
If using a Moxa nPort serial device server, a search utility from Moxa is pre-installed on the Site Server. Find it in the Start / All Programs menu and use it to configure the Moxa(s).
Configuring the Wash Select II
The Wash Select II (WSII) must be configured to communicate correctly with EPG. Open the teller and flip the toggle switch on top of the motherboard to Setup mode. (Refer to your WSII Operations Manual, "Setup and Operate Modes".) Use the 1 key on the keypad to go backwards in a menu and also to answer Yes. Use the 3 key to go forward and to answer No. The * key is used for selection, or as an Enter key.
Press 3 twice to advance the menu to Credit System, and then press * to select it.
The menu item Credit Mode is displayed; press * to select it.
Press 3 and then * to select Generic Terminal Mode.
Press 1 and then * to answer Yes to the Use extensions question.
Press 3 several times to advance to the menu item Accept Propriety, and then press * to select it.
Press 1 and then * to answer Yes to the question.
Now flip the motherboard toggle switch back to Operation mode.
WashMax Reports
Reports provided to EPG from the Epsilon interface are accessible from your WashMax.com account. To access the reports, login to WashMax.com, click on the Reports tab, and then Payment Processor Reports below that. If your site does not appear there, contact Intelio Customer Support at 800-874-6099 to have it enabled.
The Activa Virtual Attendant and Site Controller communicate with each other over over a protocol known as RykoNet. This software protocol can be physically transmitted Echelon or Ethernet (IP). At a site running a Ryko car wash, Echelon is typically used because that is the only connection possible with the Ryko car washes. (A mixed environment is possible, but unusual.)
For site with car washes from all other manufacturers, RykoNet over IP is the physical transmission method of choice.
Choose the RykoNet Server Computer
One of the computers, either the Virtual Attendant or the Site Controller, must be select to be the server computer. This choice is not trivial, as the server computer becomes a single point of failure for RykoNet. That is, if that one computer is offline, then no other device using it as the server can communicate via RykoNet. Use the following decision table to make a choice.
Scenario
Server Computer
Does the site have just one Virtual Attendant and one Site Controller using RykoNet?
Site Controller
Does the site have a Ryko car wash, and you need to use RykoNet over IP?
Virtual Attendant
Does the site use the Intelio gate system?
Site Controller
Does the site have multiple car wash bays?
Site Controller
Set Static IP on the server
The server computer must be assigned a static IP address on the LAN.
Selecting a Static IP
If the site's network is actively managed by the operator, then request an IP address to use.
Check the router's DHCP settings. Choose an IP in the same subnet but outside of the range used by DHCP.
Do not assign the computer to statically use the IP that it was given dynamically! The router could give that IP to another device, resulting in a conflict.
Ping the IP that you plan to use, to ensure that nothing is already there.
Setting a Static IP on Windows XP
Ao the selected server computer:
Bring up the Control Panel.
Double click on Network Connections.
Scroll the window sideways and identify the connection with a Device Name of RealTec.
Right-click on the connection and select Properties.
Scroll down on the item list to Internet Protocol (TCP/IP), and double-click on it.
Click on the bubble to the left of Use the following IP address.
Fill in the IP address (which you choose), Subnet mask (usually 255.255.255.0), and Default gateway (the nearest router).
Fill in the Preferred DNS server. Use the router address again if you don't know of any other.
Click on the OK button. (If you are running this remotely, you will be disconnect and need to VNC back in after some delay.)
Click on the next OK button.
Configure the non-server device
If you selected the Site Controller as the server computer, then the Activa must now be configured to use it as the server. See the next section. Otherwise, the section after the next describes how to configure the Site Controller to use the Virtual Attendant as the server.
Configure the Activa Virtual Attendant to use the Site Controller as the server
Log in to the Activa maintenance mode.
Go to the RykoNet tab by:
Touch the System Setups button.
Touch the Software Setups button.
Touch the RykoNet tab.
Use a keyboard (real or on screen by pressing the ABC button) to change the Connect To field to the static IP of the Site Controller.
Touch the Accept button.
Touch the Close buttons until the system returns to the idle screen.
Configure the Site Controller to use the Virtual Attendant as the server
Configuring the Site Controller requires changes in three places, including editing files on the file system. It is not for the non-technical.
From the main application screen, touch the Setup Menu button.
If the Setup Menu button is grayed out, you will need to Login first.
Touch the RykoNet button.
Touch the Setup tab.
Use a keyboard (real or on screen by pressing the ABC button) to change the Connection field to the static IP of the Virtual Attendant.
Touch the Accept button.
Hold down the Windows key (it looks like a four-sectioned waving flag), press the e key, and then release the Windows key.
Windows Explorer should appear, showing My Computer.
Stop the EPI Server and WashTrax:
In the notification area on the bottom right of the screen, next to the clock, are small icons of programs running.
EPI Server looks like a red notebook with a hand holding a pen.
Right click on the EPI Server icon and click on Exit.
WashTrax looks like a blue-handled magnifying glass over two tire tracks.
Right click on the WashTrax icon and click on Exit.
Use the tree view on the left pane to navigate to C:\Program Files\Ryko\EPI Server\Setups
Right click on the EPIServerSettingns.xml file, and click on Edit.
Find the part that says <RykoNetHost>localhost</RykoNetHost> and change the localhost part to the static IP of the Virtual Attendant.
Save the file and exit Notepad.
Use the tree view on the left pane to navigate to C:\Program Files\Ryko\WashTrax
Double-click on the WashTrax.ini file.
On the ninth line it says Host=localhost . Change the localhost part to the static IP of the Virtual Attendant.
Save the file and exit Notepad.
Close the Windows Explorer window.
You should be returned to the Setup Menu.
Touch the red Exit button.
On the next screen, touch the green Start button.
Adam Fanello
Select VMware Server Bridged Network Adapter
When setting up an edge VM to bridge to the physical network, you usually only need to configure eth1 on the edge and VMware on the host will automatically select the correct adapter to bridge to the uplink. This works best if the uplink is working before you start the edge. If not, VMware may choose the wrong adapter to bridge.
You can manually tell VMware which adapter to use by following these steps:
Run the Manage Virtual Networks program.
If running under the LocalTerminal account (or other non-administrator account), you must run this application as Administrator by right-clicking on "Manage Virtual Networks" and selecting "Run As"
... and then select "The following user:". Make sure the local Administrator account is selected, enter the password, and click OK.
Now click to the "Automatic Bridging" tab and uncheck it.
On the "Host Virtual Networking Mapping" tab, drop down the list for VMnet0 and select the adapter that provides the uplink. You can cross-reference this on the Control Panel / Network Connections window. In the example below, it's the Realtek Gigabit. On Sys6 and Sys7 Site Servers, it'll be the only Intel adapter.
Click OK, and you're done.
Adam Fanello
Update Manager Usage Manual
Intelio provides software updates to Site Servers and Activas on its network through its own system specially designed for the Intelio and Ryko products and network. The Intelio Support Scripts running on each device automatically download these updates and can install them during Windows shutdown or reboot. On the Site Server, this behavior can be monitored and controlled through the Update Manager application.
Update Manager is launched by CAW Boot and appears in the taskbar. Normally the icon is , but when an update is waiting, it changes to . Right-click on the icon to trigger a reboot, show the waiting updates, or configure update manager.
Update Processing Mode: Fully Automated is recommended, as it ensures that the Site Server always installs the latest updates on a timely basis. Updates are automatically downloaded and installed upon the next reboot, as scheduled or sooner based on the urgency of the update.
When set to Manually Initated, updates are still automatically downloaded. Rare emergency security fixes may cause an immediate reboot and install, but normally updates will not install until manually initiated by right-clicking on the Update Manager icon and selecting the reboot option. This ensures that updates are only installed when someone is ready for them, and allows for the list of updates to be reviewed. However, it's important that someone remembers to follow this procedure and initiate the install & reboot at least once a month!
When set to Offline, updates are never downloaded or installed. When selected, the customer is taking responsibility for all application and operating system updates. Using this option may break PCI compliance and void the site's support contract.
Updates Provider: Select the provider of your updates. Intelio Site Server default to Intelio, while Ryko devices default to Ryko.
Auto-Reboot Schedule: Setting a reboot schedule is highly recommended when using Fully Automated processing, as it allows for the reboots to be scheduled during a known slow period. If disabled, a reboot will typically be triggered exactly eight days after the older pending update was downloaded, which could be during a busy time of day! Setting a weekly schedule is preferred.
Intelio recommends scheduling reboot every Tuesday at 2:30:00 AM.
Warn before reboot: Before any automated reboot, whether scheduled or driven by pending updates, a warning will be displayed on the screen. This warning provides the option to delay the reboot for some time.
Adam Fanello
Use $1 Coins
To use $1 coins in the Activa coin dispenser, rather than quarters, you must change settings in two different places.
On the Activa,
Login to Maintenance mode.
Touch the System Setups button.
Touch the Hardware Setups button.
Touch the Coin Dispenser tab.
Enter 1.00 in the Coin Value field.
Touch Accept.
In the Code-a-Wash application on the Site Controller:
Login to the Code-a-Wash application.
Touch the Setup Menu button.
Touch the Coinbox button.
Touch the Currency tab.
Set Change Value to 1.00.
Adam Fanello
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).
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
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:
<image-class> is usually sserv for a Site Server, although Sheetz's is cws, which stands for Car Wash Server.
<highest model support> the highest hardware model number that the image works on. Images are usually backwards compatible.
<variant> is optional. If none is given, then the image is Intelio's baseline. "R" is used for Ryko Code-a-Wash, "S" is Ryko iServer.
<revision> each time the image is updated, the image letter is increased.
<company> is the company that produces the image.
<date> is the date that this revision was released.
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.
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:
Belden 8760 (top choice)
Belden 9318
Belden 88760
Carol C2521
Carol C2534
Alpha 2421C
Manhattan 13242
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.
Log in as Administrator.
Click the Start button, then right click on "My Computer" then left click on "Manage".
Select "Device Manager" on the left.
Double click on "Ports".
Right click on "Communications Port (COM1) and select "Uninstall".
Right click on "Communications Port (COM2). Select "Properties". Go to "Port Settings" tab.
Click on the "Advanced" button.
Look for the Port Number and click on the drop down arrow.
Scroll up and select "COM1".
Click "Ok" button(s).
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.
Begin with the Site Server powered on and in normal operating mode.
Insert the USB flash drive in any USB port.
Touch the Setup Menu button. (Login if necessary.)
Touch the Database Maintenance button.
Touch the Backup Now button.
The Code-a-Wash application will shut down, backup its data to the flash drive, and then start back up.
Initialization Procedure
Begin with the PC powered off, a keyboard plugged in, and the USB Flash Imager drive in any USB port.
Press the PC power button.
On a Sys1, Sys2, Sys4 or Sys5 box:
Press the F12 key once every few seconds, until you see the Boot Menu screen.
Press the cursor down key to highlight Hard Drives and then press Enter to select it.
Highlight USB-HDD0 : USB 2.0 USB Flash Driv and then press the Enter to select it.
On a Sys6 or Sys8 box, it will boot from the flash drive without pressing anything.
On a Sys7 box:
Press the F11 key once every few seconds, until you see the Boot Menu screen.
Use the cursor down key to highlight the USB drive, and press the Enter to select it.
The imager will run:
If the Windows XP logo appears, hold the power button until the PC powers off. See the BIOS Setup section above.
White text will scroll on the screen for a while, followed by a red warning screen.
Processing text is cyan, with the second column of data showing percent complete.
A green message at the end indicates when it has completed.
Press the power button to turn the PC off.
Remove the USB Flash drive.
Press the power button to start up the newly imaged Site Server.
When Windows has started up, give it a few minutes to discover new devices. Allow it to reboot if it wants to.
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.
Double-click the Post-Cloning Fix-Up icon on the Desktop.
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.)
Begin with the Site Server powered on and in normal operating mode.
Insert the USB flash drive in any USB port.
Touch the Setup Menu button.
Touch the Exit button.
Touch the Repair BackupRestore button.
Touch the Restore Data From Backup button.
Touch the caw.mdb file and touch the OK button.
Touch the OK button.
Touch the next OK button.
Touch the Finished button.
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.
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.
Login to WIndows with the Administrator account and open Cygwin. (Or ssh in as Administrator.)
On an sserv, enter the lines:
HOSTNAME=sserv
./bootstrap.sh
On a teller, enter the lines:
HOSTNAME=teller
./bootstrap.sh
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:
Intelio Activa Virtual Attendant
Ryko AMTT coinbox
Ryko AMTT-CS coinbox
Ryko Enteract Virtual Attendant
Ryko Bay Pay
Ryko Touch-n-Go
Unitec Wash Select II
Supported payment processors:
Authorize.Net
Radiant Epsilon
WashMax Market
EPG is a replacement for non-PCI compliant EPI Server application.
Installation and Startup
EPG should operate on any Windows XP based system. However, it's only supported by Intelio as pre-installed on an Intelio Site Server. See the Application Configuration section at How to configure a new Site Server for details.
Taskbar Icon and Menu
When running, EPG has an icon in the Windows taskbar notification area that looks like this: Right click on it for a menu of windows and actions:
Status displays the Status window showing current status of the system.
Settings displays the Settings window which allows you to configure EPG.
About displays version and copyright information.
Exit shuts down the EPG application.
Status Window
The Electronic Payment Gateway Status window shows the current state of things in EPG. It may be brought up from the taskbar icon menu, or it may be displayed full screen on a Site Server that is configured solely as a Payment Gateway system (via CAW Booter configuration profile).
Items that may be appear in the status:
HTTP Server
EPG has a reports interface via the HTTP protocol. When it is being accessed, connections will be shown under this heading.
GIIP Server
EPG includes a General Intelio Interoperability Protocol server used for communication on this protocol. Connections to this server are shown below this heading.
EPI Server
EPI is the interface with Ryko and Intelio tellers. A connection with one of these tellers will appear under this heading. The connection will show an icon indicating the type of device and whether it is currently communicating or not (crossed out icon).
Unitec Tellers
If configured, this heading will appear with a line below it for each wash bay. The icon and text indicate the current state of the Wash Select II.
Authorize.Net Payment Processor
If configured, this heading will appear. The icon color and text below it indicate the state of the communication with Authorize.Net.
Intelio GIIP Payment Processor
If an Intelio edge VM is running, it will appear here as well as under GIIP Server. The icon color and text below it indicate the state of communication with WashMax Market's payment processor.
Radiant Epsilon Payment Processor
If configured, this heading will appear. The icon color and text below it indicate the state of the communication with Epsilon.
The following buttons may also be available:
EPI Diagnostics
This button is only available when a device under EPI Server is selected. Press it to view communication information with the device.
View Log
EPG maintains a detailed daily log of activity, useful for debugging. Press this button to view the current day's log.
Previous day's logs can be found in the directory C:\Program Files\Ryko\EPG\EventLog\
Close
Closes the Status window. (Only available when not running full screen.
When a Site Server is configured as a Payment Gateway, EPG runs with the Status Window full screen and adds buttons to Exit to Boot Aplication, Reboot Server, and Shutdown Server. It also displays the program version and copyright.
Settings Window
The EPG Settings window provides an interface to configure options, interfaces, and payment processing. Each area of configuration appears as a separate tab, each of which is detailed below. If the OK button is clicked, your changes are saved and EPG exits. On a Site Server, the boot application will automatically launch a new instance running the new configuration.
General Settings
This tab contains settings that are not tied to a particular interface.
Keep reports for 30 days
Some payment processors may provide reports to EPG as part of its interface. (Epsilon is one such processor.) These reports will be purged after the designated number of days.
To access the reports, login to WashMax.com, click on the Reports tab, and then Payment Processor Reports below that.
Release pre-authorization hold after 4 hours
When used with a self-serve car wash teller, this is how long a customer has to complete their purchase before the transaction closes.
It also designates how long some reference information about the transaction may be stored on the hard drive.
Sensitive Authentication Data, as defined by PCI PA-DSS, is never to be stored, in any form, by EPG.
Your Computer ID: xxxx xxxx
This read-only field has a unique hash defining this computer. Upon installation, you must provide this value to Intelio Customer Support to generate a license key for EPG's interface with your payment processor.
Authorize.Net Settings
Authorize.Net is an online credit card processor gateway. A merchant account must be setup by your provider (not Intelio). The Authorize.Net account must be setup as Merchant Type "Retail". Device type should be set to Self-Service Terminal. Once the account is created, login to Authorize.Net, go to Settings, and generate an API login and transaction key.
Fields:
Authorize.Net Server name or address: cardpresent.authorize.net
If DNS is not functioning on the Site Server, try entering 64.94.118.65 here.
Account API Login
Enter the API Login ID generated from the Authorize.Net web site.
Account Transaction Key
Enter the Transaction Key generated from the Authorize.Net web site.
Device Type: 3: Self Service Terminal
Should not change, but some account are mistakenly set to 2: Unattended Terminal, and you can select that here.
Product License Key
The Authorize.Net functionality in EPG requires a license key from Intelio.
If you are installing without the assistance of Intelio, call 800-874-6099 to obtain a license key.
EPI Settings
Electronic Payment Interface (EPI) is the protocol used to communicate with Ryko coinboxes and car washes, and Intelio tellers.
Fields:
RykoNet Host: localhost
Rarely is there reason to change this field.
If communicating with a single Virtual Attendant over Ethernet/IP, it occasionally works to enter that device's name or IP address here.
Terminals
List of terminals (coinboxes, tellers) to communicate with.
Use the Edit Terminals button to add terminals.
Epsilon Settings
Radiant Epsilon is credit and fleet card processor that is customized to each customer. The Epsilon service may be installed on the Site Server itself, or on a Radiant server on site. Contact your Intelio or Radiant sales representative for more information.
Fields:
Location ID: POS000000000100
Base value of point of sale terminal's ID. The last digit will be changed to the teller/coinbox number.
End of Day Batch time
At the designated time each day, the current batch will be closed and a report will be generated.
Product Code
Product Code that car washes will appear as in the Point of Sale system.
Product License Key
The Epsilon functionality in EPG requires a license key from Intelio.
If you are installing without the assistance of Intelio, call 800-874-6099 to obtain a license key.
GIIP Settings
The lone field in this tab defines the port on which the General Intelio Interoperability Protocol (GIIP) server will listen for connection. There is currently no reason to change this.
HTTP Settings
The lone field in this tab defines the port on which a basic HTTP server will listen for connection. This server is used to access reports provided to EPG from the Epsilon interface. To access the reports, login to WashMax.com, click on the Reports tab, and then Payment Processor Reports below that.
There is currently no reason to change this setting.
Unitec Settings
EPG can process payments for and monitor up to four Unitec Wash Select II bays at a single site. The interface in a Wash Select II is serial, so a serial device server is installed within the teller to provide an Ethernet interface. Enter the IP address and listening port for the TCP Server for each bay you wish to connect to.
Configuring the Serial Device Server
A serial device server must be connected to the site's IP network or directly to the Site Server via an Auxiliary Connection and a cross-over cable. Configured the device to:
An IP address compatible with its subnet.
For a direct connection to Auxiliary Connection #1 on a Site Server, use IP 192.168.111.21.
Set to run as a TCP Server
Set the serial port to 9600 baud, 8 data bits, 1 stop bit, no parity, no flow control.
If using a Moxa nPort serial device server, a search utility from Moxa is pre-installed on the Site Server. Find it in the Start / All Programs menu and use it to configure the Moxa(s).
Configuring the Wash Select II
The Wash Select II (WSII) must be configured to communicate correctly with EPG. Open the teller and flip the toggle switch on top of the motherboard to Setup mode. (Refer to your WSII Operations Manual, "Setup and Operate Modes".) Use the 1 key on the keypad to go backwards in a menu and also to answer Yes. Use the 3 key to go forward and to answer No. The * key is used for selection, or as an Enter key.
Press 3 twice to advance the menu to Credit System, and then press * to select it.
The menu item Credit Mode is displayed; press * to select it.
Press 3 and then * to select Generic Terminal Mode.
Press 1 and then * to answer Yes to the Use extensions question.
Press 3 several times to advance to the menu item Accept Propriety, and then press * to select it.
Press 1 and then * to answer Yes to the question.
Now flip the motherboard toggle switch back to Operation mode.
WashMax Reports
Reports provided to EPG from the Epsilon interface are accessible from your WashMax.com account. To access the reports, login to WashMax.com, click on the Reports tab, and then Payment Processor Reports below that. If your site does not appear there, contact Intelio Customer Support at 800-874-6099 to have it enabled.
The Sys8 Site Servers have a glitch with serial ports 1 and 2. Here are the instructions on how to change COM2 to COM1.
Log in as Administrator.
Click the Start button, then right click on "My Computer" then left click on "Manage".
Select "Device Manager" on the left.
Double click on "Ports".
Right click on "Communications Port (COM1) and select "Uninstall".
Right click on "Communications Port (COM2). Select "Properties". Go to "Port Settings" tab.
Click on the "Advanced" button.
Look for the Port Number and click on the drop down arrow.
Scroll up and select "COM1".
Click "Ok" button(s).
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.
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.
Click the VMs link on the VPN list, point your web browser to http://<sserv IP address>:8222/ui/
You may also increase the screen resolution to 800x600 and then double-click the VMware Server desktop icon. Be sure to change the screen resolution back before putting the server in operation with a monitor on it.
Login as Administrator with the default or current password.
With sserv selected on the left, find the Commands block on the right and click on Edit Virtual Machine Startup/Shutdown Settings.
Click on Intelio Edge A and then click the Move Up button to put it in the (Startup Order) Any Order section.
Repeat as needed for Intelio Edge B and Intelio Edge C to run two or three edges.
Click on Intelio Edge A on the left.
Notes about power on/off from on this page:
Do not power on the edge until the bootstrap/installation scripts complete!
Do notuse the red square STOP button or Power Off link. These are like cutting power to the machine.
Do use the Shut Down Guest and Restart Guest links when needed. These do clean shutdowns and reboots.
If the edge VM needs to be on the physical network rather than a virtual network inside of the Site Server:
If the edge is already running, click the Shut Down Guest link and wait for it to shut down.
If Network Adapter 2 isn't listed in the Hardware section:
Click on Add Hardware in the right column.
Click on Network Adapter and then Next.
Click on Next and then Finish.
If the edge had been running, start it back up by clicking the Power On link on the right.
If the edge VM needs to access a device plugged into the 9-pin DIN serial port:
Go to the Hardware section and click the icon next to Serial Port 1.
Click on Edit.
Select Connect at power on.
Click on the OK button.
Note: Do not do this if the Code-a-Wash application is to run. They will conflict!
If the edge VM needs to access a USB Serial adapter:
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.
Go to the Hardware section and click the icon next to Serial Port 1.
Click on Edit.
Select Connect at power on.
Select the Physical COM port. The one on the motherboard is COM1. The adaptor will show with a higher number.
Click on the OK button.
If you need multiple adapters, only add them one at a time so that you can tell which is which.
Feel free to put comments in the Notes section if you feel a need.
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:
Shut down all applications that you can.
Press the Windows key to pop up the START menu, and select Log Out.
Alternatively, press Ctrl-Alt-Del and click Log Out.
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.
Right click on the desktop and select Properties.
Click the Settings tab.
Click the Advanced button.
Click the Adapter tab.
Click List All Modes.
Scroll the list up and select 640 by 480, True Color (32 bit), 60 Hertz, and click OK.
Click OK.
Click OK.
Click Yes on the dialog box.
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)
Configure startup programs:
On the Booter program, touch the Set Program Options button.
Touch the Startup Options button.
Touch the down arrow next to Configuration one so that it reads Payment Gateway.
Touch the OK button.
Touch the Finished button.
Touch the Start button.
See the article How to configure EPG.
Installations Connected to Ryko or Intelio Tellers and WashMax Merchandise
Configure startup programs:
On the Booter program, touch the Set Program Options button.
Touch the Startup Options button.
Touch the down arrow next to Configuration twice so that it reads Full Function.
Touch the OK button.
Touch the Finished button.
Touch the Start button.
Login to the Code-a-Wash application.
User: ENG, PIN: 7956
Touch the Setup Menu button.
Touch the Wash Keys button.
Edit each wash package to match the Activa. Touch the Close button when done.
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.
Use of Fleet Account,Discount Keys and Discount Programs are discouraged, as they do not report properly to WashMax. Use WashMax Marketing instead.
Touch the Users button and have the OWNER consider a new password. They may also want additional accounts for other users.
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.
Touch the Point Of Sale button.
If the POS always claims that the car was is offline and won't sell codes, toggle Power Flag Always OK
If the POS uses the Unitec protocol, set Protocol to ALTERNATE
Touch the Coinbox button.
Set the Name field, if desired, to give a more meaningful name to what will appear on the main screen.
Set the Type to AMTT-CS.
On the Currency tab,
Set Coin 1 Value to match the Coin Accepter value on the Activa.
Set Change Value to match the Coin Dispenser value on the Activa.
If there is more than one Activa, touch the right arrow at the top of the screen to select the next bay.
Touch Close to exit the Setup Menu.
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.
Give the sserv VPN access to the other sserv or caw device:
On intelio@bertha, run devtodev add sserv### sserv### , replacing the sserv### with the correct sserv or caw node names.
Reboot the other Site Server or Site Controller so that it will obtain the new VPN routing access.
Configure startup programs:
On the Booter program, touch the Set Program Options button.
Touch the Startup Options button.
Touch the down arrow next to Configuration twice so that it reads Full Function.
Touch the down arrow next to Applications and then touch the Run button to change it to Stopped. Repeat for each application so that only Code A Wash is left as Run.
Touch the OK button.
Touch the Finished button.
Touch the REBOOT button. Wait for the reboot.
Configure application to communicate with master CAW at car wash site.
Click on the Setup Menu button.
If the Setup Menu button is grayed out, touch Login and enter the PIN 7956 and then click Enter (which is down by the zero). This will make the Setup Menu available.
Click the RykoNet button.
Click the Setup tab.
Set Type to Remote 1. (Or Remote 2, or Remote 3, ...)
Set Connection to the VPN address of the sserv or caw at the car wash site.
Click on the Net Devices tab.
Click the Refresh button.
The devices CAW 1 as well as other remote devices should appear. If not, there's probably a routing problem between the devices.
Click the Accept button.
Click the Close button.
Once communication is establish with the host CAW and wash keys are setup on the host, copy them:
Click the Setup Menu button.
Click the Wash Keys button.
Click the Duplicate From Host button.
Now navigate to each wash package up through #8. They will all be enabled. Disable each package that is not actually used by:
Click the Edit Wash Package button.
Click the big Enabled button, which will change to Disabled.
Click the Accept button.
Click the Close button.
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.
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:
Shut down all applications that you can.
Press the Windows key to pop up the START menu, and select Log Out.
Alternatively, press Ctrl-Alt-Del and click Log Out.
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.
Right click on the desktop (or Control Panel / Desktop) and select Properties.
Click the Settings tab.
Click the Advanced button.
Click the Adapter tab.
Click List All Modes.
Scroll the list up and select 640 by 480, True Color (32 bit), 60 Hertz, and click OK.
Click OK.
Click OK.
Click Yes on the dialog box.
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.
Configure startup programs:
On the Booter program, touch the Set Program Options button.
Touch the Startup Options button.
Touch the down arrow next to Configuration one so that it reads Payment Gateway.
Touch the OK button.
Touch the Finished button.
Touch the Start button.
See the article How to configure EPG.
Installations with WashMax Merchandise or a Ryko car wash.
Configure startup programs:
On the Booter program, touch the Set Program Options button.
Touch the Startup Options button.
Touch the down arrow next to Configuration twice so that it reads Full Function.
Touch the OK button.
Touch the Finished button.
Touch the Start button.
Login to the Code-a-Wash application.
User: ENG, PIN: 7956
Touch the Setup Menu button.
Touch the Wash Keys button.
Edit each wash package to match the Activa. Touch the Close button when done.
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.
Use of Fleet Account,Discount Keys and Discount Programs are discouraged, as they do not report properly to WashMax. Use WashMax Marketing instead.
Touch the Users button and have the OWNER consider a new password. They may also want additional accounts for other users.
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.
Touch the Point Of Sale button.
If the POS always claims that the car was is offline and won't sell codes, toggle Power Flag Always OK
If the POS uses the Unitec protocol, set Protocol to ALTERNATE
For some other protocols like Gasman you may need to set the Protocol to ALTERNATE
Touch the Coinbox button.
Set the Name field, if desired, to give a more meaningful name to what will appear on the main screen.
On the Currency tab,
Set Coin 1 Value to match the Coin Accepter value on the Activa.
Set Change Value to match the Coin Dispenser value on the Activa.
If there is more than one Activa, touch the right arrow at the top of the screen to select the next bay.
Touch Close to exit the Setup Menu.
Touch the Logout button. Never leave the ENG user logged in once you are done.
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.
Give the sserv VPN access to the other sserv or caw device:
On intelio@bertha, run devtodev add sserv### sserv### , replacing the sserv### with the correct sserv or caw node names.
Reboot the other Site Server or Site Controller so that it will obtain the new VPN routing access.
Configure startup programs:
On the Booter program, touch the Set Program Options button.
Touch the Startup Options button.
Touch the down arrow next to Configuration twice so that it reads Full Function.
Touch the down arrow next to Applications and then touch the Run button to change it to Stopped. Repeat for each application so that only Code A Wash is left as Run.
Touch the OK button.
Touch the Finished button.
Touch the REBOOT button. Wait for the reboot.
Configure application to communicate with master CAW at car wash site.
Click on the Setup Menu button.
If the Setup Menu button is grayed out, touch Login and enter the PIN 7956 and then click Enter (which is down by the zero). This will make the Setup Menu available.
Click the RykoNet button.
Click the Setup tab.
Set Type to Remote 1. (Or Remote 2, or Remote 3, ...)
Set Connection to the VPN address of the sserv or caw at the car wash site.
Click on the Net Devices tab.
Click the Refresh button.
The devices CAW 1 as well as other remote devices should appear. If not, there's probably a routing problem between the devices.
Click the Accept button.
Click the Close button.
Once communication is establish with the host CAW and wash keys are setup on the host, copy them:
Click the Setup Menu button.
Click the Wash Keys button.
Click the Duplicate From Host button.
Now navigate to each wash package up through #8. They will all be enabled. Disable each package that is not actually used by:
Click the Edit Wash Package button.
Click the big Enabled button, which will change to Disabled.
Click the Accept button.
Click the Close button.
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.
Check the SOC comment to ensure that the site has been added to a WashMax Server.
Bring up EPG Status and see green lights for the configured credit payment processor and Intelio GIIP Payment Processor.
Wash code sale (if applicable)
Wash code redemption (if applicable)
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:
Download Site Server/CCA_v1.x.x.x.msi from the software repository and install it.
Then run C:\Program Files\Ryko\CCA\ColdCardActivator.exe and unblock the firewall.
Edit C:\Program Files\Ryko\CAWV\cawboot.ini
Add to the end of the [STARTUP?] block that is being used:
Change the 5 on each line to be the next number after the block before it.
Close and save the file.
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:
Clerk ID: If owner/manager would like to track what clerk activates a card, set this to shown and required.
Initial Value: If site will only be activating dollar value cards, with variable dollar amounts, then set this as shown and required. If they will be doing this, but other things too, then set it as shown and optional. Otherwise, set it to not shown.
Initial Use Count: If the site is replacing paper card punch cards with loyalty cards, set this as shown with initial value of 0. Otherwise, probably want it not shown.
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:
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.
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.
Open the VMware Server console (from SOC link, Desktop, or Start Menu) and log in as administrator.
Click on Edit Virtual Machine Startup/Shutdown Settings.
Move all edges to the Manual Startup section.
Click OK.
Close the browser window.
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:
Open Windows Explorer and navigate to the D drive.
Double-click on WashMax-Onsite-Libs_v5*.exe
Double-click on WashMax-Onsite_v5*.exe
Double-click on the enzo-upgrade folder and then install.bat. (Do not try running from within the .zip file - it won't work.)
If a MySQL window hangs for more than a minute, close it and press a key in the command-line window to exit. Then double-click on fix_mysql.bat.
Click Next and Finish as needed to proceed through any prompts.
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
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:
ssh intelio@wms-xx, where wms-xx is the server that the site reports to.
Enter: enzoUpgradeCleanup.sh xxxx , where xxxx is the WashMax edge number, zero-padded to four digits.
Repeat this command for each edge at the site.
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.
Begin with the Site Server powered on and in normal operating mode.
Insert the USB flash drive in any USB port.
Touch the Setup Menu button. (Login if necessary.)
Touch the Database Maintenance button.
Touch the Backup Now button.
The Code-a-Wash application will shut down, backup its data to the flash drive, and then start back up.
Initialization Procedure
Begin with the PC powered off, a keyboard plugged in, and the USB Flash Imager drive in any USB port.
Press the PC power button.
On a Sys1, Sys2, Sys4 or Sys5 box:
Press the F12 key once every few seconds, until you see the Boot Menu screen.
Press the cursor down key to highlight Hard Drives and then press Enter to select it.
Highlight USB-HDD0 : USB 2.0 USB Flash Driv and then press the Enter to select it.
On a Sys6 or Sys8 box, it will boot from the flash drive without pressing anything.
On a Sys7 box:
Press the F11 key once every few seconds, until you see the Boot Menu screen.
Use the cursor down key to highlight the USB drive, and press the Enter to select it.
The imager will run:
If the Windows XP logo appears, hold the power button until the PC powers off. See the BIOS Setup section above.
White text will scroll on the screen for a while, followed by a red warning screen.
Processing text is cyan, with the second column of data showing percent complete.
A green message at the end indicates when it has completed.
Press the power button to turn the PC off.
Remove the USB Flash drive.
Press the power button to start up the newly imaged Site Server.
When Windows has started up, give it a few minutes to discover new devices. Allow it to reboot if it wants to.
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.
Double-click the Post-Cloning Fix-Up icon on the Desktop.
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.)
Begin with the Site Server powered on and in normal operating mode.
Insert the USB flash drive in any USB port.
Touch the Setup Menu button.
Touch the Exit button.
Touch the Repair BackupRestore button.
Touch the Restore Data From Backup button.
Touch the caw.mdb file and touch the OK button.
Touch the OK button.
Touch the next OK button.
Touch the Finished button.
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.
Login to the Code-a-Wash application.
Touch the Setup Menu button.
Touch the Coinbox button.
Touch the Currency tab.
Set Coin 1 Value to match the Coin Acceptor value on the Activa.
Set Change Value to match the Coin Dispenser value on the Activa.
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.
Log in as Administrator.
Click the Start button, then right click on "My Computer" then left click on "Manage".
Select "Device Manager" on the left.
Double click on "Ports".
Right click on "Communications Port (COM1) and select "Uninstall".
Right click on "Communications Port (COM2). Select "Properties". Go to "Port Settings" tab.
Click on the "Advanced" button.
Look for the Port Number and click on the drop down arrow.
Scroll up and select "COM1".
Click "Ok" button(s).
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.)
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:
Auxiliary Connection 1 is located nearest the primary port and is preconfigured to IP 192.168.111.20.
Auxiliary Connection 2 is located nearest the outer edge of the box and is preconfigured to IP 192.168.112.20.
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).
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
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:
<image-class> is usually sserv for a Site Server, although Sheetz's is cws, which stands for Car Wash Server.
<highest model support> the highest hardware model number that the image works on. Images are usually backwards compatible.
<variant> is optional. If none is given, then the image is Intelio's baseline. "R" is used for Ryko Code-a-Wash, "S" is Ryko iServer.
<revision> each time the image is updated, the image letter is increased.
<company> is the company that produces the image.
<date> is the date that this revision was released.
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.
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:
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.
The number of cards to produce.
You will receive a response with a csv file containing three fields per line:
The card number to print somewhere on the plastic card itself. (fifteen digits)
The data to encode on the first track. (WP followed by fifteen digits)
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:
TCP Server Mode
Serial port settings:
Baud: 19200 baud
Parity: None
Data Bit: 8
Stop Bit: 1
Flow Control: None
UART FIFO: Enabled
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.
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:
IP:
Old scheme: 192.168.1.54 (Use 192.168.1.64 for a second bay.)
sserv Auxiliary Connection #2: 192.168.112.21
If this IP does not work for the site's network, any other address may be used but Intelio site controller must be configured with the alternative address.
Run as a TCP Server listening on port 4001
The inactivity timeout must be disabled .
Serial side set to 9600 baud, 8 bit data, 1 stop bit, no parity, and no flow control.
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:
IP:
Old scheme: 192.168.1.54 (Use 192.168.1.64 for a second bay.)
sserv Auxiliary Connection #2: 192.168.112.21
If this IP does not work for the site's network, any other address may be used but Intelio site controller must be configured with the alternative address.
Run as a TCP Server listening on port 4001 and set Force transmit to 75 ms.
The inactivity timeout must be disabled .
Serial side set to 2400 baud, 8 bit data, 1 stop bit, no parity, and no flow control.
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
Turn power on to A9 (controller board)
Wait for it to boot up.
Press the 0 button twice.
On the "Enter access code" screen shown, enter 2003.
On the Main menu screen:
Scroll down by pressing 0. You will see a second screen with 7 - communications.
Press 7.
The next screen shows: 1 - local connexion, 2 - remote connexion, etc
Press 1.
The next screen shows: 1.1 serie connexion // NOT installed
Press E. The next screen shows 1- printer, 2 - computer, 3 - not installed
Press 2.
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:
Run as a TCP Server listening on port 4001.
Serial side set to 9600 baud, 8 bit data, 1 stop bit, no parity, and no flow control.
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
From the Site Server, open Internet Explorer and enter the IP address of the PDQ server.
Login. owner - 12345, or PDQ Eng - 83340.
Enter the Site Management System setup page. (Click Setup ->SMS links.)
Set the Pulse Time to 10 minutes.
Set the URL to the static IP address for the edge VM (if using one, v4) or the site server (v5).
Set the port to 8790.
Click the Test SMS Server button. You should see a message received in the edge's log.
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:
TCP Server Mode
Serial port settings:
Baud: 9600 baud
Parity: None
Data Bit: 8
Stop Bit: 1
Flow Control: None
UART FIFO: Enabled
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
Login to WashMax.com using the super- variant of the customer's login.
Click on the Management tab.
Click the Edit button next to the site to link.
On the bottom left of the Site Setup screen, ensure that the Entry Device Model selection is correct and ends with "EPG".
Near the bottom right , find the field Electronic Payment Gateway address.
Enter the full domain qualified name or IP address of the Site Server hosting the EPG instance to link to.
Example: sserv123.edgenet
Example: sserv202.sheetz
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:
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:
Click the Start menu and then click "Control Panel".
Double click on "User Accounts".
Click the "Create a new account" link.
Enter a name for the account, such as "owner", and click the "Next" button.
Select "Computer administrator", if not already, and then click the "Create Account" button.
Click on the new account name.
Click the "Charge the password" link.
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.
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
Exit the application, to the O/S.
Right click on the Intel Extreme Graphics icon on the task bar. (Blue trapezoid on the far right.)
Click on Graphics Properties.
Click on the Color Correction tab.
Adjust the settings as desired, clicking the Apply button to see the result.
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:
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:
Copy all the files in the .zip to the C:\Program Files\RealVNC\ folder on your computer
Double-click on Register-VNC-protocol.reg to register the VNC protocol handler.
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
Press the Windows key to access the Start menu and task bar.
Press F8 for the VNC Viewer menu of special actions, including transmitting a Ctrl-Alt-Del signal to the remote computer.
If the screen draws in full color and is slow, press F8 for the VNC Viewer menu, click Options, and set the Color Level to Low.
If you log into something (such as Code-a-Wash), always log out when done.
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
Press the Windows key to pop up the toolbar.
Right-click on the VNC icon in the tools bar.
Select Options... on the pop-up menu.
Select VNC Password Authentication (if not already selected)
Click on the Configure button.
Enter the new password in both fields.
BE VERY CAREFUL! If you make a typo, you won't be able to get back in!
Click the OK button.
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
Open the Control Panel.
Double-click on Network Connections.
Right-click on Intelio VPN.
Left-click on Properties.
Scroll Internet Protocol (TCP/IP), left-click it, then click on the Properties button.
Click the radio button next to Use the following DNS server addresses.
Enter the IP address from the table above into the Preferred DNS server field.
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:
Click on the START button and then click My Computer.
Double-click on the C: drive.
Double-click on the Program Files folder.
Double-click on the OpenVPN folder.
Double-click on the config folder.
Right-click on the file OpenVPN Config File (your name.ovpn)
Select Open With...
Click on WordPad.
If WordPad isn't shown, click on Choose Program and select WordPad from there.
On the 7th line, you'll find the line starting with "remote 64.79.169.197".
Change the numbers to 209.11.249.195. Leave "remote" and the number at the end of the line in place.
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:
Click on the START button and then click My Computer.
Double-click on the C: drive.
Double-click on the Program Files folder.
Double-click on the OpenVPN folder.
Double-click on the config folder.
Right-click on the file OpenVPN Config File (<node name>.ovpn or <node-type>_configme.ovpn)
Select Open With...
Click on WordPad.
If WordPad isn't shown, click on Choose Program and select WordPad from there.
On the 7th line, you'll find the line starting with "remote 64.79.169.197".
Change the numbers to 209.11.249.195. Leave "remote" and the number at the end of the line in place.
Close WordPad and save the change.
Restart the OpenVPN connection by rebooting or restarting the Windows Service.
To restart the OpenVPN service:
Click on the START button and then click Control Panel.
Double click on Administration Tools.
Double click on Services.
Scroll down and click on the OpenVPN Service line.
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: