Shinydocs Pro Pre-Installation Checklist
The purpose of this checklist is to determine the readiness of an environment for a Shinydocs® Pro deployment. A project start may be dependent on the completion of this checklist.
A successful implementation requires a dedicated virtual machine or bare-metal system. A single-machine configuration supports up to 40 TB of your data from various sources.
Operating System
Shinydocs Pro is designed for Microsoft Windows:
Windows Server 2019 or newer
Windows 11
Hardware
Up to 40 TB | |
|---|---|
CPU
| 12-16 core** |
Memory (RAM) | 64 GB* |
Disk
| 4 TB free disk space (for 40 TB - 10% of 40 TB is 4 TB) |
Network | Gigabit connection |
|
For customers also implementing Private AI: | |
AI Server | (Required for Private AI integration) |
CPU
| 12-16 core** |
Memory (RAM) | 64 GB* |
Disk | 1 TB free disk space |
Network | Gigabit connection |
GPU | Nvidia based GPU with minimum 16GVRAM This is specification is for entry level performance suitable for testing. GPUs and VRAM may need to be increased based on performance. |
**Minimum recommended CPU cores. Text extraction and OCR are extremely CPU-intensive tasks; additional CPU cores or a more performant CPU architecture will increase throughput. We recommend giving your server(s) more resources for the initial analysis. Later, you can scale down as Shinydocs Pro will then only analyze changes in your content source.
Note: Your content source’s throttling policies can still limit throughput.
*With regards to RAM usage, while a system with up to 10TB of data to index may run well on 32Gb of RAM, the make-up of the data is variable environment-to-environment and this should be considered a baseline with some expectation that this may need to be increased to meet higher needs.
Software
This software will be automatically installed when you follow the Shinydocs® Pro installation:
Shinydocs® Search Engine
Shinydocs® Dashboards
Shinydocs® Extraction Service
Shinydocs® Control Center
Shinydocs® Search
Java 21 Runtime Environment
Microsoft® .NET Desktop runtime 8
Microsoft® .NET ASP Core runtime 8
Microsoft® Visual C++ Redistributable
Access
Scanning file share content requires that the file share(s) are on the same domain as the computer running Shinydocs Pro.
Please Note: Shinydocs® Pro works best with a service account with read (for scanning) and write (for file deletion) access in your desired repository. For file share scanning, the service account will need interactive logon enabled (Group Policy dependent).
Default Ports Required By Shinydocs Pro
The following ports are required to be accessible for Shinydocs Pro though some* may not require access external to the server on a basic deployment.
Service | 24.1 | 24.x… |
|---|---|---|
Control Center | 5001 | 9701 |
Search | 9702 | 9702 |
Search Engine* | 9200/9300 | 9200/9300 |
Extraction Service* | 55555 | 9711 |
Dashboards | 5601 | 5601 |
The Search Engine, on a single system deployment will only require localhost (127.0.0.1) access as would the Extraction Service. If customizations or additional servers are configured for Cognitive Toolkit or scaling up is required there ports may need to be opened though restrictions are advised to limit access to those specific servers.
Endpoint and Security Software Considerations
Endpoint protection includes anti-malware, anti-virus, and other file scanning loss prevention software. For the performance and stability of Shinydocs Pro, ensure you have set up the proper exclusions with your organization’s endpoint protection solution. While these items should be scanned before they are installed, we do not recommend day-to-day operation without exclusions.
Using Sophos, SentinelOne, or CrowdStrike for AV and security? These applications, while helpful in security, heavily hinder Shinydocs Pro’s ability to process content quickly. Please exclude as much Shinydocs Pro software as possible (including JVM injected agents) for the best performance.
Endpoint protection software can be configured to accommodate the needs of Shinydocs Pro and manage exceptions. Please refer to your software’s documentation to help implement these exclusions.
Your installation locations may be different if you changed the <installation folder> during installation, the default is the C:\Program Files\Shinydocs Professional\ folder.
Path Exclusions
<installation folder>
\ControlCenter
\Dashboards
\ExtractionService
\Search
\SearchEngine
C:\ProgramData\Shinydocs
\ControlCenter
\ExtractionService
\logs
\OpenSearchService
\searchAlso, if the index has been moved to it’s own location, i.e. E:\ShinyIndex\data, this should be excluded as well.
Process Exclusions
Shinydocs.Platform.ControlCenter.Web.exe
ShinydocsSearch.exe
opensearch-service-x64.exe
Did you know?
There can be a major throughput performance impact when analyzing file shares that have on-access scanning enabled. With on-access scanning enabled at the file source, all files analyzed by Shinydocs Pro will first be scanned by your endpoint protection scanning process which can lead to slower than expected performance.
Shinydocs Pro does not store the files being analyzed, only the metadata and text.