# Installation and Upgrade

*Applies to: Patch My PC Publisher*

## Overview

This section provides guidance for troubleshooting issues that may occur during installation or upgrade of the Publisher. It covers common scenarios related to missing prerequisites, unavailable installation sources, and environment configuration problems.

The topics in this section focus on identifying and resolving issues such as missing MSI files, Windows Installer errors, and missing components including the WSUS API and Configuration Manager SDK. These troubleshooting steps help ensure a successful installation or upgrade of the Publisher.

## The Publisher Fails to Upgrade

At the end of a [sync](https://docs.patchmypc.com/patch-my-pc-publisher/administration/sync-schedule), if a new version of the Publisher is available, the Publisher attempts to install the update by default. When this occurs, the following entry appears in the PatchMyPC.log file at the end of the sync.

```
Starting self-update, the command line is: MsiExec.exe /i C:\WINDOWS\TEMP\PatchMyPC-Publishing-Service.msi /qn /log C:\WINDOWS\TEMP\PatchMyPC-Publishing-Service_Upgrade.log
```

<figure><img src="https://3773699522-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MX7dvS0r_4fc0AikgJS%2Fuploads%2FIRWcnkUeWKvlTNKRrSiZ%2Fimage.png?alt=media&#x26;token=78ab7177-5313-458f-b8a4-9ba444e69e04" alt="" width="563"><figcaption></figcaption></figure>

{% hint style="info" %}
**Note**

If you see errors such as "*An error occurred with the SignalR connection*" logged around the time illustrated above, this is normal while some services stop and start again during the update process.
{% endhint %}

If a failure occurs during the self update process and [Alerts](https://docs.patchmypc.com/patch-my-pc-publisher/administration/alerts) are configured, a notification is generated. The notification will appear similar to the screenshots shown below

<figure><img src="https://3773699522-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MX7dvS0r_4fc0AikgJS%2Fuploads%2FsOY67HWBwOxbfUHm0gMB%2Fimage.png?alt=media&#x26;token=93ad31d1-1b97-4668-be80-ca5065fab79f" alt="" width="563"><figcaption></figcaption></figure>

<figure><img src="https://3773699522-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MX7dvS0r_4fc0AikgJS%2Fuploads%2FLrQCd7sDWeAowwmjmWxy%2Fimage.png?alt=media&#x26;token=135a9d47-443c-4f59-b21c-d810290ab6ee" alt="" width="500"><figcaption></figcaption></figure>

To understand the root cause of the upgrade failure, it is recommended to inspect the log file indicated in PatchMyPC.log produced by the .msi installer:&#x20;

* **C:\WINDOWS\TEMP\PatchMyPC-Publishing-Service\_Upgrade.log**

See [Error 1714](#error-1714.-the-older-version-of-patch-my-pc-publishing-service-cannot-be-removed.-contact-your-tech) for more detail on the common causes for upgrade failures.

### Error 1714/1612 - The older version of Patch My PC Publishing Service cannot be removed

When searching up for the value `return value 3` from the bottom of the **PatchMyPC-Publishing-Service\_Upgrade.log** log file, you might see log lines similar to the following:

```
Action start 05:37:07: RemoveExistingProducts.
CustomAction  returned actual error code 1612 (note this may not be 100% accurate if translation happened inside sandbox)
MSI (s) (80:D4) [05:37:07:238]: Product: Patch My PC Publishing Service -- Error 1714. The older version of Patch My PC Publishing Service cannot be removed.  Contact your technical support group.  System Error 1612.
Error 1714. The older version of Patch My PC Publishing Service cannot be removed.  Contact your technical support group.  System Error 1612.
```

When you attempt to manually install the update by downloading and running the [latest .msi](https://patchmypc.com/msi), you receive a dialogue similar to the below:

<figure><img src="https://3773699522-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MX7dvS0r_4fc0AikgJS%2Fuploads%2FqutCmTGwX9HE2Bn5j4EH%2Fimage.png?alt=media&#x26;token=2565d845-d207-4368-bb60-5e03872989d4" alt="" width="371"><figcaption></figcaption></figure>

The 1612 error code is usually thrown when the original installation media for the currently installed application is no longer available on the system - something has deleted it. Typically, .msi software caches itself to **C:\Windows\installer** and the original .msi file is critical for any application update, repair, or uninstall.

The Windows Installer service first looks the .msi of the currently installed version in **C:\Windows\installer** and also its last known install location - the self-updater is downloaded and launched from **C:\Windows\temp**.

{% hint style="success" %}
**Tip**

You can read more about system error code 1612 in the following knowledge base article: [System Error 1612 – The installation source for this product is not available.](https://patchmypc.com/kb/system-error-1612-installation-source/)
{% endhint %}

If you encounter this issue, you can resolve it by recaching the missing .msi file:

1. Download the .msi file for the current version you have installed
2. Recache the .msi file using the below command:

```
msiexec /fvomus "C:\path\to\PatchMyPC-Publishing-Service.msi" /qn
```

3. Attempt the update again and it should now be successful

We do not currently publicly host the installers for older versions of the Publisher, so it is advised to open a [technical support case](https://patchmypc.com/technical-support/) requesting a copy for the version you need.

After resolving the issue, it is strongly recommend you investigate any clean up scripts or other automations which may be deleting files from **C:\Windows\installer** to prevent the issue from happening again.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.patchmypc.com/patch-my-pc-publisher/troubleshooting/installation-and-upgrade.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
