SETUP TO USE WINDWARD ON LINUX#
This setup allows you to put the required fonts (Arial Family) on Linux and configure the Windward environment to get the proper formatted report output.
Font Installation/Setup#
Since all the reports that have been created make use of some version of Arial font, this typeface needs to be purchased. Microsoft has designated Ascender Fonts http://www.ascenderfonts.com to be an authorized distributor of this font. The Arial font set includes Arial Bold, Arial Italic and Arial Bold Italic as well.
- Upload the four files to the Linux application server.
- Add them to the list of available fonts. This process will vary from one distribution to another, but Red Hat Linux provides the Control Center utility to add fonts. This needs to be done as the ROOT user.
- Test the installation of the new fonts with the ShowFonts utility provided by Windward.
- The following command is entered at a shell prompt, in the directory the WindwardReports.jar file is located, to test the availability of the new font:
java -classpath "WindwardReports.jar" net.windward.tools.ShowFonts
- The output is a list of fonts that Windward will be able to make use of. If the Arial font is not in the list, it will be substituted in the PDF output with an equivalent font (most likely Helvetica).
- IF the font is not in the list, upload the four font files into the $JAVA_HOME/lib/fonts directory and test again (Step 3). Since Linux can have multiple versions of Java installed at the same time, these may need to be repeated for each Java home until the font appears in the list.
Windward Configuration#
Once the font has been installed and verified that it's available, the Windward properties must be set correctly. This is done within the WindwardReports.properties files, located in the 'home' instance directory of the application server ($JAVA_HOME/j2ee/home).
Configuration File#
Review and confirm or change the following settings in the WindwardReports.properties file:
- “font.files” should be set to the location of all TTF files. For example:
font.files=/usr/local/share/fonts/TTF/*.ttf;/usr/lib/java-1.5.0/jdk1.5.0_11/jre/lib/fonts/*.ttf
- “'pdf.font_level” should be set to 2 to have the PDF file contain the font itself. For example:
pdf.font_level=2
- “line.break” is required to be set as internal and thus must be uncommented. For example:
line.break=internal
Test#
This properties file is only read by the application server during the initial start up of the application server instances, thus you must restart both the 'home' instance and the OC4J instance that is running Wiki.
After the application server instance has been restarted, log into Wiki and run any Windward report, generating a PDF file. Open the resulting output file and verify the fonts used from the Files/Properties dialog.