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

質問

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

回答

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

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

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

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

Linux版

1. Confluence を停止する。
2. (Confluence インストールディレクトリ)/bin/setenv.sh をテキストエディタで開く。
3. 以下の例のように環境変数 CATALINA_OPTS に -Dfile.encoding=UTF-8 を追加する。
4. setenv.sh を保存してテキストエディタを閉じる。
5. Confluence を起動する。
6. 「管理」→「システム情報」で「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版

1. Confluence を停止する。
2. (Confluence インストールディレクトリ)\bin\setenv.bat をテキストエディタで開く。
3. 以下の例のように環境変数 JAVA_OPTS に -Dfile.encoding=UTF-8 を追加する。
4. setenv.bat を保存してテキストエディタを閉じる。
5. Conflulence を起動する。
6. 「管理」→「システム情報」で「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 サービスのプロパティをコマンドラインから設定する方法」より下をご参照下さい。