Migrando uma Configuração de Gateway de Serviços da Web do Versão 5.1
No WebSphere Application Server Versão 5.1, o gateway de serviços da web era um componente separado com sua própria interface com o usuário. Nas versões mais recentes do produto, o gateway esta integrado nos serviços da Web ativados por barramento de integração de serviço e reimplementado como um mecanismo para estender e vincular serviços de entrada e de saída. Use um script de comando wsadmin para migrar uma configuração de gateway existente de um servidor de aplicativos da Versão 5.1 para um servidor de aplicativos ou cluster em uma versão mais recente.
Antes de Iniciar
- WebSphere Application Server Versão 5.0 não é mais suportado, portanto, você deve migrar quaisquer gateways existentes que estejam em execução em servidores de aplicativos do Versão 5.0 para serem executados nos servidores de aplicativos no nível atual do produto.
- Os gateways de serviço da web em execução no WebSphere Application Server Versão 5.1 podem, sujeitos a determinadas restrições, coexistir com as instâncias de gateway em execução nos servidores de aplicativos da Versão 7.0 ou posterior servidores de aplicativos.
- A Versão 7.0 ou posterior pode conter servidores de aplicativos da Versão 5.1, Versão 6 e Versão 7.0 ou posterior servidores de aplicativos.
É possível migrar um gateway da Versão 5.1 que está em uso de produção sem parar o gateway; os aplicativos do solicitante podem ser comutados para utilizar a nova configuração do gateway enquanto o gateway da Versão 5.1 existente continua em execução.
Sobre Esta Tarefa
O procedimento de migração usa um aplicativo gateway Versão 5.1 cuja configuração foi exportada para um arquivo XML, e usa o arquivo XML exportado para configurar as mesmas funções de gateway em um único servidor de aplicativos ou cluster da versão mais recente. Para isso, você exporta a configuração de gateway de Versão 5.1, em seguida, executa um script para migrar a configuração exportada para uma nova instância de gateway em um servidor de aplicativos ou cluster existente na versão mais recente.
- Como parte do processo de migração, uma instância do gateway é criada automaticamente.
- Os serviços de gateway, serviços de destino e referências UDDI são migrados diretamente.
- As definições no gateway das rotinas de tratamento JAX-RPC e das listas de rotina de tratamento também são migradas. Certifique-se de que as classes de rotina de tratamento subjacentes estejam disponíveis no tempo de execução.
- As designações de serviços de gateway a canais específicos são substituídas por designações equivalentes a pares de listener específicos de porta de entrada e terminal (porque, nas versões mais recentes as funções de um canal são compartilhadas entre um listener de terminal e uma porta de entrada). Qualquer uso de um canal do Apache SOAP é migrado para um listener de nó de extremidade SOAP sobre HTTP e uma porta de entrada.
- Os filtros existentes não são migrados. O uso dos filtros foi descontinuado no Versão 5.1.1 e o suporte para filtros foi removido da Versão 7.0. A função anteriormente desempenhada por filtros agora é executada por uma combinação de manipuladores JAX-RPC e mediações do barramento de integração de serviços.
- Os clientes de serviços da Web que são gerados do WSDL para o serviço de destino, em vez do serviço de gateway, são sinalizados por padrão nas versões mais recentes como um erro.
- Se você usou o WSDL de serviço de gateway Versão 5.1 para gerar os seus clientes de serviço da Web e a ligação e o estilo de codificação do WSDL não for literal do documento, após a migração para uma versão mais recente, você deve gerar novamente stubs de cliente, usando o novo WSDL de serviço de gateway.
- As ligações do WS-Security são migradas como ligações que estão em
conformidade com a especificação WS-Security Draft 13. Entretanto:
- A versão final (1.0) da especificação WS-Security (implementada no WebSphere Application Server Versão 6) não é compatível com a versão Draft 13 e, portanto, o uso do WS-Security Draft 13 foi reprovado no WebSphere Application Server Versão 6. O uso do Rascunho 13 do WS-Security foi descontinuado e ele só deve ser usado para permitir o uso continuado de um aplicativo cliente de serviços da Web que está sendo gravado na especificação do Rascunho 13 do WS-Security.
- Os objetos de ligação do WS-Security são migrados apenas se o processo de migração for executado na máquina em que o servidor de destino está sendo executado no caso de um servidor independente ou na máquina em que o gerenciador de implementação está sendo executado em uma configuração de implementação de rede.
- Apenas os objetos de ligação do WS-Security que são utilizados por um Serviço de Gateway ou configuração do WS-Security de Serviço de Destino são migrados. Quaisquer objetos de ligação que você cria, mas não utiliza, não são migrados. Exemplo: Se você possui uma configuração do WS-Security que faça referência a um objeto Signing Information e o objeto Signing Information fizer referência ao Trust Anchor, o objeto Signing Information e o objeto Trust Anchor serão migrados juntamente com a configuração do WS-Security que faz referência a eles.
- A migração assume que os endereços da Web externos para os serviços migrados estão inalterados. Essa suposição é baseada na expectativa de que esses endereços estejam associados a um servidor da Web e não com a máquina na qual o gateway está hospedado e de que o nome do host e o número da porta para esses endereços não sejam, portanto, afetados. Se em sua configuração o endereço da web externo apontar para a máquina de gateway, modifique a configuração do listener terminal após a conclusão do processo de migração.
- Você pode usar o WebSphere Application Server Network Deployment para migrar para um servidor único sendo executado sob um dos perfis de configuração (servidor independente ou gerenciador de implementação). No entanto, é recomendável migrar para um único servidor em execução em um perfil do gerenciador de implementação. Se você migrar para um perfil de servidor independente, não poderá usar o console administrativo para modificar subsequentemente a sua configuração de gateway.
- Os serviços da Web ativados pelo barramento da integração de serviços validam as mensagens do serviço da Web mais completamente do que como é feito no WebSphere Application Server Versão 5.1. Como resultado, alguns aplicativos clientes que utilizam pedidos ou respostas malformados (em que partes da mensagem estão nomeadas incorretamente) e que funcionam ao utilizar a Versão 5.1 agora são identificados como malformados. Para obter as etapas a serem executadas para resolver o problema, consulte Serviços da Web Acionados por Barramento: Restrições Conhecidas.
Para migrar uma configuração de gateway existente de um servidor de aplicativos da Versão 5.1 para a capacidade de gateway em um servidor de aplicativos ou cluster em uma versão mais recente, conclua as seguintes etapas:
Procedimento
O que Fazer Depois
- Se o gateway Versão 5.1 tiver usado filtros, recrie as funções do filtro usando uma combinação de manipuladores JAX-RPC e mediações de barramentos de integração de serviços.
- Se a configuração de gateway incluir qualquer serviço de gateway que tenha vários serviços de destino, a configuração da Versão 5.1 pode ter utilizado um filtro de roteamento para escolher um serviço de destino específico. Se esse for o caso, você deverá ainda configurar seu gateway migrado para escolher um serviço e porta de destino por meio de uma mediação de roteamento.
- Um gateway de serviços da Web em uma versão mais recente usa mais memória para processar uma mensagem, de modo que se você passar um anexo grande através do gateway migrado, talvez receba um erro de falta de memória na Java Virtual Machine. Para resolver esse problema, aumente o tamanho de heap da JVM.