PDF Converter Installation and Administration Guide
4-7
Installing PDF Converter
I
NSTALLING
A
D
ISTILLER
E
NGINE
The purpose of PDF Converter is to convert files from their native format to the PDF file 
format. This is done to enable viewing of the file in a standard web browser, and to enable 
indexing of content whose native file format is not supported by some search engines used 
in a Content Server implementation (such as some e-mail formats).
When running on either Windows or UNIX, PDF Converter can use OpenOffice to 
convert some file types directly to PDF. When using this option, PDF Converter requires 
only OpenOffice; a distiller engine is not required. For more information about file 
formats that can be converted using this option, see Appendix B (File Formats Converted 
to PDF Using OpenOffice).
When running on Windows, there are two additional options for converting files to PDF:
• PDF Converter can use several third-party applications to create PDF files of content 
items. In most cases, a third-party application that can open and print the file is used to 
print the file to PostScript, and then the PostScript file is converted to PDF using the 
configured PostScript distiller engine. In some cases, PDF Converter can use a 
third-party application to convert a file directly to PDF. For details on file formats that 
can be converted to PDF using third-party applications, see Appendix A (File Formats 
Converted to PDF Using Third-Party Applications).
• PDF Converter includes Outside In X, which can be used on Windows to create PDF 
files of some content items. Outside In X is used to print the files to PostScript, and 
then the PostScript files are converted to PDF using the configured PostScript distiller 
engine. For details on file formats that can be converted to PDF using Outside In X, 
see Appendix C (File Formats Converted to PDF Using Outside In X).
Additional steps might be performed on the resultant PDF file after conversion, such as 
optimizing the PDF for a smaller file size and faster deployment.
A distiller engine is not provided with PDF Converter. You must obtain a distiller engine 
of your choice. The distiller engine you choose must be able to execute conversions via a 
command-line. The procedures in this section use AFPL Ghostscript as an example. This 
is a free, robust distiller engine that performs both PostScript to PDF conversion and 
optimization of PDF files during or after conversion.
Change pdf to tiff for - SDK application API:C# PDF Convert to Tiff SDK: Convert PDF to tiff images in C#.net, ASP.NET MVC, Ajax, WinForms, WPF
Online C# Tutorial for How to Convert PDF File to Tiff Image File
www.rasteredge.com
Change pdf to tiff for - SDK application API:VB.NET PDF Convert to Tiff SDK: Convert PDF to tiff images in vb.net, ASP.NET MVC, Ajax, WinForms, WPF
Free VB.NET Guide to Render and Convert PDF Document to TIFF
www.rasteredge.com
4-8
PDF Converter Installation and Administration Guide
Installing PDF Converter
To install a distiller engine, complete the following steps:
1. Make sure that the PDFConverter component has been installed on the refinery. For 
details, see Installing PDF Converter (page 4-4).
2. Log in to the PDF Converter computer. Be mindful of the user account that you use. 
The same user must be used to install Inbound Refinery and PDF Converter, install all 
required third-party applications, and run Inbound Refinery and PDF Converter.
3. Obtain and install a distiller engine on the PDF Converter computer. A freeware 
version of AFPL Ghostscript is available from the Internet at 
http://www.ghostscript.com/awki.
4. You can configure the your distiller engine settings using the Inbound Refinery 
administration interface:
a. Open a new browser window and log into the refinery.
b. Select Conversion Settings—Third-Party Application Settings. The Third-
Party Application Settings page is displayed.
c. Click the Distiller Engine Options button. The Distiller Engine Options Page is 
displayed.
d. To use Ghostscript, complete the following steps:
• Select the Use Ghostscript check box.
• In the Path to Ghostscript installation directory field, enter the path to the 
main Ghostscript installation directory. For example: c:/gs/gs8.54
e. To use a different distiller engine, complete the following steps:
• Clear the Use Ghostscript check box.
• In the Path to generic PostScript to PDF engine field, enter the path to the 
executable or script file of the PostScript to PDF distiller engine.
For example: c:/gs/gs8.54/lib/ps2pdf14.bat
• In the Parameters to pass to generic PostScript to PDF engine field, enter 
the parameters to be passed to the PostScript to PDF distiller engine. This 
field is Idoc Script enabled. Different distillers have different parameter 
options.
For example, if the path to the distiller engine is c:\utils\PostScript\distll.exe 
and the distiller engine takes the parameters [options <psPath> [<pdfPath>], 
at a command prompt you would enter 
c:\utils\PostScript\distll.exe 
c:\temp\mypsFile.ps –optimize -1.3 –crop c:\temp\file.pdf
SDK application API:Online Convert PDF file to Tiff. Best free online PDF Tif
Online PDF to Tiff Converter. Download Free Trial. Then just wait until the conversion from PDF to Tiff is complete and download the file.
www.rasteredge.com
SDK application API:Online Convert PDF file to Word. Best free online PDF Conversion
Creating a PDF from Tiff/Tif has never been so easy! Web Security. Your PDF and Tiff/Tif files will be deleted from our servers an hour after the conversion.
www.rasteredge.com
PDF Converter Installation and Administration Guide
4-9
Installing PDF Converter
To achieve this result through PDF Converter, you would set the following:
Path to generic PostScript to PDF engine:
c:/utils/PostScript/distll.exe
Parameters to pass to generic PostScript to PDF engine:
<$postscriptFile$> –optimize -1.3 –crop <$pdfFile$>
To achieve maximum flexibility, this entry uses the tokens <$postscriptFile$> 
for the PostScript file path and <$pdfFile$> for the output file. Consider these 
tokens as place holders and not actual path references.
• In the Path to generic PDF optimization engine field, enter the path to the 
executable or script file capable of optimizing PDF files.
For example: c:/gs/gs8.54/lib/pdfopt.bat
• In the Parameters to pass to generic PDF optimization engine field, enter 
the parameters to be passed to the distiller engine during PDF optimization. 
This field is Idoc Script enabled. Different distillers have different parameter 
options.
For example, if the path to the distiller engine is c:\utils\PostScript\opt.exe 
and the distiller engine takes the parameters [options <psPath> [<pdfPath>], 
at a command prompt you would enter 
c:\utils\PostScript\opt.exe 
c:\temp\myPDF.pdf c:\temp\file.pdf
To achieve this result through PDF Converter, you would set the following:
Path to generic PDF optimization engine:
c:/utils/PostScript/opt.exe
Parameters to pass to generic PDF optimization engine:
<$pdfFile$> <$optimizedPdfFile$>
To achieve maximum flexibility, this entry uses the tokens <$pdfFile$> for 
the PostScript file path and <$optimizedPdfFile$> for the output file. 
Consider these tokens as place holders and not actual path references.
f. Click Update to save your changes.
Note: Ghostscript can also be configured using the “generic” PostScript to PDF engine 
and PDF optimization engine fields.
SDK application API:C# Create PDF from Tiff Library to convert tif images to PDF in C#
Create PDF from Tiff. |. Home ›› XDoc.PDF ›› C# PDF: Create PDF from Tiff. C#.NET PDF - .NET PDF Library for Creating PDF from Tiff in C#.
www.rasteredge.com
SDK application API:Online Convert Excel to PDF file. Best free online export xlsx
Online Excel to PDF Converter. Download Free Trial. Convert a Excel File to PDF. Drag and drop your excel file into the box or
www.rasteredge.com
4-10
PDF Converter Installation and Administration Guide
Installing PDF Converter
I
NSTALLING
THE
IDC PDF C
ONVERTER
P
RINTER
After installing PDF Converter on Windows, you must install a PostScript printer on the 
PDF Converter computer if you want to use third-party applications or Outside In X to 
create PDF files. To install the IDC PDF Converter Printer, complete the following steps:
1. Log in to the PDF Converter computer. Be mindful of the user account that you use. 
The same user must be used to install Inbound Refinery and PDF Converter, install all 
required third-party applications, and run Inbound Refinery and PDF Converter.
2. Close all other Windows programs.
3. Create a c:\temp\ directory.
4. Launch the Windows Add Printer Wizard.
5. Click Next to continue.
6. Select the Local printer attached to this computer radio button, clear the 
Automatically detect and install my Plug and Play printer check box, and click 
Next to continue.
7. Select the Create a new port radio button, select Local Port from the drop-down 
menu, and click Next to continue.
8. Enter c:\temp\idcoutput.ps as the port name, and click OK. The idcoutput.ps file does 
not need to exist in the temp directory; it will be created by PDF Converter.
9. Click Have Disk.
10. Click Browse.
11. Navigate to the PostScript printer driver that you want to use. If you are using AFPL 
Ghostscript as your PostScript distiller engine, it is recommended that you use the 
AFPL Ghostscript printer driver that is installed with AFPL Ghostscript. Navigate to 
the ghostpdf.inf file located in the <ghostscript_install_dir>\lib\ directory.
Select the printer driver, and click Open.
12. Click OK to copy the printer files.
13. Click Next to continue. If you receive a message stating that driver is not digitally 
signed, this is not an issue; you can still continue.
Important: Make sure that the Print Spooler service is installed and running on the 
Inbound Refinery computer before attempting to install a printer. If this service is not 
installed and running, Microsoft Windows will not allow any printers to be installed.
SDK application API:VB.NET Create PDF from Tiff Library to convert tif images to PDF
Convert PDF to Word; Convert PDF to Tiff; Convert PDF to HTML; PDF; Merge PDF Files; Split PDF Document; Remove Password from PDF; Change PDF Permission Settings
www.rasteredge.com
SDK application API:RasterEdge XDoc.Tiff for .NET - SDK for Tiff Document Imaging
Able to view and edit Tiff rapidly. Convert. Convert Tiff to PDF. Convert Tiff to Jpeg Images. Convert PDF to Tiff. Convert Jpeg Images to Tiff. Tiff File Process
www.rasteredge.com
PDF Converter Installation and Administration Guide
4-11
Installing PDF Converter
14. Enter IDC PDF Converter for the printer name. The IDC PDF Converter printer can 
be set as your default printer, but it does not have to be. Click Next to continue.
15. Select the Do not share this printer radio button and click Next to continue.
16. Select the No radio button to not print a test page and click Next to continue.
17. Click Finish to install the printer. If you receive a message stating the printer has not 
passed Windows testing, click Yes/Continue Anyway to continue.
18. When the printer is installed, right-click on the IDC PDF Converter printer icon and 
select Properties to display the printer properties window.
19. On the General tab, make sure the printer is named IDC PDF Converter.
20. On the Sharing tab, make sure the Not shared/Do not share this printer radio button is 
selected.
21. On the Ports tab, make sure that the selected port is c:\temp\idcoutput.ps, and that it is 
specified as a Local Port. If the port has not been added, complete the following steps 
to add the port (the port only needs to be added once; if it was added correctly during 
the installation of the printer, it does not need to be added again):
a. Click Add Port.
b. In the list of available printer ports, select Local Port, and click New Port.
c. Specify c:\temp\idcoutput.ps as the port name, and click OK. The c:\temp\ 
directory must exist, but the idcoutput.ps file will be created by PDF Converter.
d. Click Close to close the Printer Ports dialog.
22. On the Advanced tab, make sure the Print directly to the printer radio button is 
selected.
23. Click Apply to save any changes.
24. Click OK to close the printer properties window.
SDK application API:C# WPF Viewer: Load, View, Convert, Annotate and Edit Tiff
Convert PDF to Word; Convert PDF to Tiff; Convert PDF to HTML; PDF; Merge PDF Files; Split PDF Document; Remove Password from PDF; Change PDF Permission Settings
www.rasteredge.com
SDK application API:C# WinForms Viewer: Load, View, Convert, Annotate and Edit Tiff
Convert PDF to Word; Convert PDF to Tiff; Convert PDF to HTML; PDF; Merge PDF Files; Split PDF Document; Remove Password from PDF; Change PDF Permission Settings
www.rasteredge.com
4-12
PDF Converter Installation and Administration Guide
Installing PDF Converter
I
NSTALLING
T
HIRD
-P
ARTY
A
PPLICATIONS
FOR
PDF C
ONVERSION
This section provides installation tips and settings for the following third-party 
applications that are supported for use with PDF Converter:
ʍ Considerations for All Applications (page 4-12)
ʍ Adobe FrameMaker (page 4-13)
ʍ Adobe InDesign CS2 (4.0) (page 4-13)
ʍ Adobe Photoshop CS2 (9.0) (page 4-13)
ʍ Corel WordPerfect (page 4-14)
ʍ Microsoft Office (page 4-14)
ʍ OpenOffice (page 4-16)
Considerations for All Applications
The following installation tips and recommended settings apply to all third-party 
applications:
ɽ When installing any third-party application, make sure that you are logged on as the 
same user used to install and run Inbound Refinery and its conversion add-ons. If you 
do not, conversion to PDF might fail; for example, because some of the conversion 
engines might not be able to locate the applications.
ɽ If you do not use the recommended configuration settings for the third-party 
applications, the refinery process might time out.
ɽ For a file to be converted automatically by PDF Converter, the third-party application 
used must be able to open the file without any user intervention. After completing the 
software installation, open the application and turn off any extra screens that start up 
before the application can be used, such as startup dialogs, tip wizards, or update 
notices. These cause the refinery process to time out. Password-protected files will 
also time out unless you enter a password before processing.
Note: Only the installation tips and recommended settings for OpenOffice apply when 
PDF Converter is being run on UNIX.
PDF Converter Installation and Administration Guide
4-13
Installing PDF Converter
Adobe FrameMaker
The following installation tips and recommended settings apply to Adobe FrameMaker:
ɽ Adobe FrameMaker+SGML is not supported.
ɽ The version of FrameMaker on the refinery computer must be the same as the version 
used to create the FrameMaker files being processed, or the conversion will fail.
ɽ Adobe FrameMaker must be installed on the refinery computer, using the same user 
login as used for the Inbound Refinery installation.
ɽ When installing this software on the refinery computer, perform a typical installation.
Adobe InDesign CS2 (4.0)
The following installation tips and recommended settings apply to Adobe InDesign CS2:
ɽ When installing this software on the refinery computer, perform a typical installation.
Adobe Photoshop CS2 (9.0)
The following installation tips and recommended settings apply to Adobe Photoshop CS2:
ɽ Adobe Photoshop CS2 must be installed before Inbound Refinery, using the same user 
login as used for the Inbound Refinery installation.
ɽ When installing this software on the refinery computer, make sure that you only install 
Photoshop, regardless of what Setup claims is required otherwise.
ɽ Adobe Photoshop files cannot be converted to PDF using a French or German version 
of Photoshop. French and German files can be converted using an English version of 
Photoshop. This is due to errors in Adobe’s Setup for the French and German 
Photoshop versions, which does not install some files that are required for conversion 
(these files are installed with the English version of Photoshop).
4-14
PDF Converter Installation and Administration Guide
Installing PDF Converter
Corel WordPerfect
The following installation tips and recommended settings apply to Corel WordPerfect:
ɽ When installing this software on the refinery computer, perform a typical installation.
ɽ WordPerfect files created in versions prior to version 6 might not be processed 
effectively. Convert these files to a more recent version of WordPerfect before 
sending them to Inbound Refinery. Otherwise, they might time out.
Microsoft Office
This section covers the following topics:
ʍ Word, Excel, PowerPoint, and Publisher (page 4-14)
ʍ Project (page 4-15)
ʍ Visio (page 4-15)
Word, Excel, PowerPoint, and Publisher
The following installation tips and recommended settings apply to Microsoft Word, Excel, 
PowerPoint, and Publisher:
ɽ When installing this software on the refinery computer, perform a custom installation. 
Install everything except Outlook. This is because Outlook, by default, creates a 
journal of all Microsoft Office file activities. As the journal grows, performance 
deteriorates. If Outlook is absolutely required, turn off the journaling function.
ɽ When installing this software on Windows 2000 Server, make sure that Microsoft 
Snapshot is installed. To verify that Microsoft Snapshot is installed, search for the 
snapview.ocx file in the C:\Program Files\Common Files\Microsoft Shared\Snapshot 
Viewer directory. If you do not find the snapview.ocx file, install Microsoft Snapshot 
from the Microsoft Office media.
ɽ Send the license information the first time you start any of the applications.
Important: To keep a conversion of a Microsoft Office file from timing out, all functions 
requiring user input should be disabled. These include password protection, security 
notifications, such as disabling of macros, and online access requests to show online 
content or participate in user feedback programs. For details on how to disable these and 
other similar features, refer to the Microsoft documentation for each product.
PDF Converter Installation and Administration Guide
4-15
Installing PDF Converter
ɽ Make sure that you turn off automatic spelling and grammar checking (Options—
Tools—Spelling & Grammar). These features might cause unexpected pop-up 
windows to appear, which time out the refinery process.
ɽ Make sure that you set the macro security to Low (Options—Tools—Macro—
Security—Security Level tab). This means the applications will not prompt you to 
enable/disable macros when you open a file that contains macros. Unexpected pop-up 
windows like these might cause the refinery process to time out.
ɽ Make sure that you turn off Show content and links from Microsoft Online on the 
Tools—Options—General tab under the Online category, and opt out of the 
Customer Experience Improvement Program on the Tools—Options—General tab 
under the Customer Feedback category. If you do not, these files might time out.
Project
The following installation tips and recommended settings apply to Microsoft Project:
ɽ When installing this software on the refinery computer, perform a typical installation.
Visio
The following installation tips and recommended settings apply to Microsoft Visio:
ɽ When installing this software on the refinery computer, perform a typical installation.
ɽ All files should be set up so that the printer paper size and orientation matches the 
drawing page size and orientation. Otherwise, links will not be converted correctly 
(they will be placed in the wrong location). For example, if the printer paper is set to 
Letter/Landscape, the drawing page should also be set to Letter/Landscape.
ɽ Visio files created using the Cross-Functional Flowchart template might cause a 
pop-up dialog to appear when Visio attempts to open the file, and thus the refinery 
process will time out unless this dialog is cleared manually on the refinery computer. 
To prevent this from happening, do not base files on the Cross-Functional Flowchart 
template. You can use OutsideIn to convert Visio files based on the Cross-Functional 
Flowchart template. However, please note that Visio hyperlinks are not converted by 
OutsideIn.
ɽ Make sure that you turn off Show content and links from Microsoft Online on the 
Tools—Options—General tab under the Online category, and opt out of the 
Customer Experience Improvement Program on the Tools—Options—General tab 
under the Customer Feedback category. If you do not, these files might time out.
4-16
PDF Converter Installation and Administration Guide
Installing PDF Converter
OpenOffice
The following installation tips and recommended settings apply to OpenOffice:
ɽ The OpenOffice Listener must always be running on the Inbound Refinery computer, 
or PDF conversion will fail.
ɽ When running OpenOffice on Windows, it is recommended that you configure an 
OpenOffice port in the Setup.xcu file and run the OpenOffice Quickstarter. The 
Quickstarter adds shortcuts to OpenOffice applications to your system tray and runs 
the OpenOffice Listener as a background process.
ʍ By default, the Quickstarter loads at system startup, and you should see the 
OpenOffice icon in your system tray. To start the Quickstarter, launch any 
OpenOffice application. The application can then be closed, and the Quickstarter 
will remain running.
ʍ To set the Quickstarter to load at system startup, right-click the OpenOffice icon 
in the system tray, and choose Load OpenOffice.org During System Start-Up.
ɽ When running OpenOffice on UNIX, it is recommended that you configure an 
OpenOffice port in the Setup.xcu file and run soffice, which acts as the Listener. If 
desired, soffice can be used on Windows instead of the Quickstarter.
ʍ To start soffice, launch the soffice.exe file located in the following directory:
Windows: <OpenOffice_install_dir>\program\
UNIX: <OpenOffice_install_dir>/program
ɽ To configure an OpenOffice port in the Setup.xcu file, complete the following steps:
1. Open the Setup.xcu file in a text editor. This file is located in the following 
directory:
Windows: <OpenOffice_install_dir>\share\registry\data\org\openoffice\
UNIX: <OpenOffice_install_dir>/share/registry/data/org/openoffice
2. Search for the element 
<node oor:name="Office">
. This element contains several 
<prop/>
elements.
Note:  OpenOffice can be launched by Inbound Refinery running as a service on Windows 
XP, 2000, 2003. However, since you must be logged in to Windows to run the OpenOffice 
Listener, you must always be logged in to Windows when using OpenOffice for PDF 
conversion (even when running Inbound Refinery as a service).
Documents you may be interested
Documents you may be interested