Installation Guide WS

Installing Each Component

1 IIS (Internet Information Services)

Download the archive "WebServiceInstaller.7z" from the address http://portal.sbsoftware.ro/ipos/Android/Releases/ and extract it to the "C:\BBC" directory of the store.

Within the extracted directory, please run "MasterInstall Win10,Win8 x64" ( x86 for Windows 10, 32-bit ) WITH ADMINISTRATOR PRIVILEGES.

Then, press the space key (when your command prompt looks like the one in the image below), and the installation process will begin.

Proceed with next until a pop-up appears with two installation options (custom and default). Select the custom installation, and keep only the "SelfSSL 1.0" option checked, as illustrated in the image below. Uncheck the other options.

Finally, click Yes as shown in the image below, and the IIS installation will be completed.

To verify if IIS is installed, search for "IIS" in the menu bar, and the result should appear as illustrated below.

2 Web Services

2.1 Compatibility Between Web Services and Database (DB)

The higher version of the web service (WS) ensures compatibility with the features of the previous version of the database (DB). Specifically, a WS version with a higher number than the DB version is guaranteed to support all the features presented in the previous version of the database.

2.2 Compatibility with the Database

The latest version of the IPOS database is accessible when downloading the latest version of the Ipos application. Upon first login, the database will be automatically updated. In the accompanying image, it can be observed that a newer version of the IPOS application has been installed, and the database has been updated accordingly. If DBVersion does not appear in the database properties, it will be manually inserted by taking the version of the IPOS application. (This DBVersion is inserted in the "extended properties" of the respective DB property).

2.3 Where to Find the Latest Version of Web Services

The latest version of web services can be accessed in [BBC FTP]. To access this BBC FTP, please use AnyDesk with the address "bbcftp1@ad", and the corresponding password can be found in KeePass at the location → SB Software → BBC FTP.

Location of the latest version of WS.

The path and exact locati on of the latest WS version.

2.4 Web Services Installation

THIS PARAGRAPH IS EXECUTED ONLY IF IT IS A NEW CLIENT

Create the folder "WS-CLIENT_NAME" in the "C:" directory of the BBCFTP. In this folder, copy the latest version of web services from the "C:\WS-IPOS-LATESTVS" directory.

Modify the path where setting name='PublishPath' from the "C:\BBC\IposUpdater" folder on the store PC (using, for example, Notepad+ or simple notepad), of the file "iposUpdater.exe.config", as illustrated in the image below.

In this case, the installation is performed on a Virgo store.

Run the SCHEDULED OPERATION "IposUpdater", created during the installation of the IPOS kit on the store, which will download and install web services on the PC.

Check the installation status by following the log: "IPOS.Updater.TraceYyyy_mm_dd" with the path: "C:\BBC\Logs\yyyy_mm\IPOS.Updater".

Do not forget to create the windows user iposservice and the sql user iposservice as well

2.5 Verifying Web Services Functionality

To verify the current version of the WebService, open the browser and enter the address: "http://localhost/IposVision/v4/PromoEngine/api/Version/GetVersion" in the "Search" bar, and the current version of the WS should be displayed as shown in the image below.

Verification of Web Services functionality can be performed using the "CheckIposVisionWebServices" application from the "C:\BBC\WebServiceInstaller" directory of the respective PC. The result should be similar to the one presented in the image below to confirm the correctness of the operation.