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 dos diversos problemas. 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...
  1. Migrar primeiro os dados: eles são os seus ativos empresariais.
  2. Migrar, em seguida, os processos do tempo de execução.
  3. 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

Para migrar os dados do Red Hat JBoss BPM Suite 5, siga as instruções a seguir:
  1. 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.
  2. 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ção
    • jcr-exporter-libs - contém as bibliotecas específicas à parte export-from-JCR da migração.
    • vfs-importer-libs - contém as bibliotecas específicas à parte import-into-Git da migração.
    • conf - contém a configuração global da ferramenta de migração.
  3. 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-libs da ferramenta de migração.
  4. Execute os seguintes comandos: 
    ./bin/runMigration.sh -i <source-path> -o <destination-path> -r <repository-name>
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 Repositórios e, depois, clique no menu Clonar Repositório 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:
  1. Inicie o JBoss Developer Studio.
  2. 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.
  3. Selecione Arquivo → Importar... e navegue até a pasta Git. Abra a pasta Git para selecionar os Projetos do Git e clique em avançar.
  4. Selecione a origem do repositório como Repositório local existente e clique em avançar.
  5. Selecione o repositório a ser configurado a partir da lista dos repositórios disponíveis.
  6. Importe o projeto como um projeto geral na próxima janela e clique em avançar. Nomeie este projeto e clique em Concluir.