Install the EPM Windows client via CMD

Prev Next

Install the EPM client on Microsoft Windows from the command line using the msiexec command.

Follow these steps:

Open Command Prompt, PowerShell, or Bash on Windows. Go to the folder where the EPM installer (.msi file) is stored. Run the following command:

msiexec /i "EPM.v.<version>.msi" /passive TOKEN=<token> URL=<IP or domain name> ADDLOCAL=Core,Vault,Automation /l log.txt

Remember to replace the values ​​indicated by the greater than and less than signs (<>):

  1. Replace <version> with the version of the EPM installer file, and keep the quotation marks. For example: "EPM.v.4.2.15.2.msi".
  2. Replace <token> with the installation key available in Segura™ Platform, on the EPM parameters configuration page.
  3. Replace <IP or domain name> with the IP address of the Segura™ Platform server, or with the domain name (when DNS is configured).

TOKEN and URL are required. If either is missing or invalid, the installerreturns an error and does not proceed. No files are installed.

Version compatibility

The installer checks version compatibility before installing.

  • If the versions are compatible, installation continues normally.
  • the versions are incompatible, the installer blocks the installation and does not modify any files. This happens when your Segura™ Platform requires a newer agent version than the one you are installing, or when the agent requires a newer Segura™ Platform version than the one you are connecting to. For example, EPM Windows agent 4.2.17 requires Segura™ Platform 4.2.17 or later. When the agent version is the older one, the installer also logs the event to the Windows Event Viewer. If the Segura™ Platform version is older than the agent requires, update Segura™ Platform first, and then run the command again.

If the parameters are invalid or missing, or the version is incompatible, msiexec automatically rolls back the installation: no files are modified on the machine.

Reinstallation

Running the installation command creates a folder called IsolatedStorage in C:/ProgramData/ that stores the token and the Segura™ Platform server IP.

When you reinstall the same agent version, you do not need to re-enter the token or Segura™ Platform IP.

To ensure a complete reinstallation, use the REINSTALLMODE=AS parameter:

msiexec /i "EPM.v.<version>.msi" /passive ADDLOCAL=Core,Vault,Automation /l log.txt REINSTALLMODE=AS

Upgrade

To upgrade the agent to a newer version from the command line, run the installation command with the TOKEN parameter. The installer can reuse the Segura™ Platform address from the previous installation, but not the token. Update Segura™ Platform before you upgrade the agent.

About installation and reinstallation command parameters

Parameter Description
/i Specifies the msiexec installation function.
<version> Version of the EPM agent installer file.
/passive Establishes passive installation, which does not require user interaction.
TOKEN Required. Installation key to relate the EPM client being installed with Segura™ Platform.
URL Required. IP or domain (if DNS is configured) of the Segura™ Platform server.
ADDLOCAL Parameter for defining which EPM client modules to install. Core is mandatory, while Vault and Automation are optional.
/l log.txt (optional) Generates the log.txt file with installation records, for troubleshooting.