MainBoss, Version 4.2.4:
Updating an Existing ClickOnce Installation

ClickOnce is simple to use but complicated to set up.
It requires an IT department with a high degree of technical sophistication.

Microsoft provides a good deal of information about ClickOnce at https://docs.microsoft.com/en-us/previous-versions/visualstudio/visual-studio-2008/wh45kb66(v=vs.90).

The web page you are reading now is for people who have installed an earlier version of ClickOnce MainBoss. If you are installing ClickOnce MainBoss for the first time, click here for instructions.

Introductory Notes

ClickOnce users go to a web page to access ClickOnce. Typically, you will have a customized web page for this purpose. You may be able to re-use your existing web page with this new version of ClickOnce.

If you don't remember where your ClickOnce directory is: Start your IIS manager (by running inetmgr using "Run" in the Windows Start Menu). In the left hand panel, keep expanding entries until you find the one for the web site that your ClickOnce uses. Right-click on the entry for that site and click either "Explore" or "Properties" (different versions of IIS manager have different menu entries). The resulting information will tell you where your current ClickOnce directory is.

Installing the new ClickOnce software:

  1. Move the contents of your existing ClickOnce directory to some (temporary) holding directory.
  2. to obtain a ZIP file named Install.MainBoss.ClickOnce.4.2.4.20.zip containing the files you need for ClickOnce deployment.
  3. Extract the contents of the ZIP file into your existing MainBoss ClickOnce directory.
  4. Copy your old web page file (typically an HTML file) from the holding directory back to the ClickOnce directory.

Once you are satisfied that ClickOnce is working, you can delete the holding directory that contains your old ClickOnce files.

Prerequisite Software

In order to run MainBoss using ClickOnce, the user's system must have .NET Framework 4.6.2 or newer.

If you attempt to run MainBoss through the ClickOnce web page without .NET Framework 4.6.2, you will see the message "System update required". Note that all versions of Windows that are up to date from Windows 7 onwards will have .NET 4.6.2 installed so it is unlikely you will need to do anything.

Browser: In order to use ClickOnce, users must connect to your ClickOnce web page using Internet Explorer, or else they must download an appropriate plug-in (e.g. for Firefox or for Google Chrome). There are other extensions for ClickOnce for Chrome in the Chrome Web Store.

Caveats about ClickOnce

If several people use ClickOnce to run MainBoss on the same computer, the MainBoss software will be installed once for each such user. For example, if three people use the same computer at different times and all of them run MainBoss, the MainBoss software will be installed separately for each person.

People who invoke MainBoss through ClickOnce will not be able to specify command line arguments to the MainBoss software. They will also not be able to run the MBUtility program.

Changing the ClickOnce Location

When installing a new version of ClickOnce, you may decide that it's a good time to change the software's location. If so, make sure you tell your users to start ClickOnce at least once through the web page rather than just using the entries in their Start menus.

Why? Because if users start ClickOnce through their Start menus, Windows looks for the software in the known location. If the software can't be found (because it's been moved), Windows just uses the local version of MainBoss without issuing a message. This local version will be the old version of MainBoss, and will continue to be the old one until the user, at least once, executes the software through the web page and obtains the new software.

Note that this is only a problem if you move the software location. If you install a new version of MainBoss in the same location as the old one, Windows will look at that location, see that there's a new version, and install it on the user's computer.

Launching ClickOnce MainBoss without a Browser

You can launch a ClickOnce version of MainBoss without using a browser by using the following command line:

C:\Windows\System32\rundll32.exe dfshim ShOpenVerbApplication URL

where URL is the URL of the file that contains the application you want to run. For example, you might have something like this:

C:\Windows\System32\rundll32.exe dfshim ShOpenVerbApplication http://ourcompany.com/mainboss/mainboss.application

You can use this command line in a command prompt window or in the command line associated with a shortcut icon.