Step 3: Installing & configuring the agent
The Acunetix 360 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.
TIP: You can also install the Acunetix 360 Agent in silent mode. For more information, refer to Installing the Acunetix 360 Agent in Silent Mode. |
How to install the Acunetix 360 Agent
- Run the AgentSetup.exe file.
- On the Acunetix 360 Agent Setup window, select Next.
- 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.
- 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 of the installation wizard - 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.
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 to the folder containing the AgentSetup.exe file.
- 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 to the folder containing the AgentSetup.exe file.
- 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.
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 Acunetix 360 Agent, as usual, using the AgentSetup.exe file.
- Copy all files from the default Agent’s folder to the new Agent’s folder. The default installation path is: C:\Program Files (x86)\Acunetix 360 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 new Agent’s folder:
xcopy "C:\Program Files (x86)\Acunetix 360 Agent\*.*" "C:\Program Files (x86)\Acunetix 360 Agent-2" /yie |
This will create a new directory in C:\Program Files (x86)\Acunetix 360 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)\Acunetix 360 Agent-2
- This command installs the new Agent as a Windows Service:
Acunetix.Cloud.Agent.exe /i
- This command starts the new Agent’s Windows Service:
Acunetix.Cloud.Agent.exe /s