Linux でアーカイブファイルから Confluence をインストール

このページの内容

お困りですか?

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

コミュニティに質問

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

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


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

  • 評価版 - 無料トライアルをすぐに利用できます。
  • インストーラー – Linux インストーラーを使用して Confluence をインストールします。 
  • Windows – Windows サーバー上に Confluence をインストールします。 

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 のバージョンのみです。

Confluence をサービスとして実行しますか?
詳細を読む...

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

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

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

  • Confluence インストール ディレクトリで start-confluence.sh ファイルを実行して Confluence を開始します。
  • Confluence を実行する専用ユーザーの作成をお勧めします。このユーザーはインストールディレクトリおよびホームディレクトリに対する完全な読取り、書き込み、および実行権限を持つ必要があります。
  • サーバーが再起動される場合、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} をレンダリングできません。ページが見つかりませんでした)] を選択し、

JAVA_HOME 変数が正しく設定されていますか?
詳細を読む...

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

Confluence は Oracle JDK または JRE でのみ実行可能です。

ご使用の Java バージョンを確認するには:

$ java -version

JAVA_HOME 変数が正しく設定されていることを確認するには:

$ echo $JAVA_HOME

Java インストール ディレクトリへのパスが表示される場合、JAVA_Home 環境変数は正しく設定されています。パスが返されない場合、Jira をインストールする前に JAVA_HOME 環境変数を手動で設定する必要があります。

Confluence を実行するために専用ユーザーを作成しましたか?
詳細を読む...

専用ユーザーとして Confluence を実行することを強くお勧めします。

開始する前にこのユーザーを作成してください。こにより、インストールディレクトリおよびホームディレクトリの作成時に、このユーザーに適切な読み取りおよび書き込み権限を付与できます。

この例では、confluence というユーザーを作成します。

$ sudo /usr/sbin/useradd --create-home --comment "Account for running Confluence" --shell /bin/bash confluence

詳細は、「オペレーティングシステム上に専用ユーザーアカウントを作成して Confluence を実行する」を参照してください。

セットアップ中に、ロード バランサ (またはプロキシ) がサーバーに ping を実行して、Confluence のインストールまたは Data Center への移行が中断する既知の問題があります。CONFSERVER-61189 - Getting issue details... (課題情報を取得中...) STATUS をご参照ください。
インストール時に、ロード バランサのヘルス チェックを無効にして、同じ Confluence URL を指す複数のタブを開かないようにする必要があります。

Confluence のインストール

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

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

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

  1. インストール ディレクトリの作成 – これは Confluence がインストールされる場所です。パスにスペースや特殊文字を使用しないでください。このディレクトリを <installation-directory> と呼びます。
     

    手順について

    この例では、インストール ディレクトリを confluence と呼びます。

    $ mkdir confluence
  2. Confluence の tar.gz ファイルを <installation-directory> に展開します。特に Solaris では、アーカイブ ユーティリティの GNU バージョンを使用することをお勧めします。
     

    手順について

    Confluence をダウンロードしたディレクトリに移動し、次のコマンドを実行します。

    $ tar -xzf atlassian-confluence-X.X.X.tar.gz -C <installation-directory>
    $ cd <installation-directory>
    $ tar -xf atlassian-confluence-X.X.X.tar

    x.x.x をご使用の Confluence バージョンで、<installation-directory> を直前のステップで作成したディレクトリの絶対パスで置き換えます。

  3. Confluence 専用ユーザーに、<installation-directory> に対する読み取り、書き込み、および実行権限を付与します。
     

    手順について

    この例では、インストール ディレクトリの所有権を変更し、ユーザー confluence に読み取り、書き込み、および実行権限を付与しています。

    $ chown -R confluence <installation-directory>
    $ chmod -R u=rwx,go-rwx <installation-directory>

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

  1. ホーム ディレクトリの作成 – ホーム ディレクトリは、ログ、検索インデックス、ファイルなどの Confluence のアプリケーション データが保存される場所です。インストール ディレクトリとは別に作成し、パスには空白や特殊文字を使用しないでください。このディレクトリを <home-directory> と呼びます。
     

    手順について

    この例では、ホーム ディレクトリを confluence-home と呼びます。

    $ mkdir confluence-home
  2. Confluence 専用ユーザーに、<home-directory> に対する読み取り、書き込み、および実行権限を付与します。 

    手順について

    この例では、ホーム ディレクトリの所有権を変更して、ユーザー confluence に読み取り、書き込み、および実行権限を付与しています。

    $ chown -R confluence <home-directory>
    $ chmod -R u=rwx,go-rwx <home-directory>
  3. <installation-directory>\confluence\WEB-INF\classes\confluence-init.properties を編集します。
  4. ファイルの下部に <home-directory> への絶対パスを入力します。このパスに基づいて、Confluence は起動時に <home-directory>  の場所を見つけます。
     

    手順について

    confluence-init.properties ファイルは任意のテキスト エディタで編集できます。

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

      # confluence.home=c:/confluence/data
      
    2. この行の先頭にある # と空白を削除し (これにより、Confluence は行をコメントとして扱わなくなります) 、ホーム ディレクトリへの絶対パス (シンボリック リンクとは異なる) を追加します。例:

      confluence.home=/var/confluence-home

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" />

Linux では 1024 番未満のポートにバインドできません。たとえば、Confluence をポート 80 で実行する場合、リバースプロキシを使用してトラフィックをポート 80 からリダイレクトできます。「Apache で mod_proxy を使用する」を参照してください。

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

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

手順について

以下の例では、tar.gz ファイルが抽出されて /opt/atlassian/confluence というディレクトリに保存され、confluence というユーザーが Confluence ランタイム環境用に作成されていると仮定しています。

これらのコマンドは、Confluence インストール フォルダーの親ディレクトリから実行する必要があります。したがって、この例では、コマンドは /opt/atlassian から実行されます

export install_dir=/opt/atlassian/confluence
export username=confluence

chmod -R 550 "$install_dir"

# Permission 700 for "work" / "temp" and "log" folders are important to run Confluence properly
chmod -R 700 "$install_dir/work"
chmod -R 700 "$install_dir/temp"
chmod -R 700 "$install_dir/log"

chown "$username" "$install_dir"
chown -R "$username" "$install_dir/bin"
chown -R "$username" "$install_dir/conf"
chown -R "$username" "$install_dir/confluence"
chown -R "$username" "$install_dir/jre"
chown -R "$username" "$install_dir/lib"
chown -R "$username" "$install_dir/synchrony-proxy"
chown -R "$username" "$install_dir/webapps"

次のようになります。

xyz:/opt/atlassian/confluence$ ls -la
total 404
drwxr-xr-x 14 confluence root   4096 Jan  9 14:26 .
drwxr-xr-x  3 root       root   4096 Jan  9 14:25 ..
drwxr-xr-x  3 root       root   4096 Jan  9 14:26 .install4j
-r-xr-x---  1 root       root  20577 Jan  5 12:53 BUILDING.txt
-r-xr-x---  1 root       root   6375 Jan  5 12:53 CONTRIBUTING.md
-r-xr-x---  1 root       root  58153 Jan  5 12:53 LICENSE
-r-xr-x---  1 root       root   2401 Jan  5 12:53 NOTICE
-r-xr-x---  1 root       root   2324 Jan  5 12:53 README.html
-r-xr-x---  1 root       root   3479 Jan  5 12:53 README.md
-r-xr-x---  1 root       root   1224 Jan  5 12:53 README.txt
-r-xr-x---  1 root       root   7075 Jan  5 12:53 RELEASE-NOTES
-r-xr-x---  1 root       root  16982 Jan  5 12:53 RUNNING.txt
dr-xr-x---  3 confluence root   4096 Jan  9 14:25 bin
dr-xr-x---  3 confluence root   4096 Jan  9 14:25 conf
dr-xr-x--- 26 confluence root   4096 Jan  9 14:25 confluence
-rw-r--r--  1 root       root 122407 Jan  9 14:26 install.reg
dr-xr-x---  7 confluence root   4096 Jan  9 14:25 jre
dr-xr-x---  2 confluence root   4096 Jan  9 14:25 lib
dr-xr-x---  2 root       root  77824 Jan  9 14:25 licenses
drwx------  2 confluence root   4096 Jan  9 14:26 logs
dr-xr-x---  4 confluence root   4096 Jan  9 14:25 synchrony-proxy
drwx------  3 confluence root   4096 Jan  9 14:26 temp
-rwx------  1 root       root  13586 Jan  5 12:53 uninstall
dr-xr-x---  2 confluence root   4096 Jan  5 12:53 webapps
drwx------  3 confluence root   4096 Jan  9 14:26 work

注: バイナリの Linux インストーラーを選択した場合、Confluence インスタンスのインストール フォルダーはインストーラー スクリプトによって自動的に管理されます。

6. Confluence の起動

  1. <installation-directory>/bin/start-confluence.sh を実行してセットアップ プロセスを開始します。
      

    手順について

    専用ユーザーとして Confluence を実行することをお勧めします。

    $ su -u <user>
    $ ./start-confluence.sh

    Ubuntu を使用している場合は、コマンドは次のように少し異なります。

    $ sudo su <user>
    $ ./start-confluence.sh
  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 のインストールで問題が生じていますか?

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

最終更新日 2024 年 4 月 2 日

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

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