Unable to render multibyte characters in document preview thumbnails after upgrading to Confluence Data Center 6.10.x and beyond
プラットフォームについて: Data Center - この記事は、Data Center プラットフォームのアトラシアン製品に適用されます。
このナレッジベース記事は製品の Data Center バージョン用に作成されています。Data Center 固有ではない機能の Data Center ナレッジベースは、製品のサーバー バージョンでも動作する可能性はありますが、テストは行われていません。サーバー*製品のサポートは 2024 年 2 月 15 日に終了しました。サーバー製品を利用している場合は、アトラシアンのサーバー製品のサポート終了のお知らせページにて移行オプションをご確認ください。
*Fisheye および Crucible は除く
要約
Multibyte characters such as Japanese font installation does not render properly in document previews for Confluence Data Center starting from versions that include the Document Conversion Sandbox feature.
When rendering a thumbnail for an Office or PDF file that has multibyte characters installed (Japanese kanji, katanana, hiragana etc) you instead encounter a rendering issue where the text is replaced with Unicode escape characters or placeholder boxes.
環境
- This was originally observed on Confluence Data Center 6.13.8 that was being upgraded from a 6.3.x.
- Using OpenJDK 1.8.0
- Amazon Linux 2 operating system (similar to RHEL 6)
診断
Here's an example of expected behavior:
Actual behavior before solution path is applied from the same document
原因
The issue stems from the fact that the system properties setting the default fonts for the Document Conversion service library, Aspose, do not get passed on to the sandbox process directly. Migrating to a version that has Document Conversion sandbox will thus cause thumbnail rendering to display the issues. It was originally discovered in testing for CONFSERVER-57588.
ソリューション
- Install the following font libraries using your package manager of choice. In the case of Amazon Linux 2, this would be
yum.ipa-gothic-fonts
ipa-mincho-fonts
vlgothic-fonts
vlgothic-p-fonts
ipa-pmincho-fonts
ipa-pgothic-fonts
- Add the following JVM arguments in your
setenvfile as noted from CONFSERVER-57588. This will explicitly declare the font libraries to be passed to the Document Sandbox child process:
CATALINA_OPTS="-Dconversion.sandbox.java.options=-Dconfluence.document.conversion.slides.defaultfontname.regular=IPAGothic,-Dconfluence.document.conversion.slides.defaultfontname.asian=IPAGothic,-Dconfluence.document.conversion.slides.defaultfontname.symbol=IPAGothic,-Dconfluence.document.conversion.words.defaultfontname=IPAGothic ${CATALINA_OPTS}"- Rebuild the Viewfiles macro cache in order to force document thumbnails to be regenerated: How to rebuild the file preview cache from scratch in Confluence
- Restart Confluence to apply changes.