Instalando e Configurando o Repositório SDO

Service Data Objects (SDO) é um padrão aberto para permitir que aplicativos tratem dados de diferentes origens de dados de uma maneira uniforme, como gráficos de dados. Serviços da web ativados pelo barramento de integração de serviços usam um repositório SDO para armazenar e atender definições WSDL. Use esta tarefa para criar e configurar seu banco de dados preferencial para o armazenamento de dados SDO e para instalar e configurar um repositório SDO em cada servidor que você planeja usar para serviços da web ativados pelo barramento.

Antes de Iniciar

Determine os servidores ou clusters nos quais instalar e configurar um repositório SDO conforme descrito em Planejando a Instalação de Serviços da Web Ativados pelo Barramento; em seguida, inclua cada servidor ou cluster como membro de um barramento conforme descrito em Configurando os Membros de um Barramento.

Um repositório SDO pode trabalhar com a maioria dos produtos de banco de dados. Para obter informações específicas sobre como escolher e configurar seu banco de dados preferencial, consulte o administrador de banco de dados ou a documentação do produto de banco de dados e leia as observações de uso do banco de dados fornecidas neste tópico.

Sobre Esta Tarefa

Para instalar e configurar um repositório SDO, conclua as seguintes etapas:
  • Instalar seu produto de banco de dados preferido.
  • Criar um provedor JDBC e uma origem de dados para seu banco de dados.
  • Executar o script installSdoRepository.jacl uma ou mais vezes, para instalar o aplicativo SDO em cada servidor e definir o tipo de banco de dados que o repositório SDO utilizará.
Para obter mais informações sobre como fazer isso, primeiro leia as observações a seguir sobre uso do banco de dados e sobre o script installSdoRepository.jacl e, em seguida, conclua as etapas para uma destas configurações:
Observações sobre uso do banco de dados:
  • [AIX Solaris HP-UX Linux Windows][IBM i]Para uma configuração de servidor único, é possível usar o banco de dados preferencial ou o banco de dados integrado Apache Derby, fornecido com o WebSphere Application Server. [z/OS]Em um ambiente z/OS, não é possível usar o banco de dados Derby integrado, pois esse banco de dados só pode ser acessado por um processo por vez, e mesmo um único servidor no z/OS pode ser executado em diversos processos.
  • Para uma configuração de implementação de rede, é possível usar o banco de dados preferencial ou o banco de dados Derby fornecido e o aplicativo Network Server associado. No entanto, lembre-se as limitações do Derby Network Server. Por exemplo, ele não suporta transações.
  • O repositório SDO determina o esquema e os nomes de tabela que são usados, assim, os diferentes repositórios deverão usar bancos de dados diferentes para assegurar que não acessem os mesmos dados.. Utilize um repositório SDO para cada célula, de modo que, se você tiver várias células, diversos bancos de dados sejam usados, um para cada célula.
  • [z/OS]O DB2 no z/OS não possui o conceito de vários bancos de dados. Em sistemas z/OS, cada repositório SDO deve utilizar uma instância DB2 diferente para assegurar que os diferentes repositórios não acessarão os mesmos dados.
  • Crie o banco de dados para o seu fornecedor de banco de dados preferido usando o arquivo Table.ddl a partir do diretório app_server_root/util/SdoRepository/database_type relevante. O arquivo Table.ddl descreve a tabela de banco de dados que é necessária ao repositório SDO.
  • O sinalizador -editBackendId no script installSdoRepository.jacl determina o tipo de banco de dados que o repositório deve usar. O ID de back end determina quais regras específicas do banco de dados o aplicativo segue ao falar com o banco de dados. Consulte a observação associada sobre o script installSdoRepository.jacl.
  • Alguns bancos de dados requerem que o ID do usuário que recebeu as permissões acesse o banco de dados de repositório SDO. Crie um ID de usuário para o nome de usuário SDOREP antes de criar tabelas para os bancos de dados Oracle, Sybase e SQL Server. Devido à maneira como esses bancos de dados tratam os nomes de usuários e os nomes de tabelas, o nome do usuário deve ser SDOREP para ativar o repositório SDO para acessar sua tabela com o nome completo SDOREP.BYTESTORE. Assegure-se de conceder permissão para que o usuário SDOREP possa efetuar leitura e gravação no banco de dados.
  • Se você utilizar um banco de dados Informix, não desative a criação de log.
  • O repositório SDO não requer suporte XA. Na maioria dos casos, é possível usar uma origem de dados XA ou não XA. No entanto, se seu banco de dados for Oracle 8 ou 9, você deverá usar o driver JDBC Oracle (não XA) para a origem de dados do repositório SDO.
  • Você também pode optar por concluir outras etapas, como a criação de um índice de chaves primárias, para melhorar o desempenho do banco de dados. Não altere os nomes de esquema, tabela e coluna.
  • Se estiver configurando esse repositório SDO para ser usado com uma célula que contém uma combinação de servidores de aplicativos do WebSphere Application Server Versão 6.0, Versão 6.1 e de outros servidores de aplicativos, use um banco de dados que seja compatível com todas essas versões.
Observações sobre o script installSdoRepository.jacl:
  • Utilize o cliente de script wsadmin para executar o script.
  • [IBM i]Execute o script de dentro do Qshell.
  • O script é fornecido no diretório app_server_root/bin, em que app_server_root é o diretório-raiz para a instalação do WebSphere Application Server. Se você optar por executar o cliente de script wsadmin de outro diretório, especifique o caminho completo para o script na opção de comando. Por exemplo, para trabalhar com um perfil diferente do perfil padrão, altere para o diretório app_server_root/profiles/profile_name/bin, em seguida, especifique o caminho a seguir para o script:[IBM i]
    wsadmin -f app_server_root/bin/installSdoRepository.jacl
    [AIX Solaris HP-UX Linux Windows][z/OS]
    wsadmin.ext -f app_server_root/bin/installSdoRepository.jacl
    [AIX Solaris HP-UX Linux Windows][z/OS]em que .ext é a extensão do arquivo .bat para um sistema Windows ou .sh para um sistema UNIX, Linux ou z/OS.
  • O sinalizador -editBackendId no script installSdoRepository.jacl determina o tipo de banco de dados que o repositório deve usar. O ID de back end determina quais regras específicas do banco de dados o aplicativo segue ao falar com o banco de dados. Para ver a lista de valores de ID de back end disponíveis, utilize o sinalizador -listBackendIds:
    wsadmin -f installSdoRepository.jacl -listBackendIds
    Todos os valores de ID de back end da lista podem ser usados quando o repositório SDO está instalado em um ou mais servidores de aplicativos WebSphere Application Server Versão 7.0 ou posterior. Os valores marcados com (*) não podem ser usados quando o repositório SDO está instalado nos servidores Versão 6.0. Os valores marcados com (**) não podem ser usados quando o repositório SDO está instalado nos servidores Versão 6.0 ou Versão 6.1.
  • Se a origem de dados já existe, ou houve uma instalação interrompida ou parcial anterior do aplicativo de repositório SDO, o script installSdoRepository.jacl não será concluído e as alterações de configuração não serão salvas. Nesses casos, execute o script de desinstalação do repositório SDO, corrija o problema e execute novamente o script installSdoRepository.jacl.
[IBM i][AIX Solaris HP-UX Linux Windows]

Configurar o Repositório SDO para um Único Servidor e para Usar o Banco de Dados Derby Integrado

[z/OS]

Antes de Iniciar

[z/OS]Em um ambiente z/OS, não é possível usar o banco de dados Derby integrado, pois esse banco de dados só pode ser acessado por um processo por vez, e mesmo um único servidor no z/OS pode ser executado em diversos processos.

Sobre Esta Tarefa

Se você estiver criando uma configuração de servidor único e desejar usar o Derby integrado, execute o script installSdoRepository.jacl com o comutador -createDb. Esta seção cria o banco de dados Derby e instala o repositório SDO.

Para configurar o repositório SDO para um único servidor e para usar o banco de dados Derby integrado, conclua as seguintes etapas:

Procedimento

  1. Abra um prompt de comandos, em seguida, vá para o diretório app_server_root/bin.
  2. Digite o seguinte comando: [IBM i]
    wsadmin -f installSdoRepository.jacl -createDb
    [AIX Solaris HP-UX Linux Windows][z/OS]
    wsadmin.ext -f installSdoRepository.jacl -createDb
    Nota: O sinalizador -createDb instrui o comando a criar um banco de dados Derby padrão. Se você omitir esse sinalizador, o comando ainda instalará um repositório SDO configurado para usar o Derby, mas não criará também o banco de dados.

Configurar o Repositório SDO para um Único Servidor e para Usar um Banco de Dados Diferente do Derby Integrado

Sobre Esta Tarefa

Se você estiver criando uma configuração de servidor único que usa um banco de dados diferente do Derby integrado, instale o produto de banco de dados de sua preferência e, em seguida, crie um provedor JDBC e uma origem de dados, depois, execute o script installSdoRepository.jacl duas vezes:
  1. Uma vez para instalar o aplicativo SDO no servidor de aplicativos.
  2. Uma vez para configurar o tipo de banco de dados que será utilizado pelo repositório SDO.

Para configurar o repositório SDO para um servidor único e para usar um banco de dados diferente do Derby integrado, conclua as seguintes etapas:

Procedimento

  1. Crie o banco de dados para o seu fornecedor de banco de dados preferido usando o arquivo Table.ddl a partir do diretório app_server_root/util/SdoRepository/database_type relevante.

    Para obter uma ilustração do processo de criação de tabelas no DB2, consulte Criando as Tabelas de Banco de Dados Novamente a partir da Tabela Exportada Data Definition Language. Para obter informações adicionais, consulte Implementando aplicativos de acesso de dados.

  2. Crie um alias de autenticação J2C.

    Isso é para ser utilizado com a origem de dados criada na próxima etapa. Verifique se o alias da autenticação corresponde aos detalhes de login de sua instância do banco de dados; caso contrário, uma conexão não será estabelecida.

  3. Crie e configure um provedor e uma origem de dados JDBC.
    Configure as seguintes propriedades de origem de dados:
    • Configure a propriedade authentication para utilizar o alias de autenticação criado na etapa anterior.
    • Selecione a caixa de opções Utilizar esta Origem de Dados no CMP (Container Managed Persistence).
    • Configure a propriedade Name como um nome de sua escolha. Por exemplo, Origem de Dados do Repositório SDO.
    • Configure a propriedade JNDI name como o seguinte valor exato: jdbc/com.ibm.ws.sdo.config/SdoRepository.
    • Configure todas as outras propriedades que sejam configurações necessárias para o banco de dados de sua escolha.
  4. Opcional: Teste a conexão da origem de dados:
    Nota: Essa opção não funciona em todas as configurações. A disponibilidade dessa opção depende do escopo em que a origem de dados está definida e do escopo de qualquer variável do WebSphere Application Server que for usada nas configurações de origem de dados e do provedor JDBC. Para obter informações adicionais sobre o teste de conexões para origens de dados, consulte Testar Serviço de Conexão.
    1. No console administrativo, navegue para Recursos -> JDBC -> Origens de dados.
    2. Selecione a origem de dados do repositório SDO.
    3. Clique em Testar Conexão.
  5. Configure o repositório SDO:
    1. Abra um prompt de comandos e, em seguida, acesse o diretório app_server_root/bin.
    2. Instale o aplicativo de repositório SDO no servidor: [IBM i]
      wsadmin -f installSdoRepository.jacl
      [AIX Solaris HP-UX Linux Windows][z/OS]
      wsadmin.ext -f installSdoRepository.jacl
    3. Configure o tipo de banco de dados que o repositório SDO utilizará:
      [IBM i]
      wsadmin -f installSdoRepository.jacl -editBackendId database_type
      [AIX Solaris HP-UX Linux Windows][z/OS]
      wsadmin.ext -f installSdoRepository.jacl -editBackendId database_type
      por exemplo:[IBM i]
      wsadmin -f installSdoRepository.jacl -editBackendId DB2UDB_V82
      [AIX Solaris HP-UX Linux Windows][z/OS]
      wsadmin.ext -f installSdoRepository.jacl -editBackendId DB2UDB_V82

Configurar o Repositório SDO para uma Célula de Implementação de Rede

Sobre Esta Tarefa

Se você estiver trabalhando em um ambiente de implementação de rede, instale o produto de banco de dados preferido, em seguida, crie um provedor JDBC e uma origem de dados e execute o script installSdoRepository.jacl várias vezes para cada célula:
  1. Uma vez para instalar o aplicativo SDO no gerenciador de implementação.
  2. Uma vez para configurar o tipo de banco de dados que será utilizado pelo repositório SDO.
  3. Várias vezes para instalar uma instância do aplicativo SDO em cada servidor ou cluster que você planeja usar para uma ou mais das funções de serviços da web ativadas pelo barramento.

Para configurar o repositório SDO para uma célula de implementação de rede, conclua as seguintes etapas:

Procedimento

  1. Crie o banco de dados para o seu fornecedor de banco de dados preferido usando o arquivo Table.ddl a partir do diretório app_server_root/util/SdoRepository/database_type relevante.

    Para obter uma ilustração do processo de criação de tabelas no DB2, consulte Criando as Tabelas de Banco de Dados Novamente a partir da Tabela Exportada Data Definition Language. Para obter informações adicionais, consulte Implementando aplicativos de acesso de dados.

  2. Crie as seguintes variáveis do WebSphere Application Server do nível do nó, incluindo o nó do gerenciador de implementação.
    Nota: É possível configurar essas variáveis em qualquer escopo do nó ou da célula, dependendo de sua configuração. No entanto, para nós multiplataforma, você não pode configurar de maneira útil WAS_INSTALL_ROOT no escopo da célula, porque os nós possuem diretórios de instalação diferentes.
    1. No console administrativo, navegue para Ambiente -> Variáveis do WebSphere, em seguida, configure o escopo no nível do nó.
    2. Verifique se a variável WAS_INSTALL_ROOT existe, com um valor do diretório raiz da instalação do WebSphere Application Server.
    3. Crie uma nova variável seu_banco_de_dados_JDBC_DRIVER_PATH, com um valor do local no qual os arquivos JAR de seu banco de dados serão armazenados (em uma etapa posterior) em cada máquina host da célula.
  3. Crie um alias de autenticação J2C.

    Isso é para ser utilizado com a origem de dados criada na próxima etapa. Verifique se o alias da autenticação corresponde aos detalhes de login de sua instância do banco de dados; caso contrário, uma conexão não será estabelecida.

  4. Crie e configure um provedor e uma origem de dados JDBC.
    Configure as seguintes propriedades de origem de dados:
    • Configure a propriedade authentication para utilizar o alias de autenticação criado na etapa anterior.
    • Selecione a caixa de opções Utilizar esta Origem de Dados no CMP (Container Managed Persistence).
    • Configure a propriedade Name como um nome de sua escolha. Por exemplo, Origem de Dados do Repositório SDO.
    • Configure a propriedade JNDI name como o seguinte valor exato: jdbc/com.ibm.ws.sdo.config/SdoRepository.
    • Configure todas as outras propriedades que sejam configurações necessárias para o banco de dados de sua escolha.
  5. Implemente os arquivos JAR do cliente de banco de dados em cada uma das máquinas host na célula.

    Os arquivos JAR devem ser implementados no local fornecido pela variável seu_banco_de_dados_JDBC_DRIVER_PATH que você declarou em uma etapa anterior, caso contrário, os nós remotos não poderão se conectar ao repositório SDO.

  6. Configure o repositório SDO:
    1. Abra um prompt de comandos e, em seguida, acesse o diretório app_server_root/bin.
    2. Instale o aplicativo do repositório SDO no gerenciador de implementação para esta célula: [IBM i]
      wsadmin -f installSdoRepository.jacl deployment_manager_node_name deployment_manager_server_name
      [AIX Solaris HP-UX Linux Windows][z/OS]
      wsadmin.ext -f installSdoRepository.jacl deployment_manager_node_name deployment_manager_server_name
      por exemplo:[IBM i]
      wsadmin -f installSdoRepository.jacl dmgrNode dmgr
      [AIX Solaris HP-UX Linux Windows][z/OS]
      wsadmin.sh -f installSdoRepository.jacl dmgrNode dmgr
    3. Configure o tipo de banco de dados que o repositório SDO utilizará:
      [IBM i]
      wsadmin -f installSdoRepository.jacl -editBackendId database_type
      [AIX Solaris HP-UX Linux Windows][z/OS]
      wsadmin.ext -f installSdoRepository.jacl -editBackendId database_type
      por exemplo:[IBM i]
      wsadmin -f installSdoRepository.jacl -editBackendId DB2UDB_V82
      [AIX Solaris HP-UX Linux Windows][z/OS]
      wsadmin.ext -f installSdoRepository.jacl -editBackendId DB2UDB_V82
    4. Instale uma instância do repositório SDO em cada servidor ou cluster que você planeja usar para uma ou mais funções de serviços da web ativadas pelo barramento:
      • Para cada servidor que não faz parte de um cluster, repita o seguinte comando:[IBM i]
        wsadmin -f installSdoRepository.jacl node_name server_name
        [AIX Solaris HP-UX Linux Windows][z/OS]
        wsadmin.ext -f installSdoRepository.jacl node_name server_name
      • Para cada cluster, repita o seguinte comando:[IBM i]
        wsadmin -f installSdoRepository.jacl -cluster cluster_name
        [AIX Solaris HP-UX Linux Windows][z/OS]
        wsadmin.ext -f installSdoRepository.jacl -cluster cluster_name

Ícone que indica o tipo de tópico Tópico de Tarefa



Ícone de registro de data e hora Última atualização: last_date
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=tjw_install_sdo
Nome do arquivo: tjw_install_sdo.html