Desktop Notification Client Command Line Installation

This topic describes how you can install the Desktop Notification Client (DNC) from the command line for the Windows OS and macOS.

Note: See Sending Desktop Notifications for information about installing DNC on individual machines.

You can automate the installation of the Desktop Notification Client (DNC) on Windows by distributing software through an automated tool. Many automated tools exist on the market today, including one built directly into Active Directory Group Policy. Using an automated tool, in combination with a silenced installation, eliminates the time-consuming manual steps required for installing and configuring the DNC on the desktop for each end user.

You install the DNC using a standard MSI installer. MSI-based software installations use a universal switch structure. Sending instructions to an MSI-based software installation requires learning only a single syntax. That syntax looks generally like this:

msiexec.exe /q /l* {logfile.txt} /i {setup.msi} {NAME=Value}

Microsoft's website provides the full list of MSI options at Standard Installer Command-Line Options.

To install the DNC in a fully-automated silent installation, use these options:

msiexec.exe /i "<FileLocation>\Mitel-REV-DNC.msi" LicenseAccepted=1 /qn

Other, optional, options include the following (not case sensitive):

  • DisableShortcut={true|false} - Define whether the DNC shortcut should appear on the Windows desktop.

  • LocalPort=<number> – Define the port on which the DNC and the broker (Windows service) will communicate. Default is 4442 (or retain existing setting). This port is internal-only, which means you do not need to configure any firewall rules.

  • LockscreenEnabled={true|false} – Define whether notifications can be displayed when the screen is locked. Default is false (or retain existing setting).

  • RevServer=<ip_address>[,<ip_address>]... – Specify a comma-separated list of IP addresses to include in the Manual Server List of the DNC. This setting is machine-wide to support all users who may be using the machine.

  • EnableRemoteAccess={true | false} - Define whether the DNC will work with remote access. See Using the DNC with Remote Access.

  • AppendServer={true | false} – Define whether any IP addresses specified with RevServer should be appended to the existing list of Manual Servers rather than replacing the existing list.

    • If you do not specify this option, it defaults to false.

    • If you do specify this option, you must include a value.

There are two methods you can use to uninstall the DNC.

If you have the original installer, you can use the msiexec command to uninstall it silently. A reboot is required after uninstalling, so this command will automatically reboot the machine after installation. Please review the list of MSI options from Microsoft if you wish to delay reboot.

msiexec.exe /x "<FileLocation>\Mitel-REV-DNC.msi" /qn /forcerestart

If you no longer have the original installer, you can uninstall using Windows Management Instrumentation Command Line (WMIC). The WMIC is a software utility that allows users to perform Windows Management Instrumentation (WMI) operations with a command prompt. Use the following command line to perform a silent uninstall. You'll need to manually reboot desktops after the installation or tell your end-users to do so.

wmic product where name="Mitel Revolution DNC" call uninstall

For your convenience, the following link is to a 3rd-party article with additional information on uninstalling software on remote computers using WMIC: Uninstall software on remote computers using WMIC.

You can install the DNC on your macOS using the DNC command line installer tool from the terminal.

DMG filename: Mitel Revolution DNC.dmg

You must run the installer tool with sudo privileges. You must also mount (hdiutil attach) and unmount (hdiutil detach) the DMG.

All of the following options are optional.

  • --LocalPort <port_number> – Define the port on which the DNC and the broker (macOS system daemon) will communicate. Default is 4442 (or retain existing setting). This port is internal-only, which means you do not need to configure any firewall rules.

  • --RevServer <ip_address>[,<ip_address>]... – Specify a comma-separated list of IP addresses to include in the Manual Server List of the DNC. This setting is machine-wide to support all users who may be using the machine.

  • --AppendServer [true | false] – Define whether any IP addresses specified with ‑‑RevServer should be appended to the existing list of Manual Servers rather than replacing the existing list. 

    • If you do not specify this option, it defaults to false.

    • If you specify this option without an argument, it defaults to true.

  • --EnableRemoteAccess [true | false] - Define whether the DNC will work with remote access. See Using the DNC with Remote Access.

  • --NoInstall – (rarely used) Instructs the tool to not call the macOS installer program in the DMG but does finalize any other options on the machine. Ensure that the broker and DNCs are shut down before using this argument.

Example:

hdiutil attach "Mitel Revolution DNC.dmg"

sudo /Volumes/Syn-Apps\ Revolution\ Desktop\ Notification\ Client/install --localport 5432 --appendserver --revserver 192.168.11.64,192.168.11.71

hdiutil detach /Volumes/Syn-Apps\ Revolution\ Desktop\ Notification\ Client