# Troubleshooting SharePoint Document Converter issues

SharePoint is a brilliant platform, but it can be a bit difficult to troubleshoot, especially if at some stage customisations have been made (e.g. installation of locally developed or 3rd party software).

The [Muhimbi Document Converter for SharePoint](https://www.nutrient.io/low-code) has been deployed successfully on thousands of servers, however from time to time we get support calls informing us that the deployment of our software has " _brought down the entire farm!_" Our support staff know that our software is rarely (never say never) the cause of any problems, but the deployment of any WSP file, including ours, can have unexpected side effects. (WSP Files are software installation packages used by most SharePoint products).

In case of problems with the SharePoint farm in general, please check the following. If you are experiencing problems with the Document Converter itself then see [these KB Articles](https://www.muhimbi.com/troubleshooting/).

1. **"Service Unavailable":** During a WSP deployment SharePoint recycles the Application Pools used by the affected Web Applications. Although rare, the Application Pool doesn't always spin up correctly.  To solve this, open the _Internet Information Service (IIS) Service Manager_, navigate to _Application Pools_ and verify they have been started.

2. **WSP is stuck on 'Deploying':** See [this KB Article](/guides/document-converter/sharepoint/troubleshooting/pdf-converter-front-end-wsp-is-stuck-on-deploying.md).

3. **Almost any other error:** The Document Converter for SharePoint deploys a number of files to the 'SharePoint Hive' _(%commonprogramfiles%\Microsoft Shared\Web Server Extensions\12_ (or _14_, _15_). These changes are deployed to the recommended locations and will not overwrite or modify any existing entries (unless someone else calls their software the _Muhimbi.PDFConverter_, unlikely at best). By default a single line is written to each Web Application's web.config file as well. All these changes are made using the deployment mechanism provided by SharePoint and in-line with best practices.

   From time to time we witness problems, especially when SharePoint writes out our change to the web.config file. Based on our experience the most common reason for this going wrong is that previously installed 3rd party applications (or locally developed ones) also registered web.config changes and did not clean up the 'config store' during un-installation (Microsoft's Reporting Service's SharePoint Integration is a common example). Even though web.config changes may have temporarily disappeared, SharePoint will flush them back to the web.config file during a future deployment (e.g. the WSP file that comes with the Document Converter for SharePoint)

   To see what changes have been applied to your web.config during deployment, please use a 'diff tool' ( [this one](https://www.sourcegear.com/diffmerge/) is excellent and free) and compare the current web.config in the problematic Web Application with the backup web.config (The Muhimbi Document Converter creates a backup of the web.config and adds the current date / time to the file name).

When, after checking the above, you are still experiencing problems with your SharePoint farm then please [contact us](https://www.nutrient.io/company/contact). Please read [Help us Help you](/guides/document-converter/power-automate/knowledge-base/tips-for-technical-support-requests.md) first.

---

## Related pages

- [How to check if a SharePoint server runs workflows](/guides/document-converter/sharepoint/troubleshooting/determining-if-a-server-is-involved-in-executing-workflows.md)
- [Converting HTML - Empty page / Authentication problems](/guides/document-converter/sharepoint/troubleshooting/converting-html-web-pages-returns-an-empty-pdf.md)
- [CabLib Extract ERROR when converting InfoPath files](/guides/document-converter/sharepoint/troubleshooting/cablib-extract-error-when-converting-infopath-files.md)
- [Debugging Web Service calls and Soap Messages](/guides/document-converter/sharepoint/troubleshooting/debugging-web-service-calls-and-soap-messages.md)
- [How to Disable Incremental Updates When Watermarking?](/guides/document-converter/sharepoint/troubleshooting/disable-incremental-update-when-watermarking.md)
- [Enable Custom App Authentication](/guides/document-converter/sharepoint/troubleshooting/enable-custom-app-authentication.md)
- [Converting IRM and DRM protected documents seamlessly](/guides/document-converter/sharepoint/troubleshooting/dealing-with-the-conversion-of-irm-drm-rms-aip-protected-documents.md)
- [Differences between SharePoint Online and on-premises Document Converter](/guides/document-converter/sharepoint/troubleshooting/how-does-the-pdf-converter-for-sharepoint-online-differ-from-the-on-premise-product.md)
- [Troubleshooting: SharePoint Document Converter](/guides/document-converter/sharepoint/troubleshooting.md)
- [How do I manually remove the Conversion Service?](/guides/document-converter/sharepoint/troubleshooting/how-do-i-manually-remove-the-conversion-service.md)
- [Troubleshoot PDF merging issues and solutions](/guides/document-converter/sharepoint/troubleshooting/error-while-merging-existing-pdf-files-e-g-pdflexer-errors.md)
- [Adjusting document file size limits easily](/guides/document-converter/sharepoint/troubleshooting/how-can-i-change-the-maximum-file-size-of-documents-to-process.md)
- [How do I enable debug logging?](/guides/document-converter/sharepoint/troubleshooting/how-do-i-enable-debug-logging.md)
- [Understanding InfoPath document conversion processes](/guides/document-converter/sharepoint/troubleshooting/infopath-rules-custom-code-data-connections-are-not-executed.md)
- [Troubleshooting InfoPath view-related errors](/guides/document-converter/sharepoint/troubleshooting/infopath-cannot-execute-any-view-related-object-model-calls-the-view-is-not-ready.md)
- [Check your Document Converter version easily](/guides/document-converter/sharepoint/troubleshooting/how-to-determine-which-version-of-the-pdf-converter-is-installed.md)
- [Troubleshooting error 1001 in SharePoint upgrades](/guides/document-converter/sharepoint/troubleshooting/error-1001-an-exception-occurred-in-the-onafterinstall-event-handler-during-upgrade.md)
- [Troubleshooting InfoPath form conversion issues](/guides/document-converter/sharepoint/troubleshooting/my-infopath-form-fails-to-convert-how-can-i-troubleshoot-this.md)
- [Invalid digital signature during installation](/guides/document-converter/sharepoint/troubleshooting/invalid-digital-signature-during-installation.md)
- [Document Converter front-end WSP is stuck on 'Deploying](/guides/document-converter/sharepoint/troubleshooting/pdf-converter-front-end-wsp-is-stuck-on-deploying.md)
- [Fixing SharePoint search for HTML-to-PDF conversion](/guides/document-converter/sharepoint/troubleshooting/sharepoint-search-does-not-return-converted-html-content.md)
- [Troubleshooting Document Converter login issues](/guides/document-converter/sharepoint/troubleshooting/problems-logging-in-to-pdf-converter-services-online.md)
- [Troubleshooting PDF workflow issues in SharePoint](/guides/document-converter/sharepoint/troubleshooting/pdf-workflow-activities-are-not-displayed-in-sharepoint-designer-2013.md)
- [Troubleshoot SharePoint Designer workflow issues](/guides/document-converter/sharepoint/troubleshooting/sharepoint-designer-workflow-activities-are-not-inserted.md)
- [Solving formatting issues when converting HTML to PDF](/guides/document-converter/sharepoint/troubleshooting/solving-formatting-issues-when-converting-html-to-pdf.md)
- [Troubleshoot evaluation message in SharePoint](/guides/document-converter/sharepoint/troubleshooting/the-license-has-been-installed-but-an-evaluation-message-is-still-displayed.md)
- [Troubleshooting SharePoint Online menu visibility issues](/guides/document-converter/sharepoint/troubleshooting/some-menu-options-are-not-displayed-in-sharepoint-online.md)
- [The Conversion Service does not start](/guides/document-converter/sharepoint/troubleshooting/the-conversion-service-does-not-start.md)
- [Troubleshooting install.cmd errors](/guides/document-converter/sharepoint/troubleshooting/troubleshooting-install-cmd-errors.md)
- [Troubleshooting SharePoint document converter issues](/guides/document-converter/sharepoint/troubleshooting/troubleshooting-connectivity-problems-between-web-front-end-and-conversion-servers.md)
- [Convert InfoPath forms to Word and Excel easily](/guides/document-converter/sharepoint/troubleshooting/when-converting-infopath-to-word-excel-my-file-does-not-look-100-the-same.md)
- [Troubleshooting document converter issues on SharePoint](/guides/document-converter/sharepoint/troubleshooting/troubleshooting-the-pdf-converter-for-sharepoint-online.md)
- [Where can I enable Web Application Scoped SharePoint Features?](/guides/document-converter/sharepoint/troubleshooting/where-can-i-enable-web-application-scoped-sharepoint-features.md)
- [Using the diagnostics tool to troubleshoot conversions](/guides/document-converter/sharepoint/troubleshooting/using-the-diagnostics-tool-to-troubleshoot-conversions.md)
- [Watermarker fails to load because Microsoft now enforces Content Security Policy (CSP)](/guides/document-converter/sharepoint/troubleshooting/watermarker-blocked-by-microsoft-csp.md)
- [Validating converters and troubleshooting errors](/guides/document-converter/sharepoint/troubleshooting/validating-converters-and-troubleshooting-errors.md)
- [Tips for pixel-perfect InfoPath-to-PDF conversion](/guides/document-converter/sharepoint/troubleshooting/when-converting-infopath-to-pdf-my-file-does-not-look-100-the-same.md)
- [Why are my watermarks not visible?](/guides/document-converter/sharepoint/troubleshooting/why-are-my-watermarks-not-visible.md)
- [Understanding duplicate PDF conversion options in SharePoint](/guides/document-converter/sharepoint/troubleshooting/why-are-the-various-pdf-conversion-options-displayed-twice-in-sharepoint.md)
- [Find the Document Converter administration screen](/guides/document-converter/sharepoint/troubleshooting/where-is-the-pdf-converter-s-central-administration-screen-located.md)
- [Why are my legacy DOC and XLS files failing to convert?](/guides/document-converter/sharepoint/troubleshooting/why-are-my-legacy-doc-and-xls-files-failing-to-convert.md)