Overview
The
Integration Agent (IA)
allows you to leverage your
NCR Counterpoint
data with
NCR Retail Online (NRO)
. During the install, a new service is added along with several files and folders. Prior to installing the
IA
, verify you meet the
Minimum Requirements
necessary in order to effortlessly integrate your NCR Counterpoint data with NRO.
Installation Instructions
*IMPORTANT:
Before installing the Integration Agent, please remove all CPTOCPOL-###.txt files from your Ecommerce directory (CPOnline folder). To do so, follow these steps:
1. In Counterpoint, navigate to
Setup
/
Ecommerce
/
Control
. From the main tab of the ecommerce control file, click the hyperlink in the field labeled Ecommerce Directory. This will open your CPOnline folder. Either completely delete all of the CPTOCPOL-###.txt, or archive them to a sub-folder.
2. It is
REQUIRED
that the Integration Agent be installed while logged in as the
local
Administrator account on the PC or Server where Counterpoint is installed. If the IA does not have the rights to create or modify files on the server, it will not be able to complete the installation process.
3. It is
RECOMMENDED
that the Integration Agent be installed on the same hard drive or partition as Counterpoint. Installing the software on a different local drive will cause the Company Editor on Step 11 to not populate correctly. There is a work around for this which will be discussed during Step 11 of the installation instructions.
TIP:
It's a good idea to routinely delete those publish files and then empty your computer's recycle bin. It is not necessary to keep those files for more than two weeks. Anything older than two weeks can be deleted.
-
To install the
Integration Agent (IA)
you'll need the
RadiantIntegrationAgent.msi
file. Click on the .msi file to download it and follow the steps below for assistance.
-
To determine where to install these files, please log in to
NCR Counterpoint
and navigate to
Setup / System / Registration
. If the
Multi-Site
option is selected, you are a
Multi-Site
store. If it's not selected, you are a
Single Site
or
WAN
store.
-
Multi-Site
stores must run the
IA
on the
Hub system ONLY
.
-
Single Site
or
WAN
stores must run the
IA
on the
NCR Counterpoint server ONLY
.
Note:
If you have questions regarding where to install the
IA
, please contact support at
Support.RetailApps@ncrretailonline.com
.
-
Copy the
RadiantIntegrationAgent.msi
file to the appropriate location, depending on what was discovered on #2 above.
-
If not logged in as the administrator, log in as the administrator now. Navigate to the location of
RadiantIntegrationAgent.msi
and double click on the file.
TIP:
If .NET 4.0 is already installed on your system, skip steps 5 & 6 and proceed to step 7 below.
If .NET 4.0 is
not
installed, the following window will be displayed:
-
Select
Yes
,
to be redirected to Microsoft's website to download and install .NET 4.0 Framework. Depending on your OS, you may need to reboot your system after the .NET 4.0 Framework installation is complete.
-
Repeat step 4 above to relaunch the .MSI to install the Integration Agent.
-
The
Radiant
Integration
Agent
Setup Wizard begins
, select
Next >
.
-
Use the default folder listed and select
Next >
.
TIP:
If you must change the location, select the
Browse
button to choose a new folder.
To view the amount of space available on your drive(s) select
Disk Cost
.
-
Select
Next >
to continue the installation process.
-
The
Radiant Integration Agent
installation displays a status window as it begins.
-
Next, the
Company Editor
is displayed. Select your
Top Level Directory
and
Company Alias
and select
Save
.
TIP:
If you don't know your
Top Level Directory
, log in to NCR
Counterpoint
and navigate to
System / Views / Environment
and click on the
Identification
tab.
TIP
:
If you have installed the Integration Agent on a different drive or partition on the server where Counterpoint is installed, the Company Editor may be blank. If this happens, click
Save
on the Company Editor screen. Once the IA has completed it's installation, navigate to:
C:\Program Files \ Radiant Systems \ Integration Agent \ Bin \ CounterPointCore (for Windows XP and Server 2003)
C:\Program Files (x86) \ Radiant Systems \ Integration Agent \Bin \CounterPointCore (for Windows Vista and above, Server 2008 and above)
Run
CompanyEditor.exe
. Click the
Add
button and browse the system to the Counterpoint Top Level directory (Usually C:\Program Files \ Radiant Systems \ CounterPoint \ CPSQL.1 \ TopLevel). Once the Top Level directory has been identified, it will find all the companies setup in Counterpoint. Select the check box labeled
Active
next to the company that has been registered for NRO, and then also check the NRO check box. If you have registered for Customer Connect and / or Smart Alerts, be sure to select those as well. Once this is done, click
Save
.
-
A
File Saved
window appears when the
companies.xml
file is created. Select
OK
to continue.
-
When the
Installation Complete
message appears, select
Close
to exit.
-
Several tasks occur in the background after installing the IA. In the meantime, review the email you received including your NRO credentials. Log in to the
NRO Admin Panel
using the
User Name
and
Password
provided in the email. The following steps will guide you through the process of changing your password for your Integration Agent User:
-
Select
System > Web Services > SOAP-XML-RPC-Users
-
Click on the user,
Counterpoint_IA
, and enter a
new password
in the
New API Key
field. Enter the same key in the
API Key Confirmation
field.
-
Click
Save User
, found on the top right side of the page. When complete, proceed with the step below.
-
To complete your setup of NRO, run the
NRO Connection Configuration
.
TIPS:
Files and Folders Installed
The
Integration Agent
installs a service and several files and folders on your system. What you need to be most familiar with can be found in the table below.
|