Se você for um usuário do Host Publisher V4, HATS V4 LE, HATS V5 LE, HATS V4, V5, V6, V7.0, ou V7.1, é possível migrar seus projetos para o HATS V7.5.1.
Para obter informações sobre migração a partir do HATS LE consulte Migrando do HATS LE.
Se estiver utilizando uma versão do Host Publisher anterior à V4.0, primeiro deverá seguir as instruções para migração de aplicativos do Host Publisher para o Host Publisher V4.0. Vá para http://www.ibm.com/software/awdtools/hats/support/index.html e digite a cadeia de procura "Como migrar o Host Publisher". Para obter informações adicionais, consulte HATS para Usuários do Host Publisher.
A migração de um projeto do HATS de um release anterior do HATS é um processo de duas etapas.
Caso você possua um release anterior do HATS instalado, você primeiro deve exportar seu projeto para um arquivo zip ou um arquivo project interchange antes de poder importá-lo e migrá-lo para seu HATS V7.5.1. Consulte a documentação de seu release anterior do HATS para obter informações sobre a exportação de projetos do HATS.
Depois de exportar seu projeto de um release anterior do HATS, você deve importá-lo como um arquivo project interchange para sua área de trabalho do HATS V7.5.1. Para obter mais informações sobre a importação de projetos da Web e rich client do HATS, consulte Exportando e Importando Projetos da Web do HATS e Exportando e Importando Projetos do Rich Client do HATS.
Se você tiver armazenado seus projetos HATS no Rational ClearCase, deverá criar uma visualização de captura instantânea contendo estes projetos e, então, importe-os em sua área de trabalho do HATS V7.5.1 utilizando Arquivo > Importar > Geral > Projetos Existentes na Área de Trabalho. Durante a importação, não selecione a opção Copiar projetos na área de trabalho. Depois dos projetos serem importados em sua área de trabalho do HATS V7.5.1, você pode optar por migrá-los para o HATS V7.5.1. Durante a migração, os arquivos que precisam ser atualizados têm o registro de saída efetuado automaticamente do Rational ClearCase.
O assistente de Migração da Área de Trabalho do Rational SDP é exibido quando um projeto é importado na área de trabalho e precisar de algum nível de migração do Rational SDP. Este assistente executa alguma migração básica de projeto do Rational SDP e, se o projeto for destinado a um tempo de execução não suportado, força a escolher um tempo de execução de destino suportado. Na preparação para execução do assistente de Migração do HATS, você deve primeiro executar o assistente de Migração da Área de Trabalho do Rational SDP.
Quando você alternar para a perspectiva HATS, se tiver um projeto criado a partir da liberação do HATS anterior em sua área de trabalho V7.5.1 do HATS, receberá uma mensagem afirmando que a área de trabalho contém um projeto do HATS que precisa ser migrado.
Você deve usar o assistente para Migração do HATS para migrar esse projeto para o HATS V7.5.1 antes de investigar quaisquer erros mostrados na visualização Problemas porque a migração pode eliminar alguns ou todos esses erros.
Para utilizar o assistente de Migração do HATS, siga estas etapas:
Ao migrar seus projetos do HATS de um release anterior do HATS para o HATS V7.5.1, as transformações no projeto também são migradas. Alterações feitas nas transformações dependem do release do HATS a partir do qual está fazendo a migração. Todas as transformações são salvas na pasta MigrationBackup antes de serem migradas.
O HATS V5 introduziu novos componentes e widgets. Os componentes e widgets do HATS V4 eram suportados, mas foram reprovados no HATS V5 e V6. Os componentes e widgets do HATS V4 não são suportados no HATS V7.5.1. Se você tiver componentes e widgets do HATS V4 em seus projetos, durante a migração você terá a oportunidade de migrá-los para componentes e widgets do HATS V7.5.1 ou de cancelar a migração de projeto. Se você escolher migrar, seu projeto poderá ser processado de maneira diferente. Certifique-se de testar completamente os seus projetos migrados.
Se você tiver componentes e widgets de subarquivo do HATS V4, eles serão migrados para componentes e widgets de subarquivo do HATS V5. Se você tiver componentes e widgets de subarquivo do HATS V5, eles serão deixados sozinhos. Há novos (mais ricos em função) componentes de subarquivos e widgets para o HATS V6 e posterior. Você pode querer investigar usando os novos componentes e widgets ao invés dos antigos. Para obter informações adicionais, consulte Subarquivo.
No HATS V4, se você escolheu um componente de tecla de função e o processou com um widget de botão drop-down (seleção) ou um botão de rádio (seleção), será possível utilizar o envio automático ou mostrar um botão enviar. Se você escolheu mostrar um botão enviar, quando migrar o projeto do HATS V4 para o HATS V7.5.1, o botão enviar não será mais exibido. No HATS V7.5.1, o recurso para mostrar um botão enviar foi removido.
Todos os pares DefaultExtract/DefaultWidget do HATS V4 são migrados para Renderização Padrão do HATS V7.5.1. Como este mapeamento pode não produzir os resultados pretendidos originalmente, a migração do HATS V7.5.1 exibirá e criará logs de uma mensagem informando que um par DefaultExtract/DefaultWidget foi migrado para Renderização Padrão. Neste caso, você deverá rever a transformação e fazer os ajustes necessários.
Os componentes e widgets customizados que são estendidos ou que possuem par com os componentes e widgets do HATS V4 não podem ser migrados nem podem manter os resultados originais. Quando a migração do HATS V7.5.1 detecta isso, ela exibe e cria logs de uma mensagem informando que a transformação contém componentes e widgets do HATS V4 que não podem ser migrados. Neste caso, você deverá rever a transformação e migrá-la manualmente.
Se em versões anteriores do HATS você ativou a função de avanço automático incluindo a linha turnAutoTabOn(); no arquivo lxgwfunctions.js, agora deverá utilizar a configuração Ativar avanço automático de campo na seção Configurações de Cliente da guia Outro no editor de Configurações de Projeto. Para obter informações adicionais, consulte Configurações do Cliente.
A migração do HATS cria uma pasta de backup no diretório do projeto chamada MigrationBackup. Esta pasta contém cópias dos arquivos do projeto antigo antes de serem sobrescritas pelo processo de migração. Esses arquivos são salvos, permitindo que você os compare e mescle com os novos arquivos do HATS V7.5.1. Não se preocupe se ocorrerem problemas, estes arquivos não serão mais utilizados pelo aplicativo. Quando estiver satisfeito com todos os arquivos salvos que foram comparados e mesclados, será possível excluir a pasta MigrationBackup.
Se você migrar um projeto criado antes do HATS V7.0.0.2 e escolher implementar a opção Ativar cores de primeiro plano se utilizar um modelo que utiliza a folha de estilo blacktheme.css, deve atualizar manualmente a folha de estilo blacktheme.css de uma das seguintes maneiras:
color: lime;Isso permite que as cores de primeiro plano sejam renderizadas nas teclas de função; no entanto, isso faz com que outros botões gerados por um widget do HATS renderizem uma cor padrão.
.HBLUE {
color: #3c9dff;
}
input.HBLUE {
white-space: normal;
letter-spacing: normal;
}para
.HBLUE, input.HBLUE {
color: #3c9dff;
white-space: normal;
letter-spacing: normal;
}Repita essa alteração para cada cor.Uma alternativa para editar manualmente a folha de estilo blacktheme.css é criar um novo projeto simulado e copiar os arquivos CSS de tema deste projeto em seu projeto. Esteja ciente de que quaisquer alterações feitas em seus arquivos de CSS serão sobrescritas.
Se você tiver projetos existentes do HATS V5 que tenham Beans de Acesso EJB, talvez obtenha erros de compilação ou de tempo de execução que começam com "HPubReqCompleteEvent não pode ser resolvido". Para corrigir isso, regenere o Beans de Acesso EJB.
Se quiser usar a configuração Render using monospace font para o widget Campo, e seu projeto foi criado originalmente em um release anterior ao HATS V7.0, você deve atualizar seus arquivos CSS conforme se segue:
.HF {
font-family: courier new, monospace;
}Uma nova configuração, enforceImmediacy, é incluída em qualquer regra global importada para o HATS V7.5.1 do HATS V5. Quando essa configuração é verdadeira, a regra global se comporta como no HATS V5 quando a opção Apenas campo de entrada mais próximo é selecionada para a opção Transformar do padrão Localizar campos de entrada por texto adjacente. Quando essa configuração é falsa, o padrão, as regras globais se comportam como o fazem no HATS V7.5.1.
Para fazer com que as regras globais definidas recentemente se comportem como as regras globais do HATS V5, você deve incluir e configurar a definição enforceImmediacy como true. Para fazer isso, na guia Origem do editor de Configurações do Projeto, inclua a seguinte configuração na tag globalRules componentSettings:
<setting name="enforceImmediacy" value="true"/>
Antes do HATS V7, o valor de uma variável global, digitado em um prompt inserido em uma transformação utilizando a opção Prompt para variável global com caixa de entrada, poderia ser truncado porque alguns caracteres não eram escapados corretamente.
Nesta versão do HATS, os valores da variável global solicitados por uma transformação são escapados apropriadamente para evitar truncamento. As variáveis globais inseridas em uma transformação utilizando a opção Exibir valor de variável global como texto estático não são afetadas por essa alteração. Os prompts da variável global inseridos em uma transformação em uma versão do HATS anterior ao HATS V7 não são automaticamente atualizados durante a migração, portanto, eles não são afetados por esta alteração.
Se você deseja usar o suporte do HATS para compactação de HTTP nos projetos migrados do HATS V5.0.x, V6.0 e V6.0.1, você deve incluir manualmente o filtro de compressão no arquivo do Web Deployment Descriptor (web.xml). Para incluir o filtro de compactação no arquivo web.xml:
<filter>
<description>Provides compression for output from HATS entry
servlet</description>
<display-name>CompressionFilter</display-name>
<filter-name>CompressionFilter</filter-name>
<filter-class>com.ibm.hats.runtime.filters.CompressionFilter</filter-class>
</filter>
<filter-mapping> <filter-name>CompressionFilter</filter-name> <servlet-name>EntryServlet</servlet-name> <dispatcher>ERROR</dispatcher> <dispatcher>FORWARD</dispatcher> <dispatcher>INCLUDE</dispatcher> <dispatcher>REQUEST</dispatcher> </filter-mapping> <filter-mapping> <filter-name>CompressionFilter</filter-name> <url-pattern>/</url-pattern> </filter-mapping> <filter-mapping> <filter-name>CompressionFilter</filter-name> <url-pattern>/index.jsp</url-pattern> </filter-mapping>
HATS, WebFacing e aplicativos vinculados ao HATS/WebFacing que são migrados para o HATS V7.5.1 devem ser reimplementados no ambiente de produção para selecionar o suporte ao IBM® Tivoli License Manager para o novo arquivo de assinaturas do HATS V7.5.1.
O ITLM detecta aplicativos da Web implementados como Enterprise Archives (EARs) em WebSphere Application Servers suportados. Uma vez que os projetos da Web do WebFacing são criados independentes dos EARs associados, o arquivo de assinatura ITLM deve ser incluído manualmente. Siga essas etapas para ativar a detecção de ITLM dos aplicativos da Web do WebFacing.
<shared_install_directory>\plugins\com.ibm.hats_nnn\em que shared_install_directory é o diretório de recursos compartilhados no qual você instalou a oferta HATS utilizando o IBM Installation Manager e nnn é a versão e o nível da construção do HATS.
Se você tiver ativado a detecção de ITLM para um projeto antigo do WebFacing e migrado esse projeto para V7.5.1, remova o arquivo de assinatura existente (por exemplo, WDHT0700.sys2 se o projeto antigo do WebFacing for da V7.0) do EAR associado ao projeto e inclua o arquivo de assinatura da V7.5.1 (HATS0705.sys2) antes da reimplementação.
Durante a migração para o HATS V7.5.1, o arquivo was.policy de segurança Java™ 2 do WebSphere Application Server foi sobrescrito. Se você customizou o arquivo was.policy em um projeto pré-HATS V7.5, então, deverá customizar novamente o arquivo após a migração.
Em versões anteriores do terminal do host do HATS, a tecla Pause foi mapeada para a ação [limpar] do host. No terminal host do HATS V7, e posterior, a tecla Esc está mapeada para a ação [limpar] do host.
Em versões do HATS anteriores ao HATS V6, Ctrl+R era utilizado para sessões bidirecionais para reverter a tela. No HATS V6 e posterior, Ctrl+R é mapeado para um RESET do host para sessões bidirecionais e não bidirecionais e Alt+Enter é mapeado para reversão para sessões bidirecionais.
Se você migrar um projeto rich client pre-HATS V7.5 para o HATS V7.5.1 que é destinado para o Lotus Expeditor, os mapeamentos de teclado para Lotus Notes serão incluídos no projeto. Estes mapeamentos de teclado também serão incluídos em projetos destinados ao Lotus Expeditor se você atualizar sua instalação do HATS V7.5.0.x para V7.5.1 utilizando o IBM Installation Manager.
Após a migração de um projeto rich client, se não for possível ativá-lo no ambiente de teste, crie uma nova configuração de ativação para utilizar no ambiente de teste. Para fazer isto, na visualização Projetos HATS, clique com o botão direito do mouse no projeto e selecione Executar ou Depurar. A janela Executar (ou Depurar) Configurações será exibida. Se o projeto for destinado ao Eclipse RCP, clique com o botão direito do mouse em Aplicativo Eclipse e selecione Novo. Se o projeto for destinado ao Lotus Notes ou Lotus Expeditor , clique com o botão direito do mouse em Serviços do Cliente e selecione Novo. Se desejar, modifique o nome e local da configuração de ativação. Também é possível excluir configurações de ativação antigas desta janela. Clique em Executar (ou Depurar) para ativar o projeto no ambiente de teste.
Os aplicativos do Rich client que utilizam o temaEmulador de Terminal Clássico terão a configuração Navegação de Tecla de Seta ativada após a migração.
Cadeias em inglês não-US incluídas nos modelos e transformações de um projeto do HATS rich client construídas com o HATS V7.0 ou V7.0.0.1 não são compiladas corretamente quando o projeto é exportado como um recurso. Para oferecer uma solução alternativa para esse problema, após migrar o projeto para o HATS V7.5.1, edite o arquivo build.properties localizado na pasta-raiz do projeto. Inclua a seguinte linha na parte inferior do arquivo build.properties:
javacCustomEncodings.library.jar = src/rcpproject/templates/[UTF-8], src/rcpproject/transformations/[UTF-8]
Em que rcpproject é o nome do projeto do rich client.
Para ativar totalmente o tempo de execução do HATS V7.5.1 para produção, você deve especificar suas configurações de licença usando ao assistente para Configurações de Licença. Você deve fazer isso mesmo para projetos cujos tempos de execução se encontravam totalmente ativados nas versões anteriores do HATS. Para obter mais informações sobre a especificação de configurações de licença, consulte Enabling HATS runtime and license settings na publicação HATS Getting Started
Durante a migração, o HATS V7.5.1 converte arquivos de classes de certificado SSL, arquivos CustomizedCAs.class, em arquivos de armazenamento de chaves PKCS12 com os nomes appname-CustomizedCAs.p12 e senhas de hats, em que appname é o nome do projeto. Após a migração, você deve utilizar a ferramenta Certificate Management (também conhecida como IBM Key Management ou iKeyMan) para alterar as senhas dos novos arquivos de armazenamento de chaves e verificá-las utilizando o editor de conexão. Para obter informações adicionais, consulte Segurança.
Começando com o HATS V7, os modos de teste Executar no Servidor (para projetos da Web) e Executar (para projetos do rich client) podem ser utilizados para modificar e testar as configurações do tempo de execução que são implementadas no ambiente de produção. Saiba que todas as alterações feitas nas configurações de tempo de execução durante o teste neste modo serão retidas e efetivadas quando você implementar o aplicativo do HATS em um ambiente de produção.
Os modos de Teste Depurar no Servidor (para projetos da Web) e Depurar (para projetos rich client) podem ser utilizados para modificar e testar as configurações de tempo de execução sem modificar as configurações implementadas no ambiente de produção.
Para obter informações adicionais sobre como alterar configurações do tempo de execução para projetos da Web, consulte Iniciando o Console Administrativo Enquanto Está no HATS Toolkit. Para obter informações adicionais sobre como alterar configurações do tempo de execução para projetos do rich client, consulte Administrando Aplicativos Rich Client do HATS.
Antes do HATS V7, o componente de host URL procurava dentro do campo de entrada e do campo protegido. A partir do HATS V7, o componente de host URL procura apenas dentro dos campos protegidos não-ocultos.
Quando um projeto da Web do HATS é migrado para o HATS V7.5.1 sem nenhum EAR associado, o Web Express Logon (WEL) não funciona apropriadamente. As informações de configuração do WEL para um projeto da Web são mantidas em seu projeto EAR associado. Se o projeto EAR associado não for importado e migrando, então, suas informações serão perdidas.
Se você importar os projetos EAR e da Web como arquivos de Troca de Projetos na área de trabalho e migrar o projeto da Web, o projeto EAR associado também será migrado e as informações de configuração do WEL não serão perdidas.
A partir do HATS V7, o Java Secure Socket Extension (JSSE) é utilizado pelos plug-ins de mapeador de credenciais HATS DCAS/RACF/JDBC e DCAS/RACF baseado em certificado para conexões seguras com o servidor DCAS. Como resultado, considere as seguintes alterações para os parâmetros de inicialização de plug-in.
Este parâmetro especifica um banco de dados de keyring. Um conjunto de chaves deve ser especificado para fornecer acesso ao certificado cliente DCAS assim como ao certificado do servidor DCAS. Os certificados estabelecem uma conexão segura autenticada do cliente com o servidor DCAS. Este parâmetro é uma referência de arquivo para utilizar o conjunto de chaves. O plug-in do DCAS é o cliente DCAS. O arquivo do conjunto de chaves deve ser armazenado no arquivo .ear.
Este parâmetro especifica a senha do banco de dados de keyring.
A migração de portlets do HATS V4 não é suportada. Se você desejar utilizar um projeto da Web existente do HATS V4 como um portlet, primeiro deverá migrá-lo para o HATS V7.5.1. Depois de migrar o projeto, você poderá gerar um projeto de portlet do HATS V7.5.1 a partir dele. Para obter informações adicionais, consulte Gerando Portlets a Partir de Projetos da Web do HATS.
Se você atualmente tiver o HATS LE instalado, primeiro será necessário exportar seu aplicativo para que possa importá-lo para o HATS V7.5.1. Para exportar o aplicativo do Console Administrativo HATS LE para um arquivo .zip:
Depois que o aplicativo do HATS LE tiver sido exportado como um arquivo .zip, importe-o para o HATS V7.5.1 seguindo estas etapas:
Para tornar o certificado de SSL utilizável no HATS V7.5.1, você deve criar um arquivo de armazenamento de chave PKCS12 e incluir o certificado de SSL nele. Caso não possua mais um certificado de SSL, você deve entrar em contato com seu administrador do servidor Telnet para obtê-lo. Para obter mais informações, consulte Ativando a Segurança SSL.
Se você for um usuário com experiência no IBM WebSphere Host Publisher, precisará ajustar sua abordagem a fim de desenvolver projetos com o HATS. Algumas diferenças chaves entre as abordagens do HATS e do Host Publisher no desenvolvimento de projetos são:
Se você estiver importando um aplicativo do Host Publisher V4.0 (versus um aplicativo do Host Publisher V4.0.1):
Se você for atualmente um usuário do Host Publisher V4, poderá migrar os projetos inteiros ou apenas os Objetos de Integração dos seus projetos existentes. Ao importar os arquivos .ear do Host Publisher, os Objetos de Integração permanecem compactados no arquivo .jar.
Se o Objeto de Integração estiver em um Módulo da Web, o arquivo .jar estará no diretório WEB-INF/LIB. Se o Objeto de Integração estiver em um módulo EJB, o arquivo .jar estará no diretório imported_classes\IntegrationObject. Os Beans de Acesso EJB também permanecem empacotados no arquivo .jar no diretório WEB-INF/LIB do Módulo da Web.
Se importar um .ear e modificar a macro para a qual um Objeto de Integração foi criado, você terá o .jar do Objeto de Integração original que foi importado, bem como a origem Java. Depois de gerar novamente o Objeto de Integração para o HATS, será possível excluir o arquivo .jar importado.
A seguir está uma lista das considerações durante a migração do Host Publisher V4:
Você poderá importar projetos do Host Publisher V4 no HATS como novos projetos HATS ou como parte de um projeto HATS existente.
Também é possível importar Objetos de Integração do Host Publisher individuais em um projeto existente do HATS.
O portlet de recorte que é fornecido com o WebSphere Portal Server V6.x é funcionalmente equivalente ao portlet do Host Publisher V4 portlet. É possível criar um portlet de recorte que aponte para um aplicativo do HATS baseado no Objeto de Integração ou um aplicativo migrado do Host Publisher V4 e substituir o portlet do Host Publisher V4 por ele. O portlet do Host Publisher V4 não é mais suportado.
Para obter informações sobre a integração de aplicativos baseados em Objetos de Integração mais proximamente ao WebSphere Portal, consulte a publicação HATS Web Application Programmer's Guide.
Se desejar migrar o nível de suporte do J2EE em seus projetos do HATS, execute as seguintes etapas: