Support
 
Phone Get Quote
 
Support
 
US: +1 888 720 9500
US: +1 888 791 1189
Intl: +1 925 924 9500
Aus: +1 800 631 268
UK: 0800 028 6590
CN: +86 400 660 8680

Direct Inward Dialing: +1 408 916 9892

 

Installing the agent manually

1. Server name, port, and protocol 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.
  • 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. Installing the agent manually

2. Installing the agent via Group Policy

2.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.

  • Open the ORCA tool > File > Open > Select the file- ADAuditPlusAgent-x86.msi or ADAuditPlusAgent-x64.msi
  • Click on 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, 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 communication by the ADAudit Plus server/NAT device.

    Port refers to the port number used by the ADAudit Plus server/NAT device.

    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, and Protocol used by ADAudit Plus, click here.

    ADAuditPlus Agent Configuration Setup
  • Click on the Transform tab > Select Generate Transform > Name the transformation file as ADAP.mst and Save it.
  • Copy the following 2 files into a new folder-
    • 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.

    • ADAP.mst (the file generated using the ORCA tool)
  • Right-click on the newly created folder, go to Share with > Specific people > Type Domain Computers in the search box > Provide Read permission > Click Share.
2.2 Install the agent via Group Policy
  • Log in to any computer that has the Group Policy Management Console (GPMC) with Domain Admin credentials > Open the GPMC > Create a new GPO named 'ADAuditPlusAgent' > Link this GPO to the audited computers.
  • Right-click ADAuditPlusAgent GPO and select Edit > Computer Configuration > Policies > Software Settings > Right-click Software Installation > 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.

  • In the Deploy Software pop-up, select Advanced > Modifications > Add > 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.

3. 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 by the ADAudit Plus server/NAT device.
Protocol: The protocol used for communication by the ADAudit Plus server/NAT device.

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

ADAuditPlus Agent Configuration Setup

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

4. 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:

msiexec /i "MSI file location" PROTOCOL=HTTPS PORT=8444 SERVERNAME=adap-dc2 SERVERFQDN=adap-dc2.adap.internal.com SERVERIP=192.168.225.33 /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

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 communication by the ADAudit Plus server/NAT device.

Port refers to the port number used by the ADAudit Plus server/NAT device.

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, and Protocol used by ADAudit Plus, click here.
Reboot of server is not required after agent installation.

5. Installing the agent via Desktop Central

  • 5.1 Create an MSI package:

    MSI is an installer package file format used by Windows.

    • Log in to the Desktop Central console as an administrator.
    • Click on Software Deployment → Packages → Add Packagestrong> → Select Windows from the drop-down.
    • 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. For 32-bit installations choose ADAuditPlusAgent-x86.msi and for 64-bit installations choose ADAuditPlusAgent-x64.msi.

      • Click on 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, 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 communication by the ADAudit Plus server/NAT device.

        Port refers to the port number used by the ADAudit Plus server/NAT device.

        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, and Protocol used by ADAudit Plus, click here.

      • Click on the Transform tab → Generate Transform → Name the transformation file and click on Save. ADAuditPlus Agent Configuration Setup
      • Click on Browse and select the MSI and MST files.
      • Click on Add Package. ADAuditPlus Agent Configuration Setup
      (b) Install package by using installation properties
      • Beside MSI/MSP Properties for installation, enter the following command: SERVERNAME="adap-dc1" PORT="8081" PROTOCOL="https" SERVERFQDN="adap-dc1.adap.internal.com" SERVERIP="172.21.9.20"

        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 communication by the ADAudit Plus server/NAT device.

        Port refers to the port number used by the ADAudit Plus server/NAT device.

        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, and Protocol used by ADAudit Plus, click here.

      • Click on Add Package. ADAuditPlus Agent Configuration Setup
  • 5.2 Deploy the MSI package
    • Click on Software Deployment → Install/Uninstall Software → Windows → Computer Configuration.
    • 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, enter computer name.

      Click on Deploy Immediately.

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

ADAudit Plus Trusted By