Step 3: Installing and configuring the Agent
Installing the Invicti Enterprise Agent
The Invicti Enterprise Agent is installed using a wizard.
TIP: You can also install the Invicti Enterprise Agent in silent mode. For more information, refer to Installing the Invicti Enterprise Agent in Silent Mode. |
How to install the Invicti Enterprise Agent
- Run the AgentSetup.exe file.
- On the Invicti Enterprise Agent Setup window, select Next.
- On the Select Installation Folder step, select Next to install the Agent to the default folder. Or select Browse to select an installation folder. Then, click Next.
- On the Agent Settings window, enter the Agent Name, API URL, and API Token. The Agent Name and API URL fields are already completed. (Agent Name can be configured to any value to help distinguish them from one another, and the API URL should point to the WebApp URL.) Then, click Next.
TIP: To find your API Token, from the main menu, go to Agents > Manage Agents > Configure New Agent. Copy the Agent Token. |
NOTE: If you have already configured SSL/TLS for your NE Application Server, then you should enter that URL and ensure that you use HTTPS (for example: https://ncserver/). |
- On the Ready to Install step, select Install.
- 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:
- Open a command prompt in Administrator mode.
- Run cd to navigate the folder containing AgentSetup.exe.
- Run AgentSetup.exe LAUNCH_SERVICE_PROP = 0
If you want to start the agent later, there are two methods available:
Method 1:
- Open a command prompt in Administrator mode.
- Run cd to navigate the folder containing AgentSetup.exe.
- Run AgentSetup.exe -s
Method 2:
- Press Windows+R, type 'services.msc' and press Enter.
- Find 'Netsparker Enterprise Scanning Service - [YOUR_AGENT_NAME]'.
- Right-click on it, and select Properties.
- Make sure the Startup type is set to Automatic, and click Start.
Configuring Agent Selection
If you wish, you can select a specific agent while launching a scan.
How to configure Agent selection
- Log in to the Invicti Enterprise Application Server with an Administrator account.
- From the main menu, select Settings > General.
- Enable the Agent Selection Enabled checkbox and select Save.
- From the main menu, select Scans > New Scan.
- In the General tab, select the Preferred Agent drop-down and select an option.
- Complete the fields as required.
Installing 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.
How to install multiple Agents on the same operating system
- Copy all files from the default Agent’s folder to the new Agent’s folder. 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 this command to copy all files to the new Agent’s folder:
xcopy "C:\Program Files (x86)\Invicti Enterprise Agent\*.*" "C:\Program Files (x86)\Invicti Enterprise Agent-2" /yie |
This will create a new directory in C:\Program Files (x86)\Invicti Enterprise Agent-2 and copy in all the required files.
- Locate the new Agent’s folder and open the appsettings.json file with a text editor. Set the new Agent’s name.
- 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