Agent

About nodeProtect Agents

In nodeProtect, an agent is a service that is installed on a system that communicates with the nodeProtect server at a given time interval, sends reports and receives firewall configurations. The agent uses a certificate for secure communication with the nodeProtect server.


System requirements

The nodeProtect agent is currenlty supported on the following systems:

Windows Server

  • Windows Server 2019
  • Windows Server 2016
  • Windows Server 2012 R2

Please note that all installations must be run as an administrator with elevated privileges.

Installation

The nodeProtect agent requires the following information in order to perform an installation:

  • ApiURL: The nodeProtect node API URL. Default value: https://agent.nodeprotect.com
  • TenantId: The nodeProtect tenant ID (available in the nodeProtect web administration menu, under Settings).
  • ApiKey: Primary or secondary API key (available in the nodeProtect web administration menu, under Settings).
  1. Download the latest version of the nodeProtect agent from: nodeprotect.com and extract the zip file into a temporary file location. You can also find the agent in the nodeProtect portal under Settings:Agent

  2. Launch the nodeProtect agent setup as an administrator.Agent

  3. Once the license agreement dialogue pops up, read and accept the license terms.Agent

  4. On the feature screen, verify that the default features have been selected for installation.Agent

  5. On the configuration screen, enter the required information. The TenantId and ApiKey values are available in the nodeProtect web administration menu, under Settings.Agent

  6. On the next screen, confirm that you are ready to start the installation process.Agent

  7. On the installation summary screen, verify that the installation was successfull.Agent

Silent installation

The nodeProtect agent installer supports a silent installation. This enables automation of the nodeProtect agent installation. The example below demonstrates how to perform a silent installation:

Install Options

  • /i: Installs or cofigures a product.
  • /quiet: Quiet Mode.
  • /qn: Silent Mode.
  • /norestart: Enforce no restart of server.
  • APIKEY: nodeProtect API key.
  • TENANTID: nodeProtect tenant id.
  • APIURL: nodeProtect API Url.
  • NODEGROUPID: Group Id.
  • NODEID: Node Id.

Installing a new agent on a system

msiexec.exe /i "C:\Install\nodeProtect.Agent.msi" /quiet /qn /norestart /log c:\Install\agent.log APIKEY=00000000-0000-0000-0000-000000000000 TENANTID=00000000-0000-0000-0000-000000000000 APIURL=https://agent.nodeprotect.com

Installing a new agent on a system and onboarding the node to a specific group

msiexec.exe /i "C:\Install\nodeProtect.Agent.msi" /quiet /qn /norestart /log c:\Install\agent.log APIKEY=00000000-0000-0000-0000-000000000000 TENANTID=00000000-0000-0000-0000-000000000000 APIURL=https://agent.nodeprotect.com NODEGROUPID=00000000-0000-0000-0000-000000000000

Post installation tasks

After the installation is successfully completed the node appears in the nodeProtect web portal. In the nodeProtect portal, click on Nodes/Nodes and verify that the node is available.Agent