Overview of Client Installation Process

The Prima application server must be completely installed before a client installation can be performed.

The Prima client installation can install up to five client applications, depending on the use case at each station. For a research setting, you may choose to install all. For a production oriented lab, you may only choose to install one.

Workstations
Used by the lab techs to perform the bulk of the standard workflow (printing, scanning, staining, etc.)
ControlPanel
For users with admin privileges, provides the ability to set up drop-downs, define workflow rules, etc.
LabManager
Gives lab managers the ability to handle QC problems, ok QC material, view lab metrics and more
Pathologist
Gives Pathologists the ability to view everything recorded with cases and studies and to make diagnoses
Label Template Creator
Provides the ability to create templates for printing within Workstations. Access to ControlPanel is needed in order for the settings to be used in the lab.

Client Workstations

As a general stance on supported versions of software, Fortelinea stays very much on top of using all new performance and security measures in new versions of software. This means newer versions are always better, as far as we are concerned.

Hardware Requirements

Hardware requirements can vary quite a bit from station to station, depending on which application the user will use.

Prima Workstations

Parameter Minimum Recommended
CPU 2.4GHz, 2 cores 3.4+GHz, 4 cores
Memory 4GB 8GB
Operating System Windows 10 Windows 11
Workstation Monitors 22 inch HD 27 inch HD touchscreen
LabManager/Pathologist Monitors 28 inch 4k 34+ inch 4k

Installing Features and Drivers

Network Prep

The clients need to be able to communicate to:

  • The Prima application server on ports 80 and 443
  • https://prima.fortelinea.com

Record Settings for Prima Installation

Before we run the Prima installer, you'll want to make sure you have the following:

  • The address of the Prima application server
    • Add a new Workstation entry in Prima via ControlPanel or the web app
    • Ensures correct tracking (barcode scans) and logging information
    • Shows up in a drop-down in the Prima installer

Troubleshooting and Extra Installation Info

Prima Website Logs
As long as the application has access to talk to our server (https://prima.fortelinea.com), we get and log a variety of detailed information on crashes, exceptions, and configuration warnings. Usually, the website logs are the first tool Fortelinea developers use when troubleshooting.
Event Viewer
The Windows Event viewer is a great place to look. Most serious logs end up here. Be sure to check under Application and System event logs.
File logs
There are times when exceptions don't make it to the event viewer due to a crash and the logs don't make it to our website. The fallback are textual log files which can be found at C:\ProgramData\FortelineaSoftwareSystems\Prima\Logs

Client Installation Checklist

  1. Know the address of the Prima application server
  2. Use ControlPanel or the web app to add a Workstation
  3. Ensure .Net Core 8 Desktop Runtime is installed