長期間にわたるご使用に際しては、Confluence をオペレーティング・システムが再起動するとき自動的に起動するように設定することをお勧めします。Windows サーバーに関しては、Confluence を Windows サービスとして実行するように設定してください。

Confluence ディストリビューションをサービスとしてインストールするには次の2つの方法があります。Confluence インストーラーを用いる方法と以下に述べるように手動で行う方法です。

On this page:

64ビット Windows に関する問題

If you are running 64-bit Windows, please note that Apache Tomcat cannot run as a Windows service if you are using a 64-bit JDK. Please ensure that you are using a 32-bit JDK. Refer to our knowledge base article for more information.

Confluence をサービスとして起動する理由

Windows サービスとしてインストールすることには以下のようなメリットがあります。

  • onfluence が誤ってシャットダウンするリスクの軽減。 (Confluence を手動で起動した場合、コンソール・ウィンドウが開き、誰かがそのウィンドウを閉じることにより誤って Confluence をシャットダウンしてしまう危険性があります)。
  • サーバー再起動後の Confluence の自動リカバリ
  • サーバー出力のログ・ファイルを取ることによるトラブルシューティングの改善

詳細な情報は Microsoft デベロッパーネットワーク 内の Windows サービスについて、をご覧ください。

サービスを実行するユーザーの変更

If you wish to run the service as a non-administrator user for security, or if you are using network drives for backups, attachments or indexes, you can run the service as another user. To change users, open the Apache Tomcat Confluence properties, go to the 'Log On' tab and enter the required username and password. Go to your Windows Control Panel -> User Accounts and confirm that the user has write permissions for the <CONFLUENCE-INSTALL> and <CONFLUENCE-HOME> directories, and all subfolders. Note that any network drives must be specified by UNC and not letter mappings (eg. \\backupserver\confluence not z:\confluence).

より詳細は、こちらをご覧ください。 Confluence のを実行するためのオペレーティング·システム上の専用のユーザーアカウントを作成する

Confluence ディストリビューションをサービスとして手動でインストール

Windows ベースのサーバーから

  1. Open a command prompt in the <CONFLUENCE-INSTALL>/bin directory.
  2. JAVA_HOME 変数がコマンドの JDK ベースディレクトリに設定されていることを確認する

    echo %JAVA_HOME%
    

    Note that any directory in the path with spaces (eg. C:\Program Files must be converted to its eight-character equivalent (e.g. C:\Progra~1).

  3. Confluence を Windows 2008 server にインストールしている場合は、'管理者で実行する' を用いてコマンド・プロンプトを実行することを確かめてください。 (管理者でなければ、 次のステップで述べる、'service.bat' の実行は失敗します。)
  4. 次のコマンドを使ってデフォルトの設定でサービスをインストールしてください。

    service.bat install Confluence
    

    注意: これは Apache Tomcat Confluence と呼ばれるサービスを作成します。

  5. さて、サーバーが起動するときに自動的にサービスを起動させるために、以下のように実行してください:

    tomcat6 //US//Confluence --Startup auto
    
  6. メモリが 512 MB より少ない場合は、このステップをスキップしてください。大きな Confluence インストールのユーザに関しては、Confluence の使用できる最大メモリを増加することができます。 (デフォルトは 256MB)。例えば、以下のコマンドを使って最大メモリを 512 MB に設定できます:

    tomcat6 //US//Confluence --JvmMx 512
    
  7. Confluence のディストリビューションに渡す JVM パラメータを持っていない場合は、このステップをスキップできます。その場合は、JVM パラメータをサービスに以下のコマンドを使って追加してください:

    tomcat6 //US//Confluence ++JvmOptions="-Djust.an.example=True"
    
  8. これ以上の設定オプションについては、Tomcat Windows サービスヘルプの案内をご参照ください。
  9. Go to your Windows Control Panel -> Administrative Tools -> Services -> Apache Tomcat Confluence and right-click on Properties to verify the settings are correct.

    (info) Confluence is now installed as a service, but will not automatically start up until the next server reboot
  10. コマンドで Confluence サービスを起動する:

    net start Confluence
    

Confluence をサービスとして管理

Confluence サービスをコマンド・プロンプトから管理することができます。

  • 下記ののコマンドで Confluence を停止してください:

    net stop Confluence
    
  • 下記ののコマンドで Confluence サービスをアンインストールしてください:

    service.bat remove Confluence
    

Confluence のアップグレード

Confluence をアップグレードした後、その Windows サービスをアンインストールまたは再インストールしたり、StartPath パラメータを新しいフォルダーに変更したりできます。ヘルプは、Tomcat ドキュメンテーションを参照してください。

Windows サービスとして実行している間の Confluence のトラブルシューティングConfluence をアップグレード

  • 上記の情報を見ても問題が解決しない場合は、サポート技術情報にある既知の問題の一覧(英語)をご覧ください。
  • メモリー関連の問題やバグを調べる場合は、Confluence のガベージコレクションからの情報が役に立つかもしれません。verbose ガベージコレクションを有効にするには、次のコマンドを利用してください:

    tomcat6 //US//Confluence ++JvmOptions="-Xloggc:<CONFLUENCE-INSTALL>\logs\atlassian-gc.log"
  • The Confluence 2.9 installer does not work when installed as service, due to a missing semi-colon in service.bat. Please refer to reported issue CONF-12785.
  • You can use a Sysinternals tool called Procmon.exe from the The Microsoft Windows Sysinternals Team, to check that the error occurred at the specific time when the Confluence service started. You need to match the time when Tomcat failed, as captured by this tool, against the time in the Windows Event Viewer.

    注意

    他のアトラシアン アプリケーションに支障が出る恐れがあるので、このツールを長時間実行することは推奨されません。必要な情報を取得できたら、Ctrl + E を押してツールを停止させてください。

サポートを受ける

上記のトラブルシューティングの案内に従っても Confluence を Windows のサービスとして実行できない場合、あるいはサービス実行のための jvm 設定中にエラーが生じる場合は、こちらでサポート依頼を作成できます。

サポートに必要となりますので、下記の情報をご記入ください:

  • ご利用中の Windows は、32 ビットですか、それとも 64 ビットですか?
  • Windows コマンド ライン コンソールでの java -version の実行結果。
  • Tomcat のスクリーンショットもしくは Windows レジストリ設定内容。
  • もし service.bat を変更しているのであれば、検証のためファイルのコピーを送ってください。
  • アプリケーションサーバは何をご利用ですか? 例えば Confluence distribution をご利用ですか?
  • あなたの atlassian-confluence.log ファイル。

関連トピック

Starting Confluence Automatically on System Startup
Fix java.lang.OutOfMemoryError in Confluence