É possível configurar o serviço de dados REST do eXtreme Scale no WebSphere Application Server Community Edition Version 2.1.1.3 ou posterior.
Antes de Iniciar
- Um IBM® (recomendado) ou Oracle JRE ou JDK, Versão 5
ou posterior está instalado e a variável de ambiente JAVA_HOME está configurada.
- Faça download e instale o WebSphere Application Server Community Edition Versão 2.1.1.3 ou posterior no
diretório wasce_root, por exemplo, o diretório /opt/IBM/wasce.
Leia as instruções de instalação
para obter informações sobre o
versão
2.1.1 ou
outras
versões.
Procedimento
- Configure e inicie uma grade de
dados.
- Para obter detalhes sobre como configurar uma grade de dados do eXtreme Scale para usar com o serviço de dados REST, consulte o Iniciando uma Grade de Dados Independente para os Serviços de Dados REST.
- Verifique se um cliente do eXtreme Scale pode se conectar com, e
acessar, as entidades na grade. Para obter um exemplo, consulte Tutorial: Introdução ao WebSphere eXtreme Scale.
- 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 tópico Instalando o Serviço de Dados REST para obter
detalhes.
- Inicie o servidor WebSphere Application Server Community Edition:
- Para iniciar o servidor sem a segurança
Java SE ativada, execute o
seguinte comando:
![[Unix]](./icons/ngunix.gif)
wasce_root/bin/startup.sh
wasce_root/bin/startup.bat
- Para iniciar o servidor com a segurança
Java SE ativada, siga estas
etapas:
![[Unix]](./icons/ngunix.gif)
- Abra uma janela de linha de comandos ou de terminal e execute o seguinte comando
de cópia (ou copie o conteúdo do arquivo de política especificado na política existente):
cp restservice_home/gettingstarted/wasce/geronimo.policy
wasce_root/bin
- Edite o arquivo wasce_root/bin/setenv.sh
- Depois da linha que contém "WASCE_JAVA_HOME=",
inclua o seguinte: export JAVA_OPTS="-Djava.security.manager
-Djava.security.policy=geronimo.policy"
- Abra uma janela de linha de comandos e execute o seguinte comando
de cópia, ou copie o conteúdo do arquivo de políticas especificado na
política existente:
copy restservice_home\gettingstarted\wasce\geronimo.policy\bin
- Edite o arquivo wasce_root\bin\setenv.bat
- Após a linha contendo "set WASCE_JAVA_HOME=", inclua o seguinte:
set JAVA_OPTS="-Djava.security.manager
-Djava.security.policy=geronimo.policy"
- Inclua o JAR de tempo de execução do cliente ObjectGrid ao repositório WebSphere Application Server Community Edition:
- Abra o console administrativo WebSphere Application Server Community Edition
e efetue login. A URL padrão é: http://localhost:8080/console,
o ID do usuário padrão é system e a senha é manager.
- Clique no link Repositório no lado esquerdo da
janela do console, na pasta Serviços.
- Na seção Incluir Archive no Repositório,
preencha o seguinte nas caixas de texto de entrada:
Tabela 1. Incluir Archive no RepositórioCaixa de texto |
Valor |
File |
wxs_home/lib/ogclient.jar |
Grupo |
com.ibm.websphere.xs |
Artefato |
ogclient |
Versão |
7.1 |
Tipo |
JAR |
- Clique no botão Instalar
Consulte a seguinte nota técnica para obter detalhes sobre as diferentes maneiras pelas quais
as dependências de classe e de biblioteca podem ser configuradas:Especificando dependências externas para aplicativos em execução no WebSphere Application
Server Community Edition.
- Implemente e inicie o módulo do serviço de dados REST, o arquivo wxsrestservice.war,
para o servidor WebSphere Application Server Community Edition.
- Copie e edite o arquivo XML do plano de implementação de amostra: restservice_home/gettingstarted/wasce/geronimo-web.xml para
incluir dependências do caminho para o JAR ou o diretório de configuração
do seu serviço de dados REST. Consulte a seção para obter um exemplo sobre como configurar
o caminho de classe para incluir seu arquivo wxsRestService.properties
e outros arquivos de configuração e classes de metadados.
- Abra o console administrativo WebSphere Application Server Community Edition
e efetue login.
Dica: A URL padrão é: http://localhost:8080/console.
O ID de usuário padrão é system e a senha é
manager.
- Clique no link Implementar Novo no lado esquerdo
da janela do console.
- Na página Instalar Novos Aplicativos, insira
os seguintes valores nas caixas de texto:
Tabela 2. Instalar Novos AplicativosCaixa de texto |
Valor |
Archive |
restservice_home/lib/wxsrestservice.war |
Plano |
restservice_home/gettingstarted/wasce/geronimo-web.xml |
Dica: Use o caminho para o arquivo geronimo-web.xml
que você copiou e editou na etapa 3.
- Clique no botão Instalar. A página do console indica que o
aplicativo foi instalado e iniciado com sucesso.
- Examine o log de saída do sistema ou o console do WebSphere Application Server Community Edition para verificar se o serviço de dados REST foi iniciado com êxito. A seguinte mensagem deve aparecer:
CWOBJ4000I: O serviço de
dados REST do WebSphere eXtreme Scale foi iniciado.
- Inicie o servidor WebSphere Application Server Community Edition
executando o seguinte comando:
![[Unix]](./icons/ngunix.gif)
wasce_root/bin/startup.sh
wasce_root/bin/startup.bat
- Instale o serviço de dados REST do eXtreme Scale e a
amostra fornecida no servidor WebSphere Application Server Community Edition:
- Inclua o JAR de tempo de execução do cliente ObjectGrid ao repositório WebSphere Application Server Community Edition:
- Abra o console administrativo WebSphere Application Server Community Edition
e efetue login. A URL padrão é: http://localhost:8080/console.
O ID de usuário padrão é system e a senha é
manager.
- Clique no link Repositório no lado esquerdo
da janela do console, na pasta Serviços.
- Na seção Incluir Archive no Repositório,
preencha o seguinte nas caixas de texto de entrada:
Tabela 3. Incluir Archive no RepositórioCaixa de texto |
Valor |
File |
wxs_home/lib/ogclient.jar |
Grupo |
com.ibm.websphere.xs |
Artefato |
ogclient |
Versão |
7.1 |
Tipo |
JAR |
- Clique no botão Instalar.
- Implemente o módulo de serviço de dados REST: wxsrestservice.war para
o servidor WebSphere Application Server Community Edition.
- Edite o arquivo XML de implementação restservice_home/gettingstarted/wasce/geronimo-web.xml de amostra para incluir dependências do caminho nos diretórios do caminho de classe de amostra
de introdução:
- Altere "classesDirs" para os dois GBeans do cliente de introdução:
O caminho "classesDirs" para o GBean GettingStarted_Client_SharedLib deve ser configurado para: restservice_home/gettingstarted/restclient/binO caminho "classesDirs" para o GBean GettingStarted_Common_SharedLib deve ser configurado
para: restservice_home/gettingstarted/common/bin
- Abra o console administrativo WebSphere Application Server Community Edition
e efetue login.
- Clique no link Implementar Novo no lado esquerdo
da janela do console.
- Na página Instalar Novos Aplicativos, insira
os seguintes valores nas caixas de texto:
Tabela 4. Instalar Novos AplicativosCaixa de texto |
Valor |
Archive |
restservice_home/lib/wxsrestservice.war |
Plano |
restservice_home/gettingstarted/wasce/geronimo-web.xml |
- Clique no botão Instalar.
A página do console indica que o
aplicativo foi instalado e iniciado com sucesso.
- Examine o log de saída do sistema WebSphere Application Server Community Edition
para verificar se o serviço de dados REST foi iniciado com êxito verificando
se a seguinte mensagem está presente:
CWOBJ4000I: O serviço de
dados REST do WebSphere eXtreme Scale foi iniciado.
- 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 WebSphere Application Server Community Edition é 8080 e é definida usando a
propriedade "HTTPPort" no arquivo /var/config/config-substitutions.properties.
Por exemplo:
http://localhost:8080/wxsrestservice/restservice/NorthwindGrid/
Resultados
O documento de serviço AtomPub é exibido.