JIRA の SQL Server 2005 への接続

1. SQL Server データベースの作成と設定

1. Create a database for JIRA to store issues in (e.g. jiradb).
   Remember your database name, as it will be used to configure JIRA's connection to this database in subsequent steps.
   
   • 照合タイプは、大文字と小文字の区別を無視、アクセントの区別を無視、および言語非依存でなければなりません。たとえば、「SQL_Latin1_General_CP437_CI_AI」は、大文字と小文字の区別を無視、アクセントの区別を無視、および言語非依存の照合タイプです。ご使用の SQL Server インストールの照合タイプの設定をデフォルトから変更していない場合、照合タイプの設定を確認してください。
   • SQL Server は Unicode エンコード形式で文字を格納します。これで、文字エンコード問題を十分回避できます。
2. Create a database user which JIRA will connect as (e.g. jiradbuser).
   Remember your database user name, as it will be used to configure JIRA's connection to this database in subsequent steps.
   
   • This database user should not be the database owner, but should be in the db_owner role.
3. Create an empty 'schema' in the database (e.g. jiraschema) for the JIRA tables.
   Remember this database schema name, as it will be used to configure JIRA's connection to this database in subsequent steps.
   
   • SQL Server 2005 の「スキーマ」は、オブジェクトを含むために使用されるまったく別の名前空間であり、従来のデータベーススキーマとは異なるものです。JIRA のテーブル、フィールド、または信頼関係の作成は不要です (JIRA は初回起動時に、これらのオブジェクトを空のスキーマ内に作成します)。SQL Server 2005 のスキーマに関する詳細は、Microsoft ドキュメントの関連項目を参照してください。
4. 作成したデータベース ユーザーが、データベースに接続し、新しく作成したスキーマの中でテーブルを作成・追加できる権限を持つことを確認します。
   
   • If you are having difficulties setting up your JIRA database for SQL Server, additional information is available in the Setting Up a SQL Server 2005 database for JIRA document.
5. Ensure that TCP/IP is enabled on SQL Server and listening on the correct port (which is 1433 for a default SQL Server installation).
   Remember this port number, as it will be used to configure JIRA's connection to this database in subsequent steps. JIRA does not support dynamic port assignment.
   
   • ネットワーク プロトコル (TCP/IP) を有効にする方法、および、SQL Server のリスニング ポートの変更方法に関しては、Microsoft のドキュメンテーションを参照してください。
6. SQL Server が適切な認証モードで稼働していることを確認します。
   
   • SQL Server はデフォルトで「Windows 認証モード」で稼働します。しかし、ユーザーが SQL Server の信頼関係接続に関連付けられていない場合、すなわち、JIRA セットアップ中に ”Microsoft SQL Server、エラー: 18452” が表示される場合、この認証モードを「混在モード」に変更する必要があります。認証モード、および、「混在モード」への認証モードの変更に関しては、Microsoft のドキュメンテーションを参照してください。
7. Turn off the SET NOCOUNT option (see the Error caused by SET NOCOUNT in MS SQL Serverfor an explanation). To turn off SET NOCOUNT:
   • Open SQL Server Management Studio and navigate to Tools > Options > Query Execution > SQL Server > Advanced. The following screenshot displays the configuration panel for this setting in MSSQL Server 2005. Ensure that the SET NOCOUNT option is not selected:
     

   • 新規作成したデータベース上で右クリックをして、Query Console にアクセスし、 “New Query” を選択します。次のコマンドを実行し、分離レベルを設定します。

     ALTER DATABASE THE-NEW-DATABASE-CREATED-FOR-JIRA SET READ_COMMITTED_SNAPSHOT ON 

2. SQL Server の JDBC Driver をアプリケーションサーバーへコピー (JIRA WAR 限定)

Skip this step if you installed a 'Recommended' distribution of JIRA, which includes the SQL Server JDBC driver. The JIRA WAR distribution does not include this driver.

1. Download the SQL Server JDBC driver (v1.2.4) from JTDS.
   Microsoft have their own JDBC driver but we strongly recommend avoiding it after receiving many reports of intermittent disconnections (JRA-5760 and JRA-6872), workflow problems (JRA-8443) and Chinese character problems (JRA-5054).
2. Add the SQL Server JDBC driver jar (jtds-1.2.4.jar) to the <Tomcat install>/lib/ directory.

3. JIRA Server を SQL Server 2005 データベースに接続する設定

SQL Server 2008 データベースへ接続するための JIRA サーバーの設定方法は3つあります:

• Using the JIRA setup wizard (not applicable to JIRA WAR) — Use this method, if you have just installed JIRA and are setting it up for the first time. Your settings will be saved to the dbconfig.xml file in your JIRA Home Directory.
• Using the JIRA configuration tool (not applicable to JIRA WAR) — Use this method, if you have an existing JIRA instance. Your settings will be saved to the dbconfig.xml file in your JIRA Home Directory.
• Manually — Only use this method if you have a JIRA WAR instance or you have a console-only connection to your JIRA server. You will be required to manually update the dbconfig.xml file in your JIRA Home Directory.

各設定手法の手順説明

データベース接続フィールド

dbconfig.xml ファイルのサンプル

For more information about the child elements of <jdbc-datasource/> beginning with pool in the dbconfig.xml file above, see Tuning Database Connections.

<?xml version="1.0" encoding="UTF-8"?>

<jira-database-config>
  <name>defaultDS</name>
  <delegator-name>default</delegator-name>
  <database-type>mssql</database-type>
  <schema-name>dbo</schema-name>
  <jdbc-datasource>
    <url>jdbc:jtds:sqlserver://dbserver:1433/jiradb</url>
    <driver-class>net.sourceforge.jtds.jdbc.Driver</driver-class>
    <username>jiradbuser</username>
    <password>password</password>
    <pool-min-size>20</pool-min-size>
    <pool-max-size>20</pool-max-size>
    <pool-max-wait>30000</pool-max-wait>
    <pool-max-idle>20</pool-max-idle>
    <pool-remove-abandoned>true</pool-remove-abandoned>
    <pool-remove-abandoned-timeout>300</pool-remove-abandoned-timeout>
 
    <validation-query>select 1</validation-query>
    <min-evictable-idle-time-millis>60000</min-evictable-idle-time-millis>
    <time-between-eviction-runs-millis>300000</time-between-eviction-runs-millis>
 
    <pool-test-while-idle>true</pool-test-while-idle>
  </jdbc-datasource>
</jira-database-config>

4. JIRA を起動する

ここまでで、SQL Server データベースに接続するための JIRA の設定が完了したはずです。これで、起動できます!

• JIRA の『推奨』ディストリビューションを使用している場合は、起動後、エラーがないかどうかログを観察します。
• JIRA WAR ディストリビューションを使用している場合は、アプリケーションサーバーでウェブアプリケーションを再構築・再展開します。

以上で、SQL Server データベースへの　JIRA の接続は完了です。

インストールに際して

Please see JIRA and MS SQL Server 2005.