How to Make Configuration Changes to Q-Pulse Using ClickOnce

  Who is this article for?  

  IT personnel responsible for deploying Q-Pulse.

 IT access will be required to implement this update.

ClickOnce is a deployment technology that enables you to create self-updating Windows-based applications that can be installed and run with minimal user interaction. This is used for Q-Pulse to ensure all your users applications remain up to date without any inconvenience to the end user.

This article outlines how to make configuration changes when the client has been deployed using ClickOnce. To make this easier to follow the article is split into the following sections:

1. Making the Configuration Change
2. Update the File Manifest
3. Update the .application
4. Further Reading

Looking to configure Q-Pulse via ClickOnce for the first time? Visit How to Install the Q-Pulse Client Using ClickOnce for details.

1. How to Make Configuration Changes

1. Browse to our publishing directory.
2. Open the ClientFiles folder.
3. Apply any configuration changes required.
4. Save the Q-Pulse.exe.config

2. Update the File Manifest

1. Browse to the Tools folder and launch MageUI.exe.
2. Click File, then Open and then select the manifest file contained in the ClientFiles folder.
3. When the file opens, increment the last digit on the version field.
4. On the navigation pane at the left, select [Files].
5. Confirm that the folder structure shown is the correct path to your ClientFiles folder, then click [Populate]

6. Once the files have populated, browse the file list for Thumbs.db.  If found, make this file optional as it is a hidden file created by Microsoft Windows and is not needed for the installation.

7. Click File, then Save.
8. Select your Personal Information Exchange (PFX) certificate file and enter the correct password for the file.
9. Click OK.

3. Update the .application File

The .application file is the file that will identify if there is an updated package available for use, therefore it is important to update this otherwise a deployment will not take place.

This file will hold:

• The minimum version of Q-Pulse required for the client to run.
• The location of the Q-Pulse File Manifest.

To configure the .application:

1. Open MageUI.
2. Click File, then Open and then select the Q-Pulse.application file contained in the ClickOnceManual folder.
3. When the file opens, confirm that the correct version of Q-Pulse is displayed.  

Note: This should match the version shown in the Q-Pulse.manifest file.

1. On the navigation pane at the left hand side, click Deployment Options.
2. Update the Start location field with the shared path to your Q-Pulse.application file.

3. Click Update Options and ensure that Specify a minimum version for this application has been selected.
4. Increment the last digit of the version number.

5. Click Application Reference and then click Select Manifest.
6. Browse to the ClientFiles folder and select the Q-Pulse.manifest file.