Grooper Service

Grooper Services are various executable programs that run as a Windows Service to facilitate Grooper processing. Service instances are installed, configured, started and stopped using Grooper Command Console (or in older Grooper versions, Grooper Config).

About

Services are utilities that perform specialized operations within the Grooper environment. The two most common Grooper Services are "Activity Processing" and "Import Watcher".

• Activity Processing is a service that executes processing jobs and tasks in a Batch Process. Running one or more Activity Processing services allows your system to automate Activity tasks when processing document content in a Batch.
• Import Watcher is a service that watches an assigned external storage location, like a Windows folder or an email inbox, and will import its contents into Grooper at designated times or polling cycles. Running one or more Import Watcher services allows your system to automate Batch creation from file content.

Service instances are installed and managed from Grooper Command Console (GCC) using the services commands. More information on installing and managing services can be found in this section of the Grooper Command Console article.

Service types

There are currently 6 different Grooper Services you can install.

• Activity Processing - Executes Activities which perform the work associated with steps in a Batch Process.
• API Services - Exposes a set of API endpoints, enabling 3rd party applications to interact with the Grooper Repository.
• Grooper Licensing - Dstributes Grooper licensing to workstations when using the "self-hosted" licensing method.
• Import Watcher - Schedules and runs Import jobs to import file content into Grooper.
• Indexing Service - Synchronizes data to AI Search indexes as documents are added, edited and deleted from the Grooper Repository.
• System Maintenance Service - Runs the "System Maintenance" command on a recurring schedule.

Managing services from the Design page

Managing services typically involves:

• Starting a service
• Stopping a service
• Editing a service

While it is possible to do some of these things from Grooper Command Console, it is generally easiest to do so from the Design page.

To manage services from the Design page:

1. Go to the Design page.
2. Navigate to the "Machines" folder.
3. To select a service instance first either:
   • From the "Machines" tab, select the machine where the service is installed.
   • Or, select the "Services" tab to view all services installed on all machines connected to the Grooper Repository.
4. Select the service instance you wish to manage.
5. To start the service, press the "Start" button (play_circle).
6. To stop the service, press the "Stop" button (stop_circle).
7. To edit the service instance:
   1. First stop the service (play_circle).
   2. Edit the "Service Properties" as needed.
   3. Press the "Save" button (save).
   4. Last, start the service (stop_circle).

Things you can't do from the Design page

There are certain things you cannot do from the Design page.

You can't install a service from the Design page.

Services are installed from Grooper Command Console.

You can't uninstall a service from the Design page.

Services are uninstalled from Grooper Command Console.

You can't change a service user/password from the Design page.

You must change a service user (or their password) from the Windows Services system application.

1. Open the "Services" app.
2. Search for the Grooper service instance (It will be named like the following: Grooper {ServiceTypeName}, Instance {##}).
3. Right click it and select "Properties".
4. Go to "Log On".
5. Adjust the service user as needed.
6. Press "Apply" or "OK" when finished.

Troubleshooting security issues

COMMING SOON! ARTICLE IN PROGRESS

Additional info

Service user rights

The Grooper Service user account must have the following permissions:

Permission	Type	Reason
Users	Local	Run the installed applications (Grooper)
File store access	NTFS\Share	Read and write access to the Grooper file store location
Database access	SQL	Read and write access to the Grooper database
Logon As Service	Local Security Policy	Run services installed via Grooper Command Console

These are the minimum permissions required by the Activity Processing service's user account. Other Grooper services may require additional permissions. For example, an Import Watcher's user may need access to directories used for importing file content.

Addressing "ghost services" - Deleting services from Windows

Very rarely, a Grooper service will not uninstall properly when you uninstall a Grooper service service. Or, a user may delete a Grooper Repository connection or purge a Grooper Repository without uninstalling services first.

This can make it appear as though a duplicate or "ghost" Windows service is installed without being listed in GCC (or Grooper Config before version 2024).

If this does occur, you will need to manually delete the service. If you know the name of the service instance (something like Grooper.ServiceTypeName.##) you need to delete, you can use the following command lines to stop the service (if necessary) and manually delete it.

SC STOP Grooper.ServiceTypeName.##
SC DELETE Grooper.ServiceTypeName.##

OR

You can delete the service from the Windows Registry Editor, using the following steps:

1. Open the Registry Editor (regedit.exe)
2. Navigate to HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services.
3. Select the key of the service you want to delete.
   • Grooper services will always be named something like Grooper.ServiceTypeName.##
4. From the "Edit" menu select "Delete.
5. You will be prompted "Are you sure you want to delete this Key?". Click Yes.
6. Exit the Registry Editor.