Install and Setup - Revision history

Dgreenwood at 20:44, 22 July 2026

2026-07-22T20:44:41Z

← Older revision		Revision as of 15:44, 22 July 2026
Line 12:		Line 12:
	# [[#Installing Grooper Desktop\|Installing Grooper Desktop]] - This is only required if you are scanning paper documents into Grooper using a scanner attached to a computer. If you are not scanning documents, you may ignore this.		# [[#Installing Grooper Desktop\|Installing Grooper Desktop]] - This is only required if you are scanning paper documents into Grooper using a scanner attached to a computer. If you are not scanning documents, you may ignore this.

	{~~\|class="~~attn-box"		{{attn-box\|For best results, all installers should be run as an administrator.}}
	\|
	~~⚠~~
	\|
	For best results, all installers should be run as an administrator.
	\|}

	'''''PLEASE NOTE: At the end of this article, you will also find guidance for upgrading an older version of Grooper to the current version. If you are upgrading an existing install, there are some additional things you need to be aware of. Please visit the [[#Upgrading an older version of Grooper\|Upgrading an older version of Grooper]] section of this article for more information.'''''		'''''PLEASE NOTE: At the end of this article, you will also find guidance for upgrading an older version of Grooper to the current version. If you are upgrading an existing install, there are some additional things you need to be aware of. Please visit the [[#Upgrading an older version of Grooper\|Upgrading an older version of Grooper]] section of this article for more information.'''''
Line 202:		Line 197:
	:*<li class="fyi-bullet"> For example: Browsers won't allow you to paste text copied to your clipboard to text editors in Grooper from an insecure connection.		:*<li class="fyi-bullet"> For example: Browsers won't allow you to paste text copied to your clipboard to text editors in Grooper from an insecure connection.

	{~~\|class="~~attn-box"		{{attn-box\|'''''BE AWARE: For Grooper Desktop to scan to the Grooper web server, you must connect securely in the browser (HTTPS).'''''
	\|
	~~⚠~~
	\|
	'''''BE AWARE: For Grooper Desktop to scan to the Grooper web server, you must connect securely in the browser (HTTPS).'''''
	* Always use HTTPS to connect to the Grooper web app.		* Always use HTTPS to connect to the Grooper web app.
	* NEVER use HTTP to connect to the Grooper web app. Scanned images will be refused if using an HTTP address.		* NEVER use HTTP to connect to the Grooper web app. Scanned images will be refused if using an HTTP address.
	* '''At minimum''' a [[Install_and_Setup#How to create and bind a self-signed certificate\|self-signed certificate]] must be installed on the Grooper web server. ''This is generally acceptable for test environments.''		* '''At minimum''' a [[Install_and_Setup#How to create and bind a self-signed certificate\|self-signed certificate]] must be installed on the Grooper web server. ''This is generally acceptable for test environments.''
	* '''Best practice:''' Use an internally issued certificate managed by your organization's IT.		* '''Best practice:''' Use an internally issued certificate managed by your organization's IT.}}
	\|}

	<big>Breaking Change: HTTPS Required for Application Installation</big>		<big>Breaking Change: HTTPS Required for Application Installation</big>
Line 363:		Line 353:
	Connecting to a Grooper Repository is one of the first things you will do after installing Grooper to start designing (or implementing already architected) document processing solutions. This is done with the [[Grooper Command Console]] application.		Connecting to a Grooper Repository is one of the first things you will do after installing Grooper to start designing (or implementing already architected) document processing solutions. This is done with the [[Grooper Command Console]] application.

	{~~\|class="~~attn-box"		{{attn-box\|Grooper Command Console must be run as an administrator. It performs functions that require elevated access in Windows.}}
	\|
	~~⚠~~
	\|
	Grooper Command Console must be run as an administrator. It performs functions that require elevated access in Windows.
	\|}
	<div style="padding-left: 1.5em;">		<div style="padding-left: 1.5em;">
	=== Prerequisites ===		=== Prerequisites ===
Line 510:		Line 495:
	We will show you how to install and start the most basic versions of these Grooper services from the Grooper Command Console.		We will show you how to install and start the most basic versions of these Grooper services from the Grooper Command Console.

	{~~\|class="~~attn-box"		{{attn-box\|Grooper Command Console must be run as an administrator. It performs functions that require elevated access in Windows.}}
	\|
	~~⚠~~
	\|
	Grooper Command Console must be run as an administrator. It performs functions that require elevated access in Windows.
	\|}
	<div style="padding-left: 1.5em;">		<div style="padding-left: 1.5em;">
	=== Service account permissions ===		=== Service account permissions ===

Dgreenwood at 20:41, 22 July 2026

2026-07-22T20:41:53Z

← Older revision		Revision as of 15:41, 22 July 2026
Line 34:		Line 34:
	*'''Grooper Desktop''': This is a lightweight desktop application required to scan paper documents into Grooper. It must be installed on any desktop computer connected to an optical scanner.		*'''Grooper Desktop''': This is a lightweight desktop application required to scan paper documents into Grooper. It must be installed on any desktop computer connected to an optical scanner.
	*'''Grooper services''': While not ''strictly'' required to perform basic testing in Grooper. As a practical matter, at least two Grooper services are required for most installs, an '''Activity Processing''' and '''Import Watcher''' service. [[#Installing necessary Grooper services\|See here for more information.]]		*'''Grooper services''': While not ''strictly'' required to perform basic testing in Grooper. As a practical matter, at least two Grooper services are required for most installs, an '''Activity Processing''' and '''Import Watcher''' service. [[#Installing necessary Grooper services\|See here for more information.]]

			{{fyi-box\|'''This is only a summary of install components'''

			For full system architecture information and requirements, [[Grooper_Infrastructure#System_Architecture_and_Requirements\|refer to the Grooper Infrastructure article]].
			}}

	<section begin="antivirus_advice" />		<section begin="antivirus_advice" />
	{~~\|class="~~attn-box"		{{attn-box\|In some cases, antivirus software will interfere with Grooper's installation, preventing a complete install.
	\|
	~~⚠~~
	\|
	In some cases, antivirus software will interfere with Grooper's installation, preventing a complete install.
	* You may need to whitelist the Grooper installers/software ''before'' installing.		* You may need to whitelist the Grooper installers/software ''before'' installing.
	* This will ensure the antivirus software is not preventing DLL files from installing or executing.		* This will ensure the antivirus software is not preventing DLL files from installing or executing.


	Most commonly, this issue has been demonstrated when installing the Grooper Desktop application.		Most commonly, this issue has been demonstrated when installing the Grooper Desktop application.

	If Grooper Desktop is installed correctly, and you are able to scan using the scanner's native software (but not with Grooper), you may need to (1) uninstall Grooper Desktop, (2) whitelist the Grooper Desktop installer and GrooperDesktop.exe application and (3) reinstall Grooper Desktop to ensure you can scan from the Grooper web client.		If Grooper Desktop is installed correctly, and you are able to scan using the scanner's native software (but not with Grooper), you may need to (1) uninstall Grooper Desktop, (2) whitelist the Grooper Desktop installer and GrooperDesktop.exe application and (3) reinstall Grooper Desktop to ensure you can scan from the Grooper web client.}}<section end="antivirus_advice" />
	\|}
	<section end="antivirus_advice" />
	{{#lst:Grooper Infrastructure\|centralized vs distributed}}		{{#lst:Grooper Infrastructure\|centralized vs distributed}}

Dgreenwood at 18:34, 11 June 2026

2026-06-11T18:34:49Z

← Older revision		Revision as of 13:34, 11 June 2026
Line 572:		Line 572:

	=== Installing an Import Watcher service ===		=== Installing an Import Watcher service ===

	~~{{GrooperServiceUserRights}}~~

	An Import Watcher service must be running to import documents into Grooper.		An Import Watcher service must be running to import documents into Grooper.

Dgreenwood: /* Installing an Activity Processing service */

2026-06-11T18:09:20Z

Installing an Activity Processing service

← Older revision		Revision as of 13:09, 11 June 2026
Line 519:		Line 519:
	\|}		\|}
	<div style="padding-left: 1.5em;">		<div style="padding-left: 1.5em;">
			=== Service account permissions ===

			{{LeastPrivilegeServiceAccounts}}

	=== Installing an Activity Processing service ===		=== Installing an Activity Processing service ===

	~~{{GrooperServiceUserRights}}~~

	An Activity Processing service must be running to automate task processing in a Batch Process.		An Activity Processing service must be running to automate task processing in a Batch Process.

Dgreenwood: /* Setup: App pool identity permissions */

2026-06-11T15:47:08Z

Setup: App pool identity permissions

@@ Line 178: / Line 178: @@
 </div>
 ==== Setup: App pool identity permissions ====
-From a security standpoint, it is best practice to only give a minimum number of permissions to this account.
+{{Template:LeastPrivilegeAppPoolAccounts}}
 ====Installing Grooper Web Client====

Dgreenwood: /* SSL and HTTPS: Secure website connections */

2026-05-12T16:00:38Z