LS Retail Infoserver 5.

06 Quick Setup Guide

Author: Eiur Mr Arason Date: 30.10.2006

Copyright 2005, Landsteinar Strengur. All rights reserved. All trademarks belong to their respective holders.

Contents
1 2 3 4 5 6 Introduction....................................................................................................................... 1 Requirements.................................................................................................................... 1 Installation......................................................................................................................... 2 Test installation ................................................................................................................ 4 NAS Setup ......................................................................................................................... 5 Using IMonitor .................................................................................................................. 6

Armuli 7, 108 Reykjavk, Iceland Tel: +354 550 9000 Fax: +354 550 9010

Introduction

LS Retail is an end-to-end retail solution that covers everything from POS to back office and head office. LS Retail is built on Microsoft Navision. LS Retail Infoserver 5.06 is a Service Module (ActiveX control) that is used from within Navision (Client or NAS) to services Handheld devices in various Inventory management processes. This module is part of the LS Retail 4.2 Product and is not intended for use with other products without approval from Landsteinar Strengur hf. This manual covers the steps needed to install the Infoserver for LS Retail 4.2.

Requirements

In order to use Infoserver for LS Retail 4.2 you need: 1. Microsoft Business Solution-Navision Client or Microsoft Business SolutionsNavision Application Server 2. LS Retail 4.2 Database. 3. LS Retail Toolbox 4.2.

LS Retail Infoserver Quick Setup Guide

Installation

Run the LSRetailInfoserver5.06.exe setup file.

Select Next, Install and then Finish. Infoserver will be installed into your [Program Files] directory under LS Retail. For example: C:\Program Files\LS Retail\Infoserver. The following files will be installed.

IMonControl.exe, imonservice.exe and imonsetup.exe are only used if you want to use a Navision Client to run the service. This should ONLY be done if you are using an older version of Navision than 2.65 where NAS is not applicable. For further information on how to configure the IMonitor please refer to chapter 6. The NFServer.ocx is that actual Infoserver that is used from within a NAS Server running on LS Retail 4.2.

LS Retail Infoserver Quick Setup Guide

You can remove the Infoserver installation from the Add or Remove Programs management console.

LS Retail Infoserver Quick Setup Guide

Test installation

You can test the Infoserver installation using a Navision Client and Command Prompt. 1. Open the LS Retail 4.2 Database with a Navision Client on the machine where you have installed the Infoserver. 2. Log on using a Username that exists in the Retail Application Server setup.

You can create a Retail Application Server Setup from the Distribution card. 3. Open the Debug-Mode for Radio Handhelds from the Inventory Management menu. Radio Handheld->Communication->Debug-Mode

The Infoserver OCX Module dialog will open and start the Infoserver service and starts listening for requests on port 10102. The wb(0) stands for WebBroker Connections. The cb(0) stands for ClientBroker Connections. The db(0) stands for DataBroker Connection. Connections from Handheld Devices through WaveLink Server will be identified as ClientBroker Connections.

LS Retail Infoserver Quick Setup Guide

Connections from Handheld Devices through Handpoint will be identified as WebBroker connections. 4. To test if the server is actually listening run the following command from a command line: telnet [ComputerName] 10102 where [ComputerName] is replaced by your actual computername. 5.

If you get this response then your Infoserver is successfully installed.

NAS Setup

You should never use the Debug-Mode (from Navision Client) to run the Infoserver in realtime (live) environment. For this you should use Navision Application Server. To run the LS Retail Infoserver 5.06 with NAS please first install the NAS on the machine where you have installed Infoserver. Follow the instructions manual supplied by Microsoft for installing the NAS. After you have installed the NAS and configured it to point to you LS Retail 4.2 database then you can set the STARTUPPARAMETER to LSRHANDHELDS and start the NAS Service. When the NAS Service starts it will use the Windows Login you have supplied to lookup the Retail Application Server Setup and start the Infoserver Service. You can use the same command line test to test if your Infoserver has started successfully within the NAS. If you NAS is not starting successfully please check the Event Log on your system for further details...

LS Retail Infoserver Quick Setup Guide

Using IMonitor and/or Many Infoserver on same machine (Advanced Setup)

The IMonitor Service can be used to run Infoserver in a Navision Client. The IMonSetup program is also used when you want to run more than one instance of Infoserver on the same machine (even if you are using NAS).

6.1

Installing the IMonitor Service

Note that this should only be done if you are using a Navision Client older than version 2.65 to run Infoserver and NAS is not available. 1. Run from Command Line: imonservice Service

This will install the IMonitor as a service

2. Run the IMonControler.exe from the Infoserver Installation Directory. NOTE: you can put this program into your Start up folder to have the tray icon available to users when they log on to the machine.

The Red/Green light icon will appear in your system tray. 3. Configure your services. Select the Configure -> Service Monitor.

LS Retail Infoserver Quick Setup Guide

The Infoserver Services Setup program is where you configure your services. The Service Monitor can run/monitor more than one services on one machine. When you start the program you will see that there is one service already present called Default. This is the default service and you should start by configuring this service. You can add more services by using the add button. When you run more than one service on the same machine you should keep these things in mind: They cannot have the same name. They cannot run on the same port. They cannot have the same log file path and name.

LS Retail Infoserver Quick Setup Guide

The default service runs on port 10102 and is called Default. If you add another must not only give it a different name, port and logfile but also you must create a Retail Application Server Setup for that Instance in the LS Retail 4.2 database. The InfoServer Services Setup dialog contains the following fields that are common with all services. LogFile Path: Used by the monitor that runs/monitors the services SMTPHost: Used by the monitor to send error message. For each service there are fields that are split into 3 categories: The General Tab: - ExecFilePath - The path to the Navision Financials executable (fin.exe or finsql.exe) - ExecFileName The Navision Financials executable name (fin.exe or finsql.exe) - Local Host Name The name of the computer. - Listening Port The port that this service is running on. - Request Timeout The maximum time for one request. This can be increased to avoid timeouts on the clients. - Session Timeout - The session timeout can be set to a maximum of 5000 minutes. The minimum timeout for WebBroker and ClientBroker sessions is five minutes. - Log File The log file (path and file name) for this service (should be identical) - Log Level The log level decides what is logged and what not. - Secure (3Des) If checked then all communication is encrypted with 3Des encryption. - Active If checked then the service is active (will be started and monitored by IMonitor) - Instances Should be 1 unless you are using the Multiple Service Providers version (then you can use 1 9 instances) - Notify Mail Who should get e-mails with the error messages relating to this service. - Notify SMS Who should get an SMS if the IMonitor cannot restart this service. - Restart give up limit Indicates when to give up on a service if restart fails (default is 20). An e-mail is sent when the IMonitor has given up on a service. The Database Tab: - Host The host name of the Navision Financials- or SQL Server. This should be entered in the HOST file. - Port The port number of the Navision Financials- or SQL Server. This should be entered in the SERVICES file. (typically 2407 for C/Side and 1433 for SQL Server) - Database The Navision Financials Database name to use. - Company The Navision Financials Company name to use. - Username The Username to use to log in. (notice that this user is the auto start user). An auto start user has a special start up form in Navision that calls the code unit that starts the InfoServer loop. - Password The Password to use to log in. - NTAuthentication Should be Yes if NTAuthentication is used, otherwise No. - LogonWindow Title Typically Login for the English version of Navision Financials. The IMonitor uses the field to find the login window and automatically log in.

LS Retail Infoserver Quick Setup Guide

FinancialsWindow Title Typically Navision Financials. Must be set to Navision Attain if the IMonitor is monitoring InfoServer running on an Attain client. Notify Time This is the time that the IMonitor should wait for the Navision Financials- or SQL Server to start if it has stopped. Typically, this time should be enough for a backup to finish. Notify All (Not used) SQL Server If Checked then you are using a SQL Server. It is very important to check this field if you are using a SQL Server because the Authentication of users differs between SQL Server and C/Side. Ping retry limit The IMonitor pings (sends a ping message) each InfoServer every 5 seconds. If a reply message is not sent from the InfoServer then it could be down. By default the IMonitor restarts the given InfoServer if he sends 3 ping messages without getting a reply. This ping retry limit can be changed here. If for example you think that some requests might take a very long time you would like to increase this value.

The More Tab: - Empty Temporary Reports Folder Deletes all files from the selected folder at the selected time of day. - Scheduled start/stop of this service Starts/Stops the service at given times of the day. - Do not monitor this service: (only start/stop) If checked then the service will not be monitored and hence not restarted if errors pop up on the client. This is useful if you have a client that is doing some heavy work and cannot respond to the ping messages from the monitor. - Ignore dialogs containing text: - Here you can put a semicolon separated list of phrases that if found in a title of a dialog will make the IMonitor ignore that dialog and not close it. 4. When you have configure your 1 or more services you can start them with the System Tray tool, if you are using the IMonitor to start Navision Clients that start the Infoserver

Or, if you are using NAS, by installing more instances of NASs on the Machine and identify them by using different Log On As usernames for the Services. Those usernames should correspond to the usernames used in the Retail Application Server Setup.

LS Retail Infoserver Quick Setup Guide