Skip to content

Install

Easit ProcessRunner, or EPR for short, can be installed on any Windows Server or Linux machine as its installation package contains everything it needs to run.

This application consist of the following:

  • A war file, the actual java application running.
  • A JRE instance.
  • A Tomcat service
  • Configuration files
  • PowerShell scripts

Prerequisites

  • Decide where to install and have the application running. For example D:\Easit\EPR-Test\ on a Windows Server 2022 or /opt/Easit/EPR-Test/ on a Debian based Linux server.
  • Have a user account with read / write and execute right in the directory above.
  • PowerShell 7 installed with the correct execution policy for running unsigned script (or sign the scripts and set the appropriate policy).
  • Instance ID of the instance of Easit GO you would like to use EPR with (Provided by Easit).
  • Access to install package at downloadportal.easit.com (Provided by Easit).

Install (Windows)

These steps should be performed on the machine / server that will be running EPR.

  1. Install the PowerShell module Easit.ProcessRunner.GlobalFunctions 
    1
2
      C:\Users\administrator> Install-Module -Name 'Easit.ProcessRunner.GlobalFunctions'
  C:\Users\administrator> Import-Module -Name 'Easit.ProcessRunner.GlobalFunctions'
  2. Download or move the installation package (EPR-x.x.x.zip) to the server.
  3. Expand the installation package (EPR-x.x.x.zip) to any folder. We recommend a folder named epr in a temp folder. 
    1
      C:\Users\administrator> Expand-Archive -Path 'EPR-x.x.x.zip' -DestinationPath 'C:\Temp\epr\'
  4. Install a new instance of EPR. 
    1
      New-EPRInstallation -InstanceID 'EAB001' -FromDirectory 'C:\Temp\epr\EPR-x.x.x'

You can find more installation examples and options in the documentation for New-EPRInstallation.

Once the installation have completed you will be presented with a customized version of Post Install Instructions.

Directory overview of the installation

This information is relative to the path where you decide to install EPR.

config

scripts

tomcat

  • Directory: bin
  • Directory: jre
  • Directory: logs
  • Directory: webapps

helpers

The helpers directory, located in scripts, should contain the following directories:

  • Directory: customModules
  • Directory: modules

The helpers directory should also contain a file called environmentSetup.ps1.

scriptSettings

The scriptSettings directory, located in scripts, holds settings for scripts.