PDF Converter - Installation & Administration Guide
PDF Converter - Installation & Administration Guide - Version 8.0 - 15/10/15 
© Copyright 2015, Muhimbi Ltd 
Page 41 of 84 
2. 
Settings stored in SharePoint: During the day to day operation of the 
software all settings are stored inside SharePoint. These settings are 
maintained during the upgrade process and do not need to be re-applied. 
3. 
Status of SharePoint Features: SharePoint remembers correctly which 
SharePoint Features are enabled on a site collection. However, during the 
upgrade it does not remember the status of Web Application scoped 
Features. After upgrading the front end the default Features will be 
enabled automatically by the product’s installation process. However, any 
Features that were previously manually enabled, e.g. integration with 
Nintex Workflow, will need to be re-enabled. For an overview of which 
Features ship with the product, and their scope, see 2.5.3 SharePoint 
Feature Activation / Deactivation. 
4. 
Nintex Workflow integration: Due to the fact that Nintex Workflow 
caches some details, please carry out an iisreset on all front end servers 
after uninstalling the Muhimbi front end as part of the upgrade process. 
5. 
K2 blackpearl integration: When using the PDF Converter in 
combination with blackpearl, please follow the K2 specific upgrade 
instructions in Appendix – Deploying K2 Integration facilities
Aside from the points and actions described above, the upgrade process is as 
follows: 
1. 
Uninstall the software as described in 2.7 Un-installation
2. 
Install the new version as described in 2.4 Installation steps
3. 
Make any of the post installation changes described in the introduction of 
this section, e.g. enable the various Web Application scoped SharePoint 
Features. 
Enable thumbnail preview for pdf files - Draw thumbnail images for PDF in C#.net, ASP.NET, MVC, Ajax, WinForms, WPF
Support Thumbnail Generation with Various Options for Quick PDF Navigation
cannot view pdf thumbnails in; pdf thumbnails in
Enable thumbnail preview for pdf files - VB.NET PDF Thumbnail Create SDK: Draw thumbnail images for PDF in vb.net, ASP.NET, MVC, Ajax, WinForms, WPF
Support Thumbnail Generation with Various Options for Quick PDF Navigation
show pdf thumbnail in html; show pdf thumbnail in
PDF Converter - Installation & Administration Guide
PDF Converter - Installation & Administration Guide - Version 8.0 - 15/10/15 
© Copyright 2015, Muhimbi Ltd 
Page 42 of 84 
3 Troubleshooting & Other common tasks 
This section provides some guidance related to troubleshooting problems. 
If you still have questions after reading this chapter then please visit or 
support desk at support.muhimbi.com or contact our support team at 
support@muhimbi.com. 
3.1 Windows Event Log 
Unless you have decided to disable certain logging levels in Central 
Administration > Operations > Logging and Reporting > Diagnostic logging, 
(Monitoring > Configure Diagnostic Logging in SP 2010 / 2013) the following 
entries may be written to the event log: 
1. 
Warnings: If you are running an evaluation copy of the software, or your 
license has expired then this is reported as a warning message in the 
Application Event Log.  
2. 
Errors: Although the software makes an attempt to catch any error, and 
present the user with a friendly message, the actual errors are still written 
to the event log. Errors are usually caused by corrupt documents or a Site 
Collection running out of space. 
Note that all event entries written by Muhimbi’s products use the Windows 
SharePoint Services 3 Event Source (SharePoint Foundation event source in 
SharePoint 2010 / 2013) and can be filtered down by Event ID, which is 
always 41734. 
3.2 SharePoint Trace Log 
Unless you have decided to disable certain logging levels in Central 
Administration > Operations > Logging and Reporting > Diagnostic logging 
(Monitoring > Configure Diagnostic Logging in SP 2010 / 2013), the following 
entries may be written to the SharePoint trace log: 
1. 
All Warnings and errors that are written to the Windows Event Log are 
also written to the SharePoint Trace log. 
2. 
An entry is written whenever the software is installed or uninstalled. 
3. 
An entry is written whenever the PDF Converter feature is activated. 
4. 
An entry is written whenever a document is converted. This entry contains 
the location of both the source and the destination files. 
5. 
An entry is written whenever a document is skipped because its file format 
is not supported. 
Note that the location of the log files is defined in the Diagnostic Logging 
screen in Central Administration. 
DocImage SDK for .NET: Document Imaging Features
Flexible document file navigation with thumbnail preview support High TIFF and Dicom, to TIFF and PDF file formats PNG, JPEG, BMP, and GIF Enable to render and
how to make a thumbnail of a pdf; how to view pdf thumbnails in
C# TIFF: TIFF Editor SDK to Read & Manipulate TIFF File Using C#.
Easy to generate image thumbnail or preview for Tiff Enable to add XImage.OCR for .NET into C# Tiff imaging application for characters recognition and
pdf thumbnail generator; pdf first page thumbnail
PDF Converter - Installation & Administration Guide
PDF Converter - Installation & Administration Guide - Version 8.0 - 15/10/15 
© Copyright 2015, Muhimbi Ltd 
Page 43 of 84 
3.3 Document Converter Trace Log 
The Document Converter Service maintains a detailed trace log named 
DocumentConverter.log in the directory the service has been installed in. 
For details on how to change the log settings see section 2.6.2 Fine-tuning the 
Document Conversion service. 
3.4 SharePoint audit log 
Providing SharePoint Auditing is enabled, specifically the Copy and View audit 
types, then an entry is written for each converted document. 
The entry is written to the audit log for the Site Collection the source file 
belongs to. The following XML is added to each audit entry: 
<DocumentConversion> 
<Source> 
<Version><Major>{0}</Major><Minor>{1}</Minor></Version>  
</Source> 
<Destination> 
<Url>{2}</Url> 
<Version><Major>{3}</Major><Minor>{4}</Minor></Version> 
</Destination> 
</DocumentConversion> 
Where  
1. 
0 and 1 are the version number of the source document,  
2. 
2 is the URL to the converted PDF file 
3. 
3 and 4 are the version number of the destination document. 
We recommend using a tool such as the Idera SharePoint audit to view the 
audit logs, see http://www.idera.com/Products/SharePoint/SharePoint-audit/
.  
3.5 Common issues & Errors 
3.5.1 Your account is not allowed to deploy SharePoint Solutions 
Before attempting to deploy the solution, please make sure your account is a 
Farm Administrator and your account has db_owner rights on the Admin 
content database. This is a common requirement for being able to deploy 
SharePoint Solutions and is not specific to Muhimbi’s products. 
3.5.2 Errors on newly added servers 
The software may not work on any new servers that have been added to the 
SharePoint farm after the initial deployment of the PDF Converter. 
This is a known issue with SharePoint. For details see section 3.5.4. 
C# Word - Paragraph Processing in C#.NET
C#.NET Word document paragraph processing Interface control (XDoc.Word).//More TODO is a tool which enable users to process paragraph on a new document by
disable pdf thumbnails; create thumbnail jpeg from pdf
C# Excel - Excel Page Processing Overview
Merging or splitting Excel files will not be difficult with this Excel SDK. Enable you to merge two or more Excel documents to form a combined one in C#.NET
create pdf thumbnails; can't see pdf thumbnails
PDF Converter - Installation & Administration Guide
PDF Converter - Installation & Administration Guide - Version 8.0 - 15/10/15 
© Copyright 2015, Muhimbi Ltd 
Page 44 of 84 
3.5.3 An evaluation message is displayed in the UI and converted documents 
When an evaluation message is displayed on each screen and in each 
converted document then something may be wrong with your license. This 
may be caused by: 
1. 
No license is present at all.  
Solution: Buy a license at www.muhimbi.com  
2. 
Your support license has expired and you have installed a copy of the 
software that was released after the support license expiration date. 
Solution: Renew your license or install a copy of the software that was 
released while your license was valid. 
3. 
Your (temporary) software license has expired. If you have placed your 
order via the Purchase Order payment type then you may have been 
issued with a temporary license while we wait for the invoice to be paid. 
Solution: Please check with your billing department to see if your invoice 
has been paid and download your full license from the My Account area 
on the Muhimbi Website. 
4. 
The installed license is for a different Muhimbi Product. 
Solution: Please check the installed license is for the correct product. 
5. 
The contents of the license file have been tempered with, either manually 
or because it has been opened in an application that modifies the content. 
Solution: Please download the license again from the My Account area on 
the Muhimbi Website. 
6. 
The evaluation message has been removed from the user interface but is 
still present in the converted documents.  
Solution: The license has not been installed properly in the Document 
Conversion Service¶s directory. For details see section 2.5.2 Installing the 
License. 
For additional details see Appendix - Licensing  and section 2.5.2 Installing 
the License as well as this Knowledge Base article.
C# Word - Word Conversion in C#.NET
In addition to Conversion of Word to PDF, RasterEdge XDoc.Word conversion control enable users to convert PDF to Word with C# sample code.
can't view pdf thumbnails; view pdf thumbnails
PDF Converter - Installation & Administration Guide
PDF Converter - Installation & Administration Guide - Version 8.0 - 15/10/15 
© Copyright 2015, Muhimbi Ltd 
Page 45 of 84 
3.5.4 ‘Unknown Error’ or ‘resource object not found’ 
If you receive an ‘Unknown Error’, or the equivalent in your local language, 
then there may have been a problem with the distribution of your language 
specific resource files.  
This error is not logged to the event log as this is a SharePoint error, which is 
triggered before our software is started. To get more detail about the error, 
temporarily change the ‘CallStack’ attribute in the ‘SafeMode’ element in the 
web.config to ‘True’. 
If a message similar to the following is displayed after refreshing the page 
then you need to force SharePoint to redistribute the resource files. 
This can be done by issuing the following command
7
on each server exhibiting 
the problem: 
stsadm -o copyappbincontent 
7
STSADM is located at %CommonProgramFiles%\Microsoft Shared\Web Server Extensions\12\BIN (or 
..14\BIN in SP2010, ..15\BIN in SP2013) 
PDF Converter - Installation & Administration Guide
PDF Converter - Installation & Administration Guide - Version 8.0 - 15/10/15 
© Copyright 2015, Muhimbi Ltd 
Page 46 of 84 
In some cases running the command mentioned previously does not resolve 
the problem. As a last resort copy the resource files manually on all Web Front 
End Servers from  
C:\Program Files\Common Files\Microsoft Shared\Web Server 
Extensions\12\CONFIG\Resources\MuhimbiPDFConverter.* 
to 
C:\inetpub\wwwroot\wss\VirtualDirectories\<webapplication>\App_Glo
balResources 
3.5.5 Documents using non standard fonts (e.g. Japanese) are not converted 
properly / The fonts in the destination document are not correct 
If the fonts in the converted document are not displayed properly then please 
make sure that the correct fonts are installed on the server hosting the 
Document Conversion Service, restart the server after installing new fonts.. 
For example, if Japanese characters are not displayed properly then make 
sure the Japanese language pack for Windows Server is installed. 
If a font cannot be found then the system will attempt to find an alternative, but 
similar, font. If an alternative cannot be found then the system will use the 
Times New Roman font. 
When using the optional PDF/A post processing facility then all used fonts are 
automatically embedded in the PDF document. If fonts are deployed to the 
server after Ghostscript was installed then please execute the following 
command from the Ghostscript bin directory. 
gswin32c -q -dBATCH -sFONTDIR=c:/windows/fonts -
sCIDFMAP=../lib/cidfmap ../lib/mkcidfm.ps 
Please replace gswin32c with gswin64c when using the 64 bit version of 
Ghostscript. If the Windows directory is located elsewhere then change the 
sFONTDIR, please use forward slashes, not backslashes.  
For more details about how the optional Ghostscript installation is used for 
PDF/A post processing see Appendix – 
AutoCAD fonts can be placed in the SHXFonts folder under the Conversion 
Service’s installation folder. 
3.5.6 Error messages related to printer drivers or the printer spooler are 
logged 
The Excel and InfoPath converters require the Printer Spooler service to be 
started. The installer used by the Document Conversion Service attempts to 
start the Printer Spooler service automatically, but if the service is 
subsequently disabled then you may receive an error. 
These converters also require at least one printer driver to be installed. 
Although in general it doesn’t matter which driver is installed, some drivers 
such as VMWare’s Virtual Printer or the OneNote printer will cause problems. 
Windows Server 2003 R2 and Windows Server 2008 automatically install the 
XPS driver, it is recommended to make this the default printer.  
PDF Converter - Installation & Administration Guide
PDF Converter - Installation & Administration Guide - Version 8.0 - 15/10/15 
© Copyright 2015, Muhimbi Ltd 
Page 47 of 84 
3.5.7 Problems converting InfoPath forms without a shared XSN file 
If you intend to convert InfoPath forms that don’t rely on a shared XSN 
template stored on a file share or in SharePoint then the XSN file must be 
registered on the Document Conversion Server using RegForm.exe. 
The RegForm application can be found in 
C:\Program Files\Microsoft 
Office\Office12. For details see the second half of the following article: 
http://msdn.microsoft.com/en-us/library/bb251025.aspx
3.5.8 The ‘Convert to PDF’ context menu is displayed twice 
If a user interface element associated with the Muhimbi PDF Converter for 
SharePoint is displayed twice then this is most likely caused by both the Web 
Application and Site Collection versions of the same Feature being active at 
the same time. 
For full detail see section 2.5.3 SharePoint Feature Activation / Deactivation 
as well as this Knowledge Base article
, but as a general rule enable either the 
Web Application Level Feature or the Site Collection Level Feature. Don’t 
enable both. 
3.5.9 InfoPath forms using Ink controls fail to convert 
When using Ink Controls, for example to capture signatures on InfoPath 
forms, then please make sure the Ink controls are installed on the machine(s) 
that run the Muhimbi Conversion Service. For example, in Windows Server 
2008 these controls are installed as part of the “Ink & Handwriting features”, 
part of the “Desktop Experience” Windows Feature.  
3.5.10 Error 403 (Forbidden) when converting InfoPath forms 
When InfoPath conversion fails and the error message in the Windows 
Application Event Log refers to “The remote server returned an error: (403) 
Forbidden” then this may be caused by the authentication type specified on 
the Web Application. If, for example, Forms Based Authentication is enabled, 
but NTLM authentication is not configured on the same Web Application then 
the Muhimbi Conversion Service will not be able to download the XSN file.  
The problem can be solved by adding NTLM authentication to the Web 
Application. 
3.5.11 InfoPath files are converted using an old version of the XSN template 
Although rare, InfoPath sometimes re-uses an old XSN file when carrying out 
a conversion. Running the typical InfoPath /cache ClearAll command 
will not work as XSN files are stored in a different location when running as a 
service.  
Please clear all FormCache folders manually from the following location: 
PDF Converter - Installation & Administration Guide
PDF Converter - Installation & Administration Guide - Version 8.0 - 15/10/15 
© Copyright 2015, Muhimbi Ltd 
Page 48 of 84 
Windows Server 2008 and newer 
64bit: %windir%\SysWOW64\config\systemprofile\AppData\Local\Microsoft\InfoPath 
32bit: %windir%\System32\config\systemprofile\AppData\Local\Microsoft\InfoPath 
Windows Server 2003 
C:\Documents and Settings\Default User\Local Settings\Application  
Data\Microsoft\InfoPath 
3.5.12 Nintex Workflow Activities are not working as expected after upgrading 
If you encounter any Nintex Workflow related issues after upgrading to a new 
version of the Muhimbi PDF Converter for SharePoint then make sure the 
client side browser cache is cleared. If problems persist then uninstall the 
Muhimbi SharePoint front end, carry out an IISRESET on all front end servers 
and then install the Muhimbi SharePoint front end again. This is related to 
caching inside Nintex Workflow. 
3.5.13 Event Manager error after uninstallation 
When the Muhimbi PDF Converter for SharePoint is uninstalled from a 
SharePoint server, and a new version is not installed afterwards, then you 
may occasionally see the following message in the Windows Application 
Event log. 
Event manager error: Could not load file or assembly 'Muhimbi.SharePoint 
.DocumentConverter.PDF, Version=1.0.1.1, Culture=neutral, PublicKeyToken 
=c9db4759c9eaad12' or one of its dependencies. The system cannot find the 
file specified. 
This message will not cause any side effects and will only be logged after 
configuring the system to use the automatic watermarking facilities. Contact 
Muhimbi’s support desk for instructions on how to prevent this message from 
being logged. 
3.5.14 Files uploaded via Windows Explorer do not trigger ‘Insert’ watermarks 
When using the watermarking facilities to automatically apply a watermark 
when a new file is uploaded then the appropriate event is not triggered by 
SharePoint 2010 when uploading the file using Windows File Explorer. This is 
related to a bug in SharePoint, the Update event is triggered instead. 
As a workaround either make sure all files are uploaded using the web 
browser or apply watermarks to new files using a SharePoint Designer 
Workflow, Visual Studio Workflow or Nintex Workflow. 
PDF Converter - Installation & Administration Guide
PDF Converter - Installation & Administration Guide - Version 8.0 - 15/10/15 
© Copyright 2015, Muhimbi Ltd 
Page 49 of 84 
3.5.15 ‘Watermark on Open’ does not show watermarks 
If the Watermark on Open facility is used and watermarks do not show up 
when opening a PDF file then please check the following: 
1. 
If the PDF File was previously opened by a user before this facility was 
enabled, the browser may cache the previous version of the document. To 
solve this problem clear the browser cache. 
2. 
The Web Application scoped Feature named ‘Muhimbi PDF Converter - 
Automatic Watermarking Processor’ must be enabled. For details on the 
various SharePoint Features provided by the product see 2.5.3 SharePoint 
Feature Activation / Deactivation. 
For further details see this Knowledge Base article
3.5.16 Problems with HTML to PDF Conversion of SharePoint 2010 pages  
Due to excessive use of JavaScript and Dynamic HTML in the standard 
SharePoint 2010 user interface, you may need to make some changes to the 
Muhimbi Service’s config if you expect to convert SharePoint 2010 pages to 
PDF. 
 HTMLConverterFullFidelity.ClearBrowserCache: Set to True
 HTMLConverterFullFidelity.SplitImages: Set to True
For more details about working with the Conversion Service’s config file, see 
2.6.2 Fine-tuning the Document Conversion service
3.5.17 Changing the default bookmark and sort fields when merging files 
The PDF Converter ships with a powerful facility that allows multiple files to be 
merged together. It even allows fields to be selected to sort files by and use as 
PDF bookmarks. However, the default options (sort by Modified, use Title as 
PDF bookmark) may not be suitable for your purposes. 
These default options can be modified as follows: 
1. 
Open the following file in notepad (replace ‘14’ with ‘12’ when using 
SharePoint 2007, use ‘15’ for SharePoint 2013): 
%CommonProgramFiles%\Microsoft Shared\Web Server 
Extensions\14\TEMPLATE\FEATURES\Muhimbi.PDFConverter\elem
ents.xml 
2. 
Search for all instances of the following values and change where needed: 
 BookmarkField: Enter the internal name of the field to use as the 
PDF Bookmark. 
 SortField: Enter the internal name of the field to sort on. 
 SortOrder: Specify either ascending or descending
Please repeat this change on all SharePoint Front End servers and issue an 
iisreset on each server after making the change. 
Note that these modifications do not survive an upgrade of Muhimbi’s front 
end software, so please keep track of your changes. 
For details about using this merging facility see the User Guide. 
PDF Converter - Installation & Administration Guide
PDF Converter - Installation & Administration Guide - Version 8.0 - 15/10/15 
© Copyright 2015, Muhimbi Ltd 
Page 50 of 84 
3.5.18 Deploying the Conversion Service on Windows Server 2012 and later 
In order to maximise compatibility with different operating systems, the 
Conversion Service has been created for version 3.5 of the Microsoft .NET 
Framework. However, most Windows Server 2012 systems have version 4 or 
later installed, which is not compatible, at least not without making various 
configuration changes. Therefore it is recommended to install version 3.5 of 
the framework using the Add Roles and Features wizard, part of the Windows 
Server 2012 Server Manager
Documents you may be interested
Documents you may be interested