SQL Server データベースセットアップ

ステップ 3. SQL Server データベースとユーザー情報のセットアップ

このステップでは、Confluence のデータを保存するための SQL Server データベースを作成し、データベースへのアクセス権限を有するユーザー情報を設定します。

1. 使用する文字エンコードを指定します。このためには、アプリケーションサーバーおよび Confluence で使用中の文字エンコードを確認する必要があります。SQL Server を含めた 3 台すべてで互換性のある文字エンコードを使用しなければなりません。例えば、SQL Server のデフォルトの文字エンコードである UCS-2 は、UTF-8 と互換性があります。
2. SQL 管理者権限を用いて SQL サーバーに新しいデータベースを作成します。
3. アプリケーションサーバーおよび Confluence に対して UCS-2 と互換性のない文字エンコードを設定してある場合は、それと同じ文字エンコードをデータベースにも設定します。

4. デフォルトのデータベース照合順序を、'SQL_Latin1_General_CP1_CS_AS' (大文字と小文字の区別があります) に設定します。この設定は、次の SQL クエリを発行することによって行われます:

   ALTER DATABASE <database_name> COLLATE SQL_Latin1_General_CP1_CS_AS

   
   注意: 'The database could not be exclusively locked to perform the operation' のエラーメッセージが表示された場合は、次のようにデータベースをシングルユーザーモードに変更して他のユーザーからの接続を拒否しなければならない可能性があります:

   ALTER DATABASE <database_name> SET SINGLE_USER WITH ROLLBACK IMMEDIATE;
   <your ALTER DATABASE query>
   ALTER DATABASE <database_name> SET MULTI_USER;

   
   

5. データベースの分離レベルを、'Read Committed with Row Versioning' に設定します。この設定は、次の SQL クエリを発行することによって行われます:

   READ_COMMITTED_SNAPSHOT を有効にするか決めてください

   SELECT is_read_committed_snapshot_on FROM
   sys.databases WHERE name= 'YourDatabase' 

   戻り値:
   1 = READ_COMMITTED_SNAPSHOT オプションはオンです。この場合、コミットされたデータのみを読み取る分離レベルにおける読み取り処理はスナップショットスキャンをベースとし、ロックは全く使用しません。

   0 = READ_COMMITTED_SNAPSHOT オプションはオフです (デフォルトの設定)。この場合、コミットされたデータのみを読み取る分離レベルにおける読み取り処理は共有ロックを使用します。

   ALTER DATABASE <database_name>
      SET READ_COMMITTED_SNAPSHOT ON
      WITH ROLLBACK IMMEDIATE;
   

6. Using your SQL administrator permissions, create a new SQL user account for Confluence (for example, confluenceuser). Give this user full create, read and write permissions for the database tables. Note that Confluence must be able to create its own schema.

ステップ 4. Confluence、および SQL Server データベースドライバーのインストール

SQL Server への接続方法として JDBC 直接接続またはデータソース接続のどちらを使用するかを、利用環境に合わせて決めておいてください。分からないときは JDBC 直接接続を使用してください。

Confluence のインストールを行っていない場合は、ここでインストールしてください。Confluence インストールガイドをご覧ください。

• SQL Server への JDBC 直接接続を使用する場合は、Confluence のインストールを行った後、下記の説明に従って直ちに Confluence セットアップウィザードに進んでください。SQL Server JDBC ドライバーは Confluence に組み込まれています。参考ページ: Database JDBC Drivers。
• SQL Server へのデータソース接続を使用する場合は:
  • Confluence インストール後、Confluence セットアップウィザードに進まずに一旦作業を停止してください。Confluence セットアップウィザードを一部開始してしまった場合は、データベースセットアップの前で一旦作業を停止してください。セットアップウィザードは後で停止したステップから再開することができます。
  • SQL Server データソースを Apache Tomcat に設定の説明に従って設定してください。

Step 5. Confluence セットアップウィザードにおけるデータベース接続のセットアップ

Confluence を起動して、お使いのブラウザの Confluence セットアップウィザードに行きます。ステップに従い、新しい設定をセットアップします:

1. Confluence セットアップガイドにおける最初のステップに従います。
2. 評価用インストールもしくは本番環境用インストールの選択を求められたときは、本番環境を選択します。
3. 組み込みデータベースを使用するか、外部データベースに接続するかを選択するステップで、ドロップダウンリストから Microsoft SQL Server を選択してから外部データベースボタンをクリックします。
4. SQL Server データベースドライバーをセットアップするステップにおいてあらかじめ決めておいた方針に従って、JDBC 直接接続またはデータソース接続のどちらかを選択します。
   • JDBC 接続の場合:

• • • Driver Class Name, を入力するステップで次のように指定します:

      net.sourceforge.jtds.jdbc.Driver
      

    • Database URL を入力するステップでは、次のように指定します:

      jdbc:jtds:sqlserver://<server>:<port>/<database>
      

       MS SQL がクラスター構成となっている場合は、次の形式を使用します:

      jdbc:jtds:sqlserver://<server>:<port>/<database>;instance=<instance>

    • Enter the username (for example, confluenceuser) and password you chose earlier.
  • For a datasource connection: Set the Datasource Name to java:comp/env/jdbc/confluence

以上で Confluence が SQL Server データベースにデータを保存できるようになりました。

トラブルシューティング

• 次のエラー メッセージが表示された場合は、localhost から接続する際に必要となる全てのデータベース権限を confluenceuser ユーザーに付与したかどうかを確認します。

  Could not successfully test your database: : Server connection failure during transaction. Due to underlying exception: 'java.sql.SQLException: Access denied for user 'confluenceuser'@'localhost' (using password: YES)'

• Confluence と共に使用する SQL Server データベースセットアップ時の既知の問題点に関しては、SQL Server の既知の問題点をご覧ください。
• Confluence がクラスファイルを欠いていると訴えた場合は、JDBC ドライバーを誤ったフォルダに配置した可能性があります。
• If none of the above describes your issue, please create a support ticket at http://support.atlassian.com and be sure to include your logs (found in <CONFLUENCE-INSTALLATION>/logs and <CONFLUENCE-HOME>/logs).