Iniciando Serviços de Dados REST no Apache Tomcat

Este tópico descreve como configurar e iniciar o serviço de dados REST do eXtreme Scale usando o Apache Tomcat, versão 5.5 ou posterior.

Antes de Iniciar

Verifique se a grade de dados do eXtreme Scale de amostra foi iniciada. Consulte o Ativando o Serviço de Dados REST para obter detalhes sobre como iniciar a grade de dados.

Procedimento

  1. Faça download e instale o Apache Tomcat Versão 5.5 ou posterior em tomcat_root. Por exemplo: /opt/tomcat
  2. Instale o serviço de dados REST do eXtreme Scale e a amostra fornecida no servidor Tomcat da seguinte maneira:
    1. Se você estiver usando um Oracle JRE ou JDK, deve instalar o IBM® ORB no Tomcat:
      • Para Tomcat versão 5.5

        Copie todos os arquivos JAR de:

        wxs_home/lib/endorsed

        para

        tomcat_root/common/endorsed

      • Para Tomcat versão 6.0
        1. Crie um diretório "endorsed"
          • [Unix][Linux] mkdir tomcat_root/endorsed
          • [Windows] md tomcat_root/endorsed
        2. Copie todos os arquivos JAR de:

          wxs_home/lib/endorsed

          para

          tomcat_root/endorsed

    2. Implemente o módulo de serviço de dados REST: wxsrestservice.war para o servidor Tomcat.

      Copie o arquivo wxsrestservice.war de:

      restservice_home/lib

      para:

      tomcat_root/webapps

    3. 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 caminho no final da propriedade shared.loader no formato de lista separada por vírgula:
        • wxs_home/lib/ogclient.jar
        • restservice_home/gettingstarted/restclient/bin
        • restservice_home/gettingstarted/common/bin
        Importante: O separador de caminho deve ser uma barra.

  3. Se a grade de dados do eXtreme Scale foi iniciada com a segurança do eXtreme Scale ativada, configure as seguintes propriedades no arquivo restservice_home/gettingstarted/restclient/bin/wxsRestService.properties.
    ogClientPropertyFile=restservice_home/gettingstarted/security/security.ogclient.properties
    loginType=none
  4. Inicie o servidor Tomcat com o serviço de dados REST:
    • Se estiver utilizando Tomcat 5.5 no UNIX ou Windows, ou Tomcat 6.0 no UNIX:
      1. cd tomcat_root/bin
      2. Inicie o servidor:
        • [Unix][Linux] ./catalina.sh run
        • [Windows] catalina.bat run
      3. O console exibirá logs do Apache Tomcat. Quando o serviço de dados REST for iniciado com sucesso, a seguinte mensagem será exibida no console administrativo:

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

    • Se estiver utilizando Tomcat 6.0 no Windows:
      1. cd tomcat_root/bin
      2. Inicie a ferramenta de configuração do Apache Tomcat 6 com o seguinte comando: tomcat6w.exe
      3. Clique no botão Iniciar na janela de propriedades do Apache Tomcat 6 para iniciar o servidor Tomcat.
      4. 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.

      5. 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.
  5. Verifique se o serviço de dados REST está funcionando:
    1. Abra um navegador e navegue para:

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

      O documento de serviço para NorthwindGrid é exibido.

    2. Navegue para:

      http://localhost:8080/wxsrestservice/restservice/NorthwindGrid/$metadata

      O documento Entity Model Data Extensions (EDMX) é exibido.

  6. Para parar os processos da grade de dados, use CTRL+C na respectiva janela de comando.
  7. Para parar o Tomcat, utilize CTRL +C na janela onde o iniciou.