Contents

Chocolatey for Installation of WatchGuard Endpoint Software

Deployment Overview

This document describes how to use Chocolatey to install WatchGuard endpoint software on Windows computers. This document describes how to use Chocolatey to install:

Before You Begin

Before you begin:

  • Install Chocolatey on your computer. To test this integration, we used v0.10.15.
  • Download the install file for the WatchGuard endpoint software you want to install.
  • Record the information required to install each type of WatchGuard endpoint software.

For information about how to download and install the required software, see the Chocolatey and WatchGuard documentation.

AD Helper

To install TDR AD Helper, you must first create a Chocolately install package, and then use that package to install the software.

Create the AD Helper Chocolatey Install Package

  1. Open the Command Prompt as administrator.
  2. To generate package specification and template files, run this command:
    choco new WG_AD_Helper
    A new /WG_AD_Helper subdirectory is created that contains package and template files.

Screen shot of the Administrator Command Prompt window with the command: choco new WG_AD_Helper

  1. Copy the AD Helper install file (helper-x.x.xxxx.msi) to the subdirectory \WG_AD_Helper\tools.
  2. In the \WG_AD_Helper subdirectory, open the file wg_ad_helper.nuspec with a text editor, and edit it to look like the image below. Iin the <version> parameter, specify the AD Helper version. Make sure to delete all annotations.

wg_ad_helper.nuspec

  1. In the \WG_AD_Helper\tools subdirectory, open the file chocolateyInstall.ps1, and edit it to look like the image below, Make sure to delete all annotations.

chocolateyInstall.ps1

  1. To create the package file, from the subdirectory \WG_AD_Helper, run this command:
    choco pack
    The package file (.nupkg) is created in the current subdirectory. The file name contains the version number specified in the .nuspec file. In this example, the package file is wg_ad_helper.5.7.0.9558.nupkg.

creat pack

Install AD Helper

  1. In the Administrator Command Prompt, change to the \WG_AD_Helper directory.
  2. Run this command: 
    choco install wg_ad_helper.5.7.0.9558.nupkg
    Specify the name of your nupkg file, which may have a different version number.

Install AD Helper

  1. Review the command output to verify the installation was successful.

Host Sensor

To install a TDR Host Sensor, you must first create a Chocolately install package, and then use that package to install the software.

Create the Host Sensor Chocolatey Install Package

  1. Open the Command Prompt as administrator.
  2. To generate package specification and template files, run this command:
    choco new WG_Host_Sensor
    A new /WG_Host_Sensor subdirectory is created that contains package and template files.
  1. In the \WG_Host_Sensor subdirectory, open the file wg_host_sensor.nuspec with a text editor, and edit it to look like the image below. In the <version> parameter, specify the version of the Host Sensor installer you downloaded. Make sure to delete all annotations.

wg_host_sensor.nuspec

  1. In the \WG_Host_Sensor\tools subdirectory, open chocolateyInstall.ps1 and edit it to look like the image below, Make sure to delete all annotations.

chocolateyInstall.ps1

  1. To create the package file, from the subdirectory \WG_Host_Sensor, run this command:
    choco pack
    The package file (.nupkg) is created in the current subdirectory. The file name contains the version number specified in the .nuspec file. In this example, the package file is wg_ad_helper.5.7.0.9558.nupkg.

Install the Host Sensor

  1. From your TDR account, download the Host Sensor installer .MSI file, and copy it to the subdirectory \WG_Host_Sensor\tools.
  2. From the Host Sensor installer download page, copy your Account ID and Controller Address.
  3. In the Administrator Command Prompt, change to the WG_Host_Sensor subdirectory.
  4. Run this command:
    choco install -y wg_host_sensor -source C:\Users\admin\Desktop\WG_Host_Sensor --install-arguments CONTROLLER_ADDRESS=Controller Address ACCOUNTUUID=Account ID

When you run this command:

  • Specify the correct path to your WG_Host_Sensor subdirectory.
  • Specify the Controller Address and Account ID for your TDR account.

Host Sensor Chocolatey installation

AuthPoint Logon App

To install the AuthPoin Logon App, you must first create a Chocolately install package, and then use that package to install the software.

Create the Host Sensor Chocolatey Install Package

  1. Open the Command Prompt as administrator.
  2. To generate package specification and template files, run this command:
    choco new AuthPoint_Logon_App
    A new /AuthPoint_Logon_App subdirectory is created that contains package and template files.
  1. In the \AuthPoint_Logon_App subdirectory, open the file authpoint_logon_app.nuspec with a text editor, and edit it to look like the image below. In the <version> parameter, specify the version of the installer you downloaded. Make sure to delete all annotations.

authpoint_logon_app.nuspec

  1. In the \AuthPoint_Logon_App\tools subdirectory, open chocolateyInstall.ps1 and edit it to look like the image below, Make sure to delete all annotations.

chocolateyInstall.ps1

Install the AuthPoint Logon App

  1. From your AuthPoint account, download the AuthPoint Logon App installer .MSI file and config file to the subdirectory \AuthPoint_Logon_App\tools.
  2. In the Administrator Command Prompt, change to the \AuthPoint_Logon_App subdirectory
  3. Run this command:
    choco install authpoint_logon_app.1.7.2.110.nupkg
    Specify the name of your nupkg file, which may have a different version number.

AuthPoint_Logon_App Chocolatey installation

  1. To finish installation, reboot the computer.

Mobile VPN with SSL Client

To install the Mobile VPN with SSL client, you must first create a Chocolately install package, and then use that package to install the software.

Create the Mobile VPN with SSL Chocolatey Install Package

  1. Open the Command Prompt as administrator.
  2. To generate package specification and template files, run this command:
    choco new Mobile_VPN_with_SSL
    A new /Mobile_VPN_with_SSL subdirectory is created that contains package and template files.
  1. In the \Mobile_VPN_with_SSL subdirectory, open the file mobile_vpn_with_ssl.nuspec with a text editor, and edit it to look like the image below. In the <version> parameter, specify the version of the Mobile VPN with SSL client installer you downloaded. Make sure to delete all annotations.

mobile_vpn_with_ssl.nuspec

  1. In the \Mobile_VPN_with_SSL\tools subdirectory, open chocolateyInstall.ps1 and edit it to look like the image below, Make sure to delete all annotations.

chocolateyInstall.ps1

Install the Mobile VPN with SSL Client

  1. In the Administrator Command Prompt change to the \Mobile_VPN_with_SSL subdirectory.
  2. Run this command:
    choco install mobile_vpn_with_ssl.12.2.nupkg
    Specify the name of your nupkg file, which may have a different version number.

Mobile VPN with SSL Chocolatey installation

  1. If the confirmation dialog box shown below appears, click Install to continue。

IPSec Mobile VPN Client

To install the IPSec Mobile VPN Client, you must first create a Chocolately install package, and then use that package to install the software.

Create the IPSec Mobile VPN Chocolatey Install Package

  1. Open the Command Prompt as administrator.
  2. To generate package specification and template files, run this command:
    choco new Mobile_VPN_with_SSL
    A new /Mobile_VPN_with_SSL subdirectory is created that contains package and template files.
  1. In the \IPSec_Mobile_VPN subdirectory, open the file ipsec_mobile_vpn.nuspec with a text editor, and edit it to look like the image below. In the <version> parameter, specify the version of the IPSec Mobile VPN client installer you downloaded. Make sure to delete all annotations.

ipsec_mobile_vpn.nuspec file

  1. In the \Mobile_VPN_with_SSL\tools subdirectory, open chocolateyInstall.ps1 and edit it to look like the image below, Make sure to delete all annotations.

chocolateyInstall.ps1

Install the IPSec Mobile VPN Client

  1. In the Administrator Command Prompt, change to the \IPSec_Mobile_VPN_with_SSL subdirectory.
  2. Run this command:
    choco install ipsec_mobile_vpn.13.13.nupkg
    Specify the name of your nupkg file, which may have a different version number.

IPSec Mobile VPN Chocolatey installation

  1. The computer reboots automatically during the installation.

Give Us Feedback  ●   Get Support  ●   All Product Documentation  ●   Technical Search