Windows で Zip ファイルから Confluence をダウンロード

このページの内容

お困りですか?

アトラシアン コミュニティをご利用ください。

コミュニティに質問

このガイドでは、zip ファイル使用して、外部データベースのある本番環境に手動で Confluence をインストールする方法を説明します。

この方法では、インストールプロセスをユーザーが最大限制御できます。


Confluence をインストールするその他の方法: 

  • 評価版 - 無料トライアルをすぐに利用できます。
  • インストーラー – Windows インストーラーを使用して Confluence をインストールします。 
  • Linux – Confluence を Linux オペレーティングシステム上にインストールします

On this page:

はじめる前に

Confluence をインストールする前に、いくつかの質問に答える必要があります。 


サポートされているオペレーティングシステムと Java のバージョンを使用していますか?
これについて詳しく

サポート対象プラットフォーム ページでインストールする Confluence のバージョンを確認してください。このページでは、サポート対象のオペレーティングシステム、データベースおよびブラウザーに関する情報を提供しています。

参考情報

  • 本番環境では、OS X または Mac OS への Confluence のインストールはサポートされていません。
  • Adoptium OpenJDK (旧 AdoptOpenJDK) または Oracle JDK のどちらかをインストールする必要があります。その他の OpenJDK バイナリはサポート対象外です。
  • JDK (Java Development Kit) または JRE (Java Runtime Environment)のいずれかを使用することができます。
  • サポートされているのは、Confluence とバンドルされている Apache Tomcat のバージョンのみです。

Windows Service として Confluence を実行しますか?
これについて詳しく

Windows でサービスとして Confluence を実行するとは、Windows が起動されると、Confluence が自動的に始動することを意味します。

サービスとして Confluence を実行する場合は Windows インストーラーを使用してください。

Confluence をサービスとして実行しないことを選択する場合:

  • Confluence インストール ディレクトリの start-confluence.bat ファイルを実行して Confluence を開始します。
  • Confluence は、Confluence のインストールに使用された Windows ユーザーアカウントとして実行されます。または、専用ユーザーとして実行する選択もできます (このユーザーには、インストールディレクトリとホームディレクトリへの完全な読み取りおよび書き込みアクセス権限が必要です)。
  • サーバーが再起動される場合、Confluence を手動で再起動する必要があります。
ポート 8090 と 8091 は使用できますか?
詳細を読む...

Confluence はデフォルトで、ポート 8090 上で実行します。このポートが使用中の場合、インストーラーによって別のポートを選択するよう求められます。

共同編集に必要な Synchrony は、ポート 8091 で実行されます。このポートが既に使用されている場合は、Confluence インストールが完了した後で、Synchrony を実行するポートを変更する必要があります。Synchrony を実行するポートの変更方法については、共同編集の管理を参照してください。Synchrony がポートを利用できるようになるまで、ページを編集することはできません。

使用されるすべてのポートの概要については、「アトラシアン アプリケーションで使用するポート」を参照してください。

どのデータベースを使用することを計画していますか? 
これについて詳しく

Confluence を実行するには、外部データベースが必要になります。インストールするバージョンのサポート対象プラットフォーム ページで、現在サポートされているデータベースのリストを確認してください。データベースをまだ用意していない場合、無料の PostgreSQL であればセットアップが簡単です。

参考情報

Confluence ライセンスをお持ちですか?

これについて詳しく

Confluence を使用するには、有効なライセンスが必要です。

参考情報

  • Confluence ライセンスをまだ購入していない場合は、セットアップ中に評価版ライセンスを作成できます。
  • ライセンス キーをお持ちの場合は、my.atlassian.com にログインして取得するように促すプロンプトが表示されます。セットアップ中にライセンス キーを手動で入力することもできます。
  • Confluence Cloud から移行する場合、新しいライセンスが必要です。
  • [Unable to render {include} The included page could not be found. ({include} をレンダリングできません。ページが見つかりませんでした)] を選択し、

JRE_HOME 変数が正しく設定されていますか?
これについて詳しく

Confluence をインストールする前に、サポート対象の Java バージョンを実行していることと、JRE_HOME (または JAVA_HOME) 環境変数が正しく設定されていることを確認します。

JRE_HOME 変数を確認する方法:

コマンド プロンプトを開いて「echo %JRE_HOME%」と入力し、Enter を押します。 

  • Java インストール ディレクトリへのパスが表示される場合、JRE_Home 環境変数は正しく設定されています。
  • 何も表示されない場合、または %JRE_HOME% のみ返される場合、JRE_HOME 環境変数を手動で設定する必要があります。ガイドの「Windows での JAVA_HOME 変数の設定 」を参照してください。

There’s a known issue during setup where a load balancer (or proxy) pings the server and breaks Confluence installation or migration to Data Center. See CONFSERVER-61189 - Getting issue details... STATUS
During installation, you need to disable load balancer health checks and make sure you don’t open multiple tabs that point to the same Confluence URL.

Confluence のインストール

1. Confluence をダウンロードする

ご使用のオペレーティング システムに対応した zip ファイルを https://www.atlassian.com/software/confluence/download からダウンロードします。 

2. インストールディレクトリの作成

  1. インストール ディレクトリを (Confluence の実行に使用する専用の Windows 管理者アカウントのための完全な制御権限を付与して) 作成します。ここに、Confluence をインストールします。パスには特殊文字やスペースは使用しません。このディレクトリがお客様の <installation-directory> として参照されます。

  2. Confluence の zip  ファイルを <installation-directory> に展開します。7zip または Winzip の使用をお勧めします。

3. ホームディレクトリの作成

  1. ホーム ディレクトリの作成 (完全な制御権限が必要) – ホーム ディレクトリは、ログ、検索インデックスおよびファイルなどの Confluence データが保存される場所です。このディレクトリはインストール ディレクトリとは別にします。このディレクトリを <home-directory> と呼びます。 
  2. <installation-directory>\confluence\WEB-INF\classes\confluence-init.properties を編集します。
  3. ファイルの下部に <home directory> へのパスを入力します。

    手順について

    メモ帳またはその他のテキストエディターで confluence-init.properties ファイルを編集できます。

    1. この行までテキストをスクロールします:

      # confluence.home=c:/confluence/data
      
    2. この行の先頭の '#' とスペースを削除します (これにより、Confluence はこの行をコメントと認識しません)。

      confluence.home=c:/data/confluence-home
    3. 別のディレクトリをホームディレクトリとして使用する場合:
      • ディレクトリまたはファイル名のスペースを使用しない。
      • このファイルでパスを定義するにはスラッシュ '/' を使用します。

4. ポートの確認

既定では、Confluence はポート 8090 をリッスンします。同じポートを使用する別のアプリケーションをサーバー上で実行している場合、Confluence が別のポートを使用するように指定します。 

手順について

ポートを変更する方法

  1. <installation-directory>\conf\server.xml を編集します。

  2. サーバーポート (8000) およびコネクタポート (8090) を変更してサーバー上のポートを解放します。

    以下の例では、サーバーポートを 5000、コネクタポートを 5050 に変更しました。

    Server port="5000" shutdown="SHUTDOWN" debug="0">
      <Service name="Tomcat-Standalone">
        <Connector port="5050" connectionTimeout="20000" redirectPort="8443"
            maxThreads="48" minSpareThreads="10"
            enableLookups="false" acceptCount="10" debug="0" URIEncoding="UTF-8"
            protocol="org.apache.coyote.http11.Http11NioProtocol" />

5. ディレクトリのセキュリティを強化する 

ファイルとフォルダーの権限のレイヤーを追加することで、<installation-directory> のセキュリティを強化します。

手順について

以下の例では、Confluence の zip ファイルが抽出されて C:\Program Files\Atlassian\Confluence というディレクトリに保存され、confluence というユーザーが Confluence ランタイム環境用に作成されていると仮定しています。

これらのコマンドは、 Windows のコマンド プロンプトで実行されるように設計されています。

これらのコマンドは Confluence インストールから実行する必要があるので、この例では C:\Program Files\Atlassian\Confluence となります。

icacls . /inheritance:d /t /c
icacls . /remove BUILTIN\Users /t /c
icacls . /remove "CREATOR OWNER" /t /c

icacls . /remove:g "confluence" /t /c
icacls ../confluence /grant "confluence":(RX) /t /c
icacls ../confluence /grant %USERNAME%:(RX) /t /c

rem grant full permissions to work / temp and logs folder
icacls work /grant "confluence":(OI)(CI)(F) /t /c
icacls temp /grant "confluence":(OI)(CI)(F) /t /c
icacls logs /grant "confluence":(OI)(CI)(F) /t /c

Confluence インストール フォルダーの権限を制限する上記スクリプトに加えて、Confluence ホーム フォルダーのセキュリティを強化するために次のスクリプトも実行する必要があります。

したがって、この例では、C:\Program Files\Atlassian\Application Data\Confluence からもコマンドを実行します。

目標は BUILTIN\Users グループに属する非管理者ユーザーの Confluence ホーム フォルダーへのアクセスを削除することです。

icacls . /inheritance:d /t /c
icacls . /remove BUILTIN\Users /t /c
icacls . /remove "CREATOR OWNER" /t /c

6. Confluence の起動

  1. <installation-directory>/bin/start-confluence.bat を実行してインストール プロセスを開始します。専用のユーザー アカウントを使用することをお勧めします。

    コマンド プロンプトが開きます。このウィンドウを閉じると Confluence は停止します。
     
  2. ブラウザで http://localhost:8090/ に進みConfluence を起動します (コネクタ ポートを更新した場合はポートを変更します)。
Confluence の起動で問題が発生していますか?


Confluence のセットアップ

7. インストールタイプを選択する

  1. 本番インストールを選択します。
      
  2. 他にインストールしたいアプリがあれば、それを選択します。

8. ライセンスの入力

Follow the prompts to log in to my.atlassian.com to retrieve your license, or enter a license key. 

9. データベースへの接続

  1. まだ実行していない場合は、ここでデータベースを作成します。詳細と接続オプションについては、このページの「始める前に」セクションを参照してください。 
     
  2. MySQL および Oracle の場合は、プロンプトに従い、必要なドライバーをダウンロードしてインストールします。  

  3. データベースの詳細を入力します。テスト接続を使用して、データベースが正しく設定されていることを確認します。

    高度なセットアップ オプション...

    特定のパラメーターを指定したい場合は、接続文字列で接続するよう選択できます。以下の内容を入力するよう指示されます:

    • データベース URL – データベースの JDBC URL。不明な場合は、データベースのドキュメント確認してください。
    • ユーザー名およびパスワード – Confluence がユーザーのデータベースにアクセスするために使用できる有効なユーザー名とパスワードです。

10. 新しいサイトにコンテンツを追加する

Confluence を使用してサイトにコンテンツを追加するかどうかを選択します。
 
デモ用スペース...

 これは、Confluence を理解するためにあなたとユーザーが使用できるスペースを作成するオプションです。このスペースはいつでも削除できます。

既存のサイトからデータをインポート...

既存の Confluence サイトのサイト全体のエクスポートがある場合にこのオプションを使用します。これは、別のデータベースへの移行やテストサイトの設定を行うときに便利です。  

参考情報

  • インポートできるのは、同じまたは前の Confluence バージョンのサイトのみです。
  • 以前にインストールした Confluence から、システム管理者のアカウント情報をはじめとするすべてのユーザーデータとコンテンツがインポートされます。

セットアップウィザードにて :

  • バックアップファイルのアップロード – サイトのエクスポートファイルのサイズが小さい場合 (25mb 以下) 、このオプションを使用します。
  • バックアップ ファイルをファイル システムから復元– バックアップ ファイルの容量が大きい場合はこのオプションを使用します。ファイルを <confluence-home>/restore ディレクトリにドロップし、プロンプトに従ってバックアップを復元します。

  • インデックスの作成 – インポートしたコンテンツを検索できるようにするには、インデックスを作成する必要があります。大規模サイトの場合は長時間かかるため、後でインデックスを作成したい場合は、選択解除します。インデックスが作成されるまでコンテンツは検索できません。

11. ユーザーを管理する場所を選択する

Confluence のユーザーおよびグループを Confluence 内で管理するか、Jira Software や Jira Service Management などの Jira アプリケーションで管理するかを選択します。
 
Confluence でユーザーおよびグループを管理...

Confluence でユーザーを管理する場合、またはインストール済みの Jira アプリケーションがない場合はこのオプションを選択します。

参考情報

  • Jira アプリケーションでユーザーを管理する予定で、まだ Jira アプリケーションをインストールしていない場合、Jira をインストールしてから Confluence のセットアップを再開することをおすすめします。
  • あとから外部のユーザー管理 (LDAP、Crowd または Jira) を追加することもできます。
Jira への接続...

 インストール済みの Jira アプリケーションがあり、両方のアプリケーションにわたってユーザーを管理する場合は、このオプションを選択します。

参考情報

  • これは、もっとも一般的なオプションの場合に Jira 連携をすばやくセットアップする方法です。 
  • Jira のユーザー ディレクトリが Confluence で使用できるように構成され、Jira と Confluence の間でアプリケーション リンクがセットアップされるため、データを容易に共有できるようになります。
  • Jira アプリケーションのどのグループを Confluence にログインできるようにするかを指定できます。各アプリケーションでライセンス階層が同じである必要はありません。 
  • Jira 4.3 以降、Jira Core 7.0 以降、Jira Software 7.0 以降、または Jira Service Management 3.0 以降のいずれかが必要です。

セットアップウィザードにて :

  • Jira ベース URL - ご使用の Jira サーバーのアドレス。たとえば、http://www.example.com:8080/jira/ または http://jira.example.com/

  • Jira 管理者ログイン – これは、Jira アプリケーションで Jira システム管理者グローバル権限を持つユーザーアカウントのユーザー名とパスワードです。Confluence も、このユーザー名とパスワードを使用してローカル管理者アカウントを作成し、これによって Jira が使用できない場合でもこのアカウントで Confluence にアクセスできます。このアカウントは Confluence の内部ユーザー ディレクトリに保存されるため、Jira でパスワードを変更しても、Confluence 側で自動的に更新されることはありません。
  • Confluence ベース URL - この URL を使用して、Jira はご使用の Confluence サーバーにアクセスします。ここで指定する URL は、Confluence で Jira アプリケーションに接続するために指定されたベース URL をオーバーライドします。
  • ユーザー グループ - 次の Jira グループでは、メンバーに Confluence の使用が許可されます。これらのグループのメンバーは、Confluence の "Confluence の使用" 権限を付与され、Confluence ライセンスに計上されます。既定のユーザー グループ名は、次のように Jira バージョンによって異なります。
    • Jira 6.4 以前: jira-users 
    • Jira Software 7.x 以降: jira-software-users
    • Jira Core 7.x 以降: jira-core-users
    • Jira Service Management (旧 Jira Service Desk) 3.x 以降: jira-servicedesk-users
  • グループの管理 – Confluence への管理アクセス権を持つメンバーを含む Jira グループを 1 つ以上指定します。既定のグループは jira-administrators です。これらのグループは、Confluence でシステム管理者および Confluence 管理者のグローバル権限を付与されます。

12. 管理者アカウントの作成

管理者アカウントの詳細情報を入力します。  

Jira アプリケーションでユーザー管理を行う場合や、既存のサイトからデータをインポートした場合は、このステップをスキップします。 

13. Confluence の使用を開始する

これで準備完了です。Confluence サイトは、次のような URL http://<computer_name_or_IP_address>:<port> からアクセスできます。

リバース プロキシの背後で Confluence を実行する予定がある場合は、先へ進める前にプロキシと SSL の考慮事項を確認してください。 

チームの立ち上げと運営に役立つ情報を以下に挙げます。

トラブルシューティング

Confluence のインストールで問題が生じていますか?
  • 初めて Confluence にアクセスしようとして Web ブラウザーウィンドウにエラーが表示された場合、30 秒程度待機してからページを更新します。
  • コマンドプロンプトウィンドウをすぐに閉じると JAVA_HOME 変数が正しく設定されない場合があります。「Windows での JAVA_HOME 変数の設定」を参照してください。 

 詳細は、ナレッジベースの「インストールのトラブルシューティング」を参照してください。  

最終更新日: 2024 年 10 月 3 日

この内容はお役に立ちましたか?

はい
いいえ
この記事についてのフィードバックを送信する
Powered by Confluence and Scroll Viewport.