If you installed PDF Generator as part of your LiveCycle,
complete the following tasks:
5.3.1 Environment variablesIf you installed the PDF Generator module and configured
it to convert files to PDF, for some file formats, you must manually
set an environment variable that contains the absolute path of the
executable that is used to start the corresponding application.
The table below lists the environment variables for the native applications
that you have installed.
Note: All environment variables and respective paths are case-sensitive.
Application
|
Environment variable
|
Example
|
Adobe Acrobat
|
Acrobat_PATH
|
C:\Program Files (x86)\Adobe\Acrobat 10.0\Acrobat\Acrobat.exe
|
Adobe FrameMaker®
|
FrameMaker_PATH
|
C:\Program Files (x86)\Adobe\FrameMaker7.1\FrameMaker.exe
|
Notepad
|
Notepad_PATH
|
C:\WINDOWS\notepad.exe
You can leave the Notepad_PATH variable
blank.
|
OpenOffice
|
OpenOffice_PATH
|
C:\Program Files (x86)\OpenOffice.org 3
|
Adobe PageMaker®
|
PageMaker_PATH
|
C:\Program Files (x86)\Adobe\PageMaker 7.0\PageMaker.exe
|
WordPerfect
|
WordPerfect_PATH
|
C:\Program Files (x86)\WordPerfect Office 12\Programs\wpwin12.exe
|
Adobe Photoshop®
|
Photoshop_PATH
|
C:\Program Files (x86)\Adobe\Adobe Photoshop CS4\Photoshop.exe
|
Note: The environment variable OpenOffice_PATH is
set to the installation folder instead of the path to the executable.
You do not need to set up the paths for Microsoft Office applications
such as Word, PowerPoint, Excel, Visio, and Project, or for AutoCAD.
The Generate PDF service starts these applications automatically
if they are installed on the server.
Create a new Windows environment variableSelect Start > Control Panel > System.
Click the Advanced tab and click Environment Variables.
In the System variables section, click New.
Enter the environment variable name you need to set
(for example, enter Photoshop_PATH). This folder
is the one that contains the executable file. For example, type
the following path: D:\Program Files\Adobe\Adobe Photoshop CS4\Photoshop.exe
Set the PATH variables on Linux or UNIX (OpenOffice only)Execute the following command:
export OpenOffice_PATH=/opt/openoffice.org3
5.3.2 Setting the Adobe PDF Printer as the default printerYou must set the Adobe PDF Printer to
be the default printer on the server. If the Adobe PDF Printer is
not set as the default, PDF Generator cannot convert files successfully.
Set the default printerSelect Start > Printers and Faxes.
In the Printers and Faxes window, right-click Adobe PDF and
select Set as Default Printer.
5.3.3 Configuring Acrobat Professional (Windows-based Computers Only)Note: This procedure is required only if you upgraded to or
installed Acrobat after you completed the LiveCycle installation.
Upgrading Acrobat can be completed after you run Configuration Manager
and deploy LiveCycle to the application server. Acrobat Professional
root directory is designated as [Acrobat root]. Typically,
the root directory is C:\Program Files\Adobe\Acrobat 10.0\Acrobat.
Configure Acrobat for use with PDF GeneratorIf an earlier version of Acrobat is installed, uninstall
it by using Add or Remove Programs in the Windows Control Panel.
Install Acrobat X Pro by running the installer.
Navigate to the additional\scripts folder on the LiveCycle
installation media.
Run the following batch file.
Acrobat_for_PDFG_Configuration.bat [LiveCycle root]/pdfg_config
Open Acrobat and select Help > Check for updates > Preferences.
Deselect Automatically check for Adobe updates.
Validate the Acrobat installationNavigate 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.
If the PDF file does not open correctly, uninstall Acrobat
and reinstall it.
Note: Ensure that you
dismiss all the Acrobat dialog boxes that are displayed after the
Acrobat installation is completed and disable the automatic updates
for Acrobat. Set the Acrobat_PATH environment variable
to point to Acrobat.exe (For example, C:\Program Files\Adobe\Acrobat
10.0\Acrobat\Acrobat.exe).
Configure native application supportInstall and validate Acrobat as described in the previous
procedure.
Set Adobe PDF printer as the default printer.
5.3.4 Configuring user accounts for multi-threaded file conversionsBy default, PDF Generator can convert only one OpenOffice,
Microsoft Word, or PowerPoint document at a time. If you enable
multi-threaded conversions, PDF Generator can convert more than
one of the documents concurrently by launching multiple instances
of OpenOffice or PDFMaker (which is used to perform the Word and
PowerPoint conversions).
Note: Only Microsoft Word 2007 and Microsoft PowerPoint
2007 are supported with multi-threaded file conversions. Microsoft
Excel 2003 or 2007 versions are not supported.
If you need to enable multi-threaded file conversion, you must
first perform the tasks outlined in the “Enabling multi-threaded
file conversions” section of the Preparing to Install or Upgrade
guide available on the LiveCycle documentation.
For Linux and Solaris users, you must create users and configure
the system to remove the password prompts. The following section
outlines the method to create a user and perform additional configurations.
5.3.4.1 Add user accountIn Administration Console, click Services > LiveCycle PDF Generator ES3 > User Accounts.
Click Add and enter the user name and password of
a user who has administrative privileges on the LiveCycle Server.
If you are configuring users for OpenOffice, dismiss the initial
OpenOffice activation dialogs.
Note: If you are
configuring users for OpenOffice, the number of instances of OpenOffice
cannot be greater than number of user accounts specified in this
step.
Restart the LiveCycle Server.
5.3.4.2 Additional configuration required for OpenOffice on Linux or SolarisAdd user accounts as described above.
Add entries for additional users (other than the administrator
who runs the LiveCycle Server in the /etc/sudoers file.
For example, if you are running LiveCycle as a user named lcadm on
a server named myhost, and you want to impersonate
user1 and user2, add the following entries to /etc/sudoers: lcadm myhost=(user1) NOPASSWD: ALL
lcadm myhost=(user2) NOPASSWD: ALL
This configuration
enables lcadm to run any command on host ‘myhost’
as ‘user1’ or ‘user2’ without prompting for password.
Allow all the users that you added via Add a user account
to make connections to the LiveCycle Server. For example, to allow
a local user named user1 the permission of making the connection
to the LiveCycle Server, use the following command:
For
more details, refer to xhost command documentation.
Restart the server.
5.3.5 Installing East Asian characters in Windows Server 2003When HTML files are converted to PDF by
using PDF Generator, some East Asian languages, such as Japanese,
Korean, and Chinese, and also right-to-left languages, such as Arabic,
Armenian, Georgian, Hebrew, Indic, Thai, and Vietnamese, may not
be displayed in the PDF file.
To ensure that these languages are displayed in Windows Server
2003, appropriate fonts must be present on the client and server.
Install East Asian characters in Windows Server 2003Select Start > Control Panel and
open Regional and Language Options.
Click the Languages tab and select Install Files for East Asian Languages.
Click the Advanced tab and select all the options
under Code Page Conversion Tables.
If converted
PDF files are still missing fonts, verify that the Arial Unicode
MS (TrueType) font (ARIALUNI.TTF) is present in the C:\WINDOWS\Fonts
directory.
5.3.6 Adding fonts to PDF GeneratorLiveCycle provides a central repository of fonts, which
is accessible to all LiveCycle modules. Make the extra fonts available
to non-LiveCycle applications on the server so that PDF Generator
can use these fonts to create PDF documents that are created with
these applications.
Note: Restart the application server after adding new fonts to
the specified fonts folder.
5.3.6.1 Non-LiveCycle applicationsThe following list contains non-LiveCycle applications
that PDF Generator can use for PDF generation on the server side:
Windows-only ApplicationsMicrosoft
Office Word
Microsoft Office Excel
Microsoft Office PowerPoint
Microsoft Office Project
Microsoft Office Visio
Microsoft Office Publisher
AutoDesk AutoCAD
Corel WordPerfect
Adobe Photoshop CS
Adobe FrameMaker
Adobe PageMaker
Adobe Acrobat Professional
Multiplatform applicationsOpenOffice
Writer
OpenOffice Calc
OpenOffice Draw
OpenOffice Impress
Note: In addition
to these applications, your list may include additional applications that
you added.
Of the above applications, the OpenOffice Suite
(which includes Writer, Calc, Draw, and Impress) is available on
Windows, Solaris, and Linux platforms, whereas other applications
are available on Windows only.
5.3.6.2 Adding new fonts to Windows applications onlyAll 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.
5.3.6.3 Adding new fonts to other applicationsIf 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.
5.3.7 Configuring HTML to PDF conversionsThe HTML-to-PDF conversion process is designed to use the settings
from Acrobat X that override the settings from PDF Generator.
Note: This configuration is required to enable the
HTML-to-PDF conversion process, otherwise this conversion type will
fail.
5.3.7.1 Configure the HTML-to-PDF conversion5.3.7.2 Enable support for Unicode fonts in HTML to PDF conversionsImportant: The HTML-to-PDF conversion fails
if a zipped input file contains HTML files with double-byte characters
in filenames. To avoid this problem, do not use double-byte characters
when naming HTML files.
Copy the Unicode font to any of the following directories
as appropriate for your system:
Windows
[Windows root]\Windows\fonts
[Windows root]\WINNT\fonts
UNIX
/usr/lib/X11/fonts/TrueType
/usr/openwin/lib/X11/fonts/TrueType
/usr/share/fonts/default/TrueType
/usr/X11R6/lib/X11/fonts/ttf
/usr/X11R6/lib/X11/fonts/truetype
/usr/X11R6/lib/X11/fonts/TrueType
/usr/X11R6/lib/X11/fonts/TTF
/Users/cfqauser/Library/Fonts
/System/Library/Fonts
/Library/Fonts
/Users/
+ System.getProperty(<user name>, root) + /Library/Fonts
System.getProperty(JAVA_HOME)
+ /lib/fonts
/usr/share/fonts (Solaris)
Note: Ensure that the directory /usr/lib/X11/fonts exists.
If it does not, create a symbolic link from /usr/share/X11/fonts
to /usr/lib/X11/fonts using the ln command.
Modify the font-name mapping in the cffont.properties file
located in the [LiveCycle root]/deploy/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).
5.3.8 Modify Microsoft Visio default macro settingsWhen a Microsoft Visio file containing macros is submitted
for conversion, the resultant Microsoft Office Visio Security Notice
dialog causes the conversion to time out. To successfully convert
files that contain macros, the default macro settings in Visio must
be changed.
In Visio, click Tools > Trust Center > Macro Settings and
select either of the following options and then click OK:
5.3.9 Installing the Network Printer ClientPDF Generator includes an executable file to install the PDF
Generator network printer on a client computer. After the installation
is complete, a PDF Generator printer is added to the list of existing
printers on the client computer. This printer can then be used to
send documents for conversion to PDF.
Note: The Network Printer Client installation wizard available in
the Administration Console is supported only on Windows operating
system. Ensure that you use a 32-bit JVM to launch the Network Printer
Client installation wizard. You will encounter an error if you use
a 64-bit JVM.
If the PDFG Network Printer fails to install on Windows or if
you want to install the printer on UNIX or Linux platforms, use
the operating system’s native Add Printer utility and configure
it as described in 5.3.9.2 Configure PDFG Network Printer on Windows using the native Add Printer wizard
5.3.9.1 Install the PDF Generator Network Printer ClientNote: Before installing the PDF Generator network printer
client on Windows Server 2008, Ensure that you have the Internet
Printing Client feature installed on your Windows Server 2008. For
installing the feature, see Windows Server 2008 Help.
Ensure that you successfully installed PDF Generator
on your server.
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 > PDFG Network Printer.
In the PDFG Network Printer Installation section, click Click here to
launch the PDFG Network Printer Installation.
On the Configure Internet Port screen, select Use the specified user account option,
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 apply
to all users on the client computer, select Use the same security options for all users,
and then click OK. Note: If the user’s 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 Adobe LiveCycle PDF Generator ES3 has been successfully
installed.”
Click OK. You will now have a printer named Adobe LiveCycle PDF Generator ES3in
your list of available printers.
5.3.9.2 Configure PDFG Network Printer on Windows using the native Add Printer wizardClick Start > Printers and Faxes and
double-click Add Printer.
Click Next, select A network printer, or a printer attached to another computer,
and then click Next.
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
On the Configure Internet Port screen, select Use the specified user account and
provide valid User credentials.
In the Printer Driver Select box, choose any standard
PostScript-based printer driver (for example, HP Color LaserJet
PS).
Complete the installation by choosing appropriate options
(for example, setting this printer as default).
Note: The
user credentials used while adding the printer must have a valid
email ID configured in User Management to receive the response.
Configure the email service’s sendmail service. Provide a
valid SMTP server and authentication information in the service’s
configuration options.
5.3.9.3 Install and configure the PDF Generator Network Printer Client using Proxy server port forwardingConfigure port forwarding on the CC Proxy server
on a particular port to the LiveCycle Server, and disable the authentication
at proxy server level (because 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.
Install PDFG Network Printer using the following URL:
http://[proxy server]:[forwarded port]/pdfg-ipp/install.
Provide the necessary credentials for authentication of the
PDFG Network Printer.
The PDFG Network Printer will be installed on the client
machine which you can use for PDF conversion using the firewall
protected LiveCycle Server.
5.3.10 Changing File Block SettingsChange Microsoft Office trust center settings to enable
PDFG to convert older versions of Microsoft office documents.
Click the File tab in any Office 2010 application.
Under Help, click Options; the Options dialog box
appears
Click Trust Center, and then click Trust Center Settings.
In the Trust Center settings, click File Block Settings.
In the File Type list, uncheck open for the file type that
you want to be converted by PDFG.
5.3.11 Watched folder performance parametersTo avoid java.io.IOException error
messages indicating that not enough disk space is available to perform
PDF conversions by using a watched folder, you can modify the settings
for PDF Generator in Administration Console.
You
must ensure that for WebSphere application server, the maximum transaction
time-out and ORB service have the proper values.
Configure transaction time-outDo the following:
Log in
to WebSphere Administrative Console, click Servers > Server Types > WebSphere application servers,
and then click the name of the server instance to configure (for
example, server1).
Under Container Settings, click Container Services > Transaction Service.
Under General Properties, in the Total transaction lifetime timeout box,
type 300 (or higher).
Ensure that the value in the Maximum transaction timeout box
is greater than or equal to the Total transaction lifetime timeout.
Click OK or Apply and then click Save directly to master configuration.
Increase the CORBA time-out valueDo the following:
Log in to WebSphere Administrative Console, click Servers > Server Types > WebSphere application servers,
and then click the name of the server instance to configure (for
example, server1).
Under Container Settings, click Container Services > ORB Service.
Under General Properties, in the Request timeout box,
type 360 and, in the Locate Request Timeout box,
type 300.
Click OK or Apply and then click Save directly to master configuration.
Set performance parameters for PDF GeneratorLog in to Administration Console and click Services > Applications and Services > Service Management.
In the list of services, navigate to and click PDFGConfigService,
and then set the following values:
PDFG Cleanup Scan Seconds:
1800
Job Expiration Seconds: 6000
Server Conversion Timeout: Change the default of 270
to a higher value, such as 450.
Click Save and restart the server.
|
|
|