Windows installer tutorial

There are two ways to interact with the PEP system:

• pepcli is a command line interface (CLI) application to interact with the PEP system. With pepcli you can download and upload your data.
• PEP Assessor is a GUI application that assessors use to upload data to the PEP system. This application cannot download data and is specifically designed for assessors.

The Windows installer will install both applications on your system. This document describes how to install the PEP system on your local Windows machine.

Download the installer

1. Download the correct installer for your project and environment. Different installers are available depending on your specific setup. See the main installation page for details.
2. Handle download warnings. When downloading the installer, a security warning may appear stating that this file is not commonly downloaded. If you see this warning, follow the steps in Security Measures > Not commonly downloaded.
3. Open the downloaded file. After the download completes, click 'Open file':
4. Handle Windows protection warnings. Another warning may appear indicating that Windows is protecting your PC. If you see this warning, follow the steps in Security Measures > Files from the internet.

Installation process

Note

If you choose a custom installation location, ensure you have permission to run software from that directory.

1. Follow the Installation Wizard. The installation uses a step-by-step wizard. Click 'Next' to proceed through each step.

   

   When you've made all your choices, the button will change to 'Install':

   

   Click 'Install' to begin the installation.

2. Handle User Account Control. A User Account Control warning may appear requesting administrator privileges. Follow the steps in Security Measures > User Account Control to proceed.

3. Installation completion. After installation, PEP Assessor will automatically open:

   

Using pepcli and PEP Assessor

Both applications are now installed and accessible through the Windows START menu. The applications are organized in folders based on your PEP variant:

Project	Environment	Folder Name
POM/PPP	Acceptance	PEP (ppp acc)
POM/PPP	Production	PEP (ppp prod)
Healthy Brain	Acceptance	PEP (hb acc)
Healthy Brain	Production	PEP (hb prod)

Each folder contains two applications:

• 'PEP Assessor' is the graphical user interface application
• 'Opdrachtregel' is the pepcli command line interface

Note

When starting either application for the first time, a Windows Firewall warning may appear. See Security Measures > Windows Firewall for instructions.

Upgrading to a new version

PEP Assessor automatically checks for updates each time it starts. When a new version is available:

1. Update notification. The screen color changes and the Login ('Aanmelden') button becomes an Update ('Bijwerken') button:

   

2. Start the update. Click the 'Bijwerken' button to begin the update process.

3. Handle application closure. PEP Assessor will close automatically to allow file updates. If the application doesn't close quickly enough, you may see this dialog:

   

   Select "Automatically close applications" ("Toepassingen automatisch sluiten") and click "OK".

4. Update completion. The software downloads to the same folder as the previous version. A notification appears when installation is complete:

   

   After confirmation, the updated version of PEP Assessor will launch.

Uninstalling PEP

PEP follows standard Windows installation practices and appears in your system's installed programs list.

1. Open Windows Settings. Go to the START Menu and click 'Settings':

   

2. Navigate to Apps. In Settings, click on 'Apps':

   

3. Find PEP application. Search for the PEP application you want to remove:

   

4. Uninstall. Click 'Uninstall' and follow the prompts:

   

Security measures

Windows displays various security notifications during PEP installation to protect against malicious software. For each warning, confirm that you want to install and run the PEP software.

Not commonly downloaded

When downloading the installer, you may see a warning that the file is not commonly downloaded:

To proceed:

1. Hover over the warning. Three dots will appear on the right

2. Click the three dots:

   

3. Click 'Keep':

   

4. A second warning will appear. Click 'Show More', then 'Keep Anyway':

   

The download will then proceed.

Files from the internet

Windows may not trust the installation file because it originated from the internet. This triggers a Windows Defender SmartScreen warning:

To proceed:

1. Click 'More info'

2. Click 'Run anyway':

   

User account control

Windows programs run with restricted privileges by default. Installation programs require administrator privileges, so Windows requests user confirmation. This occurs after clicking the "Install" button in the wizard:

Click 'Yes' to grant administrator privileges and continue installation.

Windows firewall

When first starting PEP Assessor, Windows Firewall may display a warning because the application attempts to make network connections:

This network connection is required for authentication with SURFconext or other login systems. Click 'Allow access' to permit the connection. This action requires administrator rights.

Troubleshooting

VCRUNTIME140_1.dll was not found

When first starting PEP software, you may encounter the error: "The code execution cannot proceed because VCRUNTIME140_1.dll was not found."

This indicates missing Microsoft Visual C++ Redistributable libraries.

To resolve:

1. Navigate to the PEP installation folder (typically C:\Program Files\PEP client ([PROJECT] [ENVIRONMENT]))
2. Run the vc_redist.x64.exe file as an administrator
3. Complete the installation process
4. Restart PEP software from the START menu

Note

Installing the Visual C++ Redistributable requires administrator privileges.