![[AIX Solaris HP-UX Linux Windows]](../images/dist.gif)
Configurações Mínimas Necessárias da Origem de Dados para o DB2 com o Servidor de Aplicativos no AIX, HP-UX, Linux, Solaris ou Windows
Essas propriedades variam de acordo com os requisitos do fornecedor do banco de dados para implementações do driver JDBC. É necessário configurar as propriedades apropriadas em cada origem de dados configurada. Essas configurações são para uma origem de dados do DB2 que se conecta a um servidor de aplicativos em execução nos sistemas AIX, HP-UX, Linux, Solaris ou Windows.


Começando com a versão 9 do DB2, os sistemas Linux, HP-UX e Solaris exigem um kernel de 64 bits. Além disso, a largura do bit da instância padrão agora é determinada pelo sistema operacional, o que difere das versões anteriores do DB2. Com essas mudanças nos requisitos do sistema operacional, a opção -w, que teria fornecido a capacidade de especificar a largura do bit da instância, foi removida dos comandos db2icrt, db2ilist e db2iupdt.
gotcha- DB2 Utilizando o IBM® JCC Driver
- DB2 Utilizando o IBM JCC Driver (XA)
- Provedor DB2 Universal JDBC Driver
- Provedor do DB2 UniversalJDBC Driver (XA)
- $INSTHOME/sqllib/lib
- $INSTHOME/sqllib/lib32
- $INSTHOME/sqllib/lib2
- $INSTHOME/sqllib/lib64
- Driver JCC DB2 Using IBM
Esse é um provedor JCC one-phase commit para DB2 que utiliza o IBM Data Server Driver para JDBC e SQLJ. O IBM Data Server Driver para JDBC e SQLJ é a próxima geração do Driver Universal JDBC DB2. Origens de dados criadas nesse provedor suportam apenas o processamento 1-phase commit, a menos que você utilize o driver JDBC tipo 2 com o servidor de aplicativos para z/OS. Se você executar o servidor de aplicativos no z/OS com o driver do tipo 2, o driver utilizará RRS e suportará processamento 2-phase commit.
Esse provedor:- É configurável somente em nós da versão 7.0 e posterior
- Suporta a seguinte origem de dados de uma fase:
com.ibm.db2.jcc.DB2ConnectionPoolDataSource
- Requer os seguintes arquivos do driver JDBC:
- db2jcc4.jar - Esse é o arquivo .jar do IBM Data Server Driver para JDBC e SQLJ. Configurar a variável de caminho DB2_JCC_DRIVER_PATH para apontar para o arquivo db2jcc4.jar. Depois de instalar o DB2, será possível localizar esse arquivo .jar no diretório DB2 java. Para obter suporte ao driver JDBC Tipo 4 em uma máquina cliente na qual o DB2 não está instalado, copie esse arquivo na máquina local. Se você instalar alguma correção ou upgrade no DB2, atualize esse arquivo também.
- db2jcc_license_cu.jar - Esse é o arquivo de licença do IBM Data Server Driver para JDBC e SQLJ que permite acessar o banco de dados DB2. Utilize esse arquivo .jar ou o próximo para obter acesso ao banco de dados. Esse arquivo .jar é fornecido com o servidor de aplicativos em um diretório definido pela variável de ambiente UNIVERSAL_JDBC_DRIVER_PATH.
- db2jcc_license_cisuz.jar - Esse é o arquivo de licença do IBM Data Server para JDBC e SQLJ que permite acesso aos seguintes bancos de dados:
- DB2 Database para Linux, UNIX e Windows
- DB2 para iSeries
- DB2 para z/OS
- DB2 for VM and VSE
db2jcc_license_cisuz.jar não é fornecido com o servidor de aplicativos. Coloque esse arquivo no mesmo diretório do arquivo db2jcc4.jar, para que DB2_JCC_DRIVER_PATH aponte para ambos os arquivos.
- Os arquivos nativos que são requeridos pelo IBM Data Server Driver for JDBC andSQLJ no servidor de aplicativos. Eles são necessários apenas quando o driverType é configurado para 2.
- Utiliza os seguintes caminhos de classe:
${DB2_JCC_DRIVER_PATH}/db2jcc4.jar ${UNIVERSAL_JDBC_DRIVER_PATH}/db2jcc_license_cu.jar ${DB2_JCC_DRIVER_PATH}/db2jcc_license_cisuz.jar ${PUREQUERY_PATH}/pdq.jar ${PUREQUERY_PATH}/pdqmgmt.jar
Atenção: Os arquivos ${PUREQUERY_PATH}/pdq.jar e ${PUREQUERY_PATH}/pdqmgmt.jar são incluídos no caminho de classe por conveniência e são necessários apenas se o provedor JDBC for usado pelos aplicativos pureQuery. Se estiver usando esse provedor JDBC com os aplicativos pureQuery, configure a variável para PUREQUERY_PATH para o diretório onde os arquivos JAR do IBM Optim pureQuery Runtime estão armazenados. - Use o seguinte caminho de biblioteca nativa:
Se o driverType for configurado para 2, a variável DB2_JCC_DRIVER_NATIVEPATH deverá ser configurada para o diretório na sua instalação do cliente DB2 que contém as bibliotecas do driver nativo. Se driverType estiver configurado para 4, o caminho nativo não será usado.${DB2_JCC_DRIVER_NATIVEPATH}
- Requer a seguinte classe DataStoreHelper:
com.ibm.websphere.rsadapter.DB2UniversalDataStoreHelper
- Exige um alias de autenticação válido.
- Requer as propriedades:
- databaseName – Será um nome de banco de dados real (ou um alias do banco de dados) se o driverType estiver configurado como 4 ou um nome de banco de dados catalogado localmente se o driverType estiver configurado como 2. Nota: Um alias de banco de dados é um nome alternativo para um nome de banco de dados real. É possível usar um alias de banco de dados para o databaseName quando o driverType estiver configurado como 4.
- driverType - Tipo de conectividade JDBC de uma origem de dados. Dois valores são permitidos: 2 e 4. Se desejar usar o driver tipo 2, configure este valor para 2. Se desejar usar o tipo 4, configure este valor para 4.
- serverName - O endereço TCP/IP ou o nome do host para o servidor DRDA (Distributed Relational Database Architecture). Fornece um valor para essa propriedade apenas se o seu driverType estiver configurado para 4. Essa propriedade não é necessária se o seu driverType estiver configurado para 2.
- portNumber - O número da porta TCP/IP na qual o servidor DRDA reside. Forneça um valor para essa propriedade apenas se o driverType estiver configurado para 4. Essa propriedade não é necessária se o driverType estiver configurado para 2.
- useTransactionRedirect Configure esta propriedade como uma propriedade customizada de
origem de dados se o backend utilizar o Database Partitioning Feature (DPF) do
e a chave de particionamento permanecer constante em toda uma transação. Ativar a propriedade afeta como o IBM Data Server Driver para JDBC e SQLJ direciona cada
solicitação de conexão que inicia uma transação com o DB2. O driver JDBC é acionado para enviar esses pedidos
de conexão ao nó DPF que contém os dados de destino da primeira instrução
direcionável na transação, se essa instrução existir. O
DB2 então
direciona a instrução SQL para partições diferentes, conforme necessário; a transação
prossegue normalmente do ponto de vista do servidor de aplicativos.
É possível usar useTransactionRedirect para as origens de dados driverType 2 e driverType 4. Para configurar a propriedade, utilize a ferramenta de script wsadmin ou a página do console administrativo e as propriedades customizadas do provedor de recursos ou do connection factory do Java EE Designe à propriedade o valor de true.
- databaseName – Será um nome de banco de dados real (ou um alias do banco de dados) se o driverType estiver configurado como 4 ou um nome de banco de dados catalogado localmente se o driverType estiver configurado como 2.
- DB2 Utilizando o IBM JCC Driver (XA)
O DB2 Utilizando o IBM JCC Driver (XA) é um provedor JCC two-phase commit para o DB2 que utiliza o IBM Data Server Driver para JDBC e SQLJ. O IBM Data Server Driver é a próxima geração do DB2 Universal JDBC Driver. As origens de dados criadas nesse provedor suportam o uso de XA para a execução do processamento two-phase commit.
Esse provedor:- É configurável em nós da versão 7.0 e posterior.
- Suporta a seguinte origem de dados de duas fases:
com.ibm.db2.jcc.DB2XADataSource
- Requer os seguintes arquivos do driver JDBC:
- db2jcc4.jar - Esse é o arquivo .jar do IBM Data Server Driver para JDBC e SQLJ. Configurar a variável de caminho DB2_JCC_DRIVER_PATH para apontar para o arquivo db2jcc4.jar. Depois de instalar o DB2, será possível localizar esse arquivo .jar no diretório DB2 Java. Para obter suporte ao driver JDBC tipo 4 em uma máquina cliente na qual o DB2 não está instalado, copie esse arquivo para a máquina local. Se você instalar alguma correção ou upgrade no DB2, atualize esse arquivo também. Você deve também especificar o caminho completo do arquivo db2jcc.jar como o valor da variável de ambiente DB2L_JCC_DRIVER_PATH.
- db2jcc_license_cu.jar - Esse é o arquivo de licença que permite acesso ao banco de dados DB2. Utilize esse arquivo .jar ou o próximo para obter acesso ao banco de dados. Esse arquivo .jar é fornecido com o servidor de aplicativos em um diretório definido pela variável de ambiente UNIVERSAL_JDBC_DRIVER_PATH.
- db2jcc_license_cisuz.jar - Esse é o arquivo de licença que permite acesso aos
seguintes bancos de dados:
- DB2 Database para Linux, UNIX e Windows
- DB2 para iSeries
- DB2 para z/OS
- DB2 for VM and VSE
db2jcc_license_cisuz.jar não é fornecido com o servidor de aplicativos. Coloque esse arquivo no mesmo diretório do arquivo db2jcc4.jar, para que DB2_JCC_DRIVER_PATH aponte para ambos os arquivos.
- Os arquivos nativos que são requeridos pelo IBM Data Server Driver for JDBC andSQLJ no servidor de aplicativos. Eles são necessários apenas quando o driverType é configurado para 2.
- Utiliza os seguintes caminhos de classe:
${DB2_JCC_DRIVER_PATH}/db2jcc4.jar ${UNIVERSAL_JDBC_DRIVER_PATH}/db2jcc_license_cu.jar ${DB2_JCC_DRIVER_PATH}/db2jcc_license_cisuz.jar ${PUREQUERY_PATH}/pdq.jar ${PUREQUERY_PATH}/pdqmgmt.jar
Atenção: Os arquivos ${PUREQUERY_PATH}/pdq.jar e ${PUREQUERY_PATH}/pdqmgmt.jar são incluídos no caminho de classe por conveniência e são necessários apenas se o provedor JDBC for usado pelos aplicativos pureQuery. Se estiver usando esse provedor JDBC com os aplicativos pureQuery, configure a variável para PUREQUERY_PATH para o diretório onde os arquivos JAR do IBM Optim pureQuery Runtime estão armazenados. - Use o seguinte caminho de biblioteca nativa:
Se o driverType for configurado para 2, a variável DB2_JCC_DRIVER_NATIVEPATH deverá ser configurada para o diretório na sua instalação do cliente DB2 que contém as bibliotecas do driver nativo. Se driverType estiver configurado para 4, o caminho nativo não será usado.${DB2_JCC_DRIVER_NATIVEPATH}
- Requer a seguinte classe DataStoreHelper:
com.ibm.websphere.rsadapter.DB2UniversalDataStoreHelper
- Exige um alias de autenticação válido.
- Requer as seguintes propriedades:
- databaseName – Será um nome de banco de dados real (ou um alias do banco de dados) se o driverType estiver configurado como 4 ou um nome de banco de dados catalogado localmente se o driverType estiver configurado como 2. Nota: Um alias de banco de dados é um nome alternativo para um nome de banco de dados real. É possível usar um alias de banco de dados para o databaseName quando o driverType estiver configurado como 4.
- driverType - Tipo de conectividade JDBC de uma origem de dados. Dois valores são permitidos: 2 e 4. Se desejar usar o driver tipo 2, configure este valor para 2. Se desejar usar o tipo 4, configure este valor para 4.
- serverName - O endereço TCP/IP ou o nome do host para o servidor DRDA (Distributed Relational Database Architecture). Fornece um valor para essa propriedade apenas se o seu driverType estiver configurado para 4. Essa propriedade não é necessária se o seu driverType estiver configurado para 2.
- portNumber - O número da porta TCP/IP na qual o servidor DRDA reside. Forneça um valor para essa propriedade apenas se o driverType estiver configurado para 4. Essa propriedade não é necessária se o driverType estiver configurado para 2.
- useTransactionRedirect Configure esta propriedade como uma propriedade customizada de
origem de dados se o backend utilizar o Database Partitioning Feature (DPF) do
e a chave de particionamento permanecer constante em toda uma transação. Ativar a propriedade afeta como o IBM Data Server Driver para JDBC e SQLJ direciona cada
solicitação de conexão que inicia uma transação com o DB2. O driver JDBC é acionado para enviar esses pedidos
de conexão ao nó DPF que contém os dados de destino da primeira instrução
direcionável na transação, se essa instrução existir. O
DB2 então
direciona a instrução SQL para partições diferentes, conforme necessário; a transação
prossegue normalmente do ponto de vista do servidor de aplicativos.
É possível usar useTransactionRedirect para as origens de dados driverType 2 e driverType 4. Para configurar a propriedade, utilize a ferramenta de script wsadmin ou a página do console administrativo e as propriedades customizadas do provedor de recursos ou do connection factory do Java EE Designe à propriedade o valor de true.
- databaseName – Será um nome de banco de dados real (ou um alias do banco de dados) se o driverType estiver configurado como 4 ou um nome de banco de dados catalogado localmente se o driverType estiver configurado como 2.
- Provedor DB2 Universal JDBC Driver
O DB2 Universal JDBC Driver é um driver JDBC de arquitetura neutra para acesso distribuído e local ao DB2. Como a arquitetura do Universal Driver não depende de nenhuma conectividade ou plataforma de destino específica do driver JDBC, ela permite a conectividade Java (Tipo 4) ou a conectividade baseada na JNI (Java Native Interface), Tipo 2, em uma instância de driver único com o DB2.
Esse provedor:- Permite que os aplicativos utilizem o acesso JDBC e SQLJ (Linguagem de Consulta Estruturada em Java).
- Suporta a seguinte origem de dados de uma fase:
com.ibm.db2.jcc.DB2ConnectionPoolDataSource
- Requer os seguintes arquivos do driver JDBC:
- db2jcc - Depois de instalar o DB2, será possível localizar esse arquivo .jar no diretório DB2 java. Para obter suporte ao driver JDBC Tipo 4 em uma máquina cliente na qual o DB2 não está instalado, copie esse arquivo na máquina local. Se você instalar alguma correção ou upgrade no DB2, atualize esse arquivo também. Defina também a variável de caminho DB2UNIVERSAL_JDBC_DRIVER_PATH para apontar para o arquivo db2jcc.jar.
- db2jcc_license_cu.jar - Esse é o arquivo de licença do driver JDBC do DB2 Universal que permite acesso ao DB2 Universal Database. Utilize esse arquivo .jar ou o próximo para obter acesso ao banco de dados. Esse arquivo .jar é fornecido com o servidor de aplicativos em um diretório definido pela variável de ambiente ${UNIVERSAL_JDBC_DRIVER_PATH}.
- db2jcc_license_cisuz.jar - Esse é o arquivo de licença do driver JDBC do
DB2
Universal que permite acesso aos seguintes bancos de dados:
- DB2 Universal
- DB2 para iSeries
- DB2 para z/OS
- DB2 for VM and VSE
db2jcc_license_cisuz.jar não é fornecido com o servidor de aplicativos. Coloque esse arquivo no mesmo diretório que o arquivo db2jcc.jar, de modo que DB2UNIVERSAL_JDBC_DRIVER_PATH aponte para ambos.
- Utiliza o seguinte caminho de classe:
${DB2UNIVERSAL_JDBC_DRIVER_PATH}/db2jcc.jar ${UNIVERSAL_JDBC_DRIVER_PATH}/db2jcc_license_cu.jar ${DB2UNIVERSAL_JDBC_DRIVER_PATH}/db2jcc_license_cisuz.jar
- Requer a seguinte classe DataStoreHelper:
com.ibm.websphere.rsadapter.DB2UniversalDataStoreHelper
- Exige um alias de autenticação válido.
- Requer as seguintes propriedades:
- databaseName – Será um nome de banco de dados real (ou um alias do banco de dados) se o driverType estiver configurado como 4 ou um nome de banco de dados catalogado localmente se o driverType estiver configurado como 2. Nota: Um alias de banco de dados é um nome alternativo para um nome de banco de dados real. É possível usar um alias de banco de dados para o databaseName quando o driverType estiver configurado como 4.
- driverType - Tipo de conectividade JDBC de uma origem de dados. Dois valores são permitidos: 2 e 4. Se você desejar utilizar o Universal JDBC Driver tipo XA 2, configure este valor para 2. Se desejar utilizar o Universal JDBC Driver tipo XA 4, configure este valor para 4.
- serverName - O endereço TCP/IP ou o nome do host para o servidor DRDA (Distributed Relational Database Architecture). Fornece um valor para essa propriedade apenas se o seu driverType estiver configurado para 4. Essa propriedade não é necessária se o seu driverType estiver configurado para 2.
- portNumber - O número da porta TCP/IP na qual o servidor DRDA reside. Forneça um valor para essa propriedade apenas se o driverType estiver configurado para 4. Essa propriedade não é necessária se o driverType estiver configurado para 2.
- useTransactionRedirect Configure esta como uma propriedade customizada de
origem de dados se o backend usar o DPF (Database Partitioning Feature) do
DB2 UDB
Versão 8.2, fix pack 10, e a chave de particionamento permanecer constante em toda uma
transação. A ativação da propriedade afeta como o
DB2
Universal JDBC Driver direciona cada pedido de conexão que inicia uma transação com o
DB2.
O driver JDBC é acionado para enviar esses pedidos
de conexão ao nó DPF que contém os dados de destino da primeira instrução
direcionável na transação, se essa instrução existir. O
DB2 então
direciona a instrução SQL para partições diferentes, conforme necessário; a transação
prossegue normalmente do ponto de vista do servidor de aplicativos.
É possível usar useTransactionRedirect para as origens de dados driverType 2 e driverType 4. Para configurar a propriedade, utilize a ferramenta de script wsadmin ou a página do console administrativo e as propriedades customizadas do connection factory ou do provedor de recursos do Java EE Designe à propriedade o valor de true.
- databaseName – Será um nome de banco de dados real (ou um alias do banco de dados) se o driverType estiver configurado como 4 ou um nome de banco de dados catalogado localmente se o driverType estiver configurado como 2.
- Provedor do IBMDB2 Universal JDBC Driver (XA)
O DB2 Universal JDBC Driver (XA) é um provedor JDBC de arquitetura neutra para acesso distribuído e local ao DB2. O IBM Data Server Driver para JDBC e SQLJ é a próxima geração do DB2 Universal JDBC Driver. Independente se esse provedor for usado para conectividade Java ou Java Native Interface (JNI), a conectividade baseada depende da versão do DB2 que está sendo executada. A versão 6.0 e posterior do servidor de aplicativos requer o DB2 8.1 Fix Pack 6. Essa versão do DB2 suporta apenas conectividade XA sobre o driver (Tipo 2) de conectividade baseada na JNI (Java Native Interface). Para usar a conectividade XA com o driver Tipo 4, o DB2 8.1 Fix Pack 7 ou superior é necessário.
Esse provedor:- Permite que os aplicativos utilizem os acessos JDBC e SQLJ.
- Suporta a origem de dados de duas fases:
com.ibm.db2.jcc.DB2XADataSource
- Requer os seguintes arquivos do driver JDBC:
- db2jcc.jar - Esse é o arquivo .jar do DB2 Universal JDBC Driver. Depois de instalar o DB2, será possível localizar esse arquivo .jar no diretório DB2 Java. Para obter suporte ao driver JDBC Tipo 4 em uma máquina cliente na qual o DB2 não está instalado, copie esse arquivo na máquina local. Se você instalar alguma correção ou upgrade no DB2, atualize esse arquivo também. Especifique também o caminho completo do db2jcc.jar como o valor da variável de ambiente DB2UNIVERSAL_JDBC_DRIVER_PATH.
- db2jcc_license_cu.jar - Esse é o arquivo de licença do Driver JDBC do DB2 Universal que permite acesso ao DB2 Universal Database. Utilize esse arquivo .jar ou o próximo para obter acesso ao banco de dados. Esse arquivo .jar é enviado com o servidor de aplicativos no diretório app_server_root/universalDriver/lib.
- db2jcc_license_cisuz.jar - Esse é o arquivo de licença do
DB2
Universal JDBC Driver que permite acesso aos seguintes bancos de dados:
- DB2 Universal
- DB2 para iSeries
- DB2 para z/OS
- DB2 for VM and VSE
Deve-se utilizar o arquivo .jar de licença correto para acessar um backend de banco de dados específico.
- Os arquivos nativos exigidos pelo DB2 Universal JDBC Driver no servidor de aplicativos.
- Utiliza o seguinte caminho de classe:
${DB2UNIVERSAL_JDBC_DRIVER_PATH}/db2jcc.jar ${UNIVERSAL_JDBC_DRIVER_PATH}/db2jcc_license_cu.jar ${DB2UNIVERSAL_JDBC_DRIVER_PATH}/db2jcc_license_cisuz.jar ${DB2UNIVERSAL_JDBC_DRIVER_NATIVEPATH}
- Requer a seguinte classe DataStoreHelper:
com.ibm.websphere.rsadapter.DB2UniversalDataStoreHelper
- Exige um alias de autenticação válido.
- Requer as propriedades:
- databaseName – Será um nome de banco de dados real (ou um alias do banco de dados) se o driverType estiver configurado como 4 ou um nome de banco de dados catalogado localmente se o driverType estiver configurado como 2. Nota: Um alias de banco de dados é um nome alternativo para um nome de banco de dados real. É possível usar um alias de banco de dados para o databaseName quando o driverType estiver configurado como 4.
- driverType - Tipo de conectividade JDBC de uma origem de dados. Há dois valores permitidos: 2 e 4. Para utilizar o Universal JDBC Driver tipo 2 XA, defina esse valor como 2. Para utilizar o Universal JDBC Driver tipo 4 XA (que requer o DB2 8.1 Fix Pack 7 ou superior), defina esse valor como 4.
- serverName - O endereço TCP/IP ou o nome do host para o servidor DRDA (Distributed Relational Database Architecture). Forneça um valor para essa propriedade apenas se o driverType estiver configurado como 4. Essa propriedade não será necessária se o driverType estiver configurado como 2.
- portNumber - O número da porta TCP/IP na qual o servidor DRDA reside. Forneça um valor para essa propriedade apenas se o driverType estiver definido como 4. Esta propriedade não é exigida se o driverType estiver definido como 2.
- useTransactionRedirect Configure esta como uma propriedade customizada de
origem de dados se o backend usar o DPF (Database Partitioning Feature) do
DB2 UDB
Versão 8.2, fix pack 10, e a chave de particionamento permanecer constante em toda uma
transação. A ativação da propriedade afeta como o
DB2
Universal JDBC Driver direciona cada pedido de conexão que inicia uma transação com o
DB2.
O driver JDBC é acionado para enviar esses pedidos
de conexão ao nó DPF que contém os dados de destino da primeira instrução
direcionável na transação, se essa instrução existir. O
DB2 então
direciona a instrução SQL para partições diferentes, conforme necessário; a transação
prossegue normalmente do ponto de vista do servidor de aplicativos.
É possível usar useTransactionRedirect para as origens de dados driverType 2 e driverType 4. Para configurar a propriedade, utilize a ferramenta de script wsadmin ou a página do console administrativo e as propriedades customizadas do connection factory ou do provedor de recursos do Java EE Designe à propriedade o valor de true.
- databaseName – Será um nome de banco de dados real (ou um alias do banco de dados) se o driverType estiver configurado como 4 ou um nome de banco de dados catalogado localmente se o driverType estiver configurado como 2.