Manual to run SIRAM as a Windows Service

Manual to run SIRAM as a Windows Service

Page 1

Manual to run SIRAM as a Windows Service

®Copyright 2020 Innova Control Systems, S.L. All rights reserved. This publication is property of Innova Control Systems, S.L. therefore, its total or partial reproduction in any forms is expressly prohibited, and its use for purposes other than those specified in this publication, without an express written authorization from the authorized personnel of Innova Control Systems, S.L. Innova Control Systems, S.L. reserves the right to modify the content of this document any without prior notice. Siram© is a trademark that belongs to Innova Vision Systems, S.L.

March, 4th Edition

Page 2

Manual to run SIRAM as a Windows Service

INDEX

1. INTRODUCTION ...... 4 2. INSTALLATION OF THE TOOL FOR THE CREATION OF THE SERVICE ...... 5 3. CREATION OF THE WINDOWS SERVICE ...... 6 4. SERVICE CHECK AND MANAGEMENT ...... 9 5. DELETE THE SERVICE ...... 10 6. COMPATIBILITY MODE IN AND WINDOWS ...... 11 6.1. Posible problems ...... 12

Page 3

Manual to run SIRAM as a Windows Service

1. INTRODUCTION

This document details the steps to follow to create a service in a Windows to launch the OCR without the need to log in as a on a PC or server.

In the following sections you can information on how to download the tool to create the service, as well as configure it and possible problems that may occur.

Page 4

Manual to run SIRAM as a Windows Service

2. INSTALLATION OF THE TOOL FOR THE CREATION OF THE SERVICE

To the Siram control system as a service we can use different tools. Here is how to download and install a simple to use tool that will allow us to create the service in an easy way.

The tool, NSSM, can be downloaded directly from its website (https://nssm.cc/download). This utility offers free use for any purpose.

Once the download is complete, the file must be unzipped and the different versions of the operating system in which the tool is available appear. Select the Windows architecture folder corresponding to the computer and the file inside C:\Windows\System32. The version of Windows that is compatible with it is specified on the download page of the tool.

Page 5

Manual to run SIRAM as a Windows Service

3. CREATION OF THE WINDOWS SERVICE

To create the service it is necessary to start the NSSM tool from the Command Prompt. For this we will look for it in the Windows menu and by right-clicking the icon we will run it as administrator.

Once the terminal is opened, the command to create a service is as follows:

nssm install service_name

When executing the command, a window opens that allows us to configure the service.

The first step is to select the application that the service is going to start, in this case Siram1.exe. Selecting the executable sets the default home directory. It is not possible to create service for

Page 6

Manual to run SIRAM as a Windows Service

each of the Siram applications since the simultaneous start of all the applications can cause errors.

The second step is to configure the way the service starts. What we want is for it to start when you turn on the computer, so the service should not be started by any specific user and should allow interaction from the desktop.

The file in which we want to keep the operation log can be included in the configuration to see errors or possible failures. To do this, select the file in the "I/O" tab of the configuration.

Page 7

Manual to run SIRAM as a Windows Service

To finish creating the service click on “Install service”.

If the installation was successful, the following message should appear:

Page 8

Manual to run SIRAM as a Windows Service

4. SERVICE CHECK AND MANAGEMENT

Once the service is created, it is included along with the rest of Windows services. To do the check, you need to open the Windows service manager. To do this, in the Windows menu we must search for "Run" and write: "services.msc"

A window with all the services will be shown, where we must search for the created service.

By clicking on the service with the right button we can see the properties of the service and we can also start, pause and stop the service. If you want to make any changes to the Siram application, either its configuration or any of its executables, the service must be previously stopped.

Once the service has started we can see its status in the

Page 9

Manual to run SIRAM as a Windows Service

5. DELETE THE SERVICE

If we want to remove the service that has been created, the first step is to stop the service in the Windows service manager (described above).

Once stopped, we must open a terminal (Command Prompt) as administrator (see previous steps regarding starting the command prompt) and :

nssm remove service_name

A window will appear to confirm the deletion of the service.

And later the operation is confirmed:

Page 10

Manual to run SIRAM as a Windows Service

6. COMPATIBILITY MODE IN WINDOWS 10 AND WINDOWS SERVER

The configuration of Siram as a service when starting the computer requires not putting any type of compatibility to the applications, to the contrary if they want to start manually. Therefore, you need to disable compatibility mode and run as administrator of all applications that Siram OCR will launch as a service.

To see an example, when you right-click on an Siram software executable and click on properties, the following should appear in the compatibility tab:

Page 11

Manual to run SIRAM as a Windows Service

6.1. Posible problems

Below are some of the errors experienced and the proposed solution for each case:

 Some apps are left unbooted (or continually restarted). The problem is due to the fact that Windows by default has an amount of memory reserved for the processes. If a high number of applications are running on the same computer (for example, than 10 vials), this problem may occur. To solve it, it is necessary to access the (regedit.exe) and go to the field HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\Session Manager\SubSystems, and modify within the :

Initial value (varies depending on SO) Recommended value SharedSection=1024, 20480,768 SharedSection=1024, 20480,20480

For more information on this problem, see: https://wrapper.tanukisoftware.com/doc/english/howto-solving-dheap-problems.html https://support.microsoft.com/es-es/help/947246/you-may-receive-an-out-of-memory- error-message-because-of-the-desktop

Page 12

Manual to run SIRAM as a Windows Service

Innova Systems Group C/ Joaquim Mir 55 08100 Mollet Vallès Barcelona (SPAIN) Tel. +34 93 5797238 Fax. +34 935797235 www.innovagroupbcn.com [email protected]

Page 13