Installing and Managing Services
jongoesboom
Posts: 26 ✭✭✭
Installing and Managing Services
Services are the workhorses of Grooper's processing. They will run all the Unattended Activities in the background as Windows services. This article will explain how to setup and manage services to get the most of your Grooper environment.
Best Practices
To install and manage services in Grooper you must run Grooper Configuration as an Administrator. If possible, navigate to your Grooper Configuration shortcut and set it to always run as an Administrator.
Services will have to be installed with a user that has administrative rights to the machine they are being installed on. Setting up a service account as the default will allow you to install and run services without having to worry about user permissions. To set the default service credentials, Open Grooper Configuration as an administrator and go to the Settings tab. Enter the default service account user name and password and then click on save. Now every time you create a service in Grooper, this account will be automatically populated in the Service Settings. (NOTE: The service account must have permissions to the Grooper database in order to work.)
Installing Services
Installing a Single Service
If you have already gone through License Activation, then you have installed a single service by installing a License Server.
Open Grooper Configuration as a Administrator
Click on Add...
Select the service you want to add. If you are connected to more than one repository, you can select which repository you are creating the service for.
Configure the settings for the service and click OK.
The service will now show up in the in the services tab, stopped.
Installing Multiple Services
When you are installing Task Processing Services, it is usually easier to install multiple services at once.
Open Grooper Configuration as an Administrator and go to the Services tab.
Click on Tools, and then Add Multiple Task Processing Services...
The Add Task Processing Services window will open with a list of all the available Task Processing activity types.
Choose which services you want to install by entering the number of instances you want to install in the Service Instances column. You can then pick how many threads you want running per instance in the Threads/Instance column. (NOTE: Your total threads should be less than or equal to the number of processing cores on the machine. On Full Text OCR your threads should be less than or equal to your number of OCR licenses).
Make sure that if you are connected to more than one repository, that you are creating services for the correct one by checking the repository name in the top right dropdown. When you are done you can scroll to the bottom of the list to see your total service instances and total threads across all services. When you are satisfied with your configuration, click OK to create the services.
Grooper Configuration will now create the service instances you have specified, this may take some time depending on how many are being created.
Once the services have been created you will now see them added in the Services tab.
Managing Services
Services can be managed using Grooper Configuration, Grooper Administration, and Grooper Dashboard.
Using Grooper Configuration
When using Grooper Configuration to manage services, you will only be able to access services that have been installed on the machine you are running Configuration from.
To start services, simply go to the services tab, highlight the service you want to start, and click on Start. If you want to start all the installed services you can instead click on Start All. As soon as services are started, they will start processing any tasks that are in the ready state in the repository they are pointing to.
To stop services, go to the Services tab, highlight the service you want to stop, and click Stop. You also have the ability to stop all running services by clicking on Stop All.
Using Grooper Administration
Using Grooper Administration to manage services lets you manage all services running for the repository you are connected to.
Open Grooper Administration and navigate to Infrastructure > Machines. From here you will see all the servers and workstations connected to the repository. By clicking on any of the machine names you can also see information such as services installed, processor and memory usage, and machine information.
If you navigate to the Global Service Instances tab, you can see all the services that are connected to this repository. Here you can view, start, and stop services running on different machines.
Using Grooper Dashboard
Grooper Dashboard can also be used to manage services for a specific repository. Once Grooper Dashboard is opened you can go to the Services tab. From there, all the services for the selected repository can be started and stopped.
