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...
  1. Migrar primeiro os dados: eles são os seus ativos de negócios.
  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>
    Copy to Clipboard Toggle word wrap
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.
Voltar ao topo
Red Hat logoGithubredditYoutubeTwitter

Aprender

Experimente, compre e venda

Comunidades

Sobre a documentação da Red Hat

Ajudamos os usuários da Red Hat a inovar e atingir seus objetivos com nossos produtos e serviços com conteúdo em que podem confiar. Explore nossas atualizações recentes.

Tornando o open source mais inclusivo

A Red Hat está comprometida em substituir a linguagem problemática em nosso código, documentação e propriedades da web. Para mais detalhes veja o Blog da Red Hat.

Sobre a Red Hat

Fornecemos soluções robustas que facilitam o trabalho das empresas em plataformas e ambientes, desde o data center principal até a borda da rede.

Theme

© 2025 Red Hat