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>;
- Specify the
tablespace
for the table objects as shown above. connect
ロールは、接続のセットアップに必要です。resource
ロールは、ユーザーが独自のスキーマでオブジェクトを作成できるようにするために必要です。resource
ロールには初期設定でcreate table
、create sequence
、create trigger
が含まれます。resource
ロールを変更してこれらを削除した場合は、これらの権限をユーザーに直接付与するか、他のロールを通じて付与する必要があります。- Don't grant the
select any table
permission as this can cause problems with other schemas. Confluence 7.130 - 7.13.5 only: It is very important that the user is granted the exact privileges indicated above. Confluence requires only these privileges so you should grant specific privileges to the user. create table, create sequence, and create trigger shouldn't be assigned as part of a role.
- Specify the
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.