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

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

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

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

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

はじめる前に

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

サポートされているオペレーティングシステムと Java のバージョンを使用していますか?	詳細を読む... [Unable to render {include} The included page could not be found. ({include} をレンダリングできません。ページが見つかりませんでした)] を選択し、
Confluence をサービスとして実行しますか?	詳細を読む... サービスとして Confluence を実行するとは、Linux サーバーが起動されると、Confluence が自動的に始動することを意味します。 Confluence をサービスとして実行する場合、Linux インストーラーを使用してください。 Confluence をサービスとして実行しないことを選択する場合: Confluence インストールディレクトリで `start-confluence.sh` ファイルを実行して Confluence を開始します。 Confluence を実行する専用ユーザーの作成をお勧めします。このユーザーはインストールディレクトリおよびホームディレクトリに対する完全な読取り、書き込み、および実行権限を持つ必要があります。サーバーが再起動される場合、Confluence を手動で再起動する必要があります。
ポート 8090 と 8091 は使用できますか?	詳細を読む... Error rendering macro 'includeplus' User 'anonymous' does not have permission to view the page with ID 859451395.
どのデータベースを使用することを計画していますか？	詳細を読む... Error rendering macro 'includeplus' User 'anonymous' does not have permission to view the page with ID 1044091858.
Confluence ライセンスをお持ちですか?	詳細を読む... Error rendering macro 'includeplus' User 'anonymous' does not have permission to view the page with ID 1044091867.
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 - 課題詳細を取得中... ステータス」をご参照ください。
インストール中はロードバランサーのヘルスチェックを無効にして、同じ Confluence URL を指す複数のタブを開かないようにする必要があります。

Confluence のインストール

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

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

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

インストールディレクトリの作成 – これは Confluence がインストールされる場所です。パスにスペースや特殊文字を使用しないでください。このディレクトリを <installation-directory> と呼びます。
手順について
この例では、インストールディレクトリを confluence と呼びます。
$ mkdir confluence
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> を直前のステップで作成したディレクトリの絶対パスで置き換えます。
Confluence 専用ユーザーに、<installation-directory> に対する読み取り、書き込み、および実行権限を付与します。
手順について
この例では、インストールディレクトリの所有権を変更し、ユーザー confluence に読み取り、書き込み、および実行権限を付与しています。
$ chown -R confluence <installation-directory> $ chmod -R u=rwx,go-rwx <installation-directory>

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

ホームディレクトリの作成 – ホームディレクトリは、ログ、検索インデックス、ファイルなどの Confluence のアプリケーションデータが保存される場所です。インストールディレクトリとは別に作成し、パスには空白や特殊文字を使用しないでください。このディレクトリを <home-directory> と呼びます。
手順について
この例では、ホームディレクトリを confluence-home と呼びます。
$ mkdir confluence-home
Confluence 専用ユーザーに、<home-directory> に対する読み取り、書き込み、および実行権限を付与します。
手順について
この例では、ホームディレクトリの所有権を変更して、ユーザー confluence に読み取り、書き込み、および実行権限を付与しています。
$ chown -R confluence <home-directory> $ chmod -R u=rwx,go-rwx <home-directory>
<installation-directory>\confluence\WEB-INF\classes\confluence-init.properties を編集します。
ファイルの下部に <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 が別のポートを使用するように指定します。

手順について

ポートを変更する方法

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

サーバーポート (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. Confluence の起動

<installation-directory>/bin/start-confluence.sh を実行してセットアッププロセスを開始します。
手順について
専用ユーザーとして Confluence を実行することをお勧めします。
$ su -u <user> $ ./start-confluence.sh
Ubuntu を使用している場合は、コマンドは次のように少し異なります。
$ sudo su <user> $ ./start-confluence.sh
ブラウザで http://localhost:8090/ に進み、Confluence を起動します (コネクタポートを更新した場合はポートを変更します)。

Confluence の起動で問題が発生していますか?

JAVA_HOME 変数が正しく設定されていることを確認します。
エラーが表示された場合は、「Spring Framework のエラーが原因で Confluence Data Center が起動しない」でトラブルシューティングの方法をご確認ください。