Configurando a Origem de Dados Utilizando o Console Administrativo

Os componentes de aplicativos utilizam uma origem de dados para acessar as instâncias de conexão com um banco de dados relacional.

1. Abra o console administrativo.
2. Acesse o painel do console necessário.
   Utilize um dos seguintes caminhos:

   • Clique em Recursos > JDBC > Origens de Dados.
   • Clique em Recursos > JDBC > Fontes de dados (WebSphere Application Server Versão 4)
   • Clique em Recursos > JDBC > JDBC provedores > JDBC_provedor > Fontes de dados
   • Clique em Recursos > JDBC > JDBC provedores > JDBC_provedor > Fontes de dados (WebSphere Application Server Versão Versão 4).
3. Selecione o escopo no qual os aplicativos podem usar a origem de dados.
   É possível escolher uma célula, nó, cluster ou servidor. Para obter mais informações, consulte o tópico sobre as configurações do escopo.

   Versão 4 apenas: A partir deste ponto em diante, as etapas para criação de fontes de dados WebSphere Application Server Versão 4 diferem das etapas para criação de fontes de dados da versão padrão mais recente. Para configurar uma origem de dados da Versão 4:

   • Clique em Novo para continuar no painel do console para definir as propriedades necessárias.
   • Nesse painel de propriedades, especifique valores para os campos que estão agrupados pelo título Configuração. O servidor de aplicativos requer estas propriedades para implementar suas classes do driver JDBC.
   • Salve a sua configuração, clicando em OK. Agora, você concluiu as principais tarefas de configuração de origem de dados.
   • Defina outras propriedades que o fornecedor de banco de dados pode precisar ou ofereça como opções, para usar o driver JDBC. O servidor de aplicativos chama-as de propriedades customizadas e requer que elas sejam configuradas na origem de dados. Comece clicando no link Propriedades Customizadas que agora é exibido no painel do console administrativo. Consulte a documentação de seu banco de dados para conhecer estas propriedades necessárias e opcionais.

     Você também pode aprender sobre propriedades opcionais de origem de dados no Application Programming Guide and Reference for Java para sua versão do DB2® for z/OS® se você usar o Driver DB2 Universal JDBC ou DB2 Usando o Driver IBM® JCC para o provedor JDBC .

4. Clique em Novo.
   Esta ação faz com que o assistente Criar uma origem de dados ative e exiba o painel Inserir informações básicas da origem de dados.
   O primeiro campo é o campo do escopo, que é de leitura. Este campo exibe a seleção de escopo anterior.
5. Digite um nome de origem de dados no campo Nome de origem de dados .
   Esse nome identifica a origem de dados somente para propósitos administrativos.
6. Digite um nome Java Naming and Directory Interface (JNDI) no campo Nome de JNDI .
   O servidor de aplicativos utiliza o nome de JNDI para ligar referências de recursos de um aplicativo a esta origem de dados. Siga estes requisitos ao especificar nomes de JNDI:

   • Não designe nomes de JNDI duplicados entre tipos de recursos diferentes, como origens de dados versus connection factories J2C ou connection factories JMS.
   • Não designe nomes JNDI duplicados para vários recursos do mesmo tipo no mesmo escopo.

   Para obter mais informações sobre JNDI, consulte o tópico sobre nomenclatura.
7. Clique em Avançar para ver o painel Selecione JDBC provedor .
   O painel Selecionar provedor JDBC será ignorado se você não possuir nenhum provedor JDBC configurado no escopo atual.
8. Selecione um provedor JDBC existente ou crie um novo provedor.
   • Selecione um provedor JDBC existente.
     1. Clique em Selecionar um provedor JDBC existente.
     2. Selecione um driver JDBC na lista.
     3. Clique em Avançar. Agora o painel com o título Inserir propriedades específicas do banco de dados para a origem de dados será exibido.
   • Crie um novo provedor JDBC.
     1. Clique em Criar Novo Provedor JDBC.
     2. Clique em Avançar para exibir o painel Criar provedor JDBC.
     3. Utilize a primeira lista suspensa para selecionar o tipo de banco de dados do provedor JDBC que você precisa criar.
        A opção Definida pelo Usuário: Selecione Definido pelo Usuário para o seu tipo de banco de dados se encontrar qualquer um dos seguintes cenários:

        • Você não vê seu tipo de banco de dados.
        • Não é possível selecionar o tipo de provedor JDBC necessário na próxima etapa.

        A seleção definida pelo usuário aciona o painel do assistente para exibir o tipo de provedor como um provedor JDBC Definido pelo Usuário e o tipo de implementação como Definida pelo Usuário. Consulte a documentação do banco de dados para obter os arquivos de classes do driver JDBC, as propriedades da origem de dados e outros requeridos para seu provedor definido pelo usuário. Você deve fornecer estas informações nos próximos dois painéis do assistente:

        • informações do caminho da classe de banco de dados
        • propriedades específicas do banco de dados
     4. O tipo de provedor JDBC é exibido na segunda lista; selecione seu tipo de provedor JDBC. Selecione Mostrar Obsoleto para acionar a exibição dos provedores atuais e obsoletos. Se não for possível localizar seu provedor nessa lista expandida, então, selecione Definido pelo Usuário na lista anterior de tipos de banco de dados.
     5. A partir da terceira lista, selecione o tipo de implementação necessário para seu aplicativo. Se seu aplicativo não precisar que as conexões suportem transações de consolidação em duas fases, escolha Origem de Dados do Conjunto de Conexões. Escolha Origem de Dados XA, no entanto, se seu aplicativo precisar de conexões que suportem transações de consolidação em duas fases. Os aplicativos que utilizam esta configuração de origem de dados têm o benefício de recuperação de transação gerenciada por contêiner.

        Após selecionar um tipo de implementação, o assistente preenche o nome e os campos de descrição para seu provedor JDBC. É possível digitar valores diferentes para esses campos; eles existem somente para propósitos administrativos.

     6. Clique em Avançar após ter definido seu tipo de banco de dados, tipo de provedor e tipo de implementação. Agora o painel do assistente Inserir informações do caminho de classe do banco de dados é exibido.
     7. No campo do caminho de classe, digite o local do caminho completo dos arquivos de classe do driver JDBC do banco de dados. Suas informações de caminho de classe tornam-se o valor da variável de ambiente do WebSphere exibida neste painel, na forma de ${DATABASE_JDBC_DRIVER_PATH}. O servidor de aplicativos utiliza a variável para definir seu provedor JDBC; esta prática elimina a necessidade de especificar caminhos de classe JDBC estáticos para aplicativos individuais. Lembre-se de que se você não fornecer o caminho de classe do driver JDBC correto e completo para a variável, sua origem de dados fatalmente falhará. Se o campo já exibir um caminho completo da classe, poderá aceitar esta definição de variável preenchendo o restante desse painel do assistente e clicando em Avançar.
     8. Utilize o campo Caminho da biblioteca nativa para especificar arquivos de classe adicionais que seu driver JDBC poderá requerer para funcionar corretamente em sua plataforma do servidor de aplicativos. Digite o nome completo do caminho de diretório desses arquivos de classe.
     9. Clique em Avançar. Agora o painel Inserir propriedades específicas do banco de dados para a origem de dados será exibido.
9. Complete todos os campos no painel Inserir propriedades específicas do banco de dados para o software de origem de dados .
   • Clique em Utilizar esta Origem de Dados em CMP (Container Managed Persistence) se os beans corporativos CMP (Container Managed Persistence) precisarem acessar esta origem de dados.
   • Quaisquer outros campos de propriedade exibidos nesse painel do assistente são específicos ao seu tipo de banco de dados. Consulte o tópico, Configurações mínimas requeridas da origem de dados, para obter informações sobre estas configurações de propriedades. O artigo aborda provedores JDBC atuais e reprovados que são predefinidos no servidor de aplicativos.
     Fontes de dados definidas pelo usuário: Este painel do assistente não exibe campos de propriedade adicionais para fontes de dados que correspondem com seus provedores JDBC definidos pelo usuário. No entanto, a partir dos arquivos de classe do driver JDBC instalados, geralmente o servidor de aplicativos poderá extrair os nomes de propriedades necessários da origem de dados. O servidor de aplicativos define-os como propriedades customizadas da origem de dados, exibe-os em um painel customizado do console de propriedades e designa a eles valores padrão. Consulte a documentação do banco de dados sobre as configurações dessas propriedades e quaisquer outros requisitos para sua origem de dados definida pelo usuário. Depois de criar a fonte de dados, navegue até o painel de coleta de propriedades customizadas correspondente no console administrativo clicando em Origens de dados > data_source > Propriedades personalizadas. Revise os valores padrão da propriedade e modifique-os se necessário.

     O servidor de aplicativos só pode extrair propriedades específicas do fornecedor a partir dos arquivos de classe do driver se você instalar os arquivos no nó do gerenciador de implementação e configurar suas variáveis representativas do WebSphere corretamente. Caso contrário, o produto exibe uma mensagem informativa (em oposição a uma mensagem de erro) que o direciona para definir manualmente as propriedades necessárias como propriedades customizadas.

10. Opcional: Configure os aliases de segurança para a origem de dados.
    É possível selecionar nenhum para qualquer um dos métodos de autenticação ou escolher um dos seguintes tipos:

    • Alias de autenticação gerenciado pelo componente - especifica um alias de autenticação a ser utilizado quando o valor res-auth de referência do recurso do componente for Aplicativo. Para definir um novo alias, navegue até Itens Relacionados > J2EE Connector Architecture (J2C) entradas de dados de autenticação. Um alias gerenciado por componente representa uma combinação de ID e senha que é especificada em um aplicativo para autenticação de origem de dados. Portanto, o alias configurado na origem de dados deve ser idêntico ao alias do código do aplicativo.
      1. Utilize a lista suspensa para selecionar um alias de autenticação gerenciado por componente existente.
      2. Para criar um novo alias, clique nos links fornecidos. Esta ação fecha o assistente da origem de dados e aciona o console administrativo para exibir o painel de dados de autenticação J2C. Clique em Novo para definir um novo alias. Clique em OK para salvar suas configurações e visualizar o novo alias no painel de dados de autenticação J2C. Reinicie o assistente da origem de dados navegando de volta para o painel de coleta da origem de dados, selecionando o escopo apropriado e clicando em Novo.
      Para obter mais informações sobre a segurança Java 2 Connector (J2C), consulte o tópico sobre o gerenciamento de entradas de dados de autenticação Java 2 Connector Architecture.
    • Alias de configuração de mapeamento - é usado apenas na ausência de uma configuração de login na referência de recurso do componente. A especificação de uma configuração de login e das propriedades associadas na referência de recurso do componente é a maneira preferencial para definir a estratégia de autenticação, quando o valor res-auth for configurado para Contêiner. Se você especificar a configuração de login DefaultPrincipalMapping, a propriedade associada será um alias de entrada de dados de autenticação JAAS - J2C.
    • Alias de autenticação gerenciado por contêiner - é usado apenas na ausência de uma configuração de login na referência de recurso do componente. A especificação de uma configuração de login e as propriedades associadas na referência de recurso de componentes determina a estratégia de autenticação gerenciada por contêiner quando o valor de res-auth for configurado comoContainer.

    Nota: Se você tiver definido domínios de segurança no servidor de aplicativos, você pode clicar em Procurar ... para selecionar um alias de autenticação para o recurso que você está configurando. Os domínios de segurança suportam o isolamento de aliases de autenticação entre servidores. A visualização em árvore é útil na determinação do domínio de segurança ao qual um alias pertence, além de poder ajudar a determinar os servidores que estão aptos para acessar cada alias de autenticação. A visualização em árvore é adaptada para cada recurso, portanto domínios e aliases ficam ocultos quando não é possível utilizá-los.
11. Clique em Avançar para visualizar o painel Resumo , e revise qualquer informação para a fonte de dados.
    Se alguma informação não estiver correta, é possível clicar em Voltar para voltar e corrigi-la.
12. Clique em Concluir para salvar a configuração e sair do assistente.
    Agora o painel Origens de dados será aberto, exibindo sua nova configuração em uma tabela junto com outras origens de dados configuradas para o mesmo escopo.