Capítulo 4. Migração
A migração dos seus projetos do Red Hat JBoss BPM Suite 5 para o Red Hat JBoss BPM Suite 6 exige um planejamento rigoroso e uma avaliação passo a passo das diversas questões envolvidas. Você pode planejar a migração manualmente ou usando processos automáticos. A maioria das migrações em um cenário real exigirá uma combinação desses dois processos.
Já que o JBoss BPM Suite 6 utiliza o GIT para o armazenamento de ativos, artefatos e repositórios de códigos, incluindo processos e regras, você deve começar criando um projeto vazio no JBoss BPM Suite 6, como a base para a sua migração, com arquivos fictícios como substitutos para os vários ativos e artefatos. A execução de um clone do GIT desse projeto vazio no seu IDE de preferência iniciará o processo de migração.
Baseado nos arquivos substitutos no seu projeto clonado, você pode começar a adicionar os ativos nos locais corretos. O sistema do JBoss BPM Suite 6 é inteligente o suficiente para compreender essas alterações e aplicá-las adequadamente. Certifique-se de que, quando estiver importando os arquivos de regras antigas, eles sejam importados com a estrutura do nome do pacote correta.
Como o Maven é usado para a criação de projetos, os ativos de projetos, como regras, processos e modelos, são acessíveis como um simples arquivo jar.
Essa seção lista passo a passo as maneiras geralmente aceitas para a migração do seu projeto. Porém, tratam-se de diretrizes apenas, podendo variar bastante o processo de migração propriamente dito.
No geral, você deve...
- Migrar primeiro os dados: eles são os seus ativos de negócios.
- Migrar, em seguida, os processos do tempo de execução.
- E, por fim, converter as chamadas API antigas em novas, uma por uma.
Esses passos serão analisados mais detalhadamente nas seções a seguir.
4.1. Migração dos Dados Copiar o linkLink copiado para a área de transferência!
Copiar o linkLink copiado para a área de transferência!
Para migrar os dados do Red Hat JBoss BPM Suite 5, siga as instruções a seguir:
- Baixe a ferramenta de migração fazendo o login no Portal do Consumidor Red Hat e, depois, navegue até a seção de Downloads de Software do Red Hat JBoss BPM Suite. Clique em Red Hat JBoss BPM Suite Migration Tool para baixar o arquivo zip.
- Descomprima o arquivo zip baixado em um diretório de sua escolha e navegue até esse diretório em um prompt de comando. Esse diretório contém quatro pastas:
bin- contém os scripts de inicializaçãojcr-exporter-libs- contém as bibliotecas específicas à parteexport-from-JCRda migração.vfs-importer-libs- contém as bibliotecas específicas à parteimport-into-Gitda migração.conf- contém a configuração global da ferramenta de migração.
- Para os bancos de dados de produção, copie o driver JDBC no banco de dados utilizado pelo repositório JCR no diretório
jcr-exporter-libsda ferramenta de migração. - Execute os seguintes comandos:
./bin/runMigration.sh -i <source-path> -o <destination-path> -r <repository-name>
./bin/runMigration.sh -i <source-path> -o <destination-path> -r <repository-name>Copy to Clipboard Copied! Toggle word wrap Toggle overflow
Onde:
- <source-path> é um caminho para um repositório JCR fonte.
- <desintation-path> é um caminho para um destino GIT VFS. Essa pasta não deve existir ainda.
- <repository-name> é um nome arbitrário para o novo repositório.
O repositório é migrado no destino especificado.
Além do comando
-i, você também pode usar -h, para imprimir uma mensagem de ajuda, e -f, para forçar a substituição do diretório de saída, eliminando, assim, a necessidade de excluir manualmente esse diretório.
Importando o repositório no Business Central
O repositório pode ser importado no Business Central clonando-o. Na perspectiva de administração, clique no menu e, depois, clique no menu para iniciar o processo.
Nota
Os ativos também podem ser migrados manualmente, pois são apenas arquivos de texto. A especificação BPMN2 e a sintaxe DRL não passaram por alterações entre as diferentes versões.
Importando o repositório no JBDS
Para importar o repositório no JBoss Developer Studio, siga as instruções a seguir:
- Inicie o JBoss Developer Studio.
- Inicie o Red Hat JBoss BPM Suite Server (caso não esteja em execução ainda) selecionando o servidor através da guia servidor e clique no ícone iniciar.
- Selecione
e navegue até a pasta Git. Abra a pasta Git para selecionar os e clique em avançar. - Selecione a origem do repositório como e clique em avançar.
- Selecione o repositório a ser configurado a partir da lista dos repositórios disponíveis.
- Importe o projeto como um projeto geral na próxima janela e clique em avançar. Nomeie este projeto e clique em Concluir.