Implementando o Serviço de Dados REST no Apache Tomcat

Este tópico descreve como configurar o serviço de dados REST do WebSphere eXtreme Scale no Apache Tomcat Versão 5.5 ou posterior.

Sobre Esta Tarefa

Procedimento

  1. Se estiver usando um Oracle JRE ou JDK, instale o IBM ORB no Tomcat:
    1. Tomcat versão 5.5:

      Copie todos os arquivos JAR de:

      o diretório wxs_home/lib/endorsed

      para:

      o diretório tomcat_root/common/endorsed

    2. Tomcat versão 6.0:

      Crie um diretório "endorsed":

      [Unix][Linux] mkdir tomcat_root/endorsed

      [Windows] md tomcat_root/endorsed

      Copie todos os arquivos JAR de:

      wxs_home/lib/endorsed

      para:

      tomcat_root/common/endorsed

  2. Configure e inicie uma grade de dados.
    1. Para obter detalhes sobre como configurar uma grade de dados para usar com o serviço de dados REST, consulte Configurando.
    2. Verifique se um cliente do eXtreme Scale pode conectar e acessar entidades na grade. Para obter um exemplo, consulte Configurando Serviços de Dados REST.
  3. Construa a JAR da configuração do serviço eXtreme Scale REST ou o diretório. Consulte as informações de empacotamento e implementação no Instalando o Serviço de Dados REST para obter detalhes.
  4. Implemente o módulo de serviço de dados REST: wxsrestservice.war para o servidor Tomcat.

    Copie o arquivo wxsrestservice.war a partir de:

    restservice_home/lib

    para:

    tomcat_root/webapps

  5. Inclua o JAR de tempo de execução do cliente ObjectGrid e o JAR do aplicativo no caminho de classe compartilhado no Tomcat:
    1. Edite o arquivo tomcat_root/conf/catalina.properties
    2. Anexe os seguintes nomes de caminhos no final da propriedade shared.loader, separando cada nome de caminho por uma vírgula:
  6. Se você estiver usando a segurança Java 2, inclua permissões de segurança para o arquivo de políticas tomcat:
    • Se estiver utilizando Tomcat versão 5.5:

      Mescle o conteúdo do arquivo 5.5 catalina policy de amostra localizado em

      restservice_home/gettingstarted/tomcat/catalina-5_5.policy com o arquivo tomcat_root/conf/catalina.policy.

    • Se estiver utilizando Tomcat versão 6.0:

      Mescle o conteúdo do arquivo 6.0 catalina policy de amostra localizado em

      restservice_home/gettingstarted/tomcat/catalina-6_0.policy com o arquivo tomcat_root/conf/catalina.policy.

  7. Inicie o servidor Tomcat:
    • Se estiver usando Tomcat 5.5 no UNIX ou Windows ou a distribuição ZIP de Tomcat 6.0:

      1. cd tomcat_root/bin
      2. Inicie o servidor:
        • Sem a segurança Java 2 ativada:

          [Unix][Linux] ./catalina.sh run

          [Windows] catalina.bat run

        • Com a segurança Java 2 ativada:

          [Unix][Linux] ./catalina.sh run -security

          [Windows] catalina.bat run -security

      3. Os logs do Apache Tomcat são exibidos no console. Quando o serviço de dados REST for iniciado com êxito, a seguinte mensagem será exibida no console administrativo:

        CWOBJ4000I: O serviço de dados REST do WebSphere eXtreme Scale foi iniciado.

    • Se estiver usando Tomcat 6.0 no Windows usando a distribuição do Windows Installer:
      1. cd /bin
      2. Inicie a ferramenta de configuração do Apache Tomcat 6:

        tomcat6w.exe

      3. Para ativar a segurança Java 2 (opcional):

        Inclua as seguintes entradas em Opções Java na guia Java na janela de propriedades do Apache Tomcat 6:

        -Djava.security.manager

        -Djava.security.policy=\conf\catalina.policy

      4. Clique no botão Iniciar na janela de propriedades do Apache Tomcat 6 para iniciar o servidor Tomcat.
      5. Revise os seguintes logs para verificar se o servidor Tomcat foi iniciado com sucesso:
        • tomcat_root/bin/catalina.log

          Exibe o status do mecanismo do servidor Tomcat

        • tomcat_root/bin/stdout.log

          Exibe o log de saída do sistema

      6. Quando o serviço de dados REST for iniciado com sucesso, a seguinte mensagem será exibida no log de saída do sistema:

        CWOBJ4000I: O serviço de dados REST do WebSphere eXtreme Scale foi iniciado.

  8. Verifique se o serviço de dados REST está funcionando.
    Abra um navegador da Web e navegue para a seguinte URL:
    http://host:port/context_root/restservice/grid_name

    A porta padrão para o Tomcat é 8080 e está configurada no arquivo tomcat_root/conf/server.xml no elemento <Connector>.

    Por exemplo:
    http://localhost:8080/wxsrestservice/restservice/NorthwindGrid/

Resultados

O documento de serviço AtomPub é exibido.