Who is this article for?

Administrators or IT Members supporting upgrades.

No elevated permissions are required.

Utilising ClickOnce as a deployment technology offers a seamless solution for creating self-updating Windows-based applications with minimal user intervention. This approach is particularly beneficial for Ideagen Quality Management, ensuring that all user applications stay current without causing inconvenience. In this article, we delve into the process of applying an Ideagen Quality Management update through ClickOnce deployment. The discussion is structured into four sections for clarity and ease of understanding.

1. How to Change the Ideagen Quality Management Files
   1. To prepare for configuration
   2. To configure the client installation files
2. How to Update the File Manifest 
   1. To populate the manifest
3. How to Update the .application
   1. To configure the .application
4. Further Reading

Looking to setup ClickOnce for the first time? Visit How to Install the Ideagen Quality Management Client Using ClickOnce.

1. How to Change the Ideagen Quality Management Files

1.1 To prepare for configuration

1. Browse to the ClickOnceManual folder that is shared on your network
2. Delete the ClientFiles folder.
3. Copy the ClientFiles folder from the Ideagen Quality Management installation files and place it into the ClickOnceManual folder.

Once completed, you are now ready to configure the client files to connect to your Ideagen Quality Management application server.

1.2 To configure the client installation files

1. Browse to our publishing directory.
2. Open the ClientFiles folder.
3. Open the Q-Pulse.exe.config file with Notepad.
4. Amend all references to 'SERVERNAME' to the IP address of your Ideagen Quality Management application server.
5. Save the Q-Pulse.exe.config.

2. How to Update the File Manifest

2.1 To populate the 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, confirm that the correct version of Ideagen Quality Management is displayed.
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. How to Update the .application

• The minimum version of Ideagen Quality Management required for the client to run.
• The location of the Ideagen Quality Management File Manifest.

3.1 To configure the .application

1. Replace the Ideagen Quality Management.application in your publishing directory with the Ideagen Quality Management.application file from the Ideagen Quality Management installation files.
2. In MageUI, Click File, then Open and then select the Ideagen Quality Management.application file contained in the ClickOnceManual folder.
3. When the file opens, confirm that the correct version of Ideagen Quality Management is displayed.  

Note: This should match the version shown in the Ideagen Quality Management Manifest file.

4. On the navigation pane at the left hand side, click Deployment Options.
5. Update the Start location field with the shared path to your Ideagen Quality Management.application file.

6. Click Update Options and ensure that the Specify a minimum version for this application checkbox has been selected.

Important: The minimum required version must be correctly configured otherwise future updates will fail to deploy.

7. Click Application Reference and then click Select Manifest button.
8. Browse to the ClientFiles folder and select the Ideagen Quality Management.manifest file.