Step 3: Installing and configuring the Agent

The Invicti Enterprise Agent is installed using a wizard. This document guides you through the installation process and provides information about installing multiple agents on the same operating system.

How to install the Invicti Enterprise Agent

1. Run the AgentSetup.exe file.
2. On the Invicti Enterprise Agent Setup window, select Next.

3. In the Select Installation Folder step, click Next to install the Agent in the default folder. Alternatively, click Browse… to choose a different installation folder, then select Next.

4. At the Agent Settings step, fill in the following information, then select Next.

• Agent Name: This can be configured to any value to help you distinguish one Agent from another.
• API URL: This needs to point to the Web App URL.
• API Token: This is the token you copied from step 7 - Scanner Agent of the installation wizard during the configuration of the web app server. If you did not copy the Access Token from the wizard, after the installation is completed, you can find it in Agents > Manage Agents > + Configure New Agent.

6. On the Ready to Install step, select Install.
7. Click Finish to complete the installation.

How to prevent the agent from starting automatically

Once the agent is installed in your environment via the wizard or command prompt, the agent starts automatically. If you prefer to prevent this behavior, you need to take the following steps:

1. Open a command prompt in Administrator mode.
2. Run cd to navigate to the folder containing the AgentSetup.exe file.
3. Run AgentSetup.exe LAUNCH_SERVICE_PROP = 0

If you want to start the agent later, there are two methods available:

Method 1:

1. Open a command prompt in Administrator mode.
2. Run cd to navigate to the folder containing the AgentSetup.exe file.
3. Run AgentSetup.exe -s

Method 2:

1. Press Windows+R, type 'services.msc' and press Enter.
2. Find 'Netsparker Enterprise Scanning Service - [YOUR_AGENT_NAME]'.
3. Right-click on it, and select Properties.
4. Make sure the Startup type is set to Automatic, and click Start.

If you wish, you can select a specific agent while launching a scan. Refer to our Configuring agent selection document for more information.

How to install multiple agents on the same operating system

If you want to install more than one agent on the same system, first install the Invicti Enterprise Agent, as usual, using the AgentSetup.exe file. Then follow the instructions below to install additional agents on the same operating system.

1. Copy all files from the default agent’s folder to a new folder for the new agent. The default installation path is: C:\Program Files (x86)\Invicti Enterprise Agent.

For example, if you decided to use Agent-2 as the new agent name, you could use the following command:

This will create a new directory in C:\Program Files (x86)\Invicti Enterprise Agent-2 and copy in all the required files.

2. Locate the folder for the new agent and open the appsettings.json file with a text editor. Set the new agent’s name.
3. Open a command prompt in Windows with Administrator rights and install the new agent as a Windows Service using these commands:

• This command changes the current folder to the new agent’s folder:

cd C:\Program Files (x86)\Invicti Enterprise Agent-2

• This command installs the new agent as a Windows Service:

Netsparker.Cloud.Agent.exe /i

• This command starts the new agent’s Windows Service:

Netsparker.Cloud.Agent.exe /s