Skip to content

Commit 9ab835e

Browse files
committed
removed duplicate directory for threatprevention
1 parent f5831d9 commit 9ab835e

File tree

969 files changed

+37956
-37956
lines changed

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

969 files changed

+37956
-37956
lines changed
File renamed without changes.
Lines changed: 129 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,129 @@
1+
# Deploy Agents
2+
3+
The Threat Prevention Agent can be deployed through any of the following methods:
4+
5+
- Deploy the Agent to server(s) through the Administration Console – You can deploy the Agent to one
6+
or multiple servers through the Administration Console
7+
8+
**_RECOMMENDED:_** This is the recommended method for deploying the Agent.
9+
10+
- Manually through the Windows Agent Setup Wizard – Run the Agent executable to launch this wizard
11+
12+
See the
13+
[Manual Agent Deployment](/docs/threatprevention/7.4/install/agent/manual.md)
14+
topic for additional information.
15+
16+
## Deploy Agents Wizard
17+
18+
The Deploy Agents wizard enables you to deploy Agents from the Administration Console. Computers
19+
targeted for Agent deployment must meet the minimum .NET Framework version required by the Agent or
20+
the deployment fails. Remember to check server requirements before deploying the Agent, including
21+
compatibility with other security products. See the
22+
[Agent Server Requirements](/docs/threatprevention/7.4/requirements/agent.md)
23+
topic for additional information.
24+
25+
**NOTE:** The wizard does not block access to the Administration Console and can be minimized while
26+
actions are in progress. If this wizard is hidden by clicking outside of the dialog box, a flashing
27+
blue link displays on the upper right corner of the interface with the action name displayed. Click
28+
this link to bring back the focus to the wizard.
29+
30+
The Deploy Agents wizard consists of four windows: Select Computers, Set Options, Prerequisites
31+
Check, and Installing.
32+
33+
Follow the steps to deploy the Agent from the Administration Console to a new or existing machine
34+
using the Deploy Agents wizard.
35+
36+
**CAUTION:** Closing the Administration Console while this action is in process causes problems with
37+
data collection.
38+
39+
**Step 1 –** Click Agents in the left pane to launch the Agents interface.
40+
41+
**Step 2 –** On the Agents interface, click the **Deploy Agent** (**+**) button on the top right
42+
corner. To re-install a previously uninstalled Agent, select the **Install Agent** right-click menu
43+
option for that machine in the grid. The Select Computers window opens.
44+
45+
![Deploy Agents wizard – Select Computers page](/img/versioned_docs/threatprevention_7.4/threatprevention/admin/agents/deploy/selectcomputers.webp)
46+
47+
**Step 3 –** On the Select Computers window, add the host or IP addresses of the target machines to
48+
the Deploy Agents to These Computers box. Use any of the three methods, as represented by the three
49+
tabs on the window. See the
50+
[Select Computers Window](/docs/threatprevention/7.4/admin/agents/deploy/selectcomputers.md)
51+
topic for additional information. Click **Next**.
52+
53+
If you open this window through the
54+
[Right-Click Menu](/docs/threatprevention/7.4/admin/agents/overview.md#right-click-menu)
55+
action, the list is auto-populated with the computer(s) selected on the Agents interface.
56+
57+
![Deploy Agents wizard – Set Options page](/img/versioned_docs/threatprevention_7.4/threatprevention/admin/agents/deploy/setoptions.webp)
58+
59+
**Step 4 –** On the Set Options window, enter the credentials required to deploy the Agent on the
60+
selected machine(s). Review the Enterprise Manager IP address/name and port for accuracy and select
61+
the desired modules to install for this Agent. You can also set other properties for the Agent. See
62+
the
63+
[Set Options Window ](/docs/threatprevention/7.4/admin/agents/deploy/setoptions.md)topic
64+
for additional information.
65+
66+
**Step 5 –** Once configurations are set, click **Next**.
67+
68+
![Deploy Agents wizard – Prerequisites Check page](/img/versioned_docs/threatprevention_7.4/threatprevention/admin/agents/deploy/prerequisitescheck.webp)
69+
70+
**Step 6 –** On the Prerequisites Check window, the credentials provided on the Set Options window
71+
either succeed or fail during a prerequisites or verification check. It also initiates a
72+
prerequisite check for the Agent. See the
73+
[Prerequisites Check Window](/docs/threatprevention/7.4/admin/agents/deploy/prerequisitescheck.md)
74+
topic for additional information.
75+
76+
![Deploy Agents wizard – Installing page](/img/versioned_docs/threatprevention_7.4/threatprevention/admin/agents/deploy/installing.webp)
77+
78+
**Step 7 –** The Installing window performs the installation and displays whether or not the action
79+
was successful. See the
80+
[Installing Window ](/docs/threatprevention/7.4/admin/agents/deploy/installing.md)
81+
topic for additional information.
82+
83+
**Step 8 –** When the task is successfully completed, click **Finish** to close the window.
84+
85+
The Agent will be listed in the table on the Agents interface.
86+
87+
**NOTE:** If the server where the Agent is deployed has multiple network adapters (multi-homed),
88+
then it is necessary to bind the Agent to an adapter that can communicate with the Enterprise
89+
Manager. See the
90+
[Bind To](/docs/threatprevention/7.4/troubleshooting/agentcommunication.md#bind-to)
91+
topic for additional information.
92+
93+
## Update Agent Settings
94+
95+
Follow the steps to update the settings for a deployed Agent through the Agents interface.
96+
97+
**Step 1 –** Click Agents in the left pane to launch the Agents interface.
98+
99+
**Step 2 –** On the Agents interface, right-click the Agent and select Update Agent Settings on the
100+
[Right-Click Menu](/docs/threatprevention/7.4/admin/agents/overview.md#right-click-menu).
101+
The Select Computers window opens.
102+
103+
**Step 3 –** On the Select Computers window, the computer where the Agent is deployed is
104+
automatically added to the Update Agent settings on These Computers box. See the
105+
[Select Computers Window](/docs/threatprevention/7.4/admin/agents/deploy/selectcomputers.md)
106+
topic for additional information. Click **Next**.
107+
108+
**Step 4 –** On the Set Options window, ensure the proper credentials, modules, and Enterprise
109+
Manager location are accurate alongside additional options. To make changes to the settings, uncheck
110+
the **Keep Existing Settings** box. Make necessary updates as needed. See the
111+
[Set Options Window ](/docs/threatprevention/7.4/admin/agents/deploy/setoptions.md)
112+
topic for additional information.
113+
114+
**Step 5 –** On the Prerequisites Check window, the credentials provided on the Set Options window
115+
either succeed or fail during a prerequisites or verification check. See the
116+
[Prerequisites Check Window](/docs/threatprevention/7.4/admin/agents/deploy/prerequisitescheck.md)
117+
topic for additional information. Click **Next**.
118+
119+
**Step 6 –** On the Updating Settings window, the Agent will be stopped and restarted. One of two
120+
status messages display:
121+
122+
- Failed – Read the failure message and either click **Back** to provide new credentials or click
123+
**Finish** to close the window and ensure any error messages are taken care of prior to next
124+
attempt
125+
- Completed – Indicates that the Agent has been successfully updated
126+
127+
**Step 7 –** Click **Finish** to close the window.
128+
129+
The status of the Agent update will display in the grid on the Agents interface.
Lines changed: 24 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,24 @@
1+
# Prerequisites Check Window
2+
3+
The Deploy Agents wizard's Prerequisites Check window is the third in a sequence of four windows to
4+
deploy the Agent on a computer. On this window, Threat Prevention checks if the provided credentials
5+
successfully allow Agent deployment.
6+
7+
![Deploy Agents wizard – Prerequisites Check page](/img/versioned_docs/threatprevention_7.4/threatprevention/admin/agents/deploy/prerequisitescheck.webp)
8+
9+
After the check is run, the status registers as either Success or Failed. Select a host to view the
10+
full message in the box at the bottom of the window.
11+
12+
- Failed – Read the failure message and either click **Back** to provide new credentials or click
13+
**Finish** to close the window and ensure any error messages are taken care of prior to next
14+
attempt
15+
- Success – Click **Next** to install the Agent
16+
- If some but not all items fail, you can click **Next** to deploy the Agent on those where access
17+
verification was successful
18+
19+
In addition to confirming access, Threat Prevention also verifies if the target machine has the
20+
minimum .NET Framework version needed by the Agent already installed; else the deployment fails.
21+
22+
See the
23+
[Installing Window ](/docs/threatprevention/7.4/admin/agents/deploy/installing.md)topic
24+
for the next step.
Lines changed: 56 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,56 @@
1+
# Select Computers Window
2+
3+
The Deploy Agents wizard's Select Computer window is the first in a sequence of four windows to
4+
deploy the Agent on a computer. It provides three methods for selecting computers where Agent(s) can
5+
be deployed:
6+
7+
- Add Single Host
8+
- Add from AD
9+
- Add from File
10+
11+
Any combination of these three methods can be used to select computers.
12+
13+
## Add Single Host Tab
14+
15+
The Add Single Host tab is displayed by default when the Select Computer window opens.
16+
17+
![Deploy Agents wizard – Select Computers page](/img/versioned_docs/threatprevention_7.4/threatprevention/admin/agents/deploy/selectcomputers.webp)
18+
19+
Manually enter and select the host name or IP address of a computer. Use the double-arrow button to
20+
add it to the Deploy Agents to These Computers box.
21+
22+
## Add From AD Tab
23+
24+
Click the Add From AD tab.
25+
26+
![Deploy Agents wizard – Select Computers page: Add from AD tab](/img/versioned_docs/threatprevention_7.4/threatprevention/admin/agents/deploy/addfromad.webp)
27+
28+
Browse the domain's computer objects (Domain Controllers and Computers) to select those where you
29+
want to deploy the Agent.
30+
31+
- Domain to Browse – Displays the domain where the Enterprise Manager resides. If unpopulated, type
32+
the desired domain in the textbox. Click Connect to connect to the domain.
33+
- List of Domain Controllers/Computers – Populates with computers found in Active Directory
34+
- Add (>) button – Adds the selected computer(s) to the Deploy Agents to These Computers box
35+
36+
> **NOTE:** Multiple computers can be selected and moved to the Deploy Agents to These Computers
37+
> box. Checking a top-level node automatically selects all child objects.
38+
39+
## Add From File Tab
40+
41+
Click the Add From File tab.
42+
43+
![Deploy Agents wizard – Select Computers page: Add from File tab](/img/versioned_docs/threatprevention_7.4/threatprevention/admin/agents/deploy/addfromfile.webp)
44+
45+
You can import a text file with a list of computer names or IP addresses with carriage returns, or a
46+
CSV file with comma-separated values.
47+
48+
- Text File to Read – Click Open to browse and select the required file. The box displays the path
49+
to the file.
50+
- List of Hosts/IP Addresses – Populates with computers from the text/CSV file
51+
- Add (>) button – Adds the selected computer(s) to the Deploy Agents to These Computers box
52+
53+
Once the list in the Deploy Agents to These Computers box is complete, you can continue through the
54+
wizard to deploy the Agent. See the
55+
[Set Options Window ](/docs/threatprevention/7.4/admin/agents/deploy/setoptions.md)topic
56+
for the next step.
Lines changed: 109 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,109 @@
1+
# Set Options Window
2+
3+
The Deploy Agents wizard's Set Options window is the second in a sequence of four windows to deploy
4+
the Agent on a computer.
5+
6+
On the Set Options window, you can manage Agent settings, such as credentials, Enterprise Manager
7+
information, modules, DNS host name resolution, and safe mode.
8+
9+
![Deploy Agents wizard - Set Options page](/img/versioned_docs/threatprevention_7.4/threatprevention/admin/agents/deploy/setoptions.webp)
10+
11+
The Set Options window provides the following options:
12+
13+
- Use These Credentials – Credentials to be used to deploy the Agent on the selected computers
14+
- Username – Must be in the DOMAIN\Username format
15+
- Password – Username password
16+
- Enterprise Manager – IP address/name and port where the Enterprise Manager is located
17+
- Modules to Install – Select the check boxes for the modules to be installed on the selected
18+
computers:
19+
- Windows AD Events – Installs the Threat Prevention for Active Directory Solution and Threat
20+
Prevention for LDAP Solution
21+
- Windows File System – Installs the Threat Prevention for File System Solution
22+
- Exchange Server Monitoring – Installs the Threat Prevention for Exchange Solution
23+
- Windows Event Logs – Deprecated functionality for v7.0+ Agents
24+
- Agent Service
25+
26+
- Safe Mode – The Agent checks LSASS versions on start up. Any changes in LSASS since the
27+
previous start prevents the AD Events monitoring module from loading. See the
28+
[Agent Safe Mode](/docs/threatprevention/7.4/admin/agents/safemode.md)
29+
topic for additional information.
30+
- Use local Pwned hash DB – A local copy of the Pwned hash database is sent to the Agent after
31+
installation from the Enterprise Manager. Any updates to the database are sent from the
32+
Enterprise Manager to the Agent(s) as long as the Agent service is enabled.
33+
- Start Agent Service – Starts the Threat Prevention Agent service on host after installation
34+
35+
**NOTE:** If the Agent Service is not started at the time of deployment, the Agent requires
36+
a manual start or will be started automatically after a server reboot. Until the Agent is
37+
started, no activity is monitored or blocked.
38+
39+
- Create Windows Firewall Rules – Creates firewall rules on the selected computers for Agent
40+
communication
41+
- Install to default location – Installs the Agent on the machine to the default location or a
42+
specified location.
43+
44+
![Deploy Agents wizard – Set Options page: Agent Install Path box](/img/versioned_docs/threatprevention_7.4/threatprevention/admin/agents/deploy/installpath.webp)
45+
46+
If checked, the Agent is installed to the default location: ...\Netwrix\Netwrix Threat
47+
Prevention\SIWindowsAgent
48+
49+
If unchecked, specify the desired installation location, e.g. d:\myagent.
50+
51+
The installation location applies to all computers where the Agent is being deployed in this session
52+
(as specified on the
53+
[Select Computers Window](/docs/threatprevention/7.4/admin/agents/deploy/selectcomputers.md)
54+
of the Deploy Agents wizard). Once these settings are configured as desired, the Agent is ready for
55+
deployment on the selected machines. See the
56+
[Prerequisites Check Window](/docs/threatprevention/7.4/admin/agents/deploy/prerequisitescheck.md)
57+
topic for the next step.
58+
59+
##### DNS Host Name Resolution
60+
61+
The Agent is configured to “Enable DNS Host Name Resolution” by default during deployment. Depending
62+
on the event type, the Agent may see some but not all of the following information:
63+
64+
- NetBIOS name
65+
- Fully Qualified Domain Name
66+
- IP Address
67+
68+
This information is stored in the SIWindowsAgent.exe.confg file as XML tags/values in the folder the
69+
Agent is installed to. When the Agent Service starts, it reads this file.
70+
71+
When the Enable DNS Host Name Resolution option is enabled, the Agent looks up the missing data. Raw
72+
events may have one or more of following: SID, domain name, NetBiosName, machine name, and IP
73+
address. When any one of these data points is available, Threat Prevention uses Windows DNS, if
74+
enabled, to collect the missing data points for the raw event from LSASS. This provides more uniform
75+
data, but may have a performance impact on the machine where the Agent is deployed, especially if
76+
name resolution is not handled locally by that machine.
77+
78+
## Set Options Window for Update Agent Settings
79+
80+
On the Agents interface, when you open the Set Options window through the Update Agent Settings
81+
option on the
82+
[Right-Click Menu](/docs/threatprevention/7.4/admin/agents/overview.md#right-click-menu),
83+
the window appears as follows:
84+
85+
![Update Agent Settings > Set Options page](/img/versioned_docs/threatprevention_7.4/threatprevention/admin/agents/deploy/updatesetoptions.webp)
86+
87+
This window displays the default selections in the Modules to Set and Additional Options areas; they
88+
do not represent the actual current state of the Agent.
89+
90+
**NOTE:** To view the current state and configured options for an Agent, hover over the Version
91+
String column on the
92+
[Agents Interface](/docs/threatprevention/7.4/admin/agents/overview.md)
93+
data grid for the tool tip. The AD Agent column indicates the Agent’s mode.
94+
95+
This Set Options window is the same as discussed above, with the exception of the following:
96+
97+
- Enable DNS Host Name Resolution – See the
98+
[DNS Host Name Resolution ](#dns-host-name-resolution)topic for information. Even when this option
99+
is enabled for the Agent, it is displayed as unchecked. You must either check this setting or
100+
check the Keep Existing Settings checkbox to keep it enabled for the Agent.
101+
- Keep Existing Settings – When checked, options in the Modules to Set and Additional Options areas
102+
are grayed out and cannot be changed, indicating that the same current settings are retained for
103+
the Agent.
104+
105+
This setting has no impact on the Use These Credentials and Enterprise Manager areas.
106+
107+
**CAUTION:** Make sure you select the desired settings for the Agent on this window, such as the
108+
Enable DNS Host Name Resolution and Safe Mode options, even when they are currently enabled for the
109+
Agent. Leaving them unchecked will disable those settings when the wizard completes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.

0 commit comments

Comments
 (0)