クラウドサービスが提供するOSにColdFusionインストールする場合の注意事項

クラウドサービスやVPSなどでは、利用するサービス業者が提供するOSを利用することができます。そのOSにColdFusionをインストールする場合の一般的な注意事項をご紹介します。

ColdFusionをインストールする前にOSの日本語環境を追加する

多くのクラウドサービスが提供するOSは、英語(多言語)版となり、デフォルトでは日本語が含まれていません。ColdFusionを日本語版としてインストールするには、OSに日本語環境が含まれている必要があります。その状態ではColdFusionを日本語版としてインストールできなかったり、日本語版としてインストールできても、ログが文字化けして表示されたり、一部のタグや関数が英語版として動作する可能性があります。

その問題を避けるためには、ColdFusionをインストールする前にOSに日本語環境を追加することです。一般ユーザー様が公開しているサイトやブログにはクラウド環境で使用するOSに日本語環境を追加するための情報が多くあり、それらの情報を確認していただくことが、もっとも最新の情報となります。こちら参考となる一般ユーザー様のサイトを以下のFAQでご紹介していますのでそちらも参考にしてください。

https://cfassociates.samuraiz.co.jp/index.cfm/faq/etc/win-add-japanese-language/
OSに日本語を追加する例(Windows)

https://cfassociates.samuraiz.co.jp/index.cfm/faq/etc/linux-add-japanese-language/
OSに日本語を追加する例(Linux)

※ColdFusionのインストーラーを起動した際に、言語の選択ができない(日本語が選択できない)場合は、OSの設定に日本語環境が足りないため、インストールを中断してOSの環境をチェックしてください。

トラブル例とその対処方法について

  • ロケールがja_JPではなく、en_USやja_USとなる

後からOSの日本語の言語パックを追加された場合や、ColdFusionの起動パラメーターに-Duser.country=USが指定されている(インストール時に"English"を選択された)場合、また、UnixOSでColdFusionを自動起動に設定していた際のOS起動時に、ColdFusion内部で判別するデフォルトJavaロケールが日本(ja_JP)ではなく、英語(en_US)やja_USと認識される場合があります。

特に、ja_USと認識された場合は、ColdFusion Administratorの画面は日本語で表示されるものの、特定のページの設定でエラーが発生したり、関数やタグの動作が通常とは異なる動作になるなど、思わぬトラブルに遭遇します。そのため、必ずJavaロケールが日本(ja_JP)となるように修正してください。詳しくは以下のFAQを確認してください。

https://cfassociates.samuraiz.co.jp/index.cfm/faq/administrator/java-default-locale/
Javaデフォルトロケールがja_USとなった場合のja_JPへの戻し方
 

  • (Linux環境)cfdocumentタグなどフォントを使用する処理でInvocationTargetExceptionエラーが発生する

RedHat Enterprise LinuxやUbuntuを最小構成でセットアップした(あるいはクラウドサービスが提供する最小イメージを利用した)際などに、ColdFusionでフォントを使用する処理、例えば cfdocumentで、 java.lang.InternalError: java.lang.reflect.InvocationTargetException エラーなどが出る場合があります。

これは、OSのfontconfig(及び、それに依存するパッケージ)やデフォルトフォントがインストールされていないなど、OS側のフォントパッケージの不足によって発生しますので、OSにフォントを追加してください。詳しくは以下のFAQを確認してください。

https://cfassociates.samuraiz.co.jp/index.cfm/faq/etc/linux-font-invocationtargetexception/
最小構成のLinux環境でcfdocumentなどのフォント周りでInvocationTargetExceptionエラー
 

  • ColdFusion Administratorの「サーバーの設定>スケジュールされたタスク」ページを開くとエラーが発生する

タスクを登録すると、タスクの開始日や時間などの情報がneo-cron.xmlファイルに書き込まれますが、異なるロケールで書き込まれたneo-cron.xmlを日本語ロケール(ja_JP)で読み込んだ場合、あるいはその逆の場合などはエラーが発生します。対処等については、以下のFAQを確認してください。

https://cfassociates.samuraiz.co.jp/index.cfm/faq/administrator/neo-cron-error/
スケジュールされたタスクのページでエラーが発生する

 


記事公開日:2024年06月06日
最終更新日:2024年06月06日


x

Sample Modal Window

This is just a sample…

Lorem ipsum dolor sit amet, consectetur adipiscing elit. Praesent suscipit iaculis libero sed tristique. Quisque mollis dolor non tellus placerat vitae sodales lectus porta. Curabitur ut suscipit tellus. Maecenas rhoncus, ante vitae vehicula vestibulum, metus sapien dapibus tellus, et mattis dolor neque vitae nisl. Nullam eleifend ultrices ipsum eget pretium. Curabitur semper metus ut ante adipiscing nec volutpat sem rutrum. Nullam a nisi lacus, non interdum ante. Vivamus ante augue, commodo vel egestas sed, pharetra nec dui. Quisque sed tellus felis. Donec ipsum mauris, sagittis eu accumsan in, aliquam non ipsum.

Vestibulum tempor nunc nec felis scelerisque eget elementum erat dignissim. Ut vel ipsum mollis orci venenatis luctus. Aenean vehicula quam vel quam porttitor ac iaculis elit pulvinar. Proin consequat, ipsum eu venenatis semper, justo turpis posuere tortor, ac placerat metus nisl et lectus. Nulla cursus dui id nunc ullamcorper sed semper nisl lobortis. Aliquam erat volutpat. Phasellus arcu ante, imperdiet in ornare sed, laoreet eu massa.