Installation Page



Requirements:

If you are wondering about any of the following are requirements, you should probably read (or re-read) the Doc2pdf Overview.    Links to the sofware listed below can be found on the Doc2pdf Download page.
 
Dedicated Windows machine This means that you need a low-end Windows machine that can be made into a dedicated Doc2pdf robot.
Viewers Available for download (free of charge) for most document formats.
AFPL Ghostscript for Windows  A "free" interpreter for the PostScript (TM) language
Doc2pdf Software Software available for free download from this site.

Step 1 - Install Microsoft Office Viewers:

Download and install the Microsoft Office viewers for Word, Powerpoint, and Excel documents.  If you are interested in converting Lotus documents you'll also want to download the Verity KeyView for Lotus SmartSuite.

Step 2 - Turn off  "hide extensions of known filenames":

Open "My Computer".   Select the "View" - "Folder Options" menu item.  In the "Advanced settings" uncheck the box labled "Hide file extions for known file types".

Step 3 - Install AFPL Ghostscript for Windows:

Download and run the self-extracting AFPL Ghostscript installer.  The AFPL installer offers a very simple setup tool.  The only important bit of information that you need to remember is the installation directory.  The default (c:\gs ) is usually acceptable.

Step 4 - Install a PostScript print-to-file printer:

The following instructions are for Windows 98, but they something very similar should work on other versions of Window. ** Actually, the Generic Postscript Driver from Adobe works the best.  For instructions on how to set this up, please read the FAQ.

Step 5 - Install Doc2pdf:

Download and run the self-extracting Doc2pdf installation.   The installer will not perform any post installation configuration for Doc2pdf.  Instead, Doc2pdf will prompt you for setup parameters when it is started.

Step 6 - Create a Doc2pdf email account:

Doc2pdf requires an email account to which email attachments are sent to be converted.   It is highly recommended that this email account be something intuitive like "doc2pdf@yourdomain.com".  The email account must have POP3 access, and mail must be able to be sent via SMTP. Before continuing, test the email account by sending and reading couple messages.  DO NOT create extra aliases for this email address.  Doc2pdf can only handle receiving email at one email address.

Step 7 - Run and configure Doc2pdf:

When started for the first time, Doc2pdf will display a Doc2pdf Setup dialog that prompts for the following information:
 
Ghostscript Directory This is the Ghostscript "bin" directory where gswin32.exe is located.  If you use the default location it will be c:\gs\gs7.03
Spool Directory This should be the set to the Windows temp directory
Mailbox Poll Interval:  Number of minutes to wait before checking mailbox for new messages (only applies if a mailbox is set up)
Directory Poll Interval: Number of seconds to wait before checking configured directories for new documents (only applies if a directory is set up)

Step 8 - Setup Mailboxes and/or Directories

Doc2PDF can be used to search for messages containing documents within a POP3 mail account, or it can be used to convert documents that are placed in a directory on your filesystem (ie can be used with an FTP server or Windows file sharing). Either operation is optional, but in order for Doc2PDF to work, you must set up at least one of these two operations.
The following settings are required to set up mailbox conversion:
Doc2pdf Email Address This is the email address from step 5 that is used to send email to doc2pdf.
Incoming POP3 Server The incoming mail server that can be accessed via POP3 to read email
Incoming POP3 User The user name used to authenticate to the POP3 server
Incoming POP3 Password The password used to authenticate to the POP3 server
Outgoing SMTP Server The outgoing mail server used to send email via SMTP

The following settings are required to set up directory based conversion:
Directory to find files in This is the directory where Doc2PDF will search for .doc, .xls etc files to convert
PDF Output Directory PDF Output Directory: After conversion, the PDF output will be placed here with the same filename (but with .pdf extension)

Step 9 - Start Doc2pdf and don't touch it:

As explained in the Doc2pdf Overview, Doc2pdf converts documents by viewing and printing to files using Microsoft's own viewers and the AFPL PostScript interpreter.   Until a better method can be found, Doc2pdf controls the Microsoft viewers by posting message to the viewer windows.  In order to process messages, the focus must not be screwed up.    While Doc2pdf is "Working..." DO NOT TOUCH IT or you may lose messages!   You may only safely stop or exit Doc2pdf when the status says "Idle" or "Stopped".  For more information, read the Doc2pdf Overview.

Step 10 - Read the FAQ

If things do not work the way that you expect, please read the Frequently Asked Questions document (FAQ).  If the FAQ does not help, please email the doc2pdf-devel@lists.sf.net mailing list.