ObjectGears Help

           
Forum   ObjectGears (Version: 1.6.0.0)

Windows service

Apart from web, there is another component of the ObjectGears system - Windows service, that ensures sending email notifications, job start, processing workflow, reading emails from mailboxes and time operations.. The service has to be installed and its automatic start up has to be ensured.

Installation

In order to install the service follow these steps:

  1. Copy the folder winservice from the install folder to the place, where you want to have Windows service files. The files must not be deleted after installation.
  2. Configure the service in the file ObjectGearsService.exe.config.
  3. Choose account, under which the service will run. Assign access rights Read and execute on folder, in which Windows service files are placed, to this account. The account has to have right  Logon as a service (see Local Security Policy – Local Policies – User Rights Assignments). It is necessary that this account can authenticate itself on smtp server.
  4. Choose in the file winservice-install.bat, if you want to install the service as a 32-bit or 64-bit application. To make this selection just uncomment appropriate line.
  5. Execute the file winservice-install.bat.
  6. Check in the list of Services, that service ObjectGearsService is installed.
  7. If the service runs on the same server as the database, set Automatic (Delayed start) to the service.
  8. Set logon of the service under above chosen account.
  9. Start the service.

In case that you need to run more instances of ObjectGears system on a single server, you need to install separate Windows service for each instance. The steps of installation are similar:

  1. Copy the folder winservice from the install folder to the place, where you want to have Windows service files. The files must not be deleted after installation.
  2. Create a new folder for every required instance. Name the folder by names of instances (e.g.: ObjectGearsService - test, ObjectGearsService - development, ObjectGearsService - customer 1, ObjectGearsService - customer 2). Keep ObjectGears at the beginning of the service name. The text for distinguishing add to the end.
  3. Change the names of files ObjectGearsService.exe a ObjectGearsService.exe.config according to the folder name in each folder.
  4. Change the name of the service in files winservice-install.bat a winservice-uninstall.bat in each folder (it is the last parameter of the command).
  5. Configure the service in files ObjectGearsService.exe.config.
  6. Choose accounts, under which each service will run. Assign access rights Read and execute on folder, in which Windows service files are placed, to this account. The account has to have right Logon as a service (see Local Security Policy – Local Policies – User Rights Assignments). It is necessary that this account can authenticate itself on smtp server.
  7. Choose in the file winservice-install.bat, if you want to install the service as a 32-bit or 64-bit application. To make this selection just uncomment appropriate line.
  8. Execute the file winservice-install.bat.
  9. Check in the list of Services, that service ObjectGearsService - xxx is installed.
  10. If the service runs on the same server as the database, set Automatic (Delayed start) to the service.
  11. Set logon of the services under above chosen accounts.
  12. Start the service.

Uninstallation

In order to uninstall the service stop it first and execute the file winservice-uninstall.bat. After that you can delete the folder with files for the Windows service.

Before running the file uncomment the line with appropriate version of the installing file 32/64 bit.

Never delete the files before service uninstalling. If this happens, we recommend to create the files again and only after that perform uninstallation.

Configuration

Configuration file for the Windows service is called ObjectGearsService.exe.config. It contains same configuration parameters like the web part of ObjectGears and several more specific only for the Windows service.

Name Example Description
RepeatIntervalInMinute 5 Time interval in minutes, in which the function for check of jobs and workflow is started.
MinEndPauseInMiliSecond 50 Minimal pause in miliseconds between two check starts.
OperationPauseInMiliSecond 50 Pause in miliseconds between two job checks.
WorkflowActivityPauseInMiliSecond 50 Pause in miliseconds between processing particular workflow activities.
WebUrl http://www.myOG.cz/ Adresa na web systému OG. Tato adrese se např. používá pro vytvoření url pro úkoly, které se zasílají v emailu.

These parameters enable to limit the load by job and workflow processing to a shorter period of time and not to overload the database server with many queries. This enables fast response of the web part of ObjectGears system. In case you need provide more time for web requests processing, increase above mentioned values, especially parameters with Pause in their name. You can track course of processing o page History of job process start.

Check of service operation

If this service does not run, new workflow instances can be created, but they will not be processed. In order to simply check, if the service is running, display the page History of job process start (JobStartLogs.aspx). Each start is recorded here together with number of processed objects. If there are no records for actual time (minus number of minutes according to the above stated parameter RepeatIntervalInMinute), then the service is not running. You can find more detailed infromation why the service is not running in the Event viewer (Windows system component).

This website is using cookies files to provide services and analyse visits. You agree with that by using this website.     Further information