como coletar dados

Para começar, conclua as etapas a seguir na Transformation Advisor UI:

1. Criar uma área de trabalho.

2. Na página do novo espaço de trabalho, clique no botão Open Discovery Tool e siga as instruções para fazer o download.

Para instalar a Discovery Tool, faça logon no servidor de aplicativos com as credenciais de usuário do proprietário do aplicativo e conclua as etapas a seguir:

1. Copie o arquivo transferido por download para o sistema do aplicativo em um diretório no qual ele tenha acesso de leitura/gravação/execução.

2. Descompacte o arquivo transferido por download emitindo o comando para o seu sistema operacional:

   **Linux:** tar xvfz DiscoveryTool-Linux_<WORKSPACE_NAME>.tgz
   
   **AIX:** gunzip -c DiscoveryTool-AIX_<WORKSPACE_NAME>.tgz | tar xf -
   
   **Solaris:** tar xvfz DiscoveryTool-Solaris_<WORKSPACE_NAME>.tgz
   
   **z/OS:** gunzip -c DiscoveryTool-zOS_<WORKSPACE_NAME>.tgz | tar xf -
   
   **Windows:** unzip DiscoveryTool-Windows_<WORKSPACE_NAME>.zip
    

3. Vá para o diretório da Discovery Tool:

   cd transformationadvisor*
    

4. (somente em z/OS )
   Vá para o diretório bin da Discovery Tool e execute o script de pré-requisito z/OS :

   cd transformationadvisor*/bin
   . zOSPrereq
    

Quando você executar a Discovery Tool pela primeira vez, a licença será exibida. Aceite os termos para continuar.

Para analisar ambos os aplicativos e a sua configuração, execute o comando para o seu domínio:

**IBM WebSphere:** ./bin/transformationadvisor -w <WEBSPHERE_HOME_DIR> -p <PROFILE_NAME> [ --ignore-missing-binary --ignore-missing-shared-library --applications --applications-file --skip-applications --skip-applications-file --no-upload] ([] denotes optional arguments)

**Oracle WebLogic:** ./bin/transformationadvisor --web-logic-config-file <Path to the WebLogic domain config.xml file> [--applications --applications-file --skip-applications --skip-applications-file --no-upload] ([] denotes optional arguments)

**JBoss:** ./bin/transformationadvisor --jboss-config-dir <Path to the JBoss server configuration directory> [--applications --applications-file --skip-applications --skip-applications-file --no-upload] ([] denotes optional arguments)

**Apache Tomcat:** ./bin/transformationadvisor --tomcat-home-dir <TOMCAT_HOME_DIR> --tomcat-config-dir <TOMCAT_CONFIG_DIR> [--applications --applications-file --skip-applications --skip-applications-file --no-upload] ([] denotes optional arguments)
 

Para visualizar as opções de linha de comando disponíveis para a Discovery Tool, use a opção --help .

Dependendo do número, do tamanho e da complexidade de seus aplicativos, a Discovery Tool pode levar algum tempo para executar e carregar os resultados. Durante esse processo, é possível acompanhar o seu progresso verificando sua linha de comandos.

Se houver uma conexão entre seu sistema e sua nova coleção, a Discovery Tool fará o upload automático dos resultados para Transformation Advisor. Uma análise detalhada que inclui vários relatórios é fornecida para ajudar a entender os problemas e o local no qual as mudanças de código podem ser necessárias.

Se não houver conexão, a Discovery Tool retornará um arquivo .zip contendo os dados do aplicativo. Você precisará carregar manualmente o arquivo zip usando o botão Carregar dados na página do Workspace.

A Discovery Tool requer a versão 1.7 + para ser executada. Em primeiro lugar, a Discovery Tool procurará uma versão compatível do Java que seja usada pelo site WebSphere (se for uma coleção WebSphere ). Se não for possível encontrar a versão WebSphere do Java, ou se a versão WebSphere não for compatível (ou seja, < 1.7 ), ou se esta não for uma coleção WebSphere, a Ferramenta de descoberta tentará usar o Java especificado no argumento -–java-home da Ferramenta de descoberta. Se o –java-home argument não for fornecido, ele usará o Java especificado com a variável de ambiente JAVA_HOME Se nenhuma dessas opções resultar na localização de uma versão compatível do Java, a Discovery Tool usará o Java que está empacotado com a Discovery Tool.

Em algumas circunstâncias, uma versão compatível do Java pode não existir previamente no sistema em que você deseja executar a Ferramenta de descoberta, e o Java que é empacotado com a Ferramenta de descoberta também não é compatível com o sistema em que está sendo executado. Por exemplo, isso pode ocorrer com a Solaris Discovery Tool, que contém Java para a arquitetura AMD64. Se o Solaris estiver em execução no SPARC, o Java compactado não funcionará. Nesses casos, você pode criar sua própria versão da Discovery Tool, com uma versão apropriada do Java.

Execute as etapas a seguir:

• Faça o download de uma versão dessa ferramenta de descoberta por meio da Transformation Advisor UI
• Descompacte a ferramenta de descoberta compactada
• Localize a pasta "jre" na ferramenta Discovery descompactada e substitua-a por um jre de uma versão desejada do Java
• OPCIONAL: há um arquivo na ferramenta Discovery descompactada chamado uploadEndpoint.json. Ele contém o local do servidor Transformation Advisor e uma chave exclusiva para fazer upload em um espaço de trabalho específico. Você pode remover o arquivo uploadEndpoint.json. Isso significa que a ferramenta Discovery não poderá carregar automaticamente a coleção para Transformation Advisor mas produzirá um zip que você poderá carregar manualmente usando a Transformation Advisor UI. A remoção do uploadEndpoint.json tem a vantagem de permitir que você crie uma ferramenta de descoberta personalizada que pode ser facilmente copiada entre ambientes. Na verdade, ele rompe o vínculo entre a ferramenta Discovery e um espaço de trabalho específico em Transformation Advisor.
• Comprimir a ferramenta de descoberta

A Discovery Tool compactada agora pode ser copiada para o ambiente em que você deseja realizar a coleta.

Transformation Advisor fornece uma ferramenta de descoberta para ambientes SunOS/Solaris. Ele foi testado em SunOS 5.10, 5.11 (Solaris 10, 11), mas pode funcionar em versões mais antigas. A ferramenta de descoberta fornecida para SunOS/Solaris empacota um JRE para uso na arquitetura SunOS/Solaris em AMD64. Se quiser executar a Ferramenta de descoberta na arquitetura SunOS/Solaris SPARC, você precisará ter uma versão compatível do Java disponível no sistema em que estiver executando a Ferramenta de descoberta.

Problemas conhecidos:

• Antes de executar a ferramenta Discovery em SunOS/Solaris,, verifique a versão do bash no ambiente. Se a versão for < 4.x, atualize para a 4.x para garantir o funcionamento correto da ferramenta de descoberta.

A Transformation Advisor Discovery Tool suporta a coleta da versão WebSphere 6.1 +. Para migrações de WebSphere de versões anteriores a 6.1, você precisa localizar manualmente todos os binários de aplicativos implantados no sistema e colocá-los em um único local. Em seguida, você pode executar a Discovery Tool usando a opção -o para apontar para esse local e realizar uma análise dos aplicativos. Quando você executar a Discovery Tool com as opções -o , ela solicitará que você escolha a fonte WebSphere e a versão Java. Se ele não mostrar suas versões exatas, selecione os valores mais próximos de suas versões reais para obter os resultados mais precisos. Nessa situação, a análise pode não detectar todos os problemas, pois os problemas de versões do WebSphere e do Java anteriores às regras compatíveis não serão sinalizados.

Transformation Advisor suporta a coleta dos seguintes servidores de aplicativos:

• WebSphere

• Red Hat JBoss

• Weblogic

• Tomcat

Se desejar executar uma análise em aplicativos de servidores de aplicativos que não são suportados (por exemplo, Glassfish), é possível fazer o seguinte:

• Colete manualmente os binárias do aplicativo do sistema e coloque em um diretório.

• Execute a ferramenta Discovery e aponte-a para o local dos aplicativos usando a opção -c . Isso executa um conjunto base de regras Java mais algumas regras específicas do Tomcat. As regras específicas do Tomcat podem ou não se aplicar ao servidor de aplicativos que você está analisando e precisam de investigação adicional.. Em versões futuras da Discovery Tool, haverá a opção de executar apenas as regras Java geralmente aplicáveis.

As regras do Tomcat que precisam de investigação adicional são as seguintes:

Set the sharing scope on resource references
Spring applications might fail to run from a non-expanded WAR file
Stub classes must be included when using remote Enterprise JavaBeans (EJB) 2.x
The getRealPath method previously returned null for files that do not exist
The OSGI remote bundle repository service API is unavailable
The OSGI Remote Service Admin API is unavailable
Transaction propagation is not supported for Enterprise JavaBeans (EJB) remote interfaces
Use correct case for tag attribute names
Use Java EE deployment descriptors and WebSphere bindings to define resource link references
Use Java EE deployment descriptors and WebSphere bindings to define resource references
Use Java EE deployment descriptors to define context lifecycle listeners
Use Java EE deployment descriptors to define context parameters
Use Java EE deployment descriptors to define environment references
Use Java EE deployment descriptors to define missing security roles
Validate the result of concatenation with getRealPath("")
Validate the result of concatenation with getRealPath("/")
Web Services Notification (WS-Notification) is unavailable
 

O arquivo customCmd.properties sob o diretório /conf é usado para configurar as opções de varredura usadas para gerar o arquivo de relatório durante a varredura do aplicativo O usuário pode editar esse arquivo para customizar opções de varredura.

Desde o lançamento do Transformation Advisor v2.5 você pode definir suas próprias regras de análise personalizadas para detectar cenários específicos da migração de aplicativos. As regras definidas pelo usuário podem ser criadas facilmente, conforme descrito em detalhes aqui. Os resultados serão exibidos na Transformation Advisor UI da mesma forma que as regras pré-escritas que saem da caixa.

Exibe a versão da Discovery Tool.

Exibe todas as opções da ferramenta Discovery.

Especifica a versão do Java usada para a Discovery Tool.

Opções JVM que são passadas para a Discovery Tool. -J serão removidas e -X e as opções restantes serão passadas para o tempo de execução do Java.

Por exemplo, -J-Xmx4G definirá o tamanho máximo do heap como 4GB para o tempo de execução da Discovery Tool.

Sinalizador para indicar que nenhum upload para o Transformation Advisor servidor ocorrerá quando a coleta for concluída

O local do diretório de instalação do WebSphere.

Se fornecido, a Discovery Tool se conectará ao WebSphere JVM associado a esse perfil e coletará as informações de configuração. Se você tiver vários perfis dentro do seu diretório de instalação do WebSphere, será possível fornecer essa opção várias vezes.

A sintaxe para esta opção é: --profile-config <Profile Name> .

Exemplo: --profile-config AppSrv01 --profile-config Dmgr01

Por padrão, a Discovery Tool coleta informações de configuração de todos os aplicativos implantados em um perfil. Se essa opção for especificada, a ferramenta coletará apenas informações de configuração para os aplicativos listados.

A sintaxe para especificar vários aplicativos é: --applications <application_1 Name>...<application_n name>

Exemplo: --applications app1.ear app2.ear app3.ear

Semelhante à opção --applications , essa opção permite que a Ferramenta de descoberta obtenha nomes de aplicativos do arquivo fornecido e colete apenas os dados de configuração dos aplicativos definidos nesse arquivo.

Exemplo: --applications-file /tmp/applicationsToScan.txt

O arquivo pode ser uma lista separada por vírgula e / ou separada por linhas de aplicativos a serem incluídos, por exemplo,

app1.ear,app2.ear
app3.ear
 

Por padrão, a Discovery Tool coleta informações de configuração de todos os aplicativos implantados em um perfil. Se essa opção for especificada, a ferramenta ignorará os aplicativos listados.

A sintaxe para especificar vários aplicativos é: --skip-applications <application_1 Name>...<application_n name>

Exemplo: --skip-applications app1.ear app2.ear app3.ear

Semelhante à opção --skip-applications, essa opção permite que a Ferramenta de descoberta obtenha nomes de aplicativos do arquivo fornecido e ignore os aplicativos definidos nesse arquivo.

Exemplo: --skip-applications-file /tmp/applicationsToScan.txt

O arquivo pode ser uma lista separada por vírgula e / ou separada por linhas de aplicativos a serem ignorados, por exemplo,

app1.ear,app2.ear
app3.ear
 

Sinaliza a varredura para ignorar aplicativos que não têm arquivos binários.

Sinaliza a varredura a ser executada em aplicativos que têm uma biblioteca compartilhada não existente.

Sinaliza a varredura a ser executada no diretório expandido do aplicativo implementado. Por padrão, a Discovery Tool examinará o arquivo binário que é carregado no servidor WAS durante o tempo de implementação. Se essa opção for especificada, a Discovery Tool examinará o diretório expandido do aplicativo implantado no servidor WAS.

Sinaliza a varredura a ser executada para perfis gerenciados no nó.

Local de um diretório fora do local inicial do WAS que contém arquivos binários do aplicativo que devem ser varridos.

A sintaxe é: ./transformationadvisor -o <location of applications Outside WAS>

Caminho do arquivo WebLogic domain config.xml . Se você tiver vários domínios, será possível especificar essa opção várias vezes.

A sintaxe é: --web-logic-config-file <Path of the config.xml file>

Exemplo: --web-logic-config-file /home/oracle/Oracle/Middleware/Oracle_Home/user_projects/domains/base_domain/config/config.xml

Local do diretório que contém arquivos binários do aplicativo WebLogic.

A sintaxe é: --web-logic-apps-location <WebLogicapps location>

Caminho do diretório de configuração do servidor JBoss. Se você tiver vários servidores, será possível especificar essa opção várias vezes.

A sintaxe é: --jboss-config-dir <Path of server configuration directory>

Exemplo: --jboss-config-dir /root/EAP-7.1.0/standalone/configuration

Local do diretório que contém arquivos binários do aplicativo JBoss.

A sintaxe é: --jboss-apps-location <JBoss applications location>

Caminho do diretório CATALINA_HOME do Tomcat. Se esse argumento for especificado e o argumento -tomcat-config-dir não for, será assumido que --tomcat-config-dir é o mesmo que --tomcat-home-dir. Se uma ou mais opções --tomcat-config-dir forem especificadas além de --tomcat-home-dir, o --tomcat-home-dir não será tratado como um diretório de configuração, a menos que esteja explicitamente listado em uma das opções --tomcat-config-dir.

A sintaxe é: --tomcat-home-dir <Directory of Tomcat home>

Caminho do diretório CATALINA_BASE do Tomcat. O --tomcat-home-dir (CATALINA_HOME) deve ser especificado, além dessa opção. Se você tiver vários diretórios CATALINA_BASE para uma instalação do Tomcat de várias instâncias, será possível fornecer essa opção várias vezes.

A sintaxe é: --tomcat-config-dir <Directory of Tomcat Configuration>

Local do diretório que contém arquivos binários do aplicativo Tomcat.

A sintaxe é: --tomcat-apps-location <Tomcat appslocation>