Installation and Configuration
Prerequisites
In order to successfully install the ATM Data Capture Plug-in, you will need the following:
IP address of each ATM
IP address of ATM transaction server (if known, will improve plug-in performance)
ATM Data Capture Plug-in Package, sent by 3VR Orders (mail_orders) with the order confirmation email. Includes the following files:
ATM Data Capture plug-in file: Plugins.AtmDataCaptureTransaction-Release-1.0.0.xxxxx-7.0.3pg
Network troubleshooting file: NetworkCaptureSupport.3pa
A network hub, or, if the network switch is capable of port-mirroring, a mirrored port that will be connected to the VIP Appliance’s secondary NIC. See the network diagrams on page 5 for more information.
A VIP Appliance with two network adapters (primary and secondary) is recommended. If you intend to install the plug-in on a VIP Appliance with only one NIC, see Appendix A.
Installation
Checking for Network Capture Support Tool
Prior to adding the plug-in to the appliance, you must install NetworkCaptureSupport.3pa (included in the plug-in download package) on the system if it is not already installed. This file is required for the plug-in to function.
Use the following steps to check whether NetworkCaptureSupport.3pa is currently installed:
Launch 3VR System Manager.
In the Configure tab, select the name of the VIP Appliance to view its settings.
On the right-hand side of System Manager, click Common Operations, then click Installed Support Tools.
In the Installed Support Tools window, check whether Network Traffic Capture Support appears in the list of tools. If it does, proceed to Installing ATM Data Capture Plug-in.
Otherwise, continue to the next step to install it.
Installing Network Capture Support Package (If Necessary)
Use the following steps to install NetworkCaptureSupport.3pa:
Click the Maintenance tab to go to the Maintenance panel.
Click the Update Software tab.
Check the box next to the name of the appliance to select it.
Click Inspect. Check the Status column to verify that the appliance is in a ready state:
“OK” is displayed if the system is operating normally and ready to be upgraded.
“Unauthorized” will be displayed if the current user is not authorized to install software on the selected server.
“Unreachable” will be displayed if the system is not in a state where it can be upgraded.
Click Update.
In the Choose 3VR Update File window, locate the Network Capture Support package file, named NetworkCaptureSupport.3pa:
If you are connected to the VIP Appliance with a laptop or over the network, navigate to the drive on your computer where you have saved the file. Click to select it.
If you are connected to the VIP Appliance with a monitor, mouse, and keyboard, browse to the USB drive or CD containing the file and click to select it.
Click OK. System Manager will install Network Capture Support on the selected appliance(s). The Status column will show the status of the update as it progresses.
When the update is complete, the Status column for each appliance will show “Done”.
Return to the Installed Support Tools dialog as described in Network Traffic Capture Support topic and verify that Network Traffic Capture Support is now listed.
Installing ATM Data Capture Plug-in
Launch 3VR System Manager.
In the Configure panel, click the plus sign beside the appliance name.
Right-click the Plug-ins folder and select Add Plug-in.
In the resulting Confirm dialog box, click Install to proceed.
Navigate to the folder containing the plug-in file (Plugins.ATMDataCapture-Release-1.0.0.xxxxx-7.0.3pg) and click to highlight the file.
Click OK. The plug-in will now begin installing.
When the plug-in is installed, it will appear below Plug-ins in System Manager.
Setting up the Network
Hub Setup
Connect an Ethernet cable from the VIP Appliance’s primary network card to the network switch.
Connect the ATMs to a hub.
Connect the hub to the network switch.
Connect an Ethernet cable from the VIP Appliance’s secondary network card to the hub.
Port Mirroring Setup
Set up a port on the network switch that will mirror traffic from the ATM host.
Connect an Ethernet cable from the VIP Appliance’s secondary network card to the mirrored port.
Connect an Ethernet cable from the VIP Appliance’s primary network card to the network switch.
Binding Cameras to Plug-In
Select the ATM Transaction Plugin.
Select the Bound Cameras field and click the ... button.
In the Bind Plug-in to Cameras dialog box, click the check box beside each camera that should be associated with ATM transactions.
Click OK to save your changes and return to the Configure panel.
A pop-up will be displayed notifying you that the 3VR system software must be restarted after making changes. Click OK to close the pop-up message and acknowledge the warning. You will restart software as the last configuration step.
Configuring Per-Camera Settings
After binding cameras to the plug-in (step 3.2), links will appear under Bound Cameras for each camera.
Click a link (for example Edit “1. ATM Camera”) to edit the settings for that camera.
Type the IP address of the ATM in the ATM IP Address box.
Type the ATM ID in the ATM ID box. This will be displayed on transaction events generated by the ATM in 3VR OpCenter.
Click OK to save your changes and return to the Configure panel.
Repeat steps 2 to 5 for any remaining cameras bound to the ATM Data Capture plug-in.
See Appendix B for assistance determining the ATM ID of an ATM.
If multiple ATMs are to be associated with a single camera, the ATM IP Address and ATM ID fields should contain the IP addresses and IDs of all of the ATMs, separated by a comma with no spaces. The values for each ATM should be placed in the same order.
For example, if ATM 1234A (IP address 10.100.2.1) and ATM 5678B (IP address 10.100.2.3) are both to be assigned to camera 1 in the plug-in configuration, the ATM ID for camera 1 should be set to “1234A,5678B” and the ATM IP Address should be set to “10.100.2.1,10.100.2.3”.