Download - IVend Installation Manual
7/23/2019 IVend Installation Manual
http://slidepdf.com/reader/full/ivend-installation-manual 1/58
iVend Retail
Installation Guide
Version: 6
July 2013
7/23/2019 IVend Installation Manual
http://slidepdf.com/reader/full/ivend-installation-manual 2/58
iVend Retail Installation Guide
Page 2 of 58
Table of ContentsTypographic Conventions ............................................................................................... 4
Purpose ........................................................................................................................... 5
Target Audience ............................................................................................................. 5 Hardware and Software Requirements........................................................................... 5
Installation Preparations ................................................................................................ 5
iVend Components ......................................................................................................... 5
Enterprise Server ............................................................................................................... 5
Store Server ....................................................................................................................... 5
Point of Sale ....................................................................................................................... 6
SAP Business One Integration Service .............................................................................. 6
Management Console ....................................................................................................... 6
iVend API ........................................................................................................................... 6Installing iVend Retail on Single Machine (Without SAP Business One Integration) ....... 7
Purpose .............................................................................................................................. 7
Procedure ........................................................................................................................... 7
Multi location Installation ............................................................................................. 14
Purpose ............................................................................................................................ 14
Procedure ......................................................................................................................... 14
iVend Retail Configuration ............................................................................................ 24
iVend Enterprise Master Data Backup ............................................................................ 26
iVend – New Store Initialization (Restore) ...................................................................... 28
iVend SBO Integration Service Configuration ................................................................ 29
Replication Service Configuration – At iVend Enterprise ............................................... 32
Replication Service Configuration – At Retail Store ....................................................... 35
Connection Manager ....................................................................................................... 37
Integration Monitor ......................................................................................................... 39
Integration Failure Log .................................................................................................... 40
Replication Monitor ......................................................................................................... 41
iVend Mobile Installation and Setup ............................................................................. 42
Registering the iVend add-on .......................................................................................... 44
SAP Business One Add-On Installation Procedure ........................................................ 45
Registering the iVend add-on .......................................................................................... 45
Removing the iVend add-on ............................................................................................ 46
New Menu Items in SAP Business One ............................................................................ 48
Database Mirroring For High Availability ...................................................................... 49
Prerequisites .................................................................................................................... 49
Servers ...................................................................................................................... 49
7/23/2019 IVend Installation Manual
http://slidepdf.com/reader/full/ivend-installation-manual 3/58
iVend Retail Installation Guide
Page 3 of 58
Change the Recovery Model of iVend database ...................................................... 49
Set the same service accounts on all the servers involved in mirroring .................. 50
Backing up the Retail database and restoring it on Mirror Server.................................. 51
Setting up database for mirroring ................................................................................... 53
7/23/2019 IVend Installation Manual
http://slidepdf.com/reader/full/ivend-installation-manual 4/58
iVend Retail Installation Guide
Page 4 of 58
Icons
Icon Meaning
Caution
Example
Note
Recommendation
Syntax
Typographic Conventions
Type Style Description
Example text Words or characters that appear on the screen. These include
field names, screen titles, pushbuttons as well as menu names,
paths and options.
Cross-references to other documentation.
Example text Emphasized words or phrases in body text, titles of graphics andtables.
EXAMPLE TEXT Names of elements in the system. These include report names,
program names, transaction codes, table names, and individual
key words of a programming language, when surrounded bybody text, for example, SELECT and INCLUDE.
Example text Screen output. This includes file and directory names and theirpaths, messages, source code, names of variables and
parameters as well as names of installation, upgrade anddatabase tools.
EXAMPLE TEXT Keys on the keyboard, for example, function keys (such as F2) or
the ENTER key.
Example text Exact user entry. These are words or characters that you enter in
the system exactly as they appear in the documentation.
<Example text> Variable user entry. Pointed brackets indicate that you replacethese words and characters with appropriate entries.
7/23/2019 IVend Installation Manual
http://slidepdf.com/reader/full/ivend-installation-manual 5/58
iVend Retail Installation Guide
Page 5 of 58
Purpose
This document describes how to install and configure iVend Retail in different scenarios.
Target Audience
This document is designed for end users or consultants.
Hardware and Software Requirements
Please refer “Hardware & Software Specifications Guide” for this.
Installation Preparations
Before installing add-ons with SAP Business One Add-On Administration, you should:
Create a backup file of all your company’s production databases.
Check all hardware and software requirements as per the list given in “Hardware
Software Specifications Guide”
SQL Server 2008 and its services are up and running
iVend Components
There are five components that may be installed in an iVend implementation.
Enterprise Server
The Enterprise Server is where enterprise information is entered and wheresettings are made that affect all stores in the system. The Enterprise Server is where
data from all stores is consolidated.
Store Server
The Store Server is where information is entered about each store and
where settings are made affecting the behavior and limitations of each user and
each Point of Sale register. Master record information is synchronized to and fromthe Enterprise Server at this server. This primarily install database for the store andthe replication service on the machine.
7/23/2019 IVend Installation Manual
http://slidepdf.com/reader/full/ivend-installation-manual 6/58
iVend Retail Installation Guide
Page 6 of 58
Point of Sale
Each register has a point of sale client installed through which all forms ofsales transactions are conducted.
SAP Business One Integration Service
SAP Business One Integration Service provides the setting and means to
communicate data to and from the Enterprise Server and to monitor that activity.
Management Console
Management console connects to either Enterprise Server or Store Serverfor proving the User Interface for the data store on these servers. Based on the
database server it is connected to, from Management Console settings for theEnterprise or Store can be defined. Inventory transactions including inventory
movement, pricing and discounts can be managed from this User Interface.
iVend API
iVend API’s enables users to synchronize data between iVend Mobile and iVend Enterprise
and also enables you to integrate iVend with third party applications or ERP’s.
7/23/2019 IVend Installation Manual
http://slidepdf.com/reader/full/ivend-installation-manual 7/58
iVend Retail Installation Guide
Page 7 of 58
Installing iVend Retail on Single Machine (Without SAP
Business One Integration)
Purpose
1. This can be used for setting up the demo systems.
2. This can be used for installing the Single Store, Single POS production environment.
3. Installation includes Enterprise Server, Management Console, Point of Sale and iVend
APIs.
Procedure
1. Run setup.exe. This will launch the installation wizard.
2. Follow the instructions on the screen to complete the installation of iVend Retail.
Figure 1 – Setup Wizard Initialization Screen
7/23/2019 IVend Installation Manual
http://slidepdf.com/reader/full/ivend-installation-manual 8/58
iVend Retail Installation Guide
Page 8 of 58
3. In the following screen, choose the Next option.
.
Figure 2 – Setup Wizard Welcome Screen
4. In the License Agreement screen, after reading the EULA and then accepting the
License Agreement, click on Next button.
Figure 3 – Setup Wizard License Agreement Screen
7/23/2019 IVend Installation Manual
http://slidepdf.com/reader/full/ivend-installation-manual 9/58
iVend Retail Installation Guide
Page 9 of 58
5. In the Customer Information window, enter your user name and company name and
choose the Next button.
Figure 4 – Company/User Information screen
6. In the Destination Folder window, select Change button to change the installation
location and then choose the Next button.
Figure 5 – Destination Folder screen
7/23/2019 IVend Installation Manual
http://slidepdf.com/reader/full/ivend-installation-manual 10/58
iVend Retail Installation Guide
Page 10 of 58
7. In Installation Mode Selection window, choose the Single Machine Installation button.
Figure 6 – Installation Mode Selection Screen
8. In the Database Setup Selection screen, select the correct database option and thenclick on Next button.
a. Create New Database: Select this option, if you are creating a production
environment
b. Use Existing Database: Select this option, if you already have an existing iVenddatabase and would like to use the same for this installation.
c.
Create Demo Database: Select this option if you are setting up a demo
machine.
Figure 7 – Database Setup Selection Screen
7/23/2019 IVend Installation Manual
http://slidepdf.com/reader/full/ivend-installation-manual 11/58
iVend Retail Installation Guide
Page 11 of 58
Note
If installer does not find SQL Server installation on local machine then an option to
install SQL Server 2008 R2 Express Edition is shown to the user.
Note
If installer does not find IIS Server installation on local machine then an option to
install IIS Server is shown to the user.
9. In the Database Server window, enter the following information and choose the Next
button.
a.
Database Serverb. Login Id
c. Password
d. Database Name
Figure 8 – Database Server Screen
10. In the Ready to Install window, choose the Next button.
7/23/2019 IVend Installation Manual
http://slidepdf.com/reader/full/ivend-installation-manual 12/58
iVend Retail Installation Guide
Page 12 of 58
Figure 9 – Install Screen
11. Installer will run the installation process and would copy the files and database scripts.
Figure 10 – Copying Files
7/23/2019 IVend Installation Manual
http://slidepdf.com/reader/full/ivend-installation-manual 13/58
iVend Retail Installation Guide
Page 13 of 58
Figure 11 – Executing Database Scripts
12. In the following window, choose the Finish button to complete the installation.
Figure 12 – Installation Completion Screen
7/23/2019 IVend Installation Manual
http://slidepdf.com/reader/full/ivend-installation-manual 14/58
iVend Retail Installation Guide
Page 14 of 58
Multi location Installation
Purpose
1.
This option installs an instance of the iVend Retail Enterprise Server at the head officeor a Store Server at the store.
2. This option installs an instance of the iVend Retail Enterprise Server at the head office
with SAP Business One Integration Components.
3. Installing iVend Management Console and Point of Sale.
Procedure
1. Run setup.exe. This will launch the installation wizard.
2. Follow the instructions on the screen to complete the installation of iVend Retail.
Figure 13 – Setup Wizard Initialization Screen
7/23/2019 IVend Installation Manual
http://slidepdf.com/reader/full/ivend-installation-manual 15/58
iVend Retail Installation Guide
Page 15 of 58
3. In the following screen, choose the Next option.
Figure 14 – Setup Wizard Welcome Screen
4. In the License Agreement screen, after reading the EULA and then accepting the
License Agreement, click on Next button.
Figure 15 – Setup Wizard License Agreement Screen
7/23/2019 IVend Installation Manual
http://slidepdf.com/reader/full/ivend-installation-manual 16/58
iVend Retail Installation Guide
Page 16 of 58
5. In the Customer Information window, enter your user name and company name and
choose the Next button.
Figure 16 – Company/User Information screen
6. In the Destination Folder window, select Change button to change the installation
location and then choose the Next button.
Figure 17 – Destination Folder screen
7/23/2019 IVend Installation Manual
http://slidepdf.com/reader/full/ivend-installation-manual 17/58
iVend Retail Installation Guide
Page 17 of 58
7. In Installation Mode Selection window, choose the Choose an Installation option
button.
Figure 18 – Installation Mode Selection Screen
8. In the Installation Option screen, select one of the options based on the following
Figure 19 – Installation option Screen
7/23/2019 IVend Installation Manual
http://slidepdf.com/reader/full/ivend-installation-manual 18/58
iVend Retail Installation Guide
Page 18 of 58
Server Installation: Select this option if you are installing iVend Enterprise oriVend Store on the current machine and do not want to install the clientcomponents like Management Console or iVend POS. This will also give an
option to install iVend APIs along with the other server components. Select iVend
APIs as component to install if you would like to connect iVend Mobile to yourstores or enterprise server.
Figure 20–
Server Installation option Screen
Client Installation: Select this option if you just want to install iVend
Management Console or iVend POS on the current machine.
7/23/2019 IVend Installation Manual
http://slidepdf.com/reader/full/ivend-installation-manual 19/58
iVend Retail Installation Guide
Page 19 of 58
Figure 21 – Client Installation option Screen
Custom Installation: Select this option if you want to install both iVend server and
client components on the current machine.
Figure 22 – Custom Installation option Screen
7/23/2019 IVend Installation Manual
http://slidepdf.com/reader/full/ivend-installation-manual 20/58
iVend Retail Installation Guide
Page 20 of 58
Note
Please note that the Store Server and the SAP Business One Integration Service cannot be
installed on the same machine. However the Enterprise server and SAP Business One
Integration Service can be installed on the same server.
9. In the Database Server window, enter the following information and choose the Next
button.
a. Database Server
b. Login Id
c. Password
d. Database Name
Figure 23 – Database Server Screen
10. In the Ready to Install window, choose the Next button.
7/23/2019 IVend Installation Manual
http://slidepdf.com/reader/full/ivend-installation-manual 21/58
iVend Retail Installation Guide
Page 21 of 58
Figure 24 – Install Screen
11. Installer will run the installation process and would copy the files and database scripts.
Figure 25 – Copying Files
7/23/2019 IVend Installation Manual
http://slidepdf.com/reader/full/ivend-installation-manual 22/58
iVend Retail Installation Guide
Page 22 of 58
Figure 26 – Executing Database Scripts
12. In the following window, choose the Finish button to complete the installation.
Figure 27 – Installation Completion Screen
7/23/2019 IVend Installation Manual
http://slidepdf.com/reader/full/ivend-installation-manual 23/58
iVend Retail Installation Guide
Page 23 of 58
After the successful installation, user has to configure the Point of Sale, theManagement Console and SBO Integration Service credentials with help of “iVendConfiguration Manager”. Please refer to the “iVend Retail Configuration” section.
7/23/2019 IVend Installation Manual
http://slidepdf.com/reader/full/ivend-installation-manual 24/58
iVend Retail Installation Guide
Page 24 of 58
iVend Retail Configuration
After completing the installation of the iVend, click on Start iVend Retail
iVend Configuration Manager.
Figure 28 – System Tray showing iVend Configuration Manager
The icon is displayed in system tray. The user can right click on icon and selectany of the following menu items.
Figure 29 – Integration Service
o Database Backup (Available only for iVend Enterprise Server Installation)
o Database Restore (Available only for Store server)
o
Configure Service
o Replication Service – Only available at iVend Store Server and iVend Enterprise Server
o Integration Service – Only available at iVend Enterprise Server
o Connection Manager - Only available at iVend Enterprise Server
o Upgrade Information - Only available at iVend Enterprise Server
o Upgrade Progress
o Replication Monitor – Only available at iVend Store Server and iVend Enterprise Server
7/23/2019 IVend Installation Manual
http://slidepdf.com/reader/full/ivend-installation-manual 25/58
iVend Retail Installation Guide
Page 25 of 58
o Replication Monitor – Mobile : – Only available at iVend Store Server and iVend Enterprise
Server
o Integration Monitor – Only available at iVend Enterprise Server
o
Integration Failure Log – Only available at iVend Enterprise Server
7/23/2019 IVend Installation Manual
http://slidepdf.com/reader/full/ivend-installation-manual 26/58
iVend Retail Installation Guide
Page 26 of 58
iVend Enterprise Master Data Backup
The Master Data Backup screen is available where the Enterprise Server is installed. Thescreen allows the user to generate a backup file of iVend master tables for a specific store.
Enter the iVend Enterprise database credentials. Click “Connect” button. Select the store
for which the backup file needs to be generated.
Figure 30 – Master Data backup at iVend Enterprise
7/23/2019 IVend Installation Manual
http://slidepdf.com/reader/full/ivend-installation-manual 27/58
iVend Retail Installation Guide
Page 27 of 58
Field Description/Activity
Master Data Backup
Server Name Sepecify the SQL Server name/IP of the of iVend Enterprise Database.
Database Name Enter the name of the iVend Enterprise Database.
User Id Enter the SQL DB UserId for the iVend Enterprise Database.
Password Enter the DB Password for the iVend Enterprise Database.
Site Id Site Id of the store for which the backup file needs to be generated.
Buttons
Connect Fill the required information and click connect button. Select the store
for which the backup needs to be generated.
Backup Click button to start backup of the database.
OK Closes the form.
Cancel Closes the form.
7/23/2019 IVend Installation Manual
http://slidepdf.com/reader/full/ivend-installation-manual 28/58
iVend Retail Installation Guide
Page 28 of 58
iVend – New Store Initialization (Restore)
This screen allows restoring the master data backup created at the enterprise. This backupcan be used to create a new store by using the restore utility thus saving the time and effort
required to initialize master data replication for each store.
Figure 31 – New Store Initialization (Restore)
Field Description/Activity
Connection Properties
Server Name Sepecify the SQL Server name/IP of the SQL Server of iVend
Store Database.
Database Name Enter the name of the iVend Store Database.
User Id Enter the SQL DB UserId for the iVend Store Database.
Password Enter the DB Password for the iVend Store Database.
Backup File Browse and select the Backup file that was generated at iVend
enterprise for this site id.Buttons
Connect Fill the required information and click connect to connect to
iVend store database.
Restore Click button to start restore of the database.
OK Closes the form.
Cancel Closes the form.
7/23/2019 IVend Installation Manual
http://slidepdf.com/reader/full/ivend-installation-manual 29/58
iVend Retail Installation Guide
Page 29 of 58
iVend SBO Integration Service Configuration
The Integration Service needs to be configured and started. The SAP Business OneCompany, iVend Enterprise and Integration credentials need to be entered.
Figure 32 – SAP Business One Settings Information
Field Description/Activity
SAP Business One
Server Name Sepecify the SQL Server name/IP of the SQL Server of SAP BusinessOne Database.
Database
Name
Enter the name of the SAP Business One Database.
DB User Id Enter the SQL DB UserId for the SAP Business One Database.
DB Password Enter the DB Password for the SAP Business One Database.User Id Enter the integration User Id. Select one from B1i or CXSRetail. The
user selected here must be a superuser in SAP Business One.
Password Enter the password setup in SAP Business one for the selected user.
7/23/2019 IVend Installation Manual
http://slidepdf.com/reader/full/ivend-installation-manual 30/58
iVend Retail Installation Guide
Page 30 of 58
Figure 33 – iVend Enterprise Settings Information
Field Description/Activity
iVend Enterprise
Server Name Sepecify the SQL Server name/IP of the SQL Server of iVend
Enterprise Database.
Database
Name
Enter the name of the iVend Enterprise Database.
User Id Enter the SQL DB UserId for the iVend Enterprise Database.
Password Enter the DB Password for the iVend Enterprise Database.
FailoverServer
Enter the SQL Server Name if the mirror server is configured for theserver defined in Server Name field. For more information see setting
up mirror server
7/23/2019 IVend Installation Manual
http://slidepdf.com/reader/full/ivend-installation-manual 31/58
iVend Retail Installation Guide
Page 31 of 58
Figure 34 –Integration Settings Information
7/23/2019 IVend Installation Manual
http://slidepdf.com/reader/full/ivend-installation-manual 32/58
iVend Retail Installation Guide
Page 32 of 58
Replication Service Configuration – At iVend Enterprise
The Enterprise Replication Windows Service needs to be configured and started. The iVendEnterprise database credentials need to be entered.
Field Description/Activity
Integration
Server Name Specify the SQL Server name/IP of the SQL Server of CXSIntegration
database. It is same as that of SAP Business One database server.
Database
Name
This is disabled field and is defaulted to CXSIntegration.
User Id Enter the SQL DB UserId for the CXSIntegration Database.
Password Enter the DB Password for the CXSIntegration Database.
Auto Retry If this flag is checked then the integration service will autoretry positng the
failed records to SAP Business One which were generated/updated in iVend.
Auto Retry
Interval(Minu
tes)
Specify the time interval in which the service will try posting the failed
records. Ideally this should be setup as more than 15 minutes.
Buttons
Start After filling the required fileds and updating the settings, press this button to
start the services.
Stop If the service is running, press this button to stop the service.
Update After filling the required filed, click on update to update the changedsettings.
Cancel Click to close the form.
7/23/2019 IVend Installation Manual
http://slidepdf.com/reader/full/ivend-installation-manual 33/58
iVend Retail Installation Guide
Page 33 of 58
Figure 35 –Replication Enterprise Settings Information
7/23/2019 IVend Installation Manual
http://slidepdf.com/reader/full/ivend-installation-manual 34/58
iVend Retail Installation Guide
Page 34 of 58
Field Description/Activity
Enterprise Settings
Server Name Sepecify the SQL Server name/IP of the SQL Server of iVend
Enterprise Database.
Database
Name
Enter the name of the iVend Enterprise Database.
User Id Enter the SQL UserId for the iVend Enterprise Database.
Password Enter the password for the iVend Enterprise Database.
Failover
Server
Enter the SQL Server Name if the mirror server is configured for the
server defined in Server Name field. For more information see setting
up mirror server
Buttons
Start After filling the required fileds and updating the settings, press this
button to start the services.
Stop If the service is running, press this button to stop the service.
Update After filling the required filed, click on update to update the changed
settings.
Cancel Click to close the form.
7/23/2019 IVend Installation Manual
http://slidepdf.com/reader/full/ivend-installation-manual 35/58
iVend Retail Installation Guide
Page 35 of 58
Replication Service Configuration – At Retail Store
The iVend Replication Store Windows Service needs to be configured at the store.The store database credentials have to be specified. In the Enterprise Settings, the
Enterprise credentials have to be specified.
Figure 36 –Replication Enterprise Settings Information
Field Description/Activity
Enterprise Settings
Server Name Sepecify the SQL Server name/IP of the SQL Server of iVend Enterprise
Database.
Database
Name
Enter the name of the iVend Enterprise Database.
User Id Enter the SQL UserId for the iVend Enterprise Database.
Password Enter the password for the iVend Enterprise Database.
7/23/2019 IVend Installation Manual
http://slidepdf.com/reader/full/ivend-installation-manual 36/58
iVend Retail Installation Guide
Page 36 of 58
Figure 37 –Replication Local Settings Information
Field Description/Activity
Local Settings
Server Name Sepecify the SQL Server name/IP of the SQL Server of iVend Store
Database.
DatabaseName
Enter the name of the iVend Store Database.
User Id Enter the SQL UserId for the iVend Store Database.
Password Enter the password for the iVend Store Database.
Site Id Enter the Site Id for the store.
Buttons
Start After filling the required fileds and updating the settings, press this
button to start the services.
Stop If the service is running, press this button to stop the service.
Update After filling the required filed, click on update to update the changed
settings.
Cancel Click to close the form.
7/23/2019 IVend Installation Manual
http://slidepdf.com/reader/full/ivend-installation-manual 37/58
iVend Retail Installation Guide
Page 37 of 58
Connection Manager
Connection manager need to be configured on the systems on which any of the followingcomponents are installed
iVend Management Console iVend POS
iVend APIs
Figure 38 – Connection Settings Information
Field Description/Activity
iVend APIs/POS / Management Console Connection Information
Server Name Enter the SQL Server Name for iVend
Database Name Enter the iVend Database Name
User Id Enter the User Id for the iVend Database
Password Enter the password for the iVend Database
Failover Server Enter the SQL Server Name if the mirror server is configured forthe server defined in Server Name field. For more information see
setting up mirror server
Network Information
Server Name Display the name of the server. This can be used in iVend Mobile
configuration to connect to iVend Server.
7/23/2019 IVend Installation Manual
http://slidepdf.com/reader/full/ivend-installation-manual 38/58
iVend Retail Installation Guide
Page 38 of 58
Server IP Address Display the IP Address of the server. This can be used in iVend
Mobile configuration to connect to iVend Server.
7/23/2019 IVend Installation Manual
http://slidepdf.com/reader/full/ivend-installation-manual 39/58
iVend Retail Installation Guide
Page 39 of 58
Integration Monitor
Figure 39 – Integration Monitor
From this screen, the user can view the status of the data integration between SAP
Business One and iVend. The upper half of the screen shown the data that is updated in SAPBusiness One and is to be integrated with iVend whereas the bottom half of the screen will
show the data that is modified in iVend and is then to be integrated to SAP Business One.
Marking the option “Do not display failed message” will not show the records that
have failed to integrate with SAP Business One.
7/23/2019 IVend Installation Manual
http://slidepdf.com/reader/full/ivend-installation-manual 40/58
iVend Retail Installation Guide
Page 40 of 58
Integration Failure Log
Figure 40 – Integration Failure Log
Through this screen, the user can view only failed events while integration data
between “SBO to iVend” and “iVend to SBO”. The screen also has the option check multiplefailed events in grid and press “Retry” button. It will reinitiate selected events. User can also
download the failed records in excel for further analysis for the cause of the failure.
Use Show Complete Error Message option will show the user the complete error
message that SAP Business One has thrown while posting the record in SAP Business One.
7/23/2019 IVend Installation Manual
http://slidepdf.com/reader/full/ivend-installation-manual 41/58
iVend Retail Installation Guide
Page 41 of 58
Replication Monitor
Figure 41 – Replication Monitor
Through this screen the users can view the status of replication to store or enterprise server.
7/23/2019 IVend Installation Manual
http://slidepdf.com/reader/full/ivend-installation-manual 42/58
iVend Retail Installation Guide
Page 42 of 58
iVend Mobile Installation and Setup
Install iVend POS (Mobile) from Apple App Store.
1. For the same search for iVend POS in Apple Store or
2.
Use this link: https://itunes.apple.com/us/app/ivend-pos/id653409390?ls=1&mt=8
3. Run the iVend POS app in your mobile device.
4. Go to Setup option
5.
Turn off the “Demo Mode” click “Save” button. 6. Lookup the iVend Connection Manager for your machine IP address.
7/23/2019 IVend Installation Manual
http://slidepdf.com/reader/full/ivend-installation-manual 43/58
iVend Retail Installation Guide
Page 43 of 58
7. Enter your machine IP address in the Server Address field and enter the POS API Token
in the API token field (API tokens will be generated by the system when creating a new
mobile POS from iVend Management Console).
Ensure that you have connectivity between your iVend API server (machine on whichiVend APIs are installed) and your mobile device.
You must have port 8642 open in your firewall to allow communication between iVend
Mobile POS and iVend Server.
8. Click on Initialize button.
9. Wait for the initialization process to complete successfully.
10.
Click the back button to display the login view.11. Login to iVend mobile POS using your user name and password setup in iVend.
7/23/2019 IVend Installation Manual
http://slidepdf.com/reader/full/ivend-installation-manual 44/58
iVend Retail Installation Guide
Page 44 of 58
Registering the iVend add-on
The add-on installation procedure starts by registering the add-on with the SAP
Business One server. This registration procedure triggers the upload of the add-oninstallation package to the SAP Business One server. To register the add-on, you must have
super user authorization.
To use SAP Business One Add-On Administration to register the add-on, follow this
procedure:
7/23/2019 IVend Installation Manual
http://slidepdf.com/reader/full/ivend-installation-manual 45/58
iVend Retail Installation Guide
Page 45 of 58
SAP Business One Add-On Installation Procedure
Registering the iVend add-on
The add-on installation procedure starts by registering the add-on with the SAPBusiness One server. This registration procedure triggers the upload of the add-on
installation package to the SAP Business One server. To register the add-on, you must have
super user authorization.
To use SAP Business One Add-On Administration to register the add-on, follow this
procedure:
Ste
p
Action Result
1. Open SAP Business One. Log on to acompany with a user that has super user
authorization.
The SAP Business One applicationopens for the company database.
2. On the SAP Business One main menu,
choose Administration Add-Ons Add-
On Administration.
The Add-On Administration windowappears.
3. Choose Register Add-On The Add-On Registration window
appears.
4. Browse for the path for the Add-On
Registration Data file (*.ard file) and choose
the iVend add-on file5. Check if the displayed path for the Add-OnInstallation Package (*.exe) is correct.
6. Select the Assign to Current Company
option, to assign the add-on to the currentcompany after installation. This option is
selected by default.
7. Choose OK In the Add-On Administration window, the name of the add-on
appears in the list of Available Add-
Ons.
The add-on installation package hasbeen uploaded to the SAP BusinessOne server. The add-on is now
available for all company databaseson this server.
8. Choose OK on the Add-on Administration
window.
Add-on Administration window closes
9. Close the SAP Business One application. SAP Business One application closes
10. Open SAP Business One. Log on to acompany with a user that has super user
authorization.
The SAP Business One applicationopens for the company database.
The add-on installation will launch
7/23/2019 IVend Installation Manual
http://slidepdf.com/reader/full/ivend-installation-manual 46/58
iVend Retail Installation Guide
Page 46 of 58
automatically.
11. Check the option Ask for restart on the
installer window and click the Install add-onbutton.
The add-on installation will
commence and on completion asuccess message box will be
displayed.12. Click the OK button on the success message
boxA SAP Business One systemmessage will be displayed informing
the user that SAP Business One will
close after add-on installation.
13. Click the OK button on the system message The SAP Business One application
closes.
Removing the iVend add-on
The add-on cannot be removed from the server or a client manually using the
Add/Remove Programs feature in Microsoft® Windows. You must remove an add-on usingSAP Business One Add-On Administration.
When you use the add-on administration tool to remove an add-on, the add-on
installation package is removed from the SAP Business One server. When a client with theinstalled add-on later connects to that server, the add-on is also removed from the client.
The removal procedure with SAP Business One Add-On Administration is as follows:
Step Action Result
1. Open SAP Business One where the
add-on is installed. Log on with auser that has super userauthorization. Log on to a company
database with the add-on.
The SAP Business One application opens
for the company database.
2. On the SAP Business One main
menu, choose Administration
Add-Ons Add-On Administration.
The Add-On Administration windowappears.
3. Select the Company Preferences
tab.
The add-ons installed on the client are
displayed in the Available Add-Ons list.The add-ons assigned to the company are
displayed in the Company-Assigned Add-
Ons list.4. If the add-on that you want toremove is assigned to the company,
first un-assign it:
To un-assign the add-on, select the
add-on in the Company-Assigned
Add-Ons list. Choose .
The add-on is removed from the list of
Company-Assigned Add-Ons.
5. Select the add-on in the Available Add-Ons list. Choose Remove Add-on.
The add-on is removed from the list of Available Add-Ons.The system will automatically start the
7/23/2019 IVend Installation Manual
http://slidepdf.com/reader/full/ivend-installation-manual 47/58
iVend Retail Installation Guide
Page 47 of 58
removal procedure the next time you start
the SAP Business One application from anyclient that is connected to the server.
7/23/2019 IVend Installation Manual
http://slidepdf.com/reader/full/ivend-installation-manual 48/58
iVend Retail Installation Guide
Page 48 of 58
New Menu Items in SAP Business One
On successful installation of the add-on, the following additional menu items will beavailable on the SAP Business One standard menu.
Figure 42 – iVend Menu within SAP Business One
On expanding the Administration System Initialization module in the main menu, a
new folder “iVend Retail” can be seen as shown above.
7/23/2019 IVend Installation Manual
http://slidepdf.com/reader/full/ivend-installation-manual 49/58
iVend Retail Installation Guide
Page 49 of 58
Database Mirroring For High Availability
Caution
If your servers are not in domain and you are using workgroups then please contactCitiXsys for configuring the database mirroring for iVend.
Prerequisites
All the database servers should have the same version of SQL Server installations.
Servers
This setup would require the following 3 SQL Servers
a. Principal Server: This is the server that has the principal CXSRetail database which is
to be mirrored.
b. Mirrored Server: This server would host the mirror copy of the principal database.
c. Witness Server: This server helps in automatic switching of database in case of
principal server failures.
Change the Recovery Model of iVend database
1. Right click on the “CXSRetail” database and then select properties from the context
menu.
2. In properties windows select the Options tab from the left menu as shown below.
3. Change the values of Recovery Model from current value of Simple to Full.
4. Click OK button to save the settings.
7/23/2019 IVend Installation Manual
http://slidepdf.com/reader/full/ivend-installation-manual 50/58
iVend Retail Installation Guide
Page 50 of 58
Figure 43–
Database properties of iVend database (CXSRetail)
Set the same service accounts on all the servers involved in mirroring
Repeat the following steps on all of the SQL Servers
d. Principal Server: This is the server that has the principal CXSRetail database which is
to be mirrored.
e. Mirrored Server: This server would host the mirror copy of the principal database.
f. Witness Server: This server helps in automatic switching of database in case of
principal server failures.
1. Open SQL Server Configuration Manager from program menu.
2. Under SQL Server Services tab, select the SQL Server services that are hosting the
iVend database.
3. Right click the service and open the properties of the SQL Server.
4. Under Log On tab change the setting “Log on as:” from Built-in-accounts to this
account as shown in the figure below. The format for this would be
[Domain]\[Account]
5. Click on “Apply” button to save the credentials.
6. Restart the SQL SERVER service.
7/23/2019 IVend Installation Manual
http://slidepdf.com/reader/full/ivend-installation-manual 51/58
iVend Retail Installation Guide
Page 51 of 58
Figure 44 – Set service account
Backing up the Retail database and restoring it on Mirror Server
1. Take the Full backup of the iVend Retail database from the principal server.
2. Take the Transaction Log backup of iVend Retail database from the principal server.
As shown below
7/23/2019 IVend Installation Manual
http://slidepdf.com/reader/full/ivend-installation-manual 52/58
iVend Retail Installation Guide
Page 52 of 58
Figure 45 – Full database backup Figure 46 – Transaction log backup
3. Restore the backup on the Mirror Server as shown below.
a. Restored database name should be the same as that of the principal server’s
database name.
b. The Recovery mode should be selected as (RESTORE WITH
NORECOVERY).
Figure 47 – Restore Database Figure 48 – Restore database options
7/23/2019 IVend Installation Manual
http://slidepdf.com/reader/full/ivend-installation-manual 53/58
iVend Retail Installation Guide
Page 53 of 58
Setting up database for mirroring
1. Right click on the principal server database which is to be mirrored.
Figure 49 – Principal database
2. Click on “Configure Security” button as shown below.
Figure 50 – Configure Security at Principal
7/23/2019 IVend Installation Manual
http://slidepdf.com/reader/full/ivend-installation-manual 54/58
iVend Retail Installation Guide
Page 54 of 58
3. Select the “Yes” option to include the Witness Server and then click on “Next”
button.
Figure 51 – Select witness server
4. Select the principal server and then click on “Next” button.
Figure 52 – Select principal server
7/23/2019 IVend Installation Manual
http://slidepdf.com/reader/full/ivend-installation-manual 55/58
iVend Retail Installation Guide
Page 55 of 58
5. Select the Mirror Server and then click on “Next” button.
Figure 53 – Select mirror server
6. Select the Witness server and then click on “Next” button.
Figure 54 – Select witness server
7/23/2019 IVend Installation Manual
http://slidepdf.com/reader/full/ivend-installation-manual 56/58
iVend Retail Installation Guide
Page 56 of 58
7. Leave the service accounts as blank and then click on “Finish” button.
Figure 52 – Service accounts
8. System will configure the endpoints for mirroring. Click “Close” button to proceed.
Figure 53 – Configuring End points
7/23/2019 IVend Installation Manual
http://slidepdf.com/reader/full/ivend-installation-manual 57/58
iVend Retail Installation Guide
Page 57 of 58
9. Click on “Start Mirroring” button to complete the setup.
Figure 54 – Start Mirroring
10. Verify the message shown in the Status to confirm that the mirroring has started.
Figure 55 – Verify Mirroring
7/23/2019 IVend Installation Manual
http://slidepdf.com/reader/full/ivend-installation-manual 58/58
iVend Retail Installation Guide
11. Refresh the status of the SQL SERVERS to verify that the principal database has
status as “Principal, Synchronized” whereas the status of the mirrored database on
Mirror Server is “Mirror, Synchronized/Restoring”.
Figure 56 – Mirroring in action