If you installed PDF Generator as part of your AEM forms
on JEE, complete the following tasks:
6.5.1 Environment variables
If 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:
Ensure
that the required applications are installed on all nodes in the
cluster.
Note:
All environment variables and respective paths are case-sensitive.
Application
|
Environment variable
|
Example
|
Adobe Acrobat
|
Acrobat_PATH
|
C:\Program Files (x86)\Adobe\Acrobat 11.0\Acrobat\Acrobat.ex
e
|
Adobe FrameMaker®
|
FrameMaker_PATH
|
C:\Program Files (x86)\Adobe\FrameMaker8.0\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.3
|
Adobe PageMaker®
|
PageMaker_PATH
|
C:\Program Files (x86)\Adobe\PageMaker 7.0.2\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:
These environment variables
must be set for all nodes in the cluster.
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 variable
-
Select
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.3
6.5.2 Configuring the application server to use HTTP proxy server
If the computer that AEM forms on JEE is running on uses
proxy settings to access external web sites, the application server
should be started with the following values set as Java virtual
machine (JVM) arguments:
-Dhttp.proxyHost=[server host]
-Dhttp.proxyPort=[server port]
Complete the following procedure to start your application server
with HTTP proxy host setting.
-
From a command
line, edit the run script in the
[appserver root]
/bin/ directory:
-
Add the following text to the script file:
Set JAVA_OPTS=%JAVA_OPTS%
-Dhttp.proxyHost=[server host]
-Dhttp.proxyPort=[server port]
-
Save and close the file.
6.5.3 Setting the Adobe PDF Printer as the default printer
You 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.
For clusters,
you must set Adobe PDF Printer as the default printer on all nodes.
Set the default printer
-
Select
Start
>
Printers and Faxes
.
-
In the Printers and Faxes window, right-click
Adobe PDF
and
select
Set as Default Printer
.
6.5.4 Configuring Acrobat Professional (Windows-based Computers Only)
Note:
This procedure is required only if you upgraded to or
installed Acrobat after you completed the AEM forms on JEE installation.
Upgrading Acrobat can be completed after you run Configuration Manager
and deploy AEM forms on JEE to the application server. Acrobat Professional
root directory is designated as
[Acrobat root]
. Typically,
the root directory is
C:\Program Files\Adobe\Acrobat 11.0\Acrobat
.
Configure Acrobat for use with PDF Generator
-
If an earlier version of Acrobat is installed, uninstall
it by using Add or Remove Programs in the Windows Control Panel.
-
Install Acrobat XI Pro by running the installer.
-
Navigate to the additional\scripts folder on the AEM forms
on JEE installation media.
-
Run the following batch file.
Acrobat_for_PDFG_Configuration.bat [LiveCycle root]/pdfg_config
Note:
On
clusters, you must run the command on the cluster node where AEM
forms on JEE is installed.
-
On other cluster nodes on which you do not run AEM forms
on JEE Configuration Manager,do the following:
-
Add
a new registry DWORD entry named SplWOW64TimeOut at HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\Print.
Set its value to 60000.
-
Copy
PDFGen.api
from the [
aem-forms root
]/plugins/x86_win32 directory
on the node where AEM forms on JEE is installed to the [
Acrobat root
]/plug_ins
directory on the node being currently configured.
-
Open Acrobat and select
Help
>
Check for updates
>
Preferences
.
-
Deselect
Automatically check for Adobe updates
.
Validate the Acrobat installation
-
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.
-
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
11.0\Acrobat\Acrobat.exe).
Configure native application support
-
Install and validate Acrobat as described in the previous
procedure.
-
Set Adobe PDF printer as the default printer.
Add temporary directories to trusted directories list in Acrobat
The
OptimizePDF
service
uses Adobe Acrobat and mandates that AEM forms on JEE temporary
directory and PDF Generator temporary directory are listed in the
trusted directories list of Acrobat.
If AEM forms on JEE
temporary directory and PDF Generator temporary directory are not
listed in the trusted directories list, the
OptimizePDF
service
fails to run. Perform the following steps to add directories to
the temporary directory list:
-
Open Acrobat, Choose Edit
> Preferences.
-
From the Categories on the left, select Security (Enhanced),
and then select the Enable Enhanced Security option.
-
To add AEM forms on JEE temporary directory and PDF Generator
temporary directory to the trusted directories list, click
Add Folder Path
,
select directories and click
OK.
6.5.5 Adding fonts to PDF Generator
AEM forms on JEE provides a central repository of fonts,
which is accessible to all AEM forms on JEE modules. Make the extra
fonts available to non-AEM forms on JEE 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.
6.5.5.1 Non-AEM forms on JEE applications
The following list contains non-AEM forms on JEE applications
that PDF Generator can use for PDF generation on the server side:
Windows-only Applications
-
Microsoft
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 applications
-
OpenOffice
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.
6.5.5.2 Adding new fonts to Windows applications only
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 AEM forms
on JEE 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.
6.5.5.3 Adding new fonts to other applications
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.
6.5.6 Configuring HTML to PDF conversions
The HTML-to-PDF conversion process is designed to use the settings
from Acrobat XI Pro 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.
6.5.6.1 Configure the HTML-to-PDF conversion
6.5.6.2 Enable support for Unicode fonts in HTML to PDF conversions
Important:
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
[aem-forms 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
).
6.5.7 Modify Microsoft Visio default macro settings
When 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
:
6.5.8 Installing the Network Printer Client
PDF 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
6.5.8.2 Configure PDFG Network Printer on Windows using the native Add Printer wizard
6.5.8.1 Install the PDF Generator Network Printer Client
Note:
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 AEM forms on JEE 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 is successfully installed.
-
Click
OK
. You will now have a PDF Generator printer
available in your list of printers.
6.5.8.2 Configure PDFG Network Printer on Windows using the native Add Printer wizard
-
Click
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.
6.5.8.3 Install and configure the PDF Generator Network Printer Client using Proxy server port forwarding
-
Configure port forwarding on the CC Proxy server
on a particular port to the AEM forms on JEE Server, and disable
the authentication at proxy server level (because AEM forms on JEE
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 AEM forms on JEE 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 AEM forms on JEE Server.
6.5.9 Changing File Block Settings
Change 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.
6.5.10 Watched folder performance parameters
To 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.
Set performance parameters for PDF Generator
-
Log 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.
6.5.11 Enable PDF Conversion for Microsoft Word document containing protected fields
The PDF Generator supports Microsoft Word documents containing
protected fields. To enable PDF Conversion for Microsoft Word document
containing protected fields, change the file type settings:
-
In the
Administration Console
, navigate to
Services
>
PDF Generator
>
File Type Settings
,
and open your file type settings profile.
-
Expand the
Microsoft Word
option and select the
Preserve document markup in Adobe PDF (for Microsoft Office 2003 or later)
option.
-
Click
Save As
, specify name of the file type setting,
and click
OK
.
|
|
|