Configurando aplicativos do WebSphere Application Server com os scripts de configuração e verificação do pureQuery Runtime

O diretório de instalação do pureQuery contém scripts que configuram o WebSphere Application Server para executar os aplicativos ativados do pureQuery. O diretório também contém um aplicativo de servlet do WebSphere que verifica se o WebSphere Application Server está configurado corretamente.

Antes de Iniciar

O usuário que estiver executando os scripts deve possuir os privilégios a seguir:

Sobre Esta Tarefa

Os scripts estão no diretório PureQuery_Websphere_Config_Scripts do diretório de instalação do pureQuery Runtime.

É possível executar os scripts sem especificar parâmetros para exibir os parâmetros necessários e opcionais para o script.

Procedimento

Para executar os scripts a fim de configurar o WebSphere Application Server para funcionar com o pureQuery Runtime e verificar a configuração, execute os scripts nesta ordem:

  1. Execute o script InstallPQJars para atualizar um caminho da classe de provedor JDBC com as informações do pureQuery Runtime.
  2. Execute o script SetupDSProp para criar uma propriedade customizada de origem de dados que especifique as propriedades do pureQuery Runtime.
  3. Execute o script InstallPQValidator para verificar a configuração do pureQuery Runtime.

Execute o script InstallPQJars para incluir os arquivos JAR pureQuery Runtime a um caminho da classe do provedor JDBC

Ao executar o script InstallPQJars, você especifica o escopo do provedor JDBC do WebSphere a ser atualizado e o caminho para os arquivos JAR do pureQuery Runtime. Você seleciona o provedor JDBC a partir de uma lista de provedores que o script exibe. O script atualiza o caminho da classe do provedor JDBC que você especifica. Após o script configurar o caminho da classe do provedor, ele exibe informações sobre o provedor JDBC do WebSphere, pureQuery Runtime e o ambiente Java.

Procedimento

Para executar o script a ser incluído aos arquivos JAR do pureQuery Runtime a um caminho da classe do provedor JDBC:

  1. Abra uma janela de comando e execute o script InstallPQJars. Por exemplo, este comando especifica se o nó devNode01 do WebSphere e o caminho para os arquivos JAR do pureQuery Runtime são C:/PureQueryRuntime. :
     InstallPQJars -node devNode01 -pqPath C:/PureQueryRuntime

    O comando de exemplo assume que os provedores JDBC WebSphere JDBC são definidos no nível do nó e que a instalação do WebSphere Application Server é uma instalação simples e independente.

  2. Siga as instruções de script para configurar o caminho da classe do provedor JDBC.

    Se o script detectar os arquivos JAR do pureQuery Runtime no caminho da classe, é possível escolher atualizar o caminho da classe ou manter o atual caminho da classe.

    Quando o script é concluído, ele exibe o WebSphere, pureQuery e as informações de configuração Java.

O que Fazer Depois

No console administrativo, é possível visualizar o caminho da classe do provedor JDBC atualizado com as informações do pureQuery Runtime.

Em seguida, execute o script SetupDSProp para configurar uma origem de dados do provedor JDBC com as propriedades do pureQuery Runtime.

Execute o Script do SetupDSProp para Incluir as Propriedades do pureQuery Runtime a uma Origem de Dados

Ao executar o script SetupDSProp, você especifica os valores da propriedade do pureQuery Runtime e um servidor WebSphere. O script SetupDSProp cria a propriedade customizada pdqProperties para a origem de dados especificada. O valor da propriedade é a lista de valores da propriedade pureQuery Runtime especificada.

Procedimento

Para executar o script para configurar uma origem de dados:

  1. Abra uma janela de comando e execute o script SetupDSProp. Por exemplo, este comando especifica o servidor WebSphere server1 e especifica o valor da propriedade captureMode do pureQuery Runtime como ON, e o valor da propriedade pureQueryXml como C:\temp\capture.pdqxml.
    SetupDSProp -server server1 -props "captureMode(ON),
    pureQueryXml(C:\temp\capture.pdqxml)"
    Nota: O script não valida os valores da propriedade do pureQuery Runtime que você especifica. Ele cria a propriedade customizada pdqProperties com a sequência como o valor da propriedade.
  2. Siga as instruções de script para configurar a origem de dados.

    Após selecionar a origem de dados para configurar, os scripts criam a propriedade customizada. Em seguida, o script exibe informações sobre a origem de dados e a propriedade customizada.

Resultados

A partir do console administrativo, é possível verificar se a propriedade customizada pdqProperties está configurada. A propriedade é listada como uma propriedade customizada para a origem de dados.

O que Fazer Depois

Em seguida, execute o script InstallPQValidator para verificar se a configuração do pureQuery Runtime está correta executando o script InstallPQValidator.

Executando o script InstallPQValidator para verificar a configuração do pureQuery Runtime

O script InstallPQValidator instala e inicia o servlet WebSphere RunPQDataVersionEAR.ear. O servlet valida a configuração do pureQuery e os pré-requisitos do pureQuery Runtime para a origem de dados. O servlet exibe o contexto, os carregadores de classes de aplicativo, as propriedades globais do pureQuery e as informações da versão do pureQuery Runtime.

Procedimento

Para executar o script a fim de verificar a instalação do pureQuery Runtime:

  1. Abra uma janela de comando e execute o script InstallPQValidator. Por exemplo, este comando especifica o servidor WebSphere server1, nó devNode01.
    InstallPQValidator -server server1 -node devNode01
    O script instala e inicia o servlet

    O servlet está listado como um aplicativo no console administrativo.

  2. Execute o servlet a partir de um navegador. Inicie um navegador e insira a URL para executar o servlet.
    Por exemplo, esta URL assume que o WebSphere está em execução, que o servlet está no computador e que a porta WebSphere Application Server é 9081:
    http://localhost:9081/RunPQValidate/
    A página do servlet é aberta.
  3. Na página do servlet, insira o nome JNDI para a origem de dados do DB2 e clique em Enviar.

    O servlet faz uma conexão com a origem de dados e, em seguida, exibe as informações de configuração na janela do navegador.

O que Fazer Depois

A origem de dados WebSphere Application Server é configurada para o pureQuery Runtime. Os aplicativos ativados do pureQuery podem usar a origem de dados para acessar um banco de dados DB2.

Feedback