Installing the agent manually

Server name, port, protocol, and org access key used by ADAudit Plus

To find the server name, port, and protocol used by ADAudit Plus, log in to the ADAudit Plus console, navigate to the Admin tab > General Settings > Connection > NAT.

• If you have not configured a NAT device between the ADAudit Plus agent and server, you can find the details adjacent to the Central server field (by default, ADAudit Plus uses port number 8555 for agent to server communication).
• If you have configured a NAT device between the ADAudit Plus agent and server, you can find the details adjacent to the NAT Device field.

  

To find the org access key used by ADAudit Plus, log in to the ADAudit Plus console, navigate to the Admin tab > Configuration > Agent Settings > Agent Security Settings > Org access key for agent to server communication.

Installing the agent via Group Policy:

1. Create an MST file

MST files are used by administrators to customize the behavior of an existing MSI file (MSI is an installer package file format used by Windows).

An MST file needs to be created using the ORCA tool, which is available under Windows SDK Components for Windows Installer Developers.

1. Open the ORCA tool > File > Open > Select the file- ADAuditPlusAgent-x86.msi or ADAuditPlusAgent-x64.msi

Note: The above files can be found under <ADAudit Plus installation directory>\webapps\adap\agent. If the target computer is running a 32-bit OS, choose ADAuditPlusAgent-x86.msi. If the target computer is running a 64-bit OS, choose ADAuditPlusAgent-x64.msi.

2. Click on the Transform menu. Select New Transform and navigate to the panel on the left. Select Registry and enter the appropriate values for the fields—ServerName, ServerIP, Build, Protocol, Port, OrgAccessKey, and ServerFQDN.

   Here, ServerName refers to the name of the server where ADAudit Plus/NAT device is hosted.

   ServerIP refers to the IP address of the server where ADAudit Plus/NAT device is hosted.

   Build refers to the build number of your ADAudit Plus installation.

   The build number is a 4 digit number that can be found by clicking on the license button located on the top right corner of your ADAudit Plus console.

   Protocol refers to the protocol used for agent to server communication (HTTPS by default).

   Port refers to the port number used for agent to server communication (8555 by default).

   OrgAccessKey refers to the key used for agent to server communication (unique to each organization).

   ServerFQDN refers to the FQDN of the server where ADAudit Plus/NAT device is hosted. For example, if ADAudit Plus is hosted on a DC named adap-dc2 in the adap.internal.com domain, the ServerFQDN is adap-dc2.adap.internal.com.

   Note: To find the ServerName, Port, Protocol, and OrgAccessKey used by ADAudit Plus, click here.

   

3. Click the Transform tab and select Generate Transform. Name the transformation file ADAP.mst and Save it.
4. Copy the following 2 files into a new folder-
   1. ADAuditPlusAgent-x86.msi or ADAuditPlusAgent-x64.msi

      Note: The above files can be found under <ADAudit Plus installation directory>\webapps\adap\agent. For 32-bit installations choose ADAuditPlusAgent-x86.msi and for 64-bit installations choose ADAuditPlusAgent-x64.msi.

   2. ADAP.mst (the file generated using the ORCA tool)
5. Right-click the newly created folder, go to Share with > Specific people and type Domain Computers in the search box. Provide Read permission and click Share.

2. Install the agent via Group Policy

1. Log in to any computer that has the Group Policy Management Console (GPMC) with Domain Admin credentials. Open the GPMC and create a new GPO named ADAuditPlusAgent. Link this GPO to the audited computers.
2. Right-click ADAuditPlusAgent GPO and select Edit > Computer Configuration > Policies > Software Settings. Right-click Software Installation and select New > Package. In the dialog box, type the full Universal Naming Convention (UNC) path of the ADAP MSI file.

   Note: For 32-bit installations type the full UNC of ADAuditPlusAgent-x86.msi and for 64-bit installations type the full UNC of ADAuditPlusAgent-x64.msi.

   For example, in the dialog box, enter:
    \\Server_name\Shared_folder\ADAuditPlusAgent-x64.msi
   Here, Server_name refers to the name of the server on which the file resides. 
   Shared_folder refers to the folder created under step 4.1.1 iv.

   Note: Ensure that you enter the full UNC path as opposed to the local/network path.

3. In the Deploy Software pop-up, select Advanced > Modifications > Add and type the full Universal Naming Convention (UNC) path of the ADAP MST file.

   Note: Again, ensure that you enter the full UNC path as opposed to the local/network path.

Once the computers restart, the ADAudit Plus agent will get automatically installed.

Note: Reboot of server is not required after agent installation.

Installing the agent by running the MSI file on client computers

Provide the below arguments while installing the agent:

Server name: The name of the server where ADAudit Plus/NAT device is hosted.

Port: The port number used for agent to server communication (8555 by default).

Protocol: The protocol used for agent to server communication (HTTPS by default).

OrgAccessKey refers to the key used for agent to server communication (unique to each organization).

Note: To find the ServerName, Port, Protocol, and OrgAccessKey used by ADAudit Plus, click here.

Note: Reboot of server is not required after agent installation.

Installing the agent via command line

On the target computer, open an elevated Command Prompt (right-click Command Prompt and select Run as administrator), and execute the below command:

msiexec /i "MSI file location" PROTOCOL=HTTPS PORT=8444 SERVERNAME=adap-dc2 SERVERFQDN=adap-dc2.adap.internal.com SERVERIP=192.168.225.33 OrgAccessKey=ADCFDA98-8FDD-45E4-90BC-E3D20B029870 /q

Copy MSI files from this location, <Installation_folder>\webapps\adap\agent, and save it on the target computer. Add the MSI file location (on the target computer) in the command above.

Note: Choose the appropriate MSI based on the OS version on your client computer.

For 32-bit versions: ADAuditPlusAgent-x86.msi

For 64-bit versions: ADAuditPlusAgent-x64.msi

Note: To find the ServerName, Port, Protocol, and OrgAccessKey used by ADAudit Plus, click here.
Reboot of server is not required after agent installation.

Installing the agent via Endpoint Central

1. Create an MSI package:

To install the ADAudit Plus agent via Endpoint Central, follow the below steps:

• Log in to the Endpoint Central console as an administrator.
• Click Software Deployment > Package creation > Packages > Add Package and select Windows from the drop-down.
• Provide the below details:
  • Beside Package Name, enter ADAudit Plus Agent or any other name of your choice.
  • Beside Package Type, select MSI/MSP.
  • Beside License Type, select Commercial from the drop-down.
  • Beside Location installable, select From Shared Folder.
• Install the package, using either one of these methods-
• (a) Install package by using MST file
• Create an MST file. MST files are used by administrators to customize the behavior of an existing MSI file (MSI is an installer package file format used by Windows). An MST file needs to be created using the ORCA tool, which is available under Windows SDK Components for Windows Installer Developers.
• Open the ORCA tool > File > Open > Select the file- ADAuditPlusAgent-x86.msi or ADAuditPlusAgent-x64.msi

  Note: The above files can be found under <ADAudit Plus installation directory>\webapps\adap\agent. If the target computer is running a 32-bit OS choose ADAuditPlusAgent-x86.msi and if it is running a 64-bit OS choose ADAuditPlusAgent-x64.msi.

• Click the Transform menu > Select New Transform > Navigate to the panel on the left, select Registry > Enter appropriate values for the fields—ServerName, ServerIP, Build, Protocol, Port, OrgAccessKey, and ServerFQDN.

  Here,

  ServerName refers to the name of the server where ADAudit Plus/NAT device is hosted.

  ServerIP refers to the IP address of the server where ADAudit Plus/NAT device is hosted.

  Build refers to the build number of your ADAudit Plus installation.

  The build number is a 4 digit number that can be found by clicking on the license button located on the top right corner of your ADAudit Plus console.

  Protocol refers to the protocol used for agent to server communication (HTTPS by default).

  Port refers to the port number used for agent to server communication (8555 by default).

  OrgAccessKey refers to the key used for agent to server communication (unique to each organization).

  ServerFQDN refers to the FQDN of the server where ADAudit Plus/NAT device is hosted. For example, if ADAudit Plus is hosted on a DC named adap-dc2 in the adap.internal.com domain, the ServerFQDN is adap-dc2.adap.internal.com.

  Note: To find the ServerName, Port, Protocol, and OrgAccessKey used by ADAudit Plus, click here.

• Click the Transform tab > Generate Transform. Name the transformation file and click Save.

  

• Click Browse and select the MSI and MST files.
• Click Add Package.

  

(b) Install the package by using installation properties:
• Beside MSI/MSP Properties for installation, enter the following command:

  For example, msiexec /i \\Steven-10123\ADAuditPlusAgent-x64.msi PROTOCOL=HTTPS PORT=8444 SERVERNAME=Steven-10123 SERVERFQDN=Steven-10123.adap.internal.com SERVERIP=192.168.225.33 OrgAccessKey=ADCFDA98-8FDD-45E4-90BC-E3D20B029870 /q

  Here,

  ServerName refers to the name of the server where ADAudit Plus/NAT device is hosted.

  ServerIP refers to the IP address of the server where ADAudit Plus/NAT device is hosted.

  Protocol refers to the protocol used for agent to server communication (HTTPS by default).

  Port refers to the port number used for agent to server communication (8555 by default).

  OrgAccessKey refers to the key used for agent to server communication (unique to each organization).

  ServerFQDN refers to the FQDN of the server where ADAudit Plus/NAT device is hosted. For example, if ADAudit Plus is hosted on a DC named adap-dc2 in the adap.internal.com domain, the ServerFQDN is adap-dc2.adap.internal.com.

  Note: To find the ServerName, Port, Protocol, and OrgAccessKey used by ADAudit Plus, click here.

• Click Add Package.

  

2. Deploy the MSI package

• In the Endpoint Central console, click Software Deployment > Install/Uninstall Software > Windows > Computer Configuration.
• Provide the below details:
  • Beside Name, enter ADAudit Plus deployment or any other name of your choice.
  • Beside Package Name, select the package.
  • Beside Operation Type, select Install from the drop-down.
  • Beside Define Target, select the Remote Office/Domain and specify the Computer.
• Click Deploy.

Note: Reboot of server is not required after agent installation.