5.17 Configuring PDF Generator

1. Ensure that the JBoss Application Server is stopped.

2. From command line, edit the run.conf.bat or run.bat script in the [JBoss root]/bin/ directory.

3. Add the following text to the script file:

   Set JAVA_OPTS=%JAVA_OPTS% 
   -Dhttp.proxyHost=[server host] 
   -Dhttp.proxyPort=[server port] 

4. Save and close the file.

1. Navigate to a PDF file on your system and double-click it to open it in Acrobat. If the PDF file opens successfully, Acrobat is installed correctly.

2. If the PDF file does not open correctly, uninstall Acrobat and reinstall it.

Set the Acrobat_PATH environment variable to point to Acrobat.exe (such as C:\Program Files\Adobe\Acrobat 10.0\Acrobat\Acrobat.exe).

1. Install and validate Acrobat as described in the previous procedure.

2. Set Adobe PDF printer as the default printer.

Change Microsoft Office trust center settings to enable PDFG to convert older versions of Microsoft office documents.

PDF Generator includes the Network Printer Client installer for installation of the PDF Generator Internet printer. After the installation is completed, a PDF Generator printer is added to the list of existing printers on the clients computer. This printer can then be used to send documents for conversion to PDF. For more information about installing the Network Printer Client, see Installing and Deploying LiveCycle document for your application server.

The following list contains non-LiveCycle applications that PDF Generator can use for PDF generation on the server side:

All the Windows-only applications that are mentioned above can access all the fonts that are available in the C:\Windows\Fonts (or equivalent) folder. In addition to C:\Windows\Fonts, each of these applications may have its own private fonts folders.

Therefore, if you plan to add any custom fonts to the LiveCycle fonts repository, ensure that the same fonts are available to the Windows-only applications also by copying these fonts to either C:\Windows\Fonts or to an equivalent folder.

Your custom fonts must be licensed under an agreement that allows you to use them with the applications that have access to these fonts.

Adding custom fonts to OpenOffice Suite is explained on the OpenOffice Fonts-FAQ page at http://wiki.services.openoffice.org.

In addition, OpenOffice Suite has these resources about the fonts-related behavior:

• OpenOffice Fonts Troubleshooting Guide at http://www.openoffice.org/FAQs/fontguide.html. Some of the text in this guide is applicable only to OpenOffice 1.x and therefore may be obsolete for OpenOffice 3.1 and above.

• Importing Fonts into OpenOffice 2.1 at http://openoffice.blogs.com/openoffice/2007/02/font_import_wiz.html. Even though this blog mentions OpenOffice 2.1, the instructions that are mentioned should be applicable to OpenOffice 3.1 and later

If you added support for PDF creation in other applications, see the Help for these applications to add new fonts. In Windows, copying your custom fonts to the C:\Windows\Fonts (or equivalent) folder should be sufficient.

1. Copy the Unicode font to any of the following directories as appropriate for your system:

   • [Windows root]\Windows\fonts

   • [Windows root]\WINNT\fonts

2. Modify the font-name mapping in the cffont.properties file located in the [LiveCycle root]/adobe-generatepdf-dsc.jar file:

   • Extract this archive, and locate the cffont.properties file and open it in an editor.

   • In the comma-separated list of Java font names, add a map to your Unicode system font for each font type. In the example below, kochi mincho is the name of your Unicode system font.

     dialog=Arial, Helvetica, kochi mincho

     dialog.bold=Arial Bold, Helvetica-Bold, kochi mincho ...

   • Save and close the properties file, and then repackage and redeploy the adobe-generatepdf-dsc.jar file.

   Note: On a Japanese operating system, specify the font mapping in the cffont.properties.ja file as well, which takes precedence over the standard cffont.properties file.
   Fonts in the list are searched from left to right, using the first font found. HTML-to-PDF conversion logs return a list of all the font names that are found in the system. To determine the font name you need to map, add the font to one of the directories above, restart the server, and run a conversion. You can determine from the log files the font name to use for mapping.

   To embed the font in the generated PDF files, set the embedFonts property in the cffont.properties file to true (the default is false).

1. Ensure that you successfully installed PDF Generator on your server.

2. Do one of the following:

   • From a Windows client computer, enter the following URL in your web browser, where [host] is the name of the server where you installed PDF Generator and [port] is the application server port used:

     http://[host]:[port]/pdfg-ipp/install

   • In Administration Console, click Home > Services > PDF Generator Evaluation > PDFG Network Printer. In the PDFG Network Printer Installation section, click Click here to launch the PDFG Network Printer Installation.

3. On the Configure Internet Port screen, select Use the specified user account and provide the credentials of a LiveCycle user who has the PDFG Administrator/User role. This user must also have an email address that can be used to receive the converted files. To have this security setting applied to all users on the client computer, select Use the same security options for all users, and then click OK.

   Note: If the users’ password changes, then users will need to reinstall the PDFG Network Printer on their computers. You cannot update the password from Administration Console.

   Upon successful installation, a dialog box appears, indicating that “The Printer LiveCycle PDF Generator has been successfully installed.”

4. Click OK. You will now have a printer named LiveCycle PDF Generator in your list of available printers.

1. Click Start > Printers and Faxes and double-click Add Printer.

2. Click Next, select A network printer, or a printer attached to another computer, and then click Next.

3. Select Connect to a printer on the internet or on a home or office network and type the following URL for the PDFG printer, where [host] is the server name and [port] is the port number where the server is running:

   http://[host]:[port]/pdfg-ipp/printer

4. On the Configure Internet Port screen, select Use the specified user account and provide valid User Management credentials.

5. In the Printer Driver Select box, choose any standard PostScript-based printer driver (for example, HP Color LaserJet PS).

6. Complete the installation by choosing appropriate options (for example, setting this printer as default).

 Configure the email service’s sendmail service. Provide a valid SMTP server and authentication information in the service’s configuration options.

1. Configure port forwarding on the CC Proxy server on a particular port to the LiveCycle server, and disable the authentication at proxy server level (since LiveCycle uses its own authentication). If a client connects to this Proxy server on the forwarded port, then all the requests will be forwarded to the LiveCycle server.

2. Install PDFG Network Printer using the following URL:

   http://[proxy server]:[forwarded port]/pdfg-ipp/install.    

3. Provide the necessary credentials for authentication of the PDFG Network Printer.

4. The PDFG Network Printer will be installed on the client machine which you can use for PDF conversion using the firewall protected LiveCycle server.