Troubleshooting
Problem
Report author created a Report Studio report that explicitly set Windows system fonts such as 'MS Gothic', 'MS Mincho' and so on, however PDF report does NOT show these fonts in client PC even if corresponding fonts exist in client PC, while HTML report does.
Symptom
The issue can be reproduced in Unix Server OS (AIX, Linux and etc). You may not see the same issue if BI server is running on Windows OS.
Cause
Cognos PDF engine does not render fonts to PDF if requested fonts are not installed in BI server machine or Cognos Configuration has not proper settings.
Note: Cognos assumes that your server has the proper license for using specific fonts set in user report and these fonts are already installed in server machine. If a requested font is not found from the location set in Cognos Configuration, Cognos report server (ReportService and BatchReportService) renders PDF files using a default font 'Andale WT' (<cognos_root>/bin or bin64/fonts/Andalewt.ttf) that has most of the Unicode characters for many languages. Default font can be customized from [Action] -> [Edit Global Configuration...] -> [General] -> [Default font].
Caution: Description in the following URL does NOT mean that Cognos PDF rendering engine can create PDF file with even any fonts if client PC side has corresponding fonts. BI server should have the fonts first and then you can choose whether to use embedding fonts for improving response time.
PDF Rendering
http://pic.dhe.ibm.com/infocenter/cbi/v10r2m0/index.jsp?topic=%2Fcom.ibm.swg.ba.cognos.crn_arch.10.2.0.doc%2Fc_arch_pdfrendering.html&resultof%3D%2522%2550%2544%2546%2522%2520%2522%2570%2564%2566%2522%2520
Environment
Unix Server OS (AIX, Linux and etc)
Diagnosing The Problem
In IBM Cognos Configuration, check the below.
- Ensure that BI server has corresponding fonts in the physical location. [Local Configuration] -> [Environment] -> [Font Settings] -> [Physical fonts locations]
- To confirm the above 1, you may use search functionality as below.
- Go to [Local Configuration] -> [Environment] -> [Font Settings] -> [Physical fonts map]
- Click the edit button.
- Click [Add...] button.
- Click the edit button for [Physical Font Name].
- Ensure that entered font paths are correct.
- Click [Search Now] and see if required fonts are listed as search result.
Resolving The Problem
In case you have the license for using fonts: Install corresponding fonts to [Physical fonts locations] set in Cognos Configuration.
In case you do NOT have the license <OR> In case font names are different between font set in report and font installed in BI server: Use alternative font using 'Physical fonts map' functionality as below.
- In Cognos Configuration, go to menu [Action] -> [Edit Global Configuration...] -> [Fonts] tab.
- Confirm that the font name you want to render is registered as Supported Font Name, and register the font name first if it does not exist.
- Go to [Local Configuration] -> [Environment] -> [Font Settings] -> [Physical fonts map].
- Click the edit button.
- Add mapping information ('Global Font Name' and 'Physical Font Name').
- Global Font Name: Enter the font name registered in above 2.
- Physical Font Name: Select the font name from the search results. Physical font will be used as an alternative for a global font.
Was this topic helpful?
Document Information
Modified date:
15 June 2018
UID
swg21624954