Software Installation Guide¶
We recommend that you use one of our Custom-built-for-you Batch files or Powershell files that you will find on your Software and deployment builds page or follow one of our RMM deployment guides. But if you need to build a custom installation we have included this page for reference.
The software is packaged as an MSI which you build on the custom builds page. It supports all the typical command line options of an MSI for example:
Using Command line Arguments¶
The following command would install the software with minimal user interface visible to the user and no cancel button and then reboot the computer.
msiexec /i buttonInst.msi /passive
The following would install the software with no user interface and would not reboot the computer.
msiexec /i buttonInst.msi /quiet /norestart
We have some command line options that would allow you to customize settings specific to our software. If you install the software the GUI way, but just running it with no options you will see that we offer the ability to bind the software to a F-Key so that pressing that key launches the app. We also have command line options to allow the same. If you wanted to bind the program to F4, for example, you would use use the following command line param.
You can also customize the name of the desktop icon. By default, it is named “Helpdesk Button” but if you wanted to have the icon named “PC Solutions Support”, this would get you there.
WRAPPED_ARGUMENTS="/iconname=""PC Solutions Support"""
Putting those things together, you would end up with a command like this:
msiexec /i "buttonInst.msi" WRAPPED_ARGUMENTS="/launchkey=4 /iconname=""PC Solutions Support"""
Note to powershell users: powershell requires an extra single quote around the WRAPPED_ARGUMENTS value. So the powershell equivalent command looks like this:
msiexec /i "buttonInst.msi" WRAPPED_ARGUMENTS='"/launchkey=4 /iconname=""PC Solutions Support"""'
Make sure you are aware that this reboots the computer! Don’t push out that command en mass during business hours. A better option during business hours is as follows.
msiexec /i "buttonInst.msi" /norestart WRAPPED_ARGUMENTS="/launchkey=4 /iconname=""PC Solutions Support"""
You would still need to reboot after hours though, the software does actually need a reboot most of the time.
Without Command line Arguments¶
If installing the software by starting the MSI without any command line options you will get a default shortcut name: “Helpdesk Button” and the MSI will allow you to select the launch key. You can use our Tier2Scripts system to change this icon on install by using the script listed here.
Via the backend¶
To make this process a bit simpler we have added the ability to uninstall endpoints remotely this feature will only work on endpoints with version 0.6.x or newer.
Select the endpoint(s) you wish to remove, select Remove Endpoints and click Apply.
The next popup confirms the remove and gives the option to run the uninstall command on the endpoints chosen.
Since the package is an MSI, you can use WMI to uninstall it. Here is an example command to uninstall it silently:
wmic product where (name="Helpdesk Button") call uninstall /nointeractive
NOTE: if you get back “ReturnValue = 1603;” from this command, then the removal failed because you are not in an elevated command prompt.
There is a checkbox on the Device Management page that will filter the list of endpoints for duplicate hostnames. For the most part it is rare for a duplicate to appear, but fully uninstalling and reinstalling the software will create a duplicate endpoint. Replacing the hard drive or the motherboard in a PC running the software will also create a duplicate. Upgrading the software will not.