Install prerequisites for PDF reports

You must install the Apache Formatting Objects Processor (FOP) to generate PDF reports.

1. Verify that Java is installed on the server machine, and that the JAVA_HOME environment variable points to the location where Java is installed.

   Note Java must be installed before you can install Apache FOP.

2. Browse to the Apache FOP page (http://xmlgraphics.apache.org/fop/download.html) and download version 2.7 or earlier for your operating system:

   Caution Apache FOP version 2.8 is not compatible with Teamcenter reporting capabilities.

   For a Windows operating system: fop-n.n-bin.zip

   For a Linux operating system: fop-n.n-bin.tar.gz

3. Extract the ZIP or GZ file on the server machine into the install folder you want to use.

   Apache FOP creates a folder when it is extracted. For example, if you extract the file into the C:\apps, Apache FOP creates the C:\apps\fop-n.n folder.

   Tip This path cannot contain any spaces.

4. Browse to the fop subfolder.

   For example, browse to C:\apps\fop-n.n\fop.

5. Create or edit a system environment variable named TC_FOP_HOME, and set its value to the fop folder.

   The path you specify should contain the fop.bat file. For example, type C:\apps\fop-n.n\fop.

6. Edit the fop.bat file to support files containing large amounts of data:

   Locate the JAVAOPTS definition in the file.

   Add the -Xss4m parameter to the end of the definition.

7. Save and close the file.