ivend installation manual

16
 iVend Retail Installation Guide Version: 6 July 2013

Upload: ayman-badr

Post on 13-Apr-2018

462 views

Category:

Documents


23 download

TRANSCRIPT

Page 1: 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

Page 2: IVend Installation Manual

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

Page 3: IVend Installation Manual

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

Page 4: IVend Installation Manual

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.

Page 5: IVend Installation Manual

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.

Page 6: IVend Installation Manual

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.

Page 7: IVend Installation Manual

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

Page 8: IVend Installation Manual

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

Page 9: IVend Installation Manual

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

Page 10: IVend Installation Manual

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

Page 11: IVend Installation Manual

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.

Page 12: IVend Installation Manual

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

Page 13: IVend Installation Manual

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

Page 14: IVend Installation Manual

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

Page 15: IVend Installation Manual

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

Page 16: IVend Installation Manual

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

Page 17: IVend Installation Manual

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

Page 18: IVend Installation Manual

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.

Page 19: IVend Installation Manual

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

Page 20: IVend Installation Manual

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.

Page 21: IVend Installation Manual

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

Page 22: IVend Installation Manual

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

Page 23: IVend Installation Manual

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. 

Page 24: IVend Installation Manual

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)

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 

Page 25: IVend Installation Manual

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

Integration Failure Log – Only available at iVend Enterprise Server  

Page 26: IVend Installation Manual

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

Page 27: IVend Installation Manual

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.

Page 28: IVend Installation Manual

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.

Page 29: IVend Installation Manual

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.

Page 30: IVend Installation Manual

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 

Page 31: IVend Installation Manual

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

Page 32: IVend Installation Manual

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.

Page 33: IVend Installation Manual

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

Page 34: IVend Installation Manual

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.

Page 35: IVend Installation Manual

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.

Page 36: IVend Installation Manual

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.

Page 37: IVend Installation Manual

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.

Page 38: IVend Installation Manual

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.

Page 39: IVend Installation Manual

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.

Page 40: IVend Installation Manual

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.

Page 41: IVend Installation Manual

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.

Page 42: IVend Installation Manual

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.

Page 43: IVend Installation Manual

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.

Page 44: IVend Installation Manual

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:

Page 45: IVend Installation Manual

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

Page 46: IVend Installation Manual

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

Page 47: IVend Installation Manual

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.

Page 48: IVend Installation Manual

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.

Page 49: IVend Installation Manual

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.

Page 50: IVend Installation Manual

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.

Page 51: IVend Installation Manual

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

Page 52: IVend Installation Manual

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 

Page 53: IVend Installation Manual

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

Page 54: IVend Installation Manual

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

Page 55: IVend Installation Manual

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

Page 56: IVend Installation Manual

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

Page 57: IVend Installation Manual

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

Page 58: IVend Installation Manual

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