Oracle データベースセットアップ
このページは、Confluence を設定して Oracle データベースを利用する方法を解説します。
始める前に
- ご使用の Oracle のバージョンがサポート対象であるかどうかについては、「サポート対象プラットフォーム」を参照してください。Confluence をインストールする前にデータベースのアップグレードが必要になる場合があります。
- 別のデータベース (組み込みの評価データベースを含む) から切り替える場合、「別のデータベースへの移行」をお読みください。
データベースのセットアップと維持には経験豊富な Oracle データベース管理者 (DBA) が必要です。
アトラシアンのサポート チームは Confluence の問題をサポートすることはできますが、Oracle データベースの管理をお手伝いすることはできません。
経験豊富な Oracle DBA がいない場合、別のサポート対象データベースを使用することを検討してください。
1. Oracle をインストールする
使用可能な Oracle サーバーがまだインストールされていない場合、今すぐダウンロードしてインストールします。手順については、Oracle のドキュメントを参照してください。
Oracle サーバーを設定する場合、次の点にご注意ください。
- 文字エンコーディングは、AL32UTF8 (Unicode UTF-8 と同等の Oracle エンコーディング) に設定する必要があります。
2. データベース ユーザーを作成する
ユーザーを作成し、権限を割り当てる方法：
sqlplusコマンドを使用してコマンド ラインから Oracle にアクセスします。sqlplus user/password <as sysdba|as sysoper>ユーザー "sys" を使用してログインしている場合は、"as sysdba" または "as sysoper" を含めて、使用する sys ロールを決定する必要があります。
Confluence ユーザー (例:
confluenceuser) を作成し、そのユーザーに次の権限のみを付与します。create user <user> identified by <password> default tablespace <tablespace_name> quota unlimited on <tablespace_name>; grant connect to <user>; grant resource to <user>; grant create table to <user>; grant create sequence to <user>; grant create trigger to <user>;上記に示された権限と完全に一致する権限をユーザーが付与されていることが非常に重要です。Confluence ではこれらの権限のみを必要とします。そのため、ユーザーに 特定の権限を付与する必要があります。テーブルの作成、シーケンスの作成、および トリガーの作成をロールの一部として割り当てることはできません。
ユーザーに
select any table権限を付与しないでください。この権限は、他のスキーマで問題を発生させる可能性があります。ユーザーの作成時に、上記のように、テーブル オブジェクト用の
tablespaceを指定します。
3. Confluence のインストール
お使いのオペレーティング システムに Confluence をインストールするための詳細な手順については、Confluence インストール ガイドを確認してください。
4. Oracle シン ドライバをダウンロードおよびインストールする
ライセンス上の制約のため、Oracle ドライバは Confluence にバンドルされていません。データベース ドライバを Confluence で使用できるようにするには、次の手順を実行します。
- Confluence を停止します。
- データベース JDBC ドライバに進み、適切なドライバをダウンロードします。ドライバ ファイルは
ojdbc8.jarのようになります。 - .jar ファイルを
<installation-directory>/confluence/WEB-INF/libディレクトリにドロップします。 - Confluence を再起動してから、ブラウザで
http://localhost:<port>を開き、セットアップ プロセスを続行します。
5. データベースの詳細を入力する
Confluence セットアップ ウィザードを利用して、お使いのデータベースに Confluence を接続できます。
JDBC 接続を使用する (既定)
データベースへの接続には JDBC の使用を推奨します。
Confluence セットアップ ウィザードは 2 つのセットアップ オプションを提供します。
- シンプル - 最も簡単にデータベースに接続する方法です。
- 接続文字列を使用 - 追加パラメーターを指定する必要があり、データベース URL の作成に慣れている場合は、このオプションを使用します。
セットアップ タイプに応じて、次の情報を求めるプロンプトが表示されます。
| セットアップ タイプ | フィールド | 説明 |
|---|---|---|
| simple | ホスト名 | データベース サーバーのホスト名または IP アドレス。 |
| simple | ポート | Oracle ポートです。Oracle をインストールした際にポートを変更していなければ、既定の 1521 になります。 |
| simple | サービス名 | Confluence データベースのサービス名です。 |
| 接続文字列を使用 | データベース URL | データベース URL は次の形式で入力されます。 <SERVICE> は SID またはサービス名にすることができます。例: 既定では、シン ドライバで提供された新しいスタイルの URL を使用します。 |
| 両方 | ユーザ名 | 専用データベース ユーザーのユーザー名 (上記の例では confluenceuser)。 |
| 両方 | パスワード | 専用データベース ユーザーのパスワードです。 |
JNDI データソースを使用する
JNDI データソースを使用したい場合、Confluence をセットアップする前に必要な手順を「データソース接続の設定」で確認してください。セットアップ ウィザードは Tomcat 構成内のデータソースを検出した場合にのみ、データソースを使用するオプションのみを提供します。
6. データベース接続のテスト
データベースのセットアップ画面で [テスト接続] ボタンをクリックすると、次の点をチェックできます。
- Confluence データベースがご利用のデータベース サーバーに接続できること
- データベースの文字エンコーディングが正しいこと
- データベース ユーザーがデータベースに対する適切な権限を持っていること
- データベース ユーザーに SELECT ANY TABLE 権限が付与されていないこと
テストが成功したら、[次へ] をクリックして Confluence のセットアップ プロセスを続行します。
トラブルシューティング
- Confluence がクラスファイルを欠いていると訴えた場合は、JDBC ドライバーを誤ったフォルダに配置した可能性があります。
- 次のページでは、Confluence と使用するために Oracle データベースをセットアップする際に発生する一般的な問題を扱っています: 「Oracle に関する既知の問題」
- There's a known issue when running Oracle with Native Network Encryption that can cause Confluence to become unresponsive. See CONFSERVER-60152 - Getting issue details... STATUS for more details and Confluence Unresponsive Due to High Database Connection Latency for some suggested mitigation strategies.
- There's a known issue when username or schema names contain dots. See CONFSERVER-60274 - Getting issue details... STATUS for more information.