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. Deploying agent manually via Group Policy:

1.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 is hosted.
    ServerIP refers to the IP Address of the server where ADAudit Plus 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, i.e., HTTP or HTTPS 

    Note:  Port refers to the port number over which ADAudit Plus communicates.  The default port number used by ADAudit Plus is 8081. If you are using a different port, please enter the corresponding value.

    ServerFQDN refers to the FQDN of the server where ADAudit Plus 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. 

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

2. Installing the agent by running the MSI file on client computers

Arguments while installing the agent:

Server name: The name of the server where ADAudit Plus is hosted.
Port: The port number used to communicate with the ADAudit Plus server.
Protocol: The defined protocol for communicating with the ADAudit Plus server.

To check which port number and transfer protocol are being used by ADAudit Plus, go to the Admin tab, and choose Connection under General Settings. The corresponding port number and protocol used by the ADAudit Plus server can be found here.

ADAuditPlus Agent Configuration Setup

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

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

Protocol refers to the protocol used for communication, i.e., HTTP or HTTPS .

Port refers to the port number over which ADAudit Plus communicates. The default port number used by ADAudit Plus is 8081. If you are using a different port, please enter the corresponding value.

Note: To find out the port number used by ADAudit Plus, open the ADAudit Plus console, click on the Admin → General Settings → Connection.

SERVERNAME refers to the name of the server where ADAudit Plus is hosted.

SERVERFQDN refers to the fully qualified domain name of the server where ADAudit Plus 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.

SERVERIP refers to the IP Address of the server where ADAudit Plus is hosted.

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

4. Installing the agent via Desktop Central

  • 4.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 is hosted.

        ServerIP refers to the IP Address of the server where ADAudit Plus 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, i.e., HTTP or HTTPS.

        Port refers to the port number over which ADAudit Plus communicates.

        The default port number used by ADAudit Plus is 8081. If you are using a different port, please enter the corresponding value.

        ServerFQDN refers to the FQDN of the server where ADAudit Plus 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.

      • 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 is hosted.

        Port refers to the port number over which ADAudit Plus communicates.

        The default port number used by ADAudit Plus is 8081. If you are using a different port, please enter the corresponding value.

        Protocol refers to the protocol used for communication, i.e., HTTP or HTTPS.

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

        ServerIP refers to the IP Address of the server where ADAudit Plus is hosted.

      • Click on Add Package. ADAuditPlus Agent Configuration Setup
  • 4.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