The Freshservice Discovery Agent helps you keep track of your assets by sending details and updates about the machine it is installed on. You can use Group Policy Object (GPO) to deploy the Discovery Agent on all the computers in your domain.


Deploy Discovery Agent using GPO (Without Proxy)


Note: The steps in this solution article are applicable for Windows Server 2012 only, and it may differ for other versions of the active directory.


  1. In your Freshservice instance, go to Admin > Global Settings > Asset Management > Discovery Hub. Click Configure Agent and Probe in the Basic discovery section, and download the Windows Discovery Agent file.
  2. Download the InstallFSWinAgent_proxy.vbs file attached to this solution article.
  3. In the Domain Controller, go to Start > Run. Then, run the gpmc.msc command.  The Group Policy Management Console (GPMC) window opens.
    1. In GPMC, right-click the Domain where the agent should be installed and select Create and Link a GPO here.
    2. If you want to install the Discovery Agent on computers only in a particular Organizational Unit (OU), right click that OU and select Create a GPO in this domain, and link it here.
  4. Enter a name for the new GPO (for example, FreshserviceAgent) and click OK.
  5. Right-click the newly created GPO and select Edit from the context menu. The Group Policy Management Editor (GPME) dialog opens.
  6. In the GPME dialog, go to Computer Configuration > Policies > Windows Settings > Scripts, and double-click Startup. The Startup Properties dialog opens.
  7. Click Show Files, which opens a folder. Copy the Agent file and the installer script (downloaded from steps 1 and 2) to this folder.
  8. In the Startup Properties dialog, click Add. 
  9. Click Browse and select the installer script from the folder mentioned in step 7. 
  10. In the Script Parameters field, enter the absolute path to MSI.

    Example:

     {01F619BB-A42B-4494-9143-F0917A87055E}\Machine\Scripts\Startup\FSAgent.msi REGISTRATIONTOKEN="<token>

  11. Click OK to close the Add a script form.
  12. Click OK to close the Startup Properties dialog.
  13. Then, close the GPME window.
  14. In order to enforce the current Group Policy immediately, run the command gpupdate /force.


The Windows machines on that particular domain or OU will automatically install the Discovery Agent upon restart.


Deploy Discovery Agent using GPO (With Proxy)

If you have Proxy configured within your organization, enter the absolute path to MSI along with the following additional arguments in the Script Parameters field (remaining steps are the same as mentioned in the above procedure).

<shared agent installer with path> REGISTRATIONTOKEN="<token>" PROXYSERVER=<proxy server name/ip> PROXYPORT=<proxy port> PROXYUSERNAME=<proxy user name> PROXYPASSWORD=<proxy password>

Example:


\\fd.labs\SysVol\fd.labs\Policies\{01F619BB-A42B-4494-9143-F0917A87055E}\Machine\Scripts\Startup\FSAgent.msi REGISTRATIONTOKEN="dummytokenvalue" PROXYSERVER=192.168.5.161 PROXYPORT=808 PROXYUSERNAME=balaguru PROXYPASSWORD=bala

More information on the Agent (supported OS, prerequisites, and download instructions) can be found here.

To install the Discovery Agent on computers in a workgroup, use the PSExec tool.



InstallFSWinAgent_proxy.vbs InstallFSWinAgent_proxy.vbs

(1.37 KB)