Manual Installation (ZIP)

When to use this The ZIP package is an alternative to the EXE installer. Use it if you prefer to control each step yourself, or if you are deploying Primentra behind IIS and want to set it up manually without running a wizard.

The ZIP contains exactly the same application files as the EXE installer — the difference is that the EXE automates Node.js installation, service registration, and firewall configuration. With the ZIP, you do these steps yourself.

Prerequisites

• Windows Server 2016 or later (Windows 10/11 also supported)
• Node.js v18 or later — download from nodejs.org (LTS version). Verify with node --version in a command prompt.
• SQL Server 2016 or later — see Install SQL Server
• Administrator rights on the server

Step 1 — Extract the ZIP

Extract Primentra-vX.X.X.zip to your desired install folder, for example:

C:\Program Files\Primentra

Step 2 — Register the Windows Service

Open a command prompt as Administrator in the install folder and run the following commands. Replace the paths with your actual install location:

nssm.exe install Primentra "C:\Program Files\nodejs\node.exe"
nssm.exe set Primentra AppParameters server.js
nssm.exe set Primentra AppDirectory "C:\Program Files\Primentra"
nssm.exe set Primentra Description "Primentra Master Data Management"
nssm.exe set Primentra Start SERVICE_AUTO_START
nssm.exe set Primentra AppEnvironmentExtra "PORT=3001"
nssm.exe set Primentra AppStdout "C:\Program Files\Primentra\logs\service.log"
nssm.exe set Primentra AppStderr "C:\Program Files\Primentra\logs\service.err.log"
nssm.exe set Primentra AppRotateFiles 1
nssm.exe set Primentra AppRotateBytes 10485760

Step 3 — Open the firewall (if users access from other machines)

Run as Administrator:

netsh advfirewall firewall add rule name="Primentra" dir=in action=allow protocol=TCP localport=3001

Step 4 — Start the service

net start Primentra

Verify it is running:

sc query Primentra

Open http://localhost:3001 in your browser — you should see the Primentra setup screen.

Step 5 — Database, license & admin account

From here, follow the same steps as the EXE installer: connect to the database, deploy the schema, and create your administrator account. See Install Primentra for the detailed walkthrough of the first-time setup wizard.

Managing the service

net start Primentra
net stop Primentra
sc query Primentra

You can also manage it from services.msc — look for the service named "Primentra".

Changing the port

Run the included script from the install folder (as Administrator):

scripts\change-port.bat 3002

This updates the service environment variable and restarts Primentra automatically.