WebSphere Message Broker ODBC Database Extender を使用する Linux および UNIX システムからのデータベースへの接続

WebSphere® Message Broker ODBC Database Extender は unixODBC ドライバー・マネージャーをカプセル化します。 このトピックでは、それを使用するためのブローカーのセットアップと構成方法について説明します。

以下の情報は、サポートされるすべてのデータベースをカバーしています。

始める前に:
  1. install_dir/ODBC/unixodbc/ ディレクトリーに提供されている odbc.ini サンプル・ファイルを、任意の場所にコピーします。 したがって、システム上の各ブローカー・サービス・ユーザー ID は、独自の DSN 定義を使用できます。

    サンプル・ファイルの内容については、WebSphere Message Broker ODBC 構成ファイルのサンプルを参照してください。

    注: バックアップとリストアの手順に関する問題を回避するため、サンプル・ファイルのコピーを、ユーザー ID のホーム・ディレクトリーではなく /var/mqsi ディレクトリーに配置することをお勧めします。
  2. odbc.ini ファイルに mqm:mqbrkrs のファイル所有権があり、提供されているサンプル・ファイルと同じ許可があることを確認します。
  3. この odbc.ini ファイルを指すように ODBCINI 環境変数を設定します。絶対パスとファイル名を指定してください。必ずコピーを指すようにし、インストール・ディレクトリーにある odbc.ini ファイルは指さないでください。
  4. install_dir/ODBC/unixodbc/ ディレクトリーに提供されている odbcinst.ini サンプル・ファイルを、任意の場所にコピーします。 ステップ 1 の注: を参照してください。

    サンプル・ファイルの内容については、WebSphere Message Broker ODBC 構成ファイルのサンプルを参照してください。

  5. odbcinst.ini ファイルに mqm:mqbrkrs のファイル所有権があり、提供されているサンプル・ファイルと同じ許可があることを確認します。
  6. この odbcinst.ini ファイルが含まれるディレクトリーを指すように ODBCSYSINI 環境変数を設定します。絶対パス名を指定してください。必ずコピーが入っているディレクトリーを指すようにし、インストール・ディレクトリーにある odbcinst.ini ファイルが入っているディレクトリーは指さないようにしてください。
  7. DB2® solidDB®、または Informix® データベースに接続する場合には、使用するデータベース・マネージャーのライブラリーの場所を示すように、ライブラリー検索パス環境変数を設定します。

    ライブラリー検索パスに関する詳細は、データベース管理者 (DBA) に問い合わせるか、またはデータベース・マネージャーの資料を参照してください。

    ライブラリー検索パス環境変数は、使用しているプラットフォームによって異なります。
    • Linux platformSolaris platform Linux および Solaris の場合は、LD_LIBRARY_PATH を設定します。
    • HP-UX platform HP-UX の場合は、SHLIB_PATH を設定します。
    • AIX platform AIX® の場合は、LIBPATH を設定します。

    サポートされている他のデータベースには、ライブラリー検索パスの更新は必要ありません。

  8. AIX 上にインストールされた DB2 データベース・インスタンスを使用する場合、1 つのプロセスが共用メモリーを使用して行える DB2 データベースへの接続の数は、10 が最大です。データベース・インスタンスに接続するには、TCP/IP モードを使用します。DB2 への接続時に DB2 エラー・メッセージ SQL1224N が出されるを参照してください。
  9. odbcinst.ini ファイルの最後のスタンザである [ODBC] スタンザを編集して、ODBC Driver Manager の場所を指定し、トレースを制御します。 このスタンザの細かい内容は、プラットフォームによって若干異なります。
    正しい odbcinst.ini ファイルを編集しているかどうかを確認するには、以下のコマンドを使用してファイルを vi テキスト・エディターで開くことができます。
    vi $ODBCSYSINI/odbcinst.ini
    1. InstallDir には、WebSphere Message Broker のインストール場所を追加して、ODBC ディレクトリーへの完全修飾パスを完成させます。 この値を正しく指定しないと、ODBC 定義は機能しません。
    2. TraceFile には、ODBC トレースを書き込むファイルの完全修飾パスとファイル名を入力します。 トレース・ファイルは大きくなる可能性があります。十分の空きディスク・スペースがあるディレクトリーを指定してください。
    3. TraceDll には、WebSphere Message Broker のインストール場所を追加して、ODBC トレース DLL への完全修飾パスを完成させます。
    4. スタンザのその他のエントリーについては、すべて、サンプル odbcinst.ini ファイルに示されているデフォルト値を受け入れます。
      例えば、AIX では以下のようにします。
      ;##########################################
      ;###### Mandatory information stanza ######
      ;##########################################
      
      [ODBC]
      ;# To turn on ODBC trace set Trace=1
      Trace=0
      TraceOptions=3
      TraceFile=<A Directory with plenty of free space to hold trace
      output>/odbctrace.out
      TraceDll=<Your Broker install directory>/ODBC/V6.0/lib/odbctrac.so
      InstallDir=<Your Broker install directory>/ODBC/V6.0
      UseCursorLib=0
      IANAAppCodePage=4
      UNICODE=UTF-8
  10. odbc.ini ファイルの最初のスタンザである [ODBC Data Sources] スタンザを編集して、各データベースの DSN をリストします。
    正しい odbc.ini ファイルを編集しているかどうかを確認するには、以下のコマンドを使用してファイルを vi テキスト・エディターで開くことができます。
    vi $ODBCINI
    例えば、AIX では以下のようにします。
    ;##########################################
    ;###### List of data sources stanza #######
    ;##########################################
    [ODBC Data Sources]
    DB2DB=IBM DB2 ODBC Driver
    ORACLEDB=DataDirect 6.0 Oracle Wire Protocol
    ORACLERACDB=DataDirect 6.0 Oracle Wire Protocol (Real Application Clusters)
    SYBASEDB=DataDirect 6.0 Sybase Wire Protocol
    SYBASEDBUTF8=DataDirect 6.0 Sybase UTF8 Wire Protocol
    SQLSERVERDB=DataDirect 6.0 SQL Server Wire Protocol
    INFORMIXDB=IBM Informix ODBC Driver
    SOLIDDB_DB=IBM solidDB Datasource

    データベース・マネージャーに関係なく、odbc.ini ファイルに DSN をすべてリストしてください。複数の DSN を同じデータベースに解決するように定義することができます。ただし、Oracle データベースでトランザクションのグローバル整合を使用している場合は、このオプションはデータ整合性の問題を引き起こす可能性があるため、使用しないでください。

  11. odbc.ini ファイル内の [ODBC Data Sources] スタンザにリストしたデータベースごとに、odbc.ini ファイルにデータ・ソース・スタンザを作成します。 スタンザ内のエントリーは、データベース・マネージャーによって異なります。また、オペレーティング・システムの違いによっても、ドライバーへのファイル・パスなどの部分でいくらかの違いがあります。
    DB2 データベース・インスタンスの場合は、次のようになります。
    Linux(x86) の場合:
    1. Driver には、DB2 インストールの絶対パスを追加します。
    2. Description には、データベースについて意味のある説明を入力します。このフィールドは情報専用で、接続には影響しません。
    3. Database には、DB2 別名を入力します。 データ・ソース名は、データベース別名と同じでなければなりません。 リモート DB2 データベースを使用している場合、この別名を正確なデータベースに解決するために、クライアント/サーバー接続をセットアップする必要があります。

      同一の DB2 データベースを参照する複数のスタンザが必要な場合は、DB2 CATALOG コマンドを使用して、DB2 でエイリアスを作成する必要があります。これらのエイリアスは、ODBCINI ファイル内で独自のスタンザを持つことができます。

      DB2 にエイリアスを設定するために ODBCINI ファイルを使用することはできません。

      詳しくは、DB2 資料を参照してください。

      以下に例を示します。

      ;# DB2 stanza
      [DB2DB]
      Driver=<Your DB2 install directory>/lib32/libdb2.so
      Description=DB2 ODBC Database
      Database=DB2DB
    その他のプラットフォームの場合:
    1. Driver には、DB2 インストールの絶対パスを追加します。
    2. Description には、データベースについて意味のある説明を入力します。このフィールドは情報専用で、接続には影響しません。
    3. Database には、DB2 別名を入力します。 データ・ソース名は、データベース別名と同じでなければなりません。 リモート DB2 データベースを使用している場合、この別名を正確なデータベースに解決するために、クライアント/サーバー接続をセットアップする必要があります。詳しくは、DB2 資料を参照してください。

      同一の DB2 データベースを参照する複数のスタンザが必要な場合は、DB2 CATALOG コマンドを使用して、DB2 でエイリアスを作成する必要があります。これらのエイリアスは、ODBCINI ファイル内で独自のスタンザを持つことができます。

      DB2 にエイリアスを設定するために ODBCINI ファイルを使用することはできません。

      例えば、AIX では以下のようにします。

      ;# DB2 stanza
      [DB2DB]
      DRIVER=<Your DB2 install directory>/lib64/db2o.o
      Description=DB2DB DB2 ODBC Database
      Database=DB2DB
    Oracle データベースの場合は、次のようになります。
    すべてのプラットフォーム:
    1. Driver には、WebSphere Message Broker のインストール場所を追加して、サンプル odbc.ini ファイルに示されているドライバーへの完全修飾パスを完成させます。
    2. Description には、データベースについて意味のある説明を入力します。このフィールドは情報専用で、接続には影響しません。
    3. HostName には、Oracle システムをホスティングするマシンの名前または IP アドレスを入力します。
    4. PortNumber には、HostName に指定したマシン上で Oracle サーバーが listen するポートの番号を入力します。
    5. ServiceName には、HostName に指定したシステム上で接続する Oracle サービス名を入力します。
    6. スタンザのその他のエントリーについては、すべて、サンプル odbc.ini ファイルに示されているデフォルト値を受け入れます。
      例えば、AIX では以下のようにします。
      ;# Oracle stanza
      [ORACLEDB]
      Driver=<Your Broker install directory>/ODBC/V6.0/lib/UKora24.so
      Description=DataDirect 6.0 Oracle Wire Protocol
      HostName=<Your Oracle Server Machine Name>
      PortNumber=<Port on which Oracle is listening on HostName>
      ServiceName=<Your Oracle Service Name>
      CatalogOptions=0
      EnableStaticCursorsForLongData=0
      ApplicationUsingThreads=1
      EnableDescribeParam=1
      OptimizePrepare=1
      WorkArounds=536870912
      ProcedureRetResults=1
      ColumnSizeAsCharacter=1
      LoginTimeout=0
    Real Application Cluster を使用する Oracle データベースの場合は、次のようになります。
    すべてのプラットフォーム:
    1. Driver には、WebSphere Message Broker のインストール場所を追加して、サンプル odbc.ini ファイルに示されているドライバーへの完全修飾パスを完成させます。
    2. Description には、データベースについて意味のある説明を入力します。このフィールドは情報専用で、接続には影響しません。
    3. HostName には、Oracle システムをホスティングするマシンの名前または IP アドレスを入力します。
    4. PortNumber には、HostName に指定したマシン上で Oracle サーバーが listen するポートの番号を入力します。
    5. ServiceName には、HostName に指定したシステム上の、接続先にする Oracle Real Application Cluster サービス名を入力します。
    6. AlternateServers には、このサービスに関する代わりの場所のリストを提供します。各場所の指定は、コロンで区切られた 3 つの部分で構成します。これらの値を 1 つの連続ストリングとして入力します。この例のテキストは、読みやすくするために分割されています。
      HostName=<Alternative host name>
      :PortNumber=<Oracle listner port on alternative server>
      :ServiceName=<Service name on the alternative server>
      複数の AlternateServer を指定する場合は、追加の各場所の指定をコンマで区切ります。
    7. スタンザのその他のエントリーについては、すべて、サンプル odbc.ini ファイルに示されているデフォルト値を受け入れます。
      例えば、AIX では以下のようにします。
      ;# Oracle Real Application Clusters stanza
      [ORACLERACDB]
      Driver=<Your Broker install directory>/ODBC/V6.0/lib/UKora24.so
      Description=DataDirect 6.0 Oracle Wire Protocol
      HostName=<Your Oracle Server Machine Name>
      PortNumber=<Port on which Oracle is listening on HostName>
      ServiceName=<Your Oracle Real Application Cluster Service Name>
      AlternateServers=(HostName=<Your alternative host name>:PortNumber=<Port on
      which Oracle is listening on the alternative host>:ServiceName=<Your
      Oracle Real Application Cluster Service Name>)
      CatalogOptions=0
      EnableStaticCursorsForLongData=0
      ApplicationUsingThreads=1
      EnableDescribeParam=1
      OptimizePrepare=1
      WorkArounds=536870912
      ProcedureRetResults=1
      ColumnSizeAsCharacter=1
      LoginTimeout=0
    Sybase データベースの場合は、次のようになります。
    Linux (System z® 以外のすべてのプラットフォームの場合:
    1. Driver には、WebSphere Message Broker のインストール場所を追加して、サンプル odbc.ini ファイルに示されているドライバーへの完全修飾パスを完成させます。
    2. Description には、データベースについて意味のある説明を入力します。このフィールドは情報専用で、接続には影響しません。
    3. Database には、デフォルトで接続するデータベースの名前を入力します。値を指定しなかった場合、各ユーザーごとにシステム管理者によって定義されたデータベースがデフォルト値となります。
    4. NetworkAddress には、使用する Sybase ASE サーバーのネットワーク・アドレスを入力します (このアドレスは、ローカルおよびリモート・データベースで必須です)。以下のように IP アドレスまたはサーバー名を指定します。
      <Your Sybase server name or IP address>,<Your Sybase port number>

      例えば、Sybaseserver,5000 のようになります。199.226.224.34,5000 のように IP アドレスを直接指定することもできます。interfaces という名前の Sybase インターフェース・ファイルからポート番号を確認できます。

    5. スタンザのその他のエントリーについては、すべて、サンプル odbc.ini ファイルに示されているデフォルト値を受け入れます。
      例えば、AIX では以下のようにします。
      ;# Sybase Stanza
      [SYBASEDB]
      Driver=<Your Broker install directory>/ODBC/V6.0/lib/UKase24.so
      Description=DataDirect 6.0 Sybase Wire Protocol
      Database=<Your Database Name>
      ApplicationUsingThreads=1
      EnableDescribeParam=1
      OptimizePrepare=1
      SelectMethod=0
      NetworkAddress=<Your Sybase Server Name>,<Your Sybase Port Number>
      SelectUserName=1
      ColumnSizeAsCharacter=1
      EnableSPColumnTypes=2
      LoginTimeout=0
      TimestampTruncationBehavior=1
      UNICODE UTF8 Sybase データ・ソースを使用する場合は、以下の行を Sybase スタンザの末尾に追加してください。
      Charset=UTF8
    SQL Server データベースへのリモート・アクセスの場合は、次のようになります。
    Linux (POWER® および Solaris (x86-64) 以外のすべてのプラットフォームの場合:
    1. Driver には、WebSphere Message Broker のインストール場所を追加して、サンプル odbc.ini に示されているドライバーへの完全修飾パスを完成させます。
    2. Description には、データベースについて意味のある説明を入力します。このフィールドは情報専用で、接続には影響しません。
    3. Address には、次のいずれかを行います。
      1. 次のように、接続先の SQLServer データベースを指定する IP アドレスまたはサーバー名およびポート番号を指定します。
        <Your SQLServer machine name or IP address>,<Your SQLServer port number>
        または
      2. 次のように、接続先の SQLServer データベースを指定する IP アドレスまたはサーバー名およびインスタンス名を指定します。
        <Your SQLServer machine name or IP address>¥<Your SQLServer instance name>
        インスタンス名が空白の場合は、<Your SQLServer machine name or IP address> を指定します。
    4. Database には、デフォルトで接続するデータベースの名前を入力します。値を指定しなかった場合、各ユーザーごとにシステム管理者によって定義されたデータベースがデフォルト値となります。
    5. スタンザのその他のエントリーについては、すべて、サンプル odbc.ini ファイルに示されているデフォルト値を受け入れます。
      例えば、AIX では以下のようにします。
      ;# UNIX to SQLServer stanza
      [SQLSERVERDB]
      Driver=<Your Broker install directory>/ODBC/V6.0/lib/UKmsss24.so
      Description=DataDirect 6.0 SQL Server Wire Protocol
      Address=<Your SQLServer Machine Name>,<Your SQLServer Port Number>
      ;# Alternative way to locate server using a named instance
      ;# Address=<Your SQLServer Machine Name>¥<Your SQLServer Instance Name>
      AnsiNPW=Yes
      Database=db
      QuotedId=No
      ColumnSizeAsCharacter=1
      LoginTimeout=0
    Informix データベースの場合は、次のようになります。
    Linux(x86) の場合:
    1. Driver には、Informix クライアント・ライブラリーの絶対パスを追加します。
    2. Description には、データベースについて意味のある説明を入力します。このフィールドは情報専用で、接続には影響しません。
    3. ServerName には、Informix IDS サーバーの名前を入力します。
    4. Database には、デフォルトで接続するデータベースの名前を入力します。値を指定しなかった場合、各ユーザーごとにシステム管理者によって定義されたデータベースがデフォルト値となります。
      以下に例を示します。
      ;# Informix Stanza
      [INFORMIXDB]
      Driver=<Your Informix Client Directory>/lib/cli/iclit09b.so
      Description=IBM Informix ODBC Driver
      ServerName=<Your Informix Server Name>
      Database=<Your Database Name>
    その他のプラットフォームの場合:
    1. Driver には、Informix クライアント・ライブラリーの絶対パスを追加します。
    2. Description には、データベースについて意味のある説明を入力します。このフィールドは情報専用で、接続には影響しません。
    3. ServerName には、Informix IDS サーバーの名前を入力します。
    4. Database には、デフォルトで接続するデータベースの名前を入力します。値を指定しなかった場合、各ユーザーごとにシステム管理者によって定義されたデータベースがデフォルト値となります。
      例えば、AIX では以下のようにします。
      ;# Informix Stanza
      [INFORMIXDB]
      Driver=libinfWrapper.so
      Description=IBM Informix ODBC Driver
      ServerName=<Your Informix Server Name>
      Database=<Your Database Name>
    solidDB データベースの場合:
    Linux (System z 以外のすべてのプラットフォームの場合:

    クライアント・サイド

    odbc.ini ファイル

    1. odbc.ini 構成ファイルは、環境変数 ODBCINI が参照します。
    2. odbc.ini ファイルには、各データ・ソースに関して以下の 2 つの項目が少なくともなければなりません。
      • ODBC データ・ソース名
      • 使用されている実際の ODBC ドライバーの論理名
      例えば、AIX では以下のようにします。
      [ODBC DATA SOURCES]
      SOLIDDB_DB=IBM solidDB Datasource
      
      [SOLIDDB_DB]
      Description=solidDB Datasource
      Driver=solid_db

      注: すべての追加情報は無視されます。

    odbcinst.ini file

    1. odbcinst.ini ファイルが含まれるディレクトリーは、環境変数 ODBCSYSINI によって参照されます。
    2. odbcinst.ini ファイルには、各データ・ソースに関して以下の 2 つの項目が少なくともなければなりません。
      • ドライバーの論理名
      • ODBC ドライバーの絶対パスと名前
      例えば、AIX では以下のようにします。
      [solid_db]
      Driver=<Your solidDB install Directory>/bin/saca5x6465.so

    solid.ini file

    1. この構成ファイルは、環境変数 SOLIDDIR によって参照されるディレクトリーにあります。
    2. solid.ini マッピングは、(ODBCINI で定義された) データ・ソース名から solidDB 接続ストリングへのマッピングです。
    3. 接続ストリングの形式は、<ドライバーの論理名> = <物理 solidDB 接続ストリング> となります。
    4. 物理接続ストリングによって、以下を指定します。
      • プロトコル
      • マシン名または IP アドレス
      • 使用するポート番号
      例えば、AIX では以下のようにします。
      [Data Sources] 
      SOLIDDB_DB=tcp my_aix_system 1964 

    サーバー・サイド

    solid.ini file

    例えば、AIX では以下のようにします。
    [Data Sources] 
    SOLIDDB_DB=tcp my_aix_system 1964
    
    [COM]
    Listen=tcpip 1964
    
    [SQL]
    CharPadding=yes
    NumericPadding=yes
  12. 以下に示すすべての関連 .ini ファイルの必要な部分すべてが編集済みであることを確認してください。
    • odbc.ini ファイルの先頭にある [ODBC Data Source] スタンザ。
    • odbc.ini ファイル内の各データ・ソースのスタンザ。
    • odbcinst.ini ファイルの最後にある [ODBC] スタンザ。
    • また、solidDB の場合、クライアント・サイドとサーバー・サイドの両方の solid.ini ファイル。
    すべての部分が適正に構成されていないと、ODBC DSN は機能せず、ブローカーはデータベースに接続できません。
これで、Linux および UNIX 上のデータベース接続が構成されました。
特記事項 | 商標 | このリンクは新しいウィンドウに開きます ダウンロード | このリンクは新しいウィンドウに開きます ライブラリー | このリンクは新しいウィンドウに開きます サポート | フィードバック

Copyright IBM Corporation 1999, 2011Copyright IBM Corporation 1999, 2011.

        
最終更新

        最終更新 : 2011-11-04 05:57:43


タスク・トピックタスク・トピック | バージョン 8.0.0.0 | bk58060