Confluence のファイルシステムエンコードを設定したい

質問

不具合対策のため、Confluence のファイルシステムエンコードを UTF-8 にしたいと考えています。
設定手順を教えて下さい。

回答

Linux 版、Windows 版、Windows サービスでそれぞれ手順が異なります。

以下の手順でファイルシステムエンコードの設定を追加してください。

また、ファイルシステムエンコードに関する詳細は、Atlassian社が公開している以下のドキュメントに記載がありますので、併せてご参照ください。

システムプロパティを設定する

Linux版

Confluence を停止する。
(Confluence インストールディレクトリ)/bin/setenv.sh をテキストエディタで開く。
以下の例のように環境変数 CATALINA_OPTS に -Dfile.encoding=UTF-8 を追加する。
setenv.sh を保存してテキストエディタを閉じる。
Confluence を起動する。
「管理」→「システム情報」で「Javaランタイム環境」の「ファイルシステムエンコード」が「 UTF-8 」であることを確認する。

変更前
    CATALINA_OPTS="-XX:ReservedCodeCacheSize=256m -XX:+UseCodeCacheFlushing ${CATALINA_OPTS}"

export CATALINA_OPTS
 
変更後
    CATALINA_OPTS="-XX:ReservedCodeCacheSize=256m -XX:+UseCodeCacheFlushing ${CATALINA_OPTS} -Dfile.encoding=UTF-8"

export CATALINA_OPTS

Windows版

Confluence を停止する。
(Confluence インストールディレクトリ)\bin\setenv.bat をテキストエディタで開く。
以下の例のように環境変数 JAVA_OPTS に -Dfile.encoding=UTF-8 を追加する。
setenv.bat を保存してテキストエディタを閉じる。
Conflulence を起動する。
「管理」→「システム情報」で「Javaランタイム環境」の「ファイルシステムエンコード」が「 UTF-8 」であることを確認する。

変更前
    set JAVA_OPTS=%JAVA_OPTS% -Xms256m -Xmx512m -XX:MaxPermSize=256m
     
    rem Checks if the JAVA_HOME has a space in it (can cause issues)
    SET _marker=%JAVA_HOME: =%
 
変更後
    set JAVA_OPTS=%JAVA_OPTS% -Xms256m -Xmx512m -XX:MaxPermSize=256m -Dfile.encoding=UTF-8
 
    rem Checks if the JAVA_HOME has a space in it (can cause issues)
    SET _marker=%JAVA_HOME: =%

Windows サービス

Windows サービスには、プロパティを「コマンドライン」から設定する方法と、「Windowsレジストリ」から設定する方法の2種類がありますが、後者はリスクが高いため、「コマンドライン」から設定する方法を推奨いたします。

手順につきましては、冒頭でお伝えしたドキュメントの「Windows サービスのプロパティをコマンドラインから設定する方法」より下をご参照下さい。