Both the Muhimbi PDF Converter for SharePoint On-Premises and the PDF Converter Server Platform ship with a handy Diagnostics Tool that can be used to troubleshoot problems. Some people use this tool for production work (e.g. to carry out individual or even batch conversions), but as its main audience is System Administrators it doesn't look as polished as the professional user interface that ships with our SharePoint product.
From time to time the Muhimbi Support Desk may ask you to carry out some tests using this tool. It can be found in the Start Menu / Muhimbi Document Converter / Diagnostics Tool and looks as follows:
What is important to remember is that this tool uses the exact same Web Services API that is exposed by our Conversion Service and SharePoint front-end. In other words, if the converter works correctly in this tool then the Conversion Service is configured correctly and works as expected.
The user interface is fairly straight forward and exposes about 90% of the object model provided by our web services interface. Most of the available options are self-describing, but the following features require further explanation.
WS Convert tab
- Selecting a file: Paste the full path, including file name, in the Source field or click the '...' button to browse for a file.
- Selecting a folder: When executing an operation that works on folders, e.g. the Convert Folder or Merge Folder options, then you must specify the path to a folder in the Source field. The '...' button will not work in this case as it can only be used to select individual files, not folders.
- Open Password: The Open Password field next to the Source field can be used to specify the password for the source file, e.g. to open secured MS-Word files. This is different from the Open Password in the PDF Security sub-tab, which is used to secure the generated PDF file.
- Service URL: If you wish to execute a request against a remote Conversion Service then you can specify its Service URL here.
- Parallel Conversions: When converting a folder the diagnostics tool will issue multiple requests in parallel. The number of parallel requests can be specified here. This is ideal for performance testing (results here), but don't go overboard and specify a value higher than 16.
- Verbose Logging: When carrying out a performance test then you may want to disable logging in the Diagnostics Tool as the logging overhead is measurable. This doesn't disable the PDF Converter Server Platform's internal logging, just the logging carried out in the Diagnostics Tool.
I noticed that when I change the timeout value in the Muhimbi config file, that this change is not reflected in the Diagnostics tool, even after restarting the Muhimbi service. Does that sound correct?
That does not sound correct John. Please contact email@example.com and provide details about what you are exactly changing and attempting to do.
Can I install somehow Diagnostic Tools without whole Converter? I want to test Muhimbi server from my PC using Diagnostic Tools.
There is no separate installation option to just install the Diagnostics Tool. What you can do is just copy the following files over to a new machine:
- Document Converter Diagnostics.exe
I hope this helps.