Red Hat SummitGuia de Instalação
Red Hat JBoss BPM Suite 6.2
Para Administradores Red Hat JBoss
Resumo
Este guia fornece os passos necessários para o administrador instalar o Red Hat JBoss BPM Suite, os plug-ins para o Red Hat JBoss Developer Studio e fornece também instruções para executar exemplos de projetos.
Capítulo 1. Introdução
Copiar o linkLink copiado para a área de transferência!
1.1. Sobre o Red Hat JBoss BPM Suite
Copiar o linkLink copiado para a área de transferência!
O Red Hat JBoss BPM Suite é um pacote de gerenciamento de processos empresariais open source que combina Business Process Management e Business Rules Management, possibilitando que as empresas e os usuários de TI criem, gerenciem, validem e implantem regras e processos empresariais.
O Red Hat JBoss BRMS e o Red Hat JBoss BPM Suite usam um repositório centralizado onde todos os recursos são armazenados. Isto garante consistência, transparência e capacidade para a realização de auditorias por todo o negócio. Os usuários empresariais podem modificar a lógica empresarial e os processos empresariais sem precisar da assistência de uma equipe de TI.
Para acomodar o componente Business Rules, o Red Hat JBoss BPM Suite inclui o Red Hat JBoss BRMS integrado.
O Business Resource Planner está incluído neste lançamento.
O Red Hat JBoss BPM Suite possui suporte para uso com o o Red Hat Enterprise Linux 7 (RHEL7).
1.2. Plataformas com Suporte
Copiar o linkLink copiado para a área de transferência!
Red Hat JBoss BPM Suite e Red Hat JBoss BRMS possuem suporte nos seguintes contêineres:
- Red Hat JBoss Enterprise Application Platform 6.4
- Red Hat JBoss Web Server 2.1 (Tomcat 7) em JDK 1.7
- IBM WebSphere Application Server 8.5.5.0
- Oracle WebLogic Server 12.1.3 (12c)
1.3. Casos de Uso: Soluções baseadas em processos na área de empréstimo
Copiar o linkLink copiado para a área de transferência!
Esta seção descreve um caso de uso de implantação do JBoss BPM Suite para automatizar os processos empresariais (tais como, processos de aprovação de empréstimos) em um banco de varejo. Trata-se de uma implantação típica baseada em processos específicos que pode compor o primeiro passo em uma ação mais ampla de adoção do JBoss BPM Suite por toda a empresa. Esse caso de uso beneficia-se dos recursos tanto das regras quanto dos processos empresariais do JBoss BPM Suite.
Um banco de varejo oferece vários tipos de produtos de empréstimo, cada um com termos e critérios de elegibilidade diferentes. Os clientes que necessitam de empréstimo precisam encaminhar uma solicitação ao banco. O banco, então, processa a solicitação seguindo alguns passos, tais como a verificação de elegibilidade, os termos determinantes, a verificação de atividades fraudulentas e a determinação do produto de empréstimo mais adequado. Uma vez que o cliente é aprovado, o banco cria uma conta de empréstimo para o candidato, que terá acesso aos fundos. O banco deve cumprir com todas as regulamentações bancárias relevantes a cada etapa do processo e deve gerenciar o seu portfólio de empréstimos para maximizar a sua lucratividade. As políticas devem ser adotadas para auxiliar as tomadas de decisão em cada etapa e devem ser gerenciadas ativamente para otimizar os resultados do banco.
Os analistas de negócios do banco modelam os processos de solicitação de empréstimo utilizando as ferramentas de criação BPMN2 (Designer de Processos) no JBoss BPM Suite. Segue abaixo o processo:
Figura 1.1. Fluxo do Processo de Solicitação para Empréstimo de Alto Nível
As regras empresariais são desenvolvidas com as ferramentas de criação de regras no JBoss BPM Suite para a imposição das políticas e das tomadas de decisão. As regras são conectadas aos modelos dos processos, impondo as políticas corretas a cada etapa do processo.
A equipe de TI do banco implanta o JBoss BPM Suite para que todo o processo de solicitação de empréstimo possa ser automatizado.
Figura 1.2. Automação do Processo de Solicitação de Empréstimo
Todas as regras e todo o processo de empréstimo podem ser modficados a qualquer momento pelos analistas de negócios do banco. O banco mantém-se em conformidade com as constantes mudanças nas regulamentações e é capaz de introduzir rapidamente novos produtos de empréstimo, além de melhorar as políticas de empréstimo para que ele possa competir eficazmente e aumentar a sua rentabilidade.
Parte I. Instalação do Red Hat JBoss BPM Suite
Copiar o linkLink copiado para a área de transferência!
Capítulo 2. Opções de Instalação
Copiar o linkLink copiado para a área de transferência!
O Red Hat JBoss BPM Suite possui duas versões:
- Instalador jar executável no Red Hat JBoss Enterprise Application Platform (EAP) 6.4.
- Instalação de arquivo zip que, por sua vez, possui duas versões:
jboss-bpmsuite-6.2-deployable-eap6.x.zip: version adapted for deployment on Red Hat JBoss Enterprise Application Platform (EAP 6.4).jboss-bpmsuite-6.2-deployable-generic.zip: a versão implantável com bibliotecas adicionais adaptadas para implantação em Red Hat JBoss Web Server (EWS), Apache Tomcat 6, and Apache Tomcat 7.
Dependendo do seu ambiente, você pode escolher a opção de instalação mais adequada para as necessidades do seu projeto.
Nota
O Red Hat JBoss BPM Suite foi desenvolvido para operar em codificação UTF-8. Caso um sistema de codificação diferente seja utilizado pela JVM subjacente, erros inesperados podem ocorrer. Para assegurar que a codificação UTF-8 seja utilizada pela JVM, use a seguinte propriedade de sistema
"-Dfile.encoding=UTF-8".
Importante
Do JBoss BPM Suite 6.1 adiante, você deve ter o JBoss EAP 6.4, ou superior, instalado antes de tentar instalar o JBoss BPM Suite.
2.1. Instalação do Instalador Red Hat JBoss BPM Suite
Copiar o linkLink copiado para a área de transferência!
Essa seção descreve as etapas necessárias para a instalação do Red Hat JBoss BPM Suite, usando o método de instalação do arquivo jar. O arquivo jar é um arquivo executável que instala o JBoss BPM Suite em uma instalação do JBoss EAP 6 existente.
Do JBoss BPM Suite 6.1 adiante, você deve ter o JBoss EAP 6.4, ou superior, instalado para instalar o JBoss BPM Suite.
Nota
Pelo fato do IBM JDK não poder utilizar armazenamentos de chaves gerados em outros JDKs, não é possível instalar o JBoss BPM Suite em um JBoss EAP executado no IBM JDK com um armazenamento de chaves em outro JDK.
2.1.1. Instalando Red Had JBoss BPM Suite Usando o Instalador
Copiar o linkLink copiado para a área de transferência!
O instalador para o Red Hat JBoss BPM Suite é um arquivo jar executável. Você pode usá-lo para instalar o JBoss BPM Suite em uma instalação EAP 6.4 existente.
Nota
Por motivos de segurança, o instalador deve ser executado como um usuário não root -
non-root user.
Pré-requisitos
Antes de tentar instalar o JBoss BPM Suite, certifique-se de que o Red Hat JBoss EAP 6.4, ou superior, já tenha sido instalado.
Certifique-se de que possui o binário
jar no $PATH antes de executar o instalador. No Red Hat Enterprise Linux, está no pacote java-$JAVA_VERSION-openjdk-devel.
- Em um prompt de comando, navegue até a pasta onde o arquivo de instalação foi baixado e execute o seguinte comando.
java -jar jboss-bpmsuite-6.2.0.GA-installer.jarNota
Quando estiver executando o instalador no Windows, você pode ser solicitado a fornecer as credenciais de administrador durante a instalação. Para evitar isto, adicioneizpack.mode=privilegedao comando de instalação:java -Dizpack.mode=privileged -jar jboss-bpmsuite-6.2.0.GA-installer.jarO instalador gráfico executará e exibirá uma tela inicial e uma página com o contrato de licença. - Aceite a licença para continuar.
- Na próxima tela, forneça o local pai de um JBoss EAP existente onde o JBoss BPM Suite deve ser instalado. A captura de tela abaixo representa um exemplo de caminho de diretório:
Figura 2.1. Red Hat JBoss BPM Suite para JBoss EAP Directory Path
- Nas próximas duas telas, crie dois usuários: o primeiro para o console de gerenciamento do EAP (ManagementRealm) e o segundo para o gerenciamento do próprio JBoss BPM Suite (ApplicationRealm).A criação do primeiro usuário para o console de gerenciamento do JBoss EAP é opcional, portanto pode ser ignorada caso não seja necessária.Anote esses nomes de usuário e senhas, pois serão necessários para acessar o servidor JBoss EAP (caso você decida criá-lo) e o aplicativo JBoss BPM Suite respectivamente.A senha do usuário do JBoss BPM Suite será usada como senha padrão tanto para o armazenamento de chaves (em inglês, keystores) JMS SSL do cliente quanto do servidor, assim como para o armazenamento de chaves no cofre de senhas, a menos que uma configuração mais avançada seja efetuada.
Nota
O nome de usuário que você criou não deve ser igual às funções predefinidas (Consulte Seção 4.1, “Definindo as Funções”).As senhas que você criar devem ter, no mínimo, 8 caracteres e devem conter, pelo menos, um número e um caractere não alfanumérico (sem incluir o caractere &).Nota
A função do aplicativo atribuída ao segundo usuário que você criar é a funçãoadmin. Funções adicionais podem ser atribuídas a esse usuário durante essa etapa. - Em seguida, configure o ambiente de segurança da sua nova instalação do JBoss BPM Suite. Nesta etapa, você pode decidir habilitar ou desabilitar o Gerenciador de Segurança do Java clicando na caixa de seleção. O Gerenciador de Segurança do Java deixa o seu sistema mais mais seguro, porém pode reduzir o desempenho. A decisão deve ser tomada de acordo com o seu ambiente.
- Você pode escolher se deseja instalar a configuração do IPv6 pura no servidor onde a instalação ocorre. Isto permitirá a você estabelecer, mais tarde, as configurações específicas do IPv6 em tempo de execução.
Configuração do Ambiente de Tempo de Execução
Essa etapa fornece a opção de usar uma configuração padrão ou especificar uma configuração avançada.Configuração Padrão
Selecione a configuração padrão para o ambiente de tempo de execução na próxima etapa e clique em , para rever os detalhes de instalação. Se estiver contente com os detalhes, clique em novamente, para iniciar a instalação propriamente dita, ou clique em , para fazer as alterações.Configuração Avançada
Selecione para habilitar opções de configurações avançadas. Selecione Efetuar configuração avançada e selecione as opções de configurações avançadas que deseja habilitar para seu ambiente através das caixas de seleção.Figura 2.2. Opções de Configuração Avançada
Configuração da Senha do Cofre
As senhas de cofre são usadas para obscurecer as senhas nos diversos descritores do servidor usando uma chave secreta java gerada durante o processo de instalação ou, manualmente, usando a ferramenta keytool. Isto evita que as senhas sejam armazenadas como textos sem formatação nos descritores. Tantoiteration countquantosaltsão usados como parâmetros para o processo de criptografia.No caso do JBoss BPM Suite, um cofre sempre será instalado, mesmo quando o usuário opta por não instalar um com seus próprios parâmetros. Quando isso acontece, os valores padrão são usados.Para mais insformações sobre as senhas de cofre, consulte o guia Red Hat JBoss EAP Security Guide.Figura 2.3. Configuração da Senha do Cofre
Segurança SSL
Essa tela permite que você adicione os elementos<ssl>e<truststore>ao realm de segurança ManagementRealm usando o armazenamento de chaves fornecido.O resultado final é uma conexão criptografada e segura entre o cliente e o servidor para o ManagementRealm.- O elemento
<ssl>faz com que o servidor apresente o certificado dentro do armazenamento de chaves como sua identidade, o que permite ao usuário aplicar o seu certificado oficial. - O elemento
<truststore>habilita a autenticação "Client-Cert". Isto significa que, se um cliente remoto tenta conectar-se com qualquer recurso gerenciado pelo ManagementRealm, o cliente pode apresentar um certificado, e caso uma entrada no armazenamento de confiança (em inglês, truststore) seja correspondida, ele será autenticado sem precisar fornecer um nome de usuário/ senha.
Figura 2.4. Configuração da Segurança SSL
Segurança LDAP
Esta etapa no instalador permite ao usuário definir um servidor LDAP, o qual, por sua vez, define os usuários que devem ter permissão para autenticar com o ManagementRealm. Isto substitui a configuração padrão.A tela permite aos usuários definir como conectar-se ao servidor LDAP.- Nome Diferenciado (em inglês, Distinguished Name - DN): o usuário que pode conectar-se com o servidor LDAP. Geralmente, o DN define, exclusivamente, um usuário especial para este propósito.
Figura 2.5. Configuração da Conexão LDAP
Segurança LDAP (Console de Gerenciamento)
A tela de permite a configuração de um realm de segurança. Isto define o elemento<security-realm>a ser adicionado aos descritores e utiliza a conexão definida anteriormente.Figura 2.6. Configuração LDAP do Console de Gerenciamento
- DN Base: define, geralmente, uma 'base de pesquisa' ou um 'contexto root' para começar a pesquisar por usuários.
- Tipo de filtro: Avisa ao JBoss EAP como encontrar o atributo LDAP que define um usuário; pode ser um atributo simples, mas também pode ser um "Filtro LDAP" complexo.
- Atributo do usuário: O atributo LDAP que mantém os valores do nome de usuário. Um nome de usuário inserido nesse campo é usado para consultas de pesquisa como um valor do atributo 'uid'. Se um usuário optar por uma 'consulta de sintaxe LDAP', como um tipo de filtro, essa consulta deve ser especificada neste campo.
- Pesquisa recursiva do diretório: se habilitada, o JBoss EAP percorrerá a árvore LDAP recursivamente, começando pelo DN Base. Caso contrário, a pesquisa ficará limitada ao DN Base.
Segurança LDAP (Business Central)
A maior parte dos campos a seguir é semelhante ao DN Base. Os contextos são usados para pesquisar por funções, o que permite a efetuação da autorização, além da autenticação. Caso contrário, os campos decontextosão análogos ao DN Base a partir do anterior e os campos deatributosão análogos ao atributo do nome de usuário. Os filtros permitem um controle específico sobre quais valores do atributo dado serão aceitos.No JBoss BPM Suite, os arquivosjbpm.usergroup.callback.propertiesejbpm.user.info.propertiesusados pelos componentesLDAPUserGroupInfoeLDAPUserInfodo Serviço de Tarefas também são preenchidos por valores inseridos na página de Configuração LDAP do Business Central.Os valores de entrada da página de Configuração LDAP do Business Central são usados para configurar um novo domínio de segurança, o qual faz uso do módulo de loginLdapExtended. Esse domínio de segurança é definido como padrão para o aplicativo web do Business Central. Para mais informações sobre domínios de segurança e módulos de login, consulte o guia Red Hat JBoss EAP Security Guide.Figura 2.7. Configuração LDAP do Business Central
Domínio de Segurança e JSSE
A tela de Domínio de Segurança permite que você configure todos os elementos do subsistema de segurança<security-domain>para o gerenciamento das informações de segurança, incluindo a configuração JSSE. Para mais detalhes sobre a configuração de domínios de segurança, consulte o guia Red Hat JBoss EAP Security Guide.Figura 2.8. Domínio de Segurança
Figura 2.9. Configuração JSSE
Configuração do Armazenamento de Chaves SSL JMS
Essa tela permite a criptografia das mensagens JMS enviadas ao Business Central. O armazenamento de chaves do cliente é distribuído a sistemas que precisam comunicar-se com o servidor para facilitar as comunicações criptografadas. Os usuários podem usar seus armazenamentos de chaves pré-existentes ou gerar novos armazenamentos.Figura 2.10. Configuração do Armazenamento de Chaves SSL JMS
Configurar Clusterização
Ao selecionar esta opção você irá instalar o JBoss BPM Suite pronto para operação clusterizada. Para maiores informações, consulte Seção 6.1, “Clusterização no JBoss EAP”.
- O instalador passará pelas etapas para instalar o JBoss BPM Suite e efetuará as etapas de configuração pós-instalação quando você clicar em . O instalador pode também iniciar o servidor JBoss BPM Suite no modo que você escolher (autônomo ou domínio, mais informações em Seção 5.1, “Iniciando o Servidor”) e conectar-se a ele para validar a instalação. Clique em para obter a última tela onde você pode gerar o script de instalação e o arquivo de propriedades. Clique em para encerrar o instalador.
O Red Hat JBoss BPM Suite é, então, instalado com êxito usando o instalador.
2.1.2. Instalando Red Hat JBoss BPM Suite Usando o Instalador no Modo CLI
Copiar o linkLink copiado para a área de transferência!
O instalador para o Red Hat JBoss BPM Suite também pode ser executado através da interface da linha de comando (CLI). O procedimento abaixo demonstra as etapas que você provavelmente encontrará ao usar essa opção para instalar o JBoss BPM Suite.
Pré-requisitos
Antes de tentar instalar o JBoss BPM Suite, certifique-se de que o Red Hat JBoss EAP 6.4, ou superior, já tenha sido instalado.
Certifique-se de que possui o binário
jar no $PATH antes de executar o instalador. No Red Hat Enterprise Linux, está no pacote java-$JAVA_VERSION-openjdk-devel.
- Em um prompt de comando, navegue até a pasta onde o arquivo de instalação foi baixado e execute o seguinte comando.
java -jar jboss-bpmsuite-6.2.0.GA-installer.jar -console
java -jar jboss-bpmsuite-6.2.0.GA-installer.jar -consoleCopy to Clipboard Copied! Toggle word wrap Toggle overflow - O processo interativo da linha de comando será iniciado e exibirá o contrato de licença. Você será solicitado a selecionar uma opção no final do acordo.
pressione 1 para continuar, 2 para sair, 3 para reexibir.
pressione 1 para continuar, 2 para sair, 3 para reexibir.Copy to Clipboard Copied! Toggle word wrap Toggle overflow - Insira 1 para iniciar a instalação e digite no diretório pai de uma instalação EAP existente.
O local abaixo deve especificar o JBOSS_HOME de uma instalação EAP existente. [/home/user/BPMSuite-6.2.0/jboss-eap-6.4]
O local abaixo deve especificar o JBOSS_HOME de uma instalação EAP existente. [/home/user/BPMSuite-6.2.0/jboss-eap-6.4]Copy to Clipboard Copied! Toggle word wrap Toggle overflow O instalador verificará o local de instalação do JBoss EAP no local indicado. Insira 1 para confirmar e continue. - Opcional: Crie um usuário para o console de gerenciamento do JBoss EAP (Realm de Gerenciamento):
Crie um usuário administrativo Esse usuário será adicionado ao realm de gerenciamento do contêiner do host para fins administrativos. Ele pode ser usado para acessar o console de gerenciamento, o gerenciamento CLI ou outros aplicativos protegidos nesse realm.
Crie um usuário administrativo Esse usuário será adicionado ao realm de gerenciamento do contêiner do host para fins administrativos. Ele pode ser usado para acessar o console de gerenciamento, o gerenciamento CLI ou outros aplicativos protegidos nesse realm.Copy to Clipboard Copied! Toggle word wrap Toggle overflow Insira 0 para ignorar a criação de um novo usuário administrativo ou 1 para a criação de um novo usuário. Caso decida criar um usuário, siga essas instruções:- Insira o nome de usuário:
Nome de usuário administrativo: [admin]
Nome de usuário administrativo: [admin]Copy to Clipboard Copied! Toggle word wrap Toggle overflow - Crie uma senha para o usuário do console de gerenciamento do EAP e confirme:
Copy to Clipboard Copied! Toggle word wrap Toggle overflow Após criar esse usuário, continue para a próxima etapa.
- Crie um usuário administrativo para o JBoss BPM Suite
Crie um Usuário Administrativo para o Business Process Management Suite Crie um usuário administrativo para o BPM Suite. O usuário será adicionado ao ApplicationRealm e pode ser utilizado para acessar o Console do Business Central. Será atribuído ao usuário a função 'admin' do aplicativo. O nome de usuário do BPM Suite não pode ser nenhum dos seguintes nomes: 'admin', 'analista', 'usuário', 'gerente' ou 'desenvolvedor'. Nome de usuário do BPM Suite: [bpmsAdmin]
Crie um Usuário Administrativo para o Business Process Management Suite Crie um usuário administrativo para o BPM Suite. O usuário será adicionado ao ApplicationRealm e pode ser utilizado para acessar o Console do Business Central. Será atribuído ao usuário a função 'admin' do aplicativo. O nome de usuário do BPM Suite não pode ser nenhum dos seguintes nomes: 'admin', 'analista', 'usuário', 'gerente' ou 'desenvolvedor'. Nome de usuário do BPM Suite: [bpmsAdmin]Copy to Clipboard Copied! Toggle word wrap Toggle overflow - Insira um nome de usuário para esse usuário e, depois, crie uma senha e confirme.
Copy to Clipboard Copied! Toggle word wrap Toggle overflow - Depois que as senhas foram inseridas e confirmadas, uma etapa opcional será oferecida para a definição de outras funções para esse usuário (além da função
admin). Insira essas funções em uma lista separada por vírgula ou apenas pressione 'enter' para ignorar essa etapa.(Opcional) Você pode atribuir funções adicionais a esse usuário que serão usadas para o gerenciamento de tarefas. Os nomes dessas funções são personalisados e usados novamente durante a criação dos seus processos com as tarefas humanas. Adicione as suas funções com nomes personalizados em uma lista separada por vírgula. Funções adicionais do usuário: []
(Opcional) Você pode atribuir funções adicionais a esse usuário que serão usadas para o gerenciamento de tarefas. Os nomes dessas funções são personalisados e usados novamente durante a criação dos seus processos com as tarefas humanas. Adicione as suas funções com nomes personalizados em uma lista separada por vírgula. Funções adicionais do usuário: []Copy to Clipboard Copied! Toggle word wrap Toggle overflow - Configure o Gerenciador de Segurança do Java pressionando 1 para selecioná-lo ou 0 para cancelar a seleção.
Copy to Clipboard Copied! Toggle word wrap Toggle overflow - Depois de selecionar o Gerenciador de Segurança do Java, escolha uma opção a partir do prompt abaixo:
pressione 1 para continuar, 2 para sair, 3 para reexibir.
pressione 1 para continuar, 2 para sair, 3 para reexibir.Copy to Clipboard Copied! Toggle word wrap Toggle overflow - Especifique se você está usando IPv6 ou não.
Copy to Clipboard Copied! Toggle word wrap Toggle overflow Depois de selecionar ou cancelar a seleção da configuração IPv6, selecione uma das seguintes opções:pressione 1 para continuar, 2 para sair, 3 para reexibir.
pressione 1 para continuar, 2 para sair, 3 para reexibir.Copy to Clipboard Copied! Toggle word wrap Toggle overflow - Configure o ambiente de tempo de execução selecionando a configuração padrão ou as opções avançadas.
Configure o ambiente de tempo de execução O Red Hat JBoss Business Process Management Suite pode ser personalizado ainda mais nesse momento. 0 [x] Efetuar a configuração padrão 1 [ ] Efetuar a configuração avançada
Configure o ambiente de tempo de execução O Red Hat JBoss Business Process Management Suite pode ser personalizado ainda mais nesse momento. 0 [x] Efetuar a configuração padrão 1 [ ] Efetuar a configuração avançadaCopy to Clipboard Copied! Toggle word wrap Toggle overflow Se você selecionar 1, "Efetuar a configuração padrão", preencha as configurações a seguir:[ ] Instalar o cofre de senhas Insira 1 para selecionar, 0 para cancelar a seleção:
[ ] Instalar o cofre de senhas Insira 1 para selecionar, 0 para cancelar a seleção:Copy to Clipboard Copied! Toggle word wrap Toggle overflow [ ] Habilitar a segurança SSL Insira 1 para selecionar, 0 para cancelar a seleção:
[ ] Habilitar a segurança SSL Insira 1 para selecionar, 0 para cancelar a seleção:Copy to Clipboard Copied! Toggle word wrap Toggle overflow [ ] Proteger o Console de Gerenciamento do EAP com LDAP Insira 1 para selecionar, 0 para cancelar a seleção:
[ ] Proteger o Console de Gerenciamento do EAP com LDAP Insira 1 para selecionar, 0 para cancelar a seleção:Copy to Clipboard Copied! Toggle word wrap Toggle overflow [ ] Proteger o Business Central com LDAP Insira 1 para selecionar, 0 para cancelar a seleção:
[ ] Proteger o Business Central com LDAP Insira 1 para selecionar, 0 para cancelar a seleção:Copy to Clipboard Copied! Toggle word wrap Toggle overflow [ ] Adicionar um domínio de segurança Insira 1 para selecionar, 0 para cancelar a seleção:
[ ] Adicionar um domínio de segurança Insira 1 para selecionar, 0 para cancelar a seleção:Copy to Clipboard Copied! Toggle word wrap Toggle overflow [ ] Gerar o Armazenamento de Chaves do Cliente JMS Insira 1 para selecionar, 0 para cancelar a seleção:
[ ] Gerar o Armazenamento de Chaves do Cliente JMS Insira 1 para selecionar, 0 para cancelar a seleção:Copy to Clipboard Copied! Toggle word wrap Toggle overflow [ ] Instalar configuração clusterizada Insira 1 para selecionar, 0 para cancelar a seleção:
[ ] Instalar configuração clusterizada Insira 1 para selecionar, 0 para cancelar a seleção:Copy to Clipboard Copied! Toggle word wrap Toggle overflow
- Em seguida, selecione uma opção a partir do prompt abaixo:
pressione 1 para continuar, 2 para sair, 3 para reexibir.
pressione 1 para continuar, 2 para sair, 3 para reexibir.Copy to Clipboard Copied! Toggle word wrap Toggle overflow - O arquivo .jar começará a descompactar e a ser configurado.
- Depois de obter uma instalação bem sucedida, a linha de comando perguntará se você deseja gerar um script de instalação automática e um arquivo de propriedades.
A instalação foi concluída com êxito. O aplicativo foi instalado em /home/user/BPMSuite-6.2.0/jboss-eap-6.4 Deseja gerar um script de instalação automática e um arquivo de propriedades? (s/n) [n]:
A instalação foi concluída com êxito. O aplicativo foi instalado em /home/user/BPMSuite-6.2.0/jboss-eap-6.4 Deseja gerar um script de instalação automática e um arquivo de propriedades? (s/n) [n]:Copy to Clipboard Copied! Toggle word wrap Toggle overflow - Se você selecionar [s], forneça um caminho para o script de instalação automática:
Selecione o caminho para o script de instalação automática: [/home/user/BPMSuite-6.2.0/jboss-eap-6.4/<auto script filename>]
Selecione o caminho para o script de instalação automática: [/home/user/BPMSuite-6.2.0/jboss-eap-6.4/<auto script filename>]Copy to Clipboard Copied! Toggle word wrap Toggle overflow Esse script gerado permitirá ao usuário executar o instalador da seguinte maneira para as futuras instalações:java -jar jboss-bpmsuite-6.2.0.GA-installer.jar <auto script filename>
java -jar jboss-bpmsuite-6.2.0.GA-installer.jar <auto script filename>Copy to Clipboard Copied! Toggle word wrap Toggle overflow Nota
Esta maneira de executar o instalador resultará em uma instalação idêntica à instalação a partir da qual o script automático foi gerado. Observe que os valores confidenciais, como as senhas, precisarão ser fornecidos de um arquivo externo ou fornecidos durante o tempo de instalação automática. O argumento opcional abaixo permite ao usuário fornecer esses valores automaticamente:-variablefile <variable filename>
-variablefile <variable filename>Copy to Clipboard Copied! Toggle word wrap Toggle overflow Os valores confidenciais também podem ser fornecidos usando o seguinte argumento:-variables key1=value1,key2=value2
-variables key1=value1,key2=value2Copy to Clipboard Copied! Toggle word wrap Toggle overflow - A linha de comando fornecerá a seguinte mensagem após a criação do script automático e/ ou da instalação do console:
XML gravado com êxito. [ Instalação do console concluída ] [BPMS_Installer]$
XML gravado com êxito. [ Instalação do console concluída ] [BPMS_Installer]$Copy to Clipboard Copied! Toggle word wrap Toggle overflow - Inicie JBoss EAP como descrito no Seção 5.1, “Iniciando o Servidor”.
- Navegue pelo http://localhost:8080/business-central.
- Faça o login com a senha e o nome de usuário corretos, como fornecidos ao usuário do JBoss BPM Suite na etapa "Crie uma senha para o usuário do JBoss BPM Suite e confirme".
2.1.3. Baixando ZIP Implantável para Red Hat JBoss EAP
Copiar o linkLink copiado para a área de transferência!
Caso você escolha não utilizar o instalador JAR, você pode baixar o arquivo ZIP implantável seguindo estas etapas:
- Acesse o Portal do Consumidor Red Hat e faça o log in.
- Clique em → .
- Quando a página Downloads de Produtos abrir, clique em Red Hat JBoss BPM Suite.
- A partir do menu suspenso Version selecione a versão 6.2.
- Selecione Red Hat JBoss BPM Suite 6.2 Implantável para EAP 6.4 e depois clique em Download.
- Extraia o arquivo. O diretório resultante é referido aqui como
$EAP_HOME. - Na linha de comando, vá para o diretório
$EAP_HOMEe inicie o servidor autônomo:Em um ambiente Unix, execute:./standalone.sh
./standalone.shCopy to Clipboard Copied! Toggle word wrap Toggle overflow Em um ambiente Windows, execute:./standalone.bat
./standalone.batCopy to Clipboard Copied! Toggle word wrap Toggle overflow
Configurando Modo Domínio
Importante
Se você instalou the JBoss BPM Suite com o instalador JAR (Seção 2.1.1, “Instalando Red Had JBoss BPM Suite Usando o Instalador” ou Seção 2.1.2, “Instalando Red Hat JBoss BPM Suite Usando o Instalador no Modo CLI”), você pode ignorar esta seção— o modo de domínio já está configurado para você.
Para descrição de como executar the JBoss BPM Suite no modo de domínio, refira-se a Seção 5.1.2, “Modo de Domínio ”.
Para instalar o pacote implantável para o JBoss EAP no modo de domínio, siga as instruções a seguir:
- Baixe e extraia o arquivo ZIP do Red Hat JBoss BPM Suite 6.2.0 Deployable for EAP 6 a partir do Red Hat Customer Portal e copie os seguintes diretórios na sua instalação local do EAP 6.4:
bindomain
Ignore o diretóriostandalone - Na linha de comando, vá para o diretório
$EAP_HOME/bine inicie o domínio:Em um ambiente Unix, execute:./domain.sh
./domain.shCopy to Clipboard Copied! Toggle word wrap Toggle overflow Em um ambiente Windows, execute:./domain.bat
./domain.batCopy to Clipboard Copied! Toggle word wrap Toggle overflow - Implante os arquivos seja via scripts CLI (
$EAP_HOME/bin/jboss-cli.shor$EAP_HOME/bin/jboss-cli.bat), ou via IU de web de gerenciamento (http://localhost:9990/):Nota
Os aplicativos webbusiness-central.waredashbuilder.warfornecidos nos binários implantáveis do EAP são diretórios, mas para a implantação no domínio, você deve usar arquivos WAR. Para criá-los, simplesmente zipe o conteúdo dos diretórios business-central.war e the dashbuilder.war.- Para implantar o arquivo via scripts CLI, mova para
$EAP_HOME/bin directorye implante o arquivo WAR, seguindo as solicitações da tela:Em um ambiente Unix, execute:./jboss-cli.sh
./jboss-cli.shCopy to Clipboard Copied! Toggle word wrap Toggle overflow Em um ambiente Windows, execute:./jboss-cli.bat
./jboss-cli.batCopy to Clipboard Copied! Toggle word wrap Toggle overflow - Para implantar o arquivo via IU de web de gerenciamento (http://localhost:9990/):
- faça o login usando a sua conta de gerenciamento do EAP
- selecione -> -> ->
- selecione o arquivo web do sistema de arquivo e carregue o arquivo web
- selecione a implantação, clique no botão
- selecione o grupo do servidor
Nota
Para fazer o login no Business Central implantado nos servidores Controladores de Host (HC), o usuário criado no Servidor Controlador de Domínio também deve ser criado nos servidores Controladores de Host, seguindo as etapas disponíveis na seção Seção 4.2, “Criando os Usuários”.
Instalando Múltiplas Instâncias do JBoss BPM Suite Server
Em muitas situações, os usuários podem querer agrupar um conjunto de nós do EAP 6 no mesmo servidor e fornecer-lhes um nome significativo para uma manutenção mais simples. Os valores únicos precisam ser incorporados às propriedades do sistema para cada instância do servidor. Segue abaixo uma lista das propriedades comuns que podem ser especificadas com um único nó do JBoss BPM Suite para mudar a configuração padrão. No entanto, elas devem ser especificadas para múltiplos nós executados em um único servidor para que todos os nós apontem para um diretório diferente:
org.uberfire.nio.git.dirorg.uberfire.metadata.index.dirorg.uberfire.nio.git.ssh.cert.dir
Quando múltiplos nós do JBoss BPM Suite são usados em um único servidor, as propriedades abaixo precisam ser especificadas:
org.uberfire.nio.git.daemon.host- pode ser deixada com o valor padrão para vincular-se ao localhost.org.uberfire.nio.git.daemon.portorg.uberfire.nio.git.ssh.host- pode ser deixada com o valor padrão para vincular-se ao localhost.org.uberfire.nio.git.ssh.port
Nota
Tanto
org.uberfire.nio.git.daemon.port quanto org.uberfire.nio.git.ssh.port necessitam de valores de porta diferentes para evitar conflitos de porta.
Incorpore as propriedades anteriores no arquivo
$EAP_HOME/domain/configuration/host.xml, como ilustrado nos dois nós abaixo:
Nó A:
Nó B:
As propriedades do sistema representadas acima devem indicar o host, a porta ou o local dos arquivos
.index ou .niogit. Esses arquivos, que devem ser usados por um nó respectivo, seriam agrupados, então, em um domínio em particular.
2.2. Instalação do Pacote Implantável Genérico
Copiar o linkLink copiado para a área de transferência!
Para instalar o Red Hat JBoss BPM Suite no Red Hat JBoss Web Server (EWS), você precisa usar o pacote implantável genérico do produto.
Para a instalação no EWS, o pacote implantável genérico contém o gerenciador de transação adicional e as bibliotecas de segurança que não fazem parte do Red Hat JBoss EWS.
Observe que, para instalar o pacote implantável genérico, você precisará dos seguintes arquivos ZIP:
jboss-bpmsuite-VERSION-deployable-generic.zip: contém os aplicativos webbusiness-central.war,dashbuilder.warekie-server.war.jboss-bpmsuite-VERSION-engine.zip: bibliotecas de mecanismo de execução com suporte para incorporar o mecanismo no seu aplicativo e outras bibliotecas necessárias para implantação genérica.
2.2.1. Baixando o Pacote Implantável Genérico
Copiar o linkLink copiado para a área de transferência!
Para baixar o pacote implantável genérico Red Hat JBoss BPM Suite no JBoss Web Server, siga as instruções a seguir:
- Acesse o Portal do Consumidor Red Hat e faça o log in.
- Clique em .
- Clique em Red Hat JBoss BPM Suite, a partir da lista de produtos.
- A partir do menu suspenso Versão, selecione a versão 6.2 (caso não esteja selecionada ainda).
- Na seção Downloads de Software que surgir, navegue pelo Red Hat JBoss BPM Suite 6.2 Deployable for All Supported Containers e clique em Download.
- Navegue também pelos arquivos Red Hat JBoss BPM Suite 6.2 Engine e clique em Download para baixar os arquivos do mecanismo JBoss BPM Suite.
2.2.2. Instalando o Pacote Implantável Genérico
Copiar o linkLink copiado para a área de transferência!
Para instalar o pacote implantável genérico, você precisará configurar o seguinte depois de ter instalado a plataforma subjacente (Red Hat JBoss WS):
- Configure o driver do banco de dados e o gerenciador de transação (Bitronix) (consulte Seção 2.2.2.1, “Configurando o Gerenciador de Transação para Red Hat JBoss Web Server 2.1 (Tomcat 7)”).
- Configure o aplicativo Business Central: defina os usuários, as funções e a persistência (consulte Seção 2.2.2.2, “Configurando o Business Central para Red Hat JBoss Web Server 2.1 (Tomcat 7)”).
- Configure o aplicativo Dashbuilder: defina os usuários, as funções e a persistência (consulte Seção 2.2.2.3, “Configurando Dashbuilder para Red Hat JBoss Web Server 2.0 (Tomcat 7)”).
2.2.2.1. Configurando o Gerenciador de Transação para Red Hat JBoss Web Server 2.1 (Tomcat 7)
Copiar o linkLink copiado para a área de transferência!
- Extraia o pacote zip implantável genérico baixado do Portal do Consumidor Red Hat para um local temporário. Esse pacote zip contém os três arquivos do aplicativo web a seguir:
business-central.war,dashbuilder.warekie-server.warem um formato expandido. Renomeie essas pastas para remover a extensão.war. - Copie essas pastas diretamente sob a pasta
$TOMCAT_DIR/webapps.Você deve obter três pastas em um formato expandido:$TOMCAT_DIR/webapps/business-central,$TOMCAT_DIR/webapps/dashbuildere$TOMCAT_DIR/webapps/kie-server.Nota
$TOMCAT_DIR refere-se ao diretório base onde seu servidor web está localizado. Substitua-o pelo próprio caminho do diretório base do seu servidor web, por exemplo:/home/john/jboss-ews-2.1/tomcat7/ - Extraia os conteúdos dos arquivos do mecanismo JBoss BPM Suite para um local temporário de onde você pode copiar as bibliotecas necessárias. Essa pasta contém, agora, todas as bibliotecas principais do JBoss BPM Suite sob a pasta extraída e uma pasta
lib. Instale o Gerenciador de Transação.
Atenção
Por favor, observe que a seção a seguir descreve a instalação de um gerenciador de transação, Bitronix, que não possui suporte da Red Hat.Copie as seguintes bibliotecas jar do gerenciador de transação da pastalibno diretório$TOMCAT_DIR/lib/:- btm-VERSION.jar
- btm-tomcat55-lifecycle-VERSION.jar
- jta-VERSION.jar
- slf4j-api-VERSION.jar
- slf4j-jdk14-VERSION.jar
Além disso, baixe a biblioteca a seguir e copie-a na pasta$TOMCAT_DIR/lib/também:Instale o Driver no seu Banco de Dados
Copie o arquivo jar com o driver do banco de dados relevante no$TOMCAT_DIR/lib/.Nota
Caso utilize o banco de dados H2 incorporado, o driver estará disponível embusiness-central/WEB-INF/lib/.- Crie os arquivos de configuração do gerenciador de transação em
$TOMCAT_DIR/conf/:- btm-config.properties
bitronix.tm.serverId=tomcat-btm-node0 bitronix.tm.journal.disk.logPart1Filename=${btm.root}/work/btm1.tlog bitronix.tm.journal.disk.logPart2Filename=${btm.root}/work/btm2.tlog bitronix.tm.resource.configuration=${btm.root}/conf/resources.propertiesbitronix.tm.serverId=tomcat-btm-node0 bitronix.tm.journal.disk.logPart1Filename=${btm.root}/work/btm1.tlog bitronix.tm.journal.disk.logPart2Filename=${btm.root}/work/btm2.tlog bitronix.tm.resource.configuration=${btm.root}/conf/resources.propertiesCopy to Clipboard Copied! Toggle word wrap Toggle overflow - resources.properties (resource.ds1.uniqueName define, depois, o nome da fonte de dados usado na definição do recurso tomcat - anote esse valor).Certifique-se de mudar os valores nas definições a seguir para corresponderem ao seu ambiente.
Exemplo 2.1. Definição da fonte de dados H2
Copy to Clipboard Copied! Toggle word wrap Toggle overflow Exemplo 2.2. Definição da fonte de dados MySQL 5.5
Copy to Clipboard Copied! Toggle word wrap Toggle overflow Exemplo 2.3. Definição da fonte de dados DB2 Tipo 4
Copy to Clipboard Copied! Toggle word wrap Toggle overflow Exemplo 2.4. Definição da fonte de dados Oracle
Copy to Clipboard Copied! Toggle word wrap Toggle overflow Exemplo 2.5. Definição da fonte de dados Microsoft SQL Server
Copy to Clipboard Copied! Toggle word wrap Toggle overflow
- Configure o ouvinte do gerenciador de transação no
$TOMCAT_DIR/conf/server.xmlpara iniciar e encerrar Bitronix na inicialização e no desligamento do contêiner:Adicione o elemento a seguir como o último elemento <Listener> no elemento <Server>:<Listener className="bitronix.tm.integration.tomcat55.BTMLifecycleListener" />
<Listener className="bitronix.tm.integration.tomcat55.BTMLifecycleListener" />Copy to Clipboard Copied! Toggle word wrap Toggle overflow - Defina a propriedade de sistema btm.root e o local onde o arquivo de configuração bitronix será colocado:Em
$TOMCAT_DIR/bin/, crie um arquivo legívelsetenv.shcom o seguinte conteúdo:CATALINA_OPTS="-Xmx512M -XX:MaxPermSize=512m -Djava.security.auth.login.config=$CATALINA_HOME/webapps/business-central/WEB-INF/classes/login.config -Dbtm.root=$CATALINA_HOME -Dbitronix.tm.configuration=$CATALINA_HOME/conf/btm-config.properties -Dorg.jbpm.designer.perspective=RuleFlow -Djbpm.tsr.jndi.lookup=java:comp/env/TransactionSynchronizationRegistry"
CATALINA_OPTS="-Xmx512M -XX:MaxPermSize=512m -Djava.security.auth.login.config=$CATALINA_HOME/webapps/business-central/WEB-INF/classes/login.config -Dbtm.root=$CATALINA_HOME -Dbitronix.tm.configuration=$CATALINA_HOME/conf/btm-config.properties -Dorg.jbpm.designer.perspective=RuleFlow -Djbpm.tsr.jndi.lookup=java:comp/env/TransactionSynchronizationRegistry"Copy to Clipboard Copied! Toggle word wrap Toggle overflow A propriedadeorg.jbpm.designer.perspectiveé definida comoRuleFlowpermitindo que a perspectiva padrão para o designer sejaRuleFlowao invés deFull. Conceda as permissões de execução do arquivo, se necessário.A propriedadejava.security.auth.login.configdeve ser definida para que o clone ssh do repositório git funcione.Importante
Nos sistemas do Microsoft Windows, substitua o valor$CATALINA_HOMEno conteúdo do arquivo pelo nome da variável do ambiente equivalente ou use o caminho absoluto e adicione os valores no arquivosetenv.bat, como apresentado aqui, no exemplo a seguir:defina "CATALINA_OPTS=-Xmx512M -XX:MaxPermSize=512m -Dbtm.root=C:/Tomcat -Dbitronix.tm.configuration=C:/Tomcat/conf/btm-config.properties -Dorg.jbpm.designer.perspective=RuleFlow"
defina "CATALINA_OPTS=-Xmx512M -XX:MaxPermSize=512m -Dbtm.root=C:/Tomcat -Dbitronix.tm.configuration=C:/Tomcat/conf/btm-config.properties -Dorg.jbpm.designer.perspective=RuleFlow"Copy to Clipboard Copied! Toggle word wrap Toggle overflow
2.2.2.2. Configurando o Business Central para Red Hat JBoss Web Server 2.1 (Tomcat 7)
Copiar o linkLink copiado para a área de transferência!
Para configurar o Business Central, siga as instruções a seguir:
- Defina um
Valvepara que o aplicativo web do Business Central possa carregar os usuários definidos no Tomcat:- Defina os usuários e as funções em
$TOMCAT_DIR/conf/tomcat-users.xml. Observe que o Business Central exige que os usuários tenham as funções especificadas comoadmine/ouanalista(para mais informações sobre as definições de usuário e função, consulte a documentação sobre Tomcat 7).Segue abaixo um exemplo de como essas duas funções seriam adicionadas e como elas seriam atribuídas a um usuário nomeadobpmsadmin.Nota
Certifique-se de que os nomes de usuário não entrem em conflito com as funções conhecidas. Por exemplo, você não deve criar um usuário com o nome de usuárioadmin.<role rolename="admin"/> <role rolename="analyst" /> <user username="bpmsadmin" password="P@ssw0rd" roles="admin,analyst"/>
<role rolename="admin"/> <role rolename="analyst" /> <user username="bpmsadmin" password="P@ssw0rd" roles="admin,analyst"/>Copy to Clipboard Copied! Toggle word wrap Toggle overflow - Mova (não copie)
kie-tomcat-integration-VERSION.jarde$TOMCAT_DIR/webapps/business-central/WEB-INF/lib/para$TOMCAT_DIR/lib/. - Copie
jboss-jaxb-api-VERSION.jarde$TOMCAT_DIR/webapps/business-central/WEB-INF/lib/no$TOMCAT_DIR/lib/. - Em
$TOMCAT_DIR/conf/server.xml, adicione a declaração Tomcat Valve no elemento <host> relevante:<Valve className="org.kie.integration.tomcat.JACCValve" />
<Valve className="org.kie.integration.tomcat.JACCValve" />Copy to Clipboard Copied! Toggle word wrap Toggle overflow
- Caso esteja utilizando uma fonte de dados que não seja a fonte de dados padrão fornecida pelo banco de dados H2 subjacente, você precisará definir as persistências. Se estiver usando o banco de dados H2 padrão, você pode ignorar as outras etapas deste procedimento.Nesse procedimento, você configura uma fonte de dados com o nome JNDI
jdbc/myDatasource, como definido antes em uniqueName=jdbc/jbpm no arquivoresources.propertiesbitronix (para a opção MySQL).- Em
business-central/META-INF/context.xml, substitua o nome JNDI da fonte de dados no elemento <Resource>. O atributo uniqueName refere-se à propriedade resource.ds1.uniqueName definida emresources.properties:<Resource name="jdbc/myDatasource" uniqueName="jdbc/jbpm" auth="Container" removeAbandoned="true" factory="bitronix.tm.resource.ResourceObjectFactory" type="javax.sql.DataSource"/>
<Resource name="jdbc/myDatasource" uniqueName="jdbc/jbpm" auth="Container" removeAbandoned="true" factory="bitronix.tm.resource.ResourceObjectFactory" type="javax.sql.DataSource"/>Copy to Clipboard Copied! Toggle word wrap Toggle overflow - Em
business-central/WEB-INF/web.xml, substitua o nome JNDI da fonte de dados no elemento <res-ref-name> pelo nome da sua fonte de dados:Copy to Clipboard Copied! Toggle word wrap Toggle overflow - Altere
business-central/WEB-INF/classes/META-INF/persistence.xml.Nesse arquivo, altere o nome do dialeto do hibernate usado para a sua fonte de dados, se estiver usando uma fonte de dados diferente da H2. O código abaixo demonstra as informações originais da fonte de dados parapersistence.xml:<property name="hibernate.dialect" value="org.hibernate.dialect.H2Dialect"/>
<property name="hibernate.dialect" value="org.hibernate.dialect.H2Dialect"/>Copy to Clipboard Copied! Toggle word wrap Toggle overflow Essas informações podem ser atualizadas da seguinte maneira (como demonstrado com o banco de dados MySQL abaixo):<property name="hibernate.dialect" value="org.hibernate.dialect.MySQLDialect"/>
<property name="hibernate.dialect" value="org.hibernate.dialect.MySQLDialect"/>Copy to Clipboard Copied! Toggle word wrap Toggle overflow Nota
O dialeto para DB2 éorg.hibernate.dialect.DB2Dialect, para DB2 em AS/400 éorg.hibernate.dialect.DB2400Dialect, para Oracle éorg.hibernate.dialect.Oracle10gDialecte para Microsoft SQL Server éorg.hibernate.dialect.SQLServerDialect - Altere o arquivo
business-central/WEB-INF/classes/META-INF/persistence.xmlpara que o mecanismo do processo JBoss BPM Suite possa usar o novo banco de dados.O código abaixo demonstra as informações originais da fonte de dados parapersistence.xml:<jta-data-source>java:comp/env/jdbc/jbpm</jta-data-source>
<jta-data-source>java:comp/env/jdbc/jbpm</jta-data-source>Copy to Clipboard Copied! Toggle word wrap Toggle overflow Altere esse valor para a fonte de dados definida antes:<jta-data-source>java:comp/env/jdbc/myDatasource</jta-data-source>
<jta-data-source>java:comp/env/jdbc/myDatasource</jta-data-source>Copy to Clipboard Copied! Toggle word wrap Toggle overflow
- Você pode, agora, iniciar o JBoss Web Server para fazer o login no Business Central.
- Execute
startup.shno diretório $TOMCAT_HOME/bin../startup.sh
./startup.shCopy to Clipboard Copied! Toggle word wrap Toggle overflow - Navegue pelo http://localhost:8080/business-central.
- Faça o login com o nome de usuário e a senha definidos antes no arquivo
tomcat-users.xml.
2.2.2.3. Configurando Dashbuilder para Red Hat JBoss Web Server 2.0 (Tomcat 7)
Copiar o linkLink copiado para a área de transferência!
Nota
Antes de configurar o Dashbuilder no Red Hat JBoss Web Server, você deve certificar-se de que o Business Central foi instalado e iniciado corretamente, como descrito na Seção 2.2.2.2, “Configurando o Business Central para Red Hat JBoss Web Server 2.1 (Tomcat 7)”. O Dashbuilder necessita que as tabelas da fonte de dados do log do histórico estejam presentes, as quais são fornecidas pelo Business Central. Se essas tabelas não existirem na fonte de dados antes de você tentar realizar as etapas abaixo, erros de inicialização podem ocorrer.
Para configurar o Dashbuilder no Red Hat JBoss Web server, siga as instruções a seguir:
- Defina os usuários e as funções em
$TOMCAT_DIR/conf/tomcat-users.xml. Observe que, o Dashbuilder exige que os usuários tenham as funções especificadas comoadmine/ouanalista. Se você já definiu esses usuários antes para o Business Central, você não precisa definí-los novamente. - Habilite o logon único entre o Dashbuilder e o Business Central removendo os comentários das seguintes linhas no arquivo
$TOMCAT_DIR/conf/server.xml:<Valve className="org.apache.catalina.authenticator.SingleSignOn" />
<Valve className="org.apache.catalina.authenticator.SingleSignOn" />Copy to Clipboard Copied! Toggle word wrap Toggle overflow - Quanto à configuração do Business Central, se você estiver usando um banco de dados que não seja o padrão e o banco de dados H2 integrado, você precisará definir as persistências.Nesse procedimento, você configura uma fonte de dados com o nome JNDI
jdbc/dashbuilderDS, como definido em uniqueName=jdbc/jbpm no arquivoresources.propertiesbitronix:- Em
dashbuilder/META-INF/context.xml, substitua o nome JNDI da fonte de dados no elemento <Resource>. O atributo uniqueName refere-se à propriedade resource.ds1.uniqueName definida emresources.properties:<Resource name="jdbc/dashbuilderDS" uniqueName="jdbc/jbpm" auth="Container" removeAbandoned="true" factory="bitronix.tm.resource.ResourceObjectFactory" type="javax.sql.DataSource"/>
<Resource name="jdbc/dashbuilderDS" uniqueName="jdbc/jbpm" auth="Container" removeAbandoned="true" factory="bitronix.tm.resource.ResourceObjectFactory" type="javax.sql.DataSource"/>Copy to Clipboard Copied! Toggle word wrap Toggle overflow Nota
Dependendo do seu banco de dados, pode ser preciso definir algumas outras propriedades também. Por exemplo, em um ambiente Oracle, essa entrada pode parecer-se com o seguinte:<Resource name="jdbc/jbpm" uniqueName="jdbc/jbpm" auth="Container" removeAbandoned="true" factory="bitronix.tm.resource.ResourceObjectFactory" type="javax.sql.DataSource" username="username" password="password" driverClassName="oracle.jdbc.xa.client.OracleXADataSource" url="jdbc:oracle:thin:YOUR-URL:1521:YOUR-DB" maxActive="8" />
<Resource name="jdbc/jbpm" uniqueName="jdbc/jbpm" auth="Container" removeAbandoned="true" factory="bitronix.tm.resource.ResourceObjectFactory" type="javax.sql.DataSource" username="username" password="password" driverClassName="oracle.jdbc.xa.client.OracleXADataSource" url="jdbc:oracle:thin:YOUR-URL:1521:YOUR-DB" maxActive="8" />Copy to Clipboard Copied! Toggle word wrap Toggle overflow - Em
dashbuilder/WEB-INF/web.xml, substitua o nome JNDI da fonte de dados no elemento <res-ref-name> pelo nome da sua fonte de dados:Copy to Clipboard Copied! Toggle word wrap Toggle overflow - Em
dashbuilder/META-INF/context.xml, defina a fábrica de transação:<Transaction factory="bitronix.tm.BitronixUserTransactionObjectFactory"/>
<Transaction factory="bitronix.tm.BitronixUserTransactionObjectFactory"/>Copy to Clipboard Copied! Toggle word wrap Toggle overflow - Atualize o nome JNDI da fonte de dados em
dashbuilder/WEB-INF/etc/hibernate.cfg.xmlno elemento <session-factory>:<property name="connection.datasource">java:/comp/env/jdbc/dashbuilderDS</property>
<property name="connection.datasource">java:/comp/env/jdbc/dashbuilderDS</property>Copy to Clipboard Copied! Toggle word wrap Toggle overflow
- Reinicie o servidor Web Java para que essas alterações sejam efetivadas. Depois de reiniciado, você pode navegar pelo Dashbuilder de dentro do Business Central ou diretamente via:
http://localhost:8080/dashbuilder.
Capítulo 3. Configurações Especiais
Copiar o linkLink copiado para a área de transferência!
3.1. Configurando Persistências para o Business Central
Copiar o linkLink copiado para a área de transferência!
O Red Hat JBoss BPM Suite é configurado para usar uma fonte de dados de exemplo com o nome JNDI (Java Naming and Directory Interface)
java:jboss/datasources/ExampleDS. Para o Business Central, essa fonte de dados de exemplo está localizada no arquivo business-central.war/WEB-INF/classes/META-INF/persistence.xml.
Caso queira configurar o JBoss BPM Suite para usar um banco de dados externo, faça as mudanças a seguir. Para o arquivo
business-central.war/WEB-INF/classes/META-INF/persistence.xml:
- Instale o respectivo driver JDBC (Java Database Connectivity) usando a abordagem modular para facilitar as configurações subsequentes (consulte a documentação do EAP 6).
- Crie uma nova fonte de dados segundo o exemplo na documentação do EAP 6, seção 6.7.1. Exemplo da Fonte de Dados PostgreSQL . Essa é a configuração padrão usada da fonte de dados específica do banco de dados H2:
Copy to Clipboard Copied! Toggle word wrap Toggle overflow - Use o nome JNDI da fonte de dados para atualizar a seguinte entrada dentro do arquivo
persistence.xml, o qual é definido por padrão nessa entrada.<jta-data-source>java:jboss/datasources/ExampleDS</jta-data-source>
<jta-data-source>java:jboss/datasources/ExampleDS</jta-data-source>Copy to Clipboard Copied! Toggle word wrap Toggle overflow Importante
Quando estiver configurando a sua fonte de dados, certifique-se de habilitar o JTA (geralmente, adicionandojta="true"à tagdatasource). - Substitua o texto a seguir pelo nome apropriado do dialeto do hibernate específico do banco de dados.Por exemplo, para um Oracle Database Express Edition 11g, o nome ficaria:
<property name="hibernate.dialect" value="org.hibernate.dialect.H2Dialect" />
<property name="hibernate.dialect" value="org.hibernate.dialect.H2Dialect" />Copy to Clipboard Copied! Toggle word wrap Toggle overflow <property name="hibernate.dialect" value="org.hibernate.dialect.Oracle10gDialect" />
<property name="hibernate.dialect" value="org.hibernate.dialect.Oracle10gDialect" />Copy to Clipboard Copied! Toggle word wrap Toggle overflow
Nota
Quando o JBoss BPM Suite utiliza o Oracle 11 como a fonte de dados, múltiplas mensagens de aviso (
Copy to Clipboard
Copied!
Toggle word wrap
Toggle overflow
WARN) são produzidas nos logs, sem que qualquer atividade correspondente ao Business Central esteja sendo realizada. Esse é o comportamento esperado. Para desabilitar essas mensagens, defina o nível da categoria org.hibernate.loader do agente como ERROR no arquivo standalone.xml:
<logger category="org.hibernate.loader"> <level name="ERROR"/> </logger>
<logger category="org.hibernate.loader">
<level name="ERROR"/>
</logger>3.2. Configurando Persistências para o Dashbuilder
Copiar o linkLink copiado para a área de transferência!
Como o Dashbuilder é dependente da configuração do Business Central, certifique-se de que o Business Central esteja configurado de acordo com a Seção 3.1, “Configurando Persistências para o Business Central”. O Red Hat BPM Suite 6 é configurado para usar uma fonte de dados com o nome JNDI (Java Naming and Directory Interface)
java:jboss/datasources/ExampleDS. Caso queira que o aplicativo funcione com um banco de dados diferente do H2 como, por exemplo, Oracle, MySQL, Postgres ou MS SQL Server, siga as instruções a seguir.
Nota
Caso queira usar UTF 8 para exibir os caracteres que não sejam do inglês, você deve verificar a documentação do seu banco de dados e configurar a codificação ao nível do banco de dados para que o Dashbuilder funcione corretamente. Por exemplo, no MySQL, adicione ao arquivo de configuração do servidor o seguinte:
Copy to Clipboard
Copied!
Toggle word wrap
Toggle overflow
[mysqld] character-set-server=utf8 collation-server=utf8_general_ci
[mysqld]
character-set-server=utf8
collation-server=utf8_general_ciImportante
Nos sistemas Unix, substitua o valor padrão do MySQL lower_case_table_names de
0 (diferenciando maiúsculas de minúsculas) para 1 (não diferenciando maiúsculas de minúsculas). As consultas do JBoss BPM Suite KPI são gravadas em minúsculas, mas os nomes das tabelas são gravados em camelCase. Ao mudar a propriedade lower_case_table_names, você evitará que as exceções ocorram depois.
- Instale o driver do banco de dados e crie uma nova fonte de dados de acordo com o exemplo na Documentação do EAP 6 na seção 6.7.1. Exemplo da Fonte de Dados PostgreSQL.
- Crie um banco de dados vazio.
- Modifique o arquivo
dashbuilder.war/WEB-INF/jboss-web.xmlcuja entrada padrão é:Copy to Clipboard Copied! Toggle word wrap Toggle overflow - Modifique também os arquivos
WEB-INF/jboss-deployment-structure.xml, de ambos os aplicativosbusiness-central.waredashbuilder.war, e adicione uma dependência sob a seção de dependências no módulo do driver JBDC, criado anteriormente durante a criação da fonte de dados. O snippet a seguir mostra uma configuração de amostra ondejdbcDriverModuleNameé o nome do módulo do driver JDBC do JBoss EAP 6.Copy to Clipboard Copied! Toggle word wrap Toggle overflow
3.3. Configuração Especial para o Banco de Dados IBM DB2
Copiar o linkLink copiado para a área de transferência!
Caso queira usar um banco de dados IBM DB2 como a fonte de dados subjacente para o Business Central, você precisará aumentar o tamanho da página para o banco de dados. O tamanho padrão de 4kb da página não é suficiente para o tamanho das colunas das tabelas do Dashbuilder.
Quando criando o banco de dados, force o tamanho da página para 16384, como no exemplo abaixo:
Exemplo 3.1. Ajustando o tamanho da página
CREATE DATABASE dashb PAGESIZE 16384
CREATE DATABASE dashb PAGESIZE 16384
Esse aumento do tamanho da página para o banco de dados subjacente deve ser realizado antes que o BPM Suite tenha sido executado pela primeira vez.
Capítulo 4. Funções e Usuários
Copiar o linkLink copiado para a área de transferência!
4.1. Definindo as Funções
Copiar o linkLink copiado para a área de transferência!
Antes de iniciar o servidor e fazer o login no Business Central, você precisará criar algumas contas de usuários. Esta seção descreve as diferentes funções de usuários que são usadas no Red Hat JBoss BPM Suite :
- admin: os usuários com funções admin são os administradores do aplicativo. Os administradores podem gerenciar os usuários e os repositórios (criar e clonar) e ter acesso completo para efetuar as alterações solicitadas no aplicativo. Os administradores têm acesso a todas as áreas do sistema.
- desenvolvedor: um desenvolvedor tem acesso a quase todos os recursos e pode gerenciar as regras, os modelos, os fluxos de processos, os formulários e os painéis. Eles podem gerenciar o repositório de ativos, criar, construir e implantar projetos e podem até mesmo usar o Red Hat JBoss Developer Studio para visualizar os processos. Apenas certas funções administrativas, como criar e clonar um novo repositório, estão ocultas para a função de desenvolvedor.
- analista: um analista tem acesso a todos os recursos de alto nível para modelar e executar seus projetos. No entanto, o acesso à → está indisponível para os usuários com a função de analista. Alguns recursos de nível mais baixo voltados para os desenvolvedores, como a visualização de → , não estão acessíveis para essa função. Já o botão Compilar & Implantar está disponível para a função de analista durante o uso do Editor de Projeto.
- usuário: o usuário ou usuário empresarial trabalha com as listas de tarefas de negócios que são usadas para operar um certo processo. Um usuário com essa função pode acessar o painel e gerenciar processos.
- gerenciador: um gerenciador é um visualizador do sistema que está interessado nas estatísticas referentes aos processos empresariais e seus desempenhos, indicadores de negócios e outros tipos de notificação do sistema. Um usuário com essa função tem acesso somente ao BAM.
Nota
Insira as funções mencionadas acima durante o processo de criação do usuário.
4.2. Criando os Usuários
Copiar o linkLink copiado para a área de transferência!
Para começar a adicionar novos usuários, você precisará executar o script add-user.sh em um sistema Unix ou o arquivo add-user.bat em um sistema Windows a partir do diretório bin do EAP.
- Execute ./add-user.sh em um sistema Unix ou add-user.bat em um sistema Windows a partir do diretório bin.
- Insira b para selecionar um Usuário do Aplicativo no prompt do usuário e pressione Enter.
- Aceite o Realm padrão (ApplicationRealm): pressionando Enter.
- No prompt de nome de usuário, insira um nome de usuário e confirme:
helloworlduser.Nota
Certifique-se de que os nomes de usuário não entrem em conflito com grupos conhecidos. Por exemplo, caso haja um grupo chamadoadmin, você não deve criar um usuário com o nome de usuárioadmin. - Crie a senha do usuário no prompt de senha e insira novamente a senha. Por exemplo:
Helloworld@123.Nota
A senha deve ter, no mínimo, 8 caracteres e deve conter caracteres alfabéticos com letras maiúsculas e minúsculas (ex.: A-Z, a-z), ao menos um caractere numérico (ex.: 0-9) e ao menos um caractere especial (ex.: ~ ! @ # $ % ^ * ( ) - _ + =). - Insira uma lista separada por vírgulas das funções que o usuário precisará no prompt de funções (consulte Seção 4.1, “Definindo as Funções”).Os usuários do Business Central precisam ter, no mínimo, a função de
analistae os usuários do Dashbuilder precisam ter a função deadmin. As funções devem ser inseridas em uma lista separada por vírgulas. - Confirme caso queira adicionar o usuário.
- Insira sim (em inglês, yes) no próximo prompt (para habilitar o clustering no futuro, se necessário).
Capítulo 5. Testando a Instalação
Copiar o linkLink copiado para a área de transferência!
5.1. Iniciando o Servidor
Copiar o linkLink copiado para a área de transferência!
Nota
Se você instalou JBoss BPM Suite utilizando a versão implantável genérica no Red Hat Java Web Server, Seção 2.2, “Instalação do Pacote Implantável Genérico ” contém as instruções para iniciar o servidor. Neste caso, você pode ignorar a discussão a seguir.
Quando o servidor JBoss BPM Suite estiver instalado no JBoss EAP 6, você pode executá-lo seja no modo standalone ou no modo domain.
5.1.1. Modo Autônomo
Copiar o linkLink copiado para a área de transferência!
Se você utilizou o instalador JAR para JBoss EAP 6, especificado no Seção 2.1, “Instalação do Instalador Red Hat JBoss BPM Suite”, você pode executar o servidor em um dos modos autônomos: standalone ou standalone-secure.
Nota
Se você escolher o ZIP Implantável para JBoss EAP, as etapas de configuração estão descritas no Seção 2.1.3, “Baixando ZIP Implantável para Red Hat JBoss EAP”.
O script de inicialização padrão
standalone.sh com que o Red Hat JBoss BPM Suite é enviado é otimizado para desempenho. Para executar o seu servidor no modo desempenho, siga as instruções a seguir:
- Na linha de comando, mova para o diretório
$EAP_HOME/bin/. - Em um ambiente Unix, execute:
./standalone.sh
./standalone.shCopy to Clipboard Copied! Toggle word wrap Toggle overflow Em um ambiente Windows, execute:./standalone.bat
./standalone.batCopy to Clipboard Copied! Toggle word wrap Toggle overflow
O Red Hat JBoss BPM Suite também é enviado com um script separado,
standalone-secure.sh, que é otimizado para segurança. Esse script utiliza uma política de segurança por padrão que evita vulnerabilidades de segurança conhecidas.
Nota
É recomendável que os ambientes de produção usem o script
standalone-secure.sh.
Atenção
É importante estar ciente de que o uso de um gerenciador de segurança afeta consideravelmente o desempenho. O equilíbrio entre segurança e desempenho deve ser feito levando em consideração as circunstâncias individuais. Consulte Seção 5.2, “Gerenciamento de Desempenho e Gerenciador de Segurança do Java”.
Para executar o seu servidor no modo de segurança com esse script, siga as instruções a seguir:
- Na linha de comando, mova para o diretório
$EAP_HOME/bin/. - Em um ambiente Unix, execute:
./standalone-secure.sh
./standalone-secure.shCopy to Clipboard Copied! Toggle word wrap Toggle overflow Em um ambiente Windows, execute:./standalone-secure.bat
./standalone-secure.batCopy to Clipboard Copied! Toggle word wrap Toggle overflow
Nota
Se você instalou o JBoss BPM Suite usando o instalador, você terá a opção de aplicar a política de segurança no momento da instalação. O instalador não fornece um script
standalone-secure.sh separado.
5.1.2. Modo de Domínio
Copiar o linkLink copiado para a área de transferência!
Se você utilizou o instalador JAR installer especificado no Seção 2.1, “Instalação do Instalador Red Hat JBoss BPM Suite”, JBoss BPM Suite já está configurado para executar no modo de domínio.
Nota
Se você escolher o ZIP implantável para JBoss EAP, as etapas de configuração para o modo de domínio estão descritas no Seção 2.1.3, “Baixando ZIP Implantável para Red Hat JBoss EAP”.
Para iniciar o JBoss BPM Suite no modo de domínio, execute as seguintes etapas:
- Na linha de comando, mova para o diretório
$EAP_HOME/bin/. - Em um ambiente Unix, execute:
./domain.sh
./domain.shCopy to Clipboard Copied! Toggle word wrap Toggle overflow Em um ambiente Windows, execute:./domain.bat
./domain.batCopy to Clipboard Copied! Toggle word wrap Toggle overflow
5.2. Gerenciamento de Desempenho e Gerenciador de Segurança do Java
Copiar o linkLink copiado para a área de transferência!
Como observado anteriormente, a habilitação do Gerenciador de Segurança do Java (JSM) para desempenhar a avaliação em área restritada dos scripts MVEL no Red Hat JBoss BPM Suite introduz uma queda de desempenho em ambientes de alta carga. Os ambientes e marcadores de desempenho devem ser levados em consideração durante a implantação de um aplicativo JBoss BPM Suite. Use as diretrizes a seguir para a implantação de aplicativos seguros e de alto desempenho JBoss BPM Suite.
- Em ambientes de alta carga, onde o desempenho é crítico, recomenda-se implantar somente os aplicativos que foram desenvolvidos em outros sistemas e que foram revisados adequadamente. Recomenda-se também não criar usuários com a função de analista em tais sistemas. Se essas salvaguardas forem seguidas, é seguro deixar o JSM desabilitado nesses sistemas para que ele não introduza degradação alguma ao desempenho.
- Nos ambientes de desenvolvimento e de testes sem altas cargas, ou em ambientes onde a criação de processos e regras está exposta às redes externas, recomenda-se ter o JSM habilitado para atingir os benefícios de segurança das avaliações em área restrita do MVEL.
Não é seguro e nem recomendável permitir que os usuários com a função de analista façam o log in no console do Business Central com o JSM desabilitado.
5.3. Fazendo o log in no Business Central
Copiar o linkLink copiado para a área de transferência!
Faça o log in no Business Central depois que o servidor foi iniciado com êxito.
- Navegue até o http://localhost:8080/business-central. Caso a interface do usuário tenha sido configurada para execução a partir de um modo de domínio, substitua
localhostpelo nome do domínio. Por exemplo, http://www.example.com:8080/business-central. - Faça o login usando as credenciais do usuário que foram criadas durante a instalação. Por exemplo: Usuário =
helloworldusere senha =Helloworld@123.
Capítulo 6. Clusterizando
Copiar o linkLink copiado para a área de transferência!
Quando clusterizando o Red Hat JBoss BPM Suite, considere quais componentes precisam ser clusterizados. Segue uma lista do que pode ser clusterizado:
- O Repositório GIT: repositório do sistema de arquivos virtual (em inglês, virtual-file-system - VFS) que retém os ativos empresariais para que todos os nós do cluster utilizem o mesmo repositório.
- O Servidor de Execução e os Aplicativos Web: servidor de tempo de execução que reside no contêiner (como o Red Hat JBoss EAP) junto com os aplicativos web BRMS e BPM Suite para que os nós compartilhem os mesmos dados de tempo de execução.Para instruções sobre como clusterizar o aplicativo, consulte a documentação de clusterização de contêineres.
- O Banco de Dados Back-end: banco de dados com dados de estados, tais como, instâncias de processos, sessões KIE, log do histórico, etc., com finalidade de failover.
Figura 6.1. Esquema do Sistema Red Hat JBoss BPM Suite com Componentes de Sistemas Individuais
Mecanismo de Clusterização do Repositório GIT
Para clusterizar o repositório GIT, usa-se o seguinte:
- Apache Zookeeper, que reúne todas as partes.
- Apache Helix, componente de gerenciamento do cluster que registra todos os detalhes do cluster (o cluster em si, os nós e os recursos).
O ambiente de tempo de execução, que é o Servidor de Execução, utiliza o seguinte para fornecer as capacidades de clusterização:
- uberfire framework, que fornece o suporte principal dos aplicativos web.
Figura 6.2. Esquema de clusterização com Helix e Zookeeper
Uma configuração típica de clusterização envolve o seguinte:
- Configurar o próprio cluster, usando Zookeeper e Helix
- Configurar o banco de dados back-end com configuração e tabelas Quartz
- Configurar a clusterização no seu contêiner (essa documentação fornece instruções de clusterização apenas para o Red Hat JBoss EAP 6)
Clusterizando os Repositórios do Maven
Várias operações dentro do Business Central publicam JARs no repositório do Maven interno no Business Central.
Esse repositório existe no sistema de arquivos do servidor do aplicativo como arquivos comuns e não oferece suporte a clusters. Esta pasta não é sincronizada através nos vários nós no cluster e deve ser sincronizada utilizando ferramentas externas como a
rsync.
Uma alternativa ao uso de ferramentas de sincronização externas é definir a propriedade do sistema org.guvnor.m2repo.dir em cada nó do cluster, apontando para um SAN ou NAS. Nesse caso, a clusterização da pasta do repositório do Maven não é necessária.
6.1. Clusterização no JBoss EAP
Copiar o linkLink copiado para a área de transferência!
Para instalar JBoss BPM Suite no modo cluster, recomendamos que utilize o instalador JAR, que fornece uma amostra de configuração que funciona por padrão. Porém, você também pode definir clusterização com um ZIP implantável para EAP.
6.1.1. Clusterização utilizando instalador JAR
Copiar o linkLink copiado para a área de transferência!
Nota
O instalador JAR fornece somente amostra de configuração, é necessário ajustar as configurações para que atenda às necessidades do seu projeto.
Utilizando o instalador JAR descrito no Seção 2.1, “Instalação do Instalador Red Hat JBoss BPM Suite”, você pode estabelecer uma configuração de clusterização básica de JBoss BPM Suite.
A configuração automática cria três instâncias ZooKeeper, uma cluster Helix que utiliza essas instâncias, e dois datastores Quartz (um gerenciado e outro não gerenciado). Esta configuração JBoss BPM Suite consiste em dois nós EAP que compartilham um repositório do Maven, utilize Quartz para coordenar tarefas cronometradas, e tenha implantados
business-central.war, dashbuilder.war, e kie-server.war . Para personalizar a configuração para adaptar ao seu cenário, ou para utilizar clusterização com ZIP implantável, consulte o Seção 6.1.2, “Configuração Personalizada (ZIP Implantável)”. Você pode também obter mais informações no JBoss EAP documentation.
Siga o processo de instalação descrito em Seção 2.1.1, “Instalando Red Had JBoss BPM Suite Usando o Instalador” e selecione Instalar configurações clusterizadas em Configuração de Tempo de Execução Avançada. Depois de clicar em avançar, você irá percorrer as seguintes etapas. :
Nota
As etapas listadas aqui descrevem a instalação com GUI. As etapas para a instalação do console são análogas.
Selecione fornecedor JDBC
Nesta tela, selecione o fornecedor JDBC da lista. Você precisa fornecer os JARs drivers JDBC correspondentes em uma destas formas:- Selecione um ou mais arquivos no sistema de arquivos
- Forneça uma ou mais URLs. O instalador baixa os arquivos automaticamente.
Em seguida, o instalador copia o(s) JAR(s) em uma localização apropriada abaixo do diretório$EAP_HOME/modules, onde um arquivomodule.xmlcorrespondente também foi criado automaticamente.Figura 6.3. Configuração do JDBC Driver
Configurar conexão Quartz
Na próxima tela, forneça os dados para o banco de dados para Quartz. O instalador automaticamente cria o arquivo de definição Quartz ($EAP_HOME/domain/configuration/quartz-definition.properties) e duas fontes de dados Quartz no arquivo de configuração de domínio$EAP_HOME/domain/domain.xml. Você pode editar os arquivos depois de terminada a instalação.Nota
Durante a instalação, scripts do DDL Quartz serão executados no banco de dados selecionado nesta etapa. Estes scripts fazem mudanças necessárias para que o Quartz opere (adicionando tabelas, etc.), e podem ser encontrados em$EAP_HOME/jboss-brms-bpmsuite-6.2-supplementary-tools/ddl-scriptspara referência (Você não precisa modificá-los de nenhuma forma).Figura 6.4. Configuração de banco de dados Quartz
- Clique em next para iniciar a instalação.
Importante
Quando utilizar o instalador JAR, os arquivoswarsão automaticamente criados dos aplicativos que residem em$EAP_HOME/standalone/deployments/. Isto significa que é necessário espaço adicional conforme os aplicativos existam em ambos os estados compactado e descompactado no armazenamento durante a instalação.Três instâncias ZooKeeper são criadas automaticamente em$EAP_HOME/jboss-brms-bpmsuite-6.2-supplementary-tools/(directory nameszookeeper-one,zookeeper-two, ezookeeper-three).No diretório$EAP_HOME/jboss-brms-bpmsuite-6.2-supplementary-tools/helix-core, você pode encontrar configuração Helix padrão e scripts para iniciar o cluster—startCluster.shpara UNIX estartCluster.batpara Windows.Depois de finalizada a instalação, NÃO selecione executar o servidor imediatamente. Primeiro você precisa iniciar o cluster mudando para o diretório$EAP_HOME/jboss-brms-bpmsuite-6.2-supplementary-tools/helix-coree executando o script de inicialização mencionado:Nos sistemas UNIX:./startCluster.sh
./startCluster.shCopy to Clipboard Copied! Toggle word wrap Toggle overflow No Windows:./startCluster.bat
./startCluster.batCopy to Clipboard Copied! Toggle word wrap Toggle overflow Este script inicializa o cluster Helix e as intâncias ZooKeeper. Somente depois disto, inicie o servidor EAP no modo de domínio, movendo para o diretório$EAP_HOME/bine executando:Nos sistemas UNIX:./domain.sh
./domain.shCopy to Clipboard Copied! Toggle word wrap Toggle overflow No Windows:./domain.bat
./domain.batCopy to Clipboard Copied! Toggle word wrap Toggle overflow
Você tem agora um JBoss BPM Suite cluster em pleno funcionamento.
6.1.2. Configuração Personalizada (ZIP Implantável)
Copiar o linkLink copiado para a área de transferência!
Quando utilizar a clusterização JBoss EAP, existe um único controlador de domínio do JBoss EAP com os outros subordinados do JBoss EAP conectando-se a ele como usuários de gerenciamento. A implantação do Business Central e do Dashbuilder pode ser feita como um usuário de gerenciamento em um controlador de domínio e as implantações WAR serão distribuídas a outros membros do cluster do JBoss EAP.
Para configurar a clusterização no Red Hat JBoss EAP 6, siga as instruções a seguir:
- Configurar Zookeeper e Helix de acordo com Seção 6.2.1, “Configurando um Cluster”.
- Configurar Quartz de acordo com Seção 6.2.2, “Configurando o Quartz”.
- Instale o seu driver JDBC como um módulo principal: copie o driver jar em
$EAP_HOME/modules/system/layers/base/e crie um arquivomodule.xmlno diretório. - Edite o arquivo
module.xmla partir do respectivo módulo XSD.Exemplo 6.1. Conteúdo do arquivo module.xml para uma fonte de dados PostgreSQL
Copy to Clipboard Copied! Toggle word wrap Toggle overflow - Configurar a fonte de dados para o servidor: abra para edição o arquivo
host.xmloustandalone.xml, dependendo do PERFIL utilizado que está localizado no$EAP_HOME/PROFILE/, localize o perfilcompletoe siga as instruções a seguir:- Adicione a definição da fonte de dados principal usada pelo JBoss BPM Suite.
Exemplo 6.2. A fonte de dados PostgreSQL definida como a fonte de dados JBoss BPM Suite principal
Copy to Clipboard Copied! Toggle word wrap Toggle overflow - Adicionar a definição da fonte de dados para o serviço Quartz.
Exemplo 6.3. A fonte de dados PostgreSQL definida como a fonte de dados Quartz
Copy to Clipboard Copied! Toggle word wrap Toggle overflow - Definir o driver da fonte de dados.
Exemplo 6.4. Definição do driver PostgreSQL
<driver name="postgres" module="org.postgresql"> <xa-datasource-class>org.postgresql.xa.PGXADataSource</xa-datasource-class> </driver>
<driver name="postgres" module="org.postgresql"> <xa-datasource-class>org.postgresql.xa.PGXADataSource</xa-datasource-class> </driver>Copy to Clipboard Copied! Toggle word wrap Toggle overflow
- Configure os nós de servidores individuais no
main-server-groupelement in the$EAP_HOME/domain/configuration/host.xmlarquivo com propriedades definidas Tabela 6.1, “Propriedades dos Nós de Cluster ”:Observe que, ao configurar um cluster do JBoss EAP com o ZooKeeper, é possível haver uma diferença entre o número de nós do JBoss EAP e do ZooKeeper (lembrando que o ZooKeeper deve ter um número ímpar de nós). No entanto, é considerada a melhor prática ter a mesma contagem de nós tanto para o ZooKeeper quanto para o JBoss EAP.Expand Tabela 6.1. Propriedades dos Nós de Cluster Nome das propriedades Valor Descrição jboss.node.namenodeOneNome de nó exclusivo dentro do clusterorg.quartz.properties/bpms/quartz-definition.propertiescaminho absoluto para o arquivo de configuração Quartzorg.uberfire.cluster.autostarttrueEste valor atrasa a clusterização VFS até que o aplicativo seja completamente inicializado, evitando conflitos quando todos os membros do cluster criam clones locais.org.uberfire.cluster.idbpms-clusterNome do cluster do Helixorg.uberfire.cluster.local.idnodeOne_12345ID exclusiva do nó do cluster do Helix.Observe que:é substituído por_.org.uberfire.cluster.vfs.lockvfs-repoNome do recurso definido no cluster Helixorg.uberfire.cluster.zkserver1:2181Localização do ZooKeeperorg.uberfire.metadata.index.dir/home/jbpm/node[N]/indexLocal onde o index para pesquisa será criado (mantido pelo Apache Lucene)org.uberfire.nio.git.daemon.hostnodeOneNome da máquina hospedeira daemon em um cluster físico. org.uberfire.nio.git.daemon.port9418Porta usada pelo repositório VFS para aceitar as conexões do clienteA porta precisa ser exclusiva para cada membro do cluster.org.uberfire.nio.git.dir/home/jbpm/node[N]/repoLocalização do repositório (VFS) GIT no nó[N]org.uberfire.nio.git.ssh.hostnodeOneNome da máquinha hospedeira SSH em um cluster físico. org.uberfire.nio.git.ssh.port8003Número de porta exclusivo para acesso ssh ao repo GIT para um cluster em execução nas máquinas físicas. org.uberfire.nio.git.ssh.hostport and org.uberfire.nio.git.daemon.hostport8003 and 9418Porta externa a ser usada em um ambiente virtualizado. Exemplo 6.5. Configuração do cluster de nó 1 (nodeOne)
Copy to Clipboard Copied! Toggle word wrap Toggle overflow Exemplo 6.6. Configuração do cluster de nó 2 (nodeTwo)
Copy to Clipboard Copied! Toggle word wrap Toggle overflow Exemplo 6.7. Configuração do cluster de nó 3 (nodeThree)
Copy to Clipboard Copied! Toggle word wrap Toggle overflow - Adicione os usuários de gerenciamento, conforme instruído no guia Administration and Configuration Guide do Red Hat JBoss EAP e os usuários do aplicativo, conforme instruído no guia Red Hat JBoss BPM Suite Administration and Configuration Guide.
- Mova para o diretório
$EAP_HOME/bine inicie o servidor do aplicativo no modo de domínio:Nos sistemas UNIX:./domain.sh
./domain.shCopy to Clipboard Copied! Toggle word wrap Toggle overflow No Windows:./domain.bat
./domain.batCopy to Clipboard Copied! Toggle word wrap Toggle overflow - Verifique se os nós estão disponíveis.
Implante o aplicativo Business Central nos seus servidores:
- Mude a persistência predefinida do aplicativo para o banco de dados solicitado (PostgreSQL): em
persistence.xml, mude o seguinte:- o nome da fonte de dados jta para a fonte definida no servidor do aplicativo (
java:jboss/datasources/psbpmsDS) - hibernar o dialeto para corresponder ao dialeto da fonte de dados (
org.hibernate.dialect.PostgreSQLDialect)
- Faça o logon como o usuário de gerenciamento no console de administração do servidor do seu domínio e adicione as novas implantações utilizando o modo de exibição Runtime do console. Depois que a implantação for adicionada ao domínio, atribua-a ao grupo de servidores correto (
main-server-group).
Nota
É importante que os usuários verifiquem explicitamente a prontidão da unidade de implantação em cada membro de cluster.
Quando uma unidade de implantação é criada em um nó de cluster, leva-se algum tempo até que ela seja distribuída entre todos os membros do cluster. O status da implantação pode ser verificado via IU e REST, no entanto, caso a consulta chegue ao nó onde a implantação foi emitida originalmente, a resposta será implantada -
deployed. Qualquer solicitação direcionando essa unidade de implantação enviada a um membro de cluster diferente falha com DeploymentNotFoundException.
6.2. Clusterização de Pacote Genérico
Copiar o linkLink copiado para a área de transferência!
6.2.1. Configurando um Cluster
Copiar o linkLink copiado para a área de transferência!
Para clusterizar seu repositório GIT (VFS) na Business Central, faça o seguinte (se você não utiliza a Business Central, você pode ignorar esta seção):
- Baixe o
jboss-bpmsuite-brms-VERSION-supplementary-tools.zip, que contém Apache Zookeeper, Apache Helix, e scripts DDL Quartz. Depois de baixar, descompacte o arquivo: o diretórioZookeeper($ZOOKEEPER_HOME) e o diretórioHelix($HELIX_HOME) são criados. - Agora, configue o ZooKeeper:
- No diretório ZooKeeper, vá para o diretório
confe siga as instruções a seguir:cp zoo_sample.cfg zoo.cfg
cp zoo_sample.cfg zoo.cfgCopy to Clipboard Copied! Toggle word wrap Toggle overflow - Abra
zoo.cfgpara edição e ajuste as configurações, incluindo:Copy to Clipboard Copied! Toggle word wrap Toggle overflow Certifique-se de que o local dataDir existe e está acessível. - Atribua uma ID de nó a cada membro que executará o ZooKeeper. Por exemplo, use "1", "2" e "3" para o nó 1, o nó 2 e o nó 3, respectivamente. O ZooKeeper deve ter um número ímpar de instâncias, no mínimo 3, para recuperar-se de falhas.A ID de nó é especificada em um campo chamado
myidsob o diretório de dados do ZooKeeper em cada nó. Por exemplo, no nó 1, execute:$ echo "1" > /zookeeper/data/myid
- Configure o ZooKeeper para que você possa usá-lo quando estiver criando o cluster com Helix:
- Vá para o diretório
$ZOOKEEPER_HOME/bin/e inicie o ZooKeeper:./zkServer.sh start
./zkServer.sh startCopy to Clipboard Copied! Toggle word wrap Toggle overflow O log do ZooKeeper pode ser verificado no arquivo$ZOOKEEPER_HOME/bin/zookeeper.out. Verifique esse log e certifique-se de que o 'ensemble' (cluster) foi formado com êxito. Um dos nós deve ser eleito o líder com os outros dois nós seguindo-o.
- Depois que o ensemble do ZooKeeper é iniciado, o próximo passo é configurar e iniciar o Helix. O Helix precisa ser configurado somente uma vez e de um único nó. A configuração é em seguida armazenada pelo ensemble do ZooKeeper e compartilhada quando conveniente.Configure o cluster com o servidor ZooKeeper como o mestre (em inglês, master) da configuração:
- Crie o cluster fornecendo a porta e o host do ZooKeeper como uma lista separada por vírgulas:
$HELIX_HOME/bin/helix-admin.sh --zkSvr ZOOKEEPER_HOST:ZOOKEEPER_PORT --addCluster CLUSTER_NAME
$HELIX_HOME/bin/helix-admin.sh --zkSvr ZOOKEEPER_HOST:ZOOKEEPER_PORT --addCluster CLUSTER_NAMECopy to Clipboard Copied! Toggle word wrap Toggle overflow - Adicione os seus nós ao cluster:
$HELIX_HOME/bin/helix-admin.sh --zkSvr ZOOKEEPER_HOST:ZOOKEEPER_PORT --addNode CLUSTER_NAME NODE_NAMEUNIQUE_ID
$HELIX_HOME/bin/helix-admin.sh --zkSvr ZOOKEEPER_HOST:ZOOKEEPER_PORT --addNode CLUSTER_NAME NODE_NAMEUNIQUE_IDCopy to Clipboard Copied! Toggle word wrap Toggle overflow Exemplo 6.8. Adicionando três nós de cluster
./helix-admin.sh --zkSvr server1:2181,server2:2181,server3:2181 --addNode bpms-cluster nodeOne:12345 ./helix-admin.sh --zkSvr server1:2181,server2:2181,server3:2181 --addNode bpms-cluster nodeTwo:12346 ./helix-admin.sh --zkSvr server1:2181,server2:2181,server3:2181 --addNode bpms-cluster nodeThree:12347
./helix-admin.sh --zkSvr server1:2181,server2:2181,server3:2181 --addNode bpms-cluster nodeOne:12345 ./helix-admin.sh --zkSvr server1:2181,server2:2181,server3:2181 --addNode bpms-cluster nodeTwo:12346 ./helix-admin.sh --zkSvr server1:2181,server2:2181,server3:2181 --addNode bpms-cluster nodeThree:12347Copy to Clipboard Copied! Toggle word wrap Toggle overflow
- Adicione os recursos ao cluster:
Exemplo 6.9. Adicionando vfs-repo como recurso
./helix-admin.sh --zkSvr server1:2181,server2:2181,server3:2181 --addResource bpms-cluster vfs-repo 1 LeaderStandby AUTO_REBALANCE
./helix-admin.sh --zkSvr server1:2181,server2:2181,server3:2181 --addResource bpms-cluster vfs-repo 1 LeaderStandby AUTO_REBALANCECopy to Clipboard Copied! Toggle word wrap Toggle overflow - Redistribua o cluster com os três nós.
Exemplo 6.10. Redistribuindo o bpms-cluster
./helix-admin.sh --zkSvr server1:2181,server2:2181,server3:2181 --rebalance bpms-cluster vfs-repo 3
./helix-admin.sh --zkSvr server1:2181,server2:2181,server3:2181 --rebalance bpms-cluster vfs-repo 3Copy to Clipboard Copied! Toggle word wrap Toggle overflow No comando acima,3significa três nós do zookeeper. - Inicie o controlador Helix em todos os nós no cluster.
Exemplo 6.11. Iniciando o controlador Helix
./run-helix-controller.sh --zkSvr server1:2181,server2:2181,server3:2181 --cluster bpms-cluster 2>&1 > /tmp/controller.log &
./run-helix-controller.sh --zkSvr server1:2181,server2:2181,server3:2181 --cluster bpms-cluster 2>&1 > /tmp/controller.log &Copy to Clipboard Copied! Toggle word wrap Toggle overflow
Nota
O ZooKeeper deve ter um número ímpar de instâncias, no mínimo 3 para recuperar-se de falhas. Após a ocorrência de uma falha, o número de nós restante ainda precisa constituir uma maioria. Por exemplo, um cluster composto de cinco nós do ZooKeeper pode resistir à perda de dois nós e recuperar-se completamente. Uma instância do ZooKeeper também é possível, a replicação irá funcionar, porém não há possibilidade de recuperar-se caso ela falhe.
Encerrando Helix e ZooKeeper
Para encerrar os processos Helix e o servidor ZooKeeper, utilize o procedimento a seguir.
Procedimento 6.1. Encerrando Helix e ZooKeeper
- Encerre os processos do servidor JBoss EAP.
- Encerre o processo Helix que foi criado pelo
run-helix-controller.sh, por exemplo,kill -15 <pid of HelixControllerMain>. - Encerre o servidor ZooKeeper usando o comando
zkServer.sh stop.
6.2.2. Configurando o Quartz
Copiar o linkLink copiado para a área de transferência!
Nota
Se você não estiver usando o Quartz (temporizadores) nos seus processos empresariais, ou se não estiver utilizando o Servidor de Execução em nenhuma forma, você pode ignorar essa seção. Observe que, caso queira replicar os temporizadores nos seus processos empresariais, você precisará usar o componente Quartz.
Antes de configurar o banco de dados no seu servidor de aplicativo, você precisa preparar o banco de dados para o Quartz para criar as tabelas Quartz, que irão manter os dados do temporizador e o arquivo de definição Quartz.
Para realizar a configuração, siga as instruções a seguir:
- Configure o banco de dados. Certifique-se de usar uma das fontes de dados com suporte sem JTA. Observe que, pelo fato do Quartz precisar de uma fonte de dados sem JTA, você não pode usar a fonte de dados do Business Central. No código de exemplo, o PostgreSQL é usado com o usuário
bpmse a senhabpms. Esse banco de dados precisará ser conectado ao seu servidor de aplicativo, portanto mantenha um registro nas credenciais e nas informações do banco de dados. - Crie tabelas Quartz no seu banco de dados para permitir a sincronização dos eventos do temporizador. Para fazer isso, utilize o script DDL para o seu banco de dados, disponível no arquivo zip suplementar extraído em
$QUARTZ_HOME/docs/dbTables. - Crie o arquivo de configuração Quartz
quartz-definition.propertiesno diretório$JBOSS_HOME/PROFILE/configuration/e defina as propriedades Quartz.Exemplo 6.12. Arquivo de configuração Quartz para um banco de dados PostgreSQL
Copy to Clipboard Copied! Toggle word wrap Toggle overflow Observe as fontes de dados, que acomodarão os dois esquemas Quartz, configuradas bem no fim do arquivo.Importante
O intervalo recomendado para a descoberta do cluster é de 20 segundos e está definido em org.quartz.jobStore.clusterCheckinInterval do arquivoquartz-definition.properties. Leve em consideração o impacto no desempenho e modifique a sua configuração, conforme necessário.Observe também a propriedade org.quartz.jobStore.driverDelegateClass que define o dialeto DB a ser usado quando comunicando-se com o banco de dados definido (nesse caso,org.quartz.impl.jdbcjobstore.PostgreSQLDelegate. Quando estiver usando Oracle, utilizeorg.quartz.impl.jdbcjobstore.oracle.OracleDelegate).
Capítulo 7. Repositórios do Maven
Copiar o linkLink copiado para a área de transferência!
7.1. Sobre o Maven
Copiar o linkLink copiado para a área de transferência!
O Apache Maven é uma ferramanta de automação de compilação distribuída usada no desenvolvimento de aplicativos Java para compilar e gerenciar projetos de software. O Maven utiliza arquivos de configuração XML chamados POM (Modelo de Objeto do Projeto) para definir as propriedades dos projetos e gerenciar o processo de compilação. Os arquivos POM descrevem o módulo do projeto e as dependências dos componentes, a ordem de compilação e as metas para o empacotamento e a saída do projeto resultante, garantindo que os projetos sejam compilados de forma correta e uniforme.
O Maven utiliza repositórios para armazenar as bibliotecas Java, plug-ins e outros artefatos de compilação. Os repositórios podem ser locais ou remotos. Um repositório local trata-se de um download de artefatos de um repositório remoto em cache em uma máquina local. Um repositório remoto é qualquer outro repositório acessado usando protocolos comuns, tais como
http://, quando localizado em um servidor HTTP, ou file://, quando localizado em um servidor de arquivos. O repositório padrão é o Repositório Central do Maven 2 remoto público.
A configuração do Maven é realizada ao modificar o arquivo
settings.xml. É possível estabelecer as configurações globais do Maven no arquivo M2_HOME/conf/settings.xml ou as configurações em nível de usuário no arquivo USER_HOME/.m2/settings.xml .
Para mais informações sobre o Maven, consulte Welcome to Apache Maven.
Para mais informações sobre os repositórios do Maven, consulte Apache Maven Project - Introduction to Repositories.
Para mais informações sobre os arquivos POM do Maven, consulte Apache Maven Project POM Reference.
Nota
Seu produto Red Hat JBoss foi compilado com Maven 3.0.x. Portanto, esta é a versão Maven recomendável para a compilação dos seus aplicativos SwitchYard.
7.2. Sobre os Repositórios do Maven Fornecidos
Copiar o linkLink copiado para a área de transferência!
Este lançamento fornece um conjunto de repositórios contendo os artefatos necessários para a compilação dos aplicativos baseados no Red Hat JBoss BPM Suite. O Maven deve ser configurado para usar esses repositórios, assim como o Repositório Central do Maven, para fornecer uma funcionalidade de compilação adequada.
São fornecidos dois conjuntos intercambiáveis de repositórios garantindo a mesma funcionalidade. O primeiro conjunto pode ser baixado e armazenado em um sistema de arquivos local e o segundo conjunto é hospedado online para uso como repositório remoto. Caso você tenha fornecido o local do arquivo
settings.xml do Maven durante a instalação, o Maven já estará configurado para usar os repositórios online.
Importante
O conjunto dos repositórios remotos online é uma fonte de visualização de tecnologia dos componentes. Como tal, não está no escopo de correção e possui suporte somente para uso em ambientes de desenvolvimento. O uso do conjunto de repositórios online em ambiente de produção é uma fonte potencial de vulnerabilidades de segurança e, portanto, não possui caso de uso com suporte. Para mais informações, consulte https://access.redhat.com/site/maven-repository.
7.3. Configurando o Maven para Usar Repositórios do Sistema de Arquivos
Copiar o linkLink copiado para a área de transferência!
Visão Geral
Em situações onde você não pode usar os repositórios online, você terá que baixar e configurar os repositórios necessários localmente.
Procedimento 7.1.
- Baixe os arquivos ZIP a seguir contendo os repositórios necessários:
- Descomprima os arquivos ZIP baixados em um local arbitrário em um sistema de arquivos local.
- Adicione as entradas para os repositórios descompactados ao arquivo
settings.xmldo Maven. O exemplo de código a seguir contém um perfil com os repositórios , a configuração de autenticação para acesso aos repositórios e uma entrada de ativação para o perfil:Copy to Clipboard Copied! Toggle word wrap Toggle overflow
Resultado
Os repositórios do Maven são baixados, descompactados em um sistema de arquivos local, registrados no arquivo settings.xml do Maven e, então, estarão prontos para serem usados durante a execução das compilações do Maven.
Solução de Problemas
- P: Por que eu ainda obtenho erros durante a compilação ou implantação dos meus aplicativos?
- P: Por que o JBoss Developer Studio está usando a minha configuração antiga do Maven?
P:
Por que eu ainda obtenho erros durante a compilação ou implantação dos meus aplicativos?
R:
Problema
Quando você compila ou implanta um projeto, ele falha com um ou ambos os erros a seguir:
[ERRO] Falha ao executar a meta no projeto PROJECT_NAMENão foi possível encontrar o artefato ARTIFACT_NAME
Causa
O seu repositório local em cache do Maven pode conter artefatos desatualizados.
Solução
Para resolver o problema, exclua o repositório local em cache – o diretório no Linux ~/.m2/repository/ ou o diretório no Windows – %SystemDrive%\Users\USERNAME\.m2\repository\ e execute mvn clean install -U. Isso forçará o Maven a baixar as versões corretas dos artefatos necessários durante a execução da próxima compilação.
P:
Por que o JBoss Developer Studio está usando a minha configuração antiga do Maven?
R:
Problema
Você atualizou a sua configuração do Maven, mas essa configuração não aparece no JBoss Developer Studio.
Causa
Se o JBoss Developer Studio estiver em execução no momento que você modifica o seu arquivo settings.xml do Maven, essa configuração não aparecerá no JBoss Developer Studio.
Solução
Atualize as configurações do Maven no IDE. A partir do menu, selecione → . Na janela Preferências, expanda o Maven e selecione Configurações do Usuário. Clique no botão para atualizar as configurações de usuário do Maven no JBoss Developer Studio.
Figura 7.1. Atualize as Configurações de Usuário do Maven
7.4. Configurando o Maven para Usar Repositórios Online
Copiar o linkLink copiado para a área de transferência!
Os repositórios online necessários para os aplicativos do Red Hat JBoss BPM Suite estão localizados em http://maven.repository.redhat.com/techpreview/all/.
Caso não tenha configurado o repositório do Maven durante a instalação, você pode configurá-lo usando o procedimento a seguir. (Também é possível configurá-lo usando o arquivo POM do projeto, mas não é recomendável.)
Procedimento 7.2. Configurando o Maven para Usar Repositórios Online
- Adicione as entradas para os repositórios online e a configuração de autenticação para acessá-los ao arquivo
settings.xmldo Maven, como no exemplo de código abaixo:Copy to Clipboard Copied! Toggle word wrap Toggle overflow - Caso tenha modificado o arquivo
settings.xmlenquanto o JBoss Developer Studio estava em execução, você deverá atualizar as configurações do Maven. A partir do menu, selecione → . Na Janela Prefereências, expanda o Maven e selecione Configurações do Usuário. Clique no botão para atualizar as configurações de usuário do Maven no JBoss Developer Studio.Figura 7.2. Atualize as Configurações de Usuário do Maven
Resultado
O Maven foi configurado para usar os repositórios online fornecidos para o seu produto Red Hat JBoss.
Importante
Caso o seu repositório local em cache do Maven contenha artefatos desatualizados, você pode encontrar um dos seguintes erros durante a compilação ou implantação do seu projeto:
- Artefato ARTIFACT_NAME ausente
- [ERRO] Falha ao executar a meta no projeto PROJECT_NAME; Não foi possível resolver as dependências para PROJECT_NAME
Para resolver o problema, exclua o repositório local em cache – o diretório no Linux
~/.m2/repository/ ou o diretório no Windows %SystemDrive%\Users\USERNAME\.m2\repository\. Isso forçará o Maven a baixar as versões corretas dos artefatos necessários durante a próxima compilação.
7.5. Gerenciamento de Dependências
Copiar o linkLink copiado para a área de transferência!
Para usar as dependências corretas do Maven no seu projeto do Red Hat JBoss BPM Suite, você deve adicionar os arquivos da Lista de Materiais (BOM) relevantes ao arquivo
pom.xml do projeto. A adição dos arquivos BOM garante que as versões corretas das dependências transitivas dos repositórios do Maven fornecidos sejam incluídas no projeto.
O repositório do Maven das versões 6.1.0 em diante está projetado para ser utilizado somente em combinação com o Maven Central e não há necessidade de outros repositórios.
Dependendo das necessidades do seu projeto, declare as dependências no seu arquivo POM e na seção de dependências:
- org.jboss.bom.brms:jboss-brms-bpmsuite-bom:VERSION: Esse é o BOM básico sem qualquer suporte Java EE6.
- org.jboss.bom.brms:jboss-javaee-6.0-with-brms-bpmsuite:VERSION: Fornece suporte ao Java EE6.
Capítulo 8. Red Hat JBoss Developer Studio
Copiar o linkLink copiado para a área de transferência!
8.1. Red Hat JBoss Developer Studio
Copiar o linkLink copiado para a área de transferência!
O Red Hat JBoss Developer Studio é o ambiente de desenvolvimento integrado (IDE) do JBoss baseado no Eclipse. Para obter as informações mais atualizadas sobre o JBoss Developer Studio, acesse o Portal do Consumidor Red Hat https://access.redhat.com. O JBoss Developer Studio fornece plug-ins com ferramentas e interfaces para o Red Hat JBoss BRMS e o Red Hat JBoss BPM Suite. Esses plug-ins são baseados nas versões da comunidade desses produtos. Portanto, o plug-in do JBoss BRMS é chamado de plug-in Drools e o plug-in do JBoss BPM Suite é chamado de plug-in jBPM.
Consulte a documentação Red Hat JBoss Developer Studio para instruções de instalação e configuração.
Atenção
Certifique-se de que a instância do JBoss Developer Studio seja iniciada com a codificação do arquivo definida como
UTF-8, devido a um problema na forma como os nomes de regra com múltiplos bytes são tratados. Você pode fazer isto editando o arquivo $JBDS_HOME/studio/jbdevstudio.ini e adicionando a seguinte propriedade: "-Dfile.encoding=UTF-8"
8.2. Instalando os Plug-ins do JBoss Developer Studio
Copiar o linkLink copiado para a área de transferência!
Os plug-ins Drools e jBPM para o JBoss Developer Studio estão disponíveis através do site de atualização.
Procedimento 8.1. Instale os Plug-ins Drools e jBPM do JBoss Developer Studio
- Inicie o JBoss Developer Studio.
- Selecione → .
- Clique em Adicionar para inserir o menu Adicionar Repositório.
- Forneça um nome ao site do software próximo ao campo Nome e adicione o seguinte url no campo Local: https://devstudio.jboss.com/updates/8.0/integration-stack/
- Clique em OK.
- Selecione o recurso JBoss Business Process and Rule Development a partir das opções disponíveis e clique em Avançar e, depois, em Avançar novamente.
- Leia o contrato de licença e aceite seus termos selecionando o botão de opção apropriado e clique em Concluir.
- Após concluir a instalação dos plug-ins, reinicie o JBoss Developer Studio.
8.3. Definindo o Tempo de Execução do Plug-in Drools
Copiar o linkLink copiado para a área de transferência!
Para usar o plug-in do Red Hat JBoss BRMS com Red Hat JBoss Developer Studio, é necessário configurar o tempo de execução.
O tempo de execução é uma coleção de arquivos jar que representa um lançamento específico do software e fornece as bibliotecas necessárias para a compilação e execução dos seus ativos empresariais.
Procedimento 8.2. Configure o Tempo de Execução do JBoss BRMS
- Extraia os arquivos jar do tempo de execução localizados no arquivo
jboss-brms-VERSION-engine.zip, que pode ser baixado através do Portal do Consumidor Red Hat. - A partir do menu JBoss Developer Studio, selecione a Janela e clique em Preferências.
- Selecione → .
- Clique em Adicionar...; forneça um nome para o novo tempo de execução e clique em Navegar para navegar até o diretório onde você extraiu os arquivos do tempo de execução na etapa 1. Clique em OK para registrar o tempo de execução selecionado no JBDS.
- Marque o tempo de execução que você criou como o tempo de execução padrão do Drools clicando na caixa de seleção próxima a ele.
- Clique em OK. Caso tenha projetos existentes, uma caixa de diálogo indicará que você deve reiniciar o JBoss Developer Studio para atualizar o tempo de execução.
8.4. Configurando o JBoss BPM Suite Server
Copiar o linkLink copiado para a área de transferência!
O JBoss Developer Studio pode ser configurado para executar o Red Hat JBoss BPM Suite Server.
Procedimento 8.3. Configure o Servidor
- Abra o modo de exibição do jBPM selecionando → → e selecione jBPM. Depois, clique em OK.
- Adicione o modo de visualização do servidor selecionando → → e selecione → .
- Abra o menu do servidor clicando com o botão direito do mouse no painel Servidores e selecione → .
- Defina o servidor selecionando → e clique em Avançar.
- Defina o diretório base clicando no botão Navegar. Navegue e selecione o diretório de instalação para o JBoss EAP 6.4, o qual possui JBoss BPM Suite instalado.
- Forneça um nome para o servidor no campo Nome, certifique-se de que o arquivo de configuração esteja definido e clique em Concluir.
8.5. Importando os Projetos de um Repositório Git no JBoss Developer Studio
Copiar o linkLink copiado para a área de transferência!
Você pode configurar o JBoss Developer Studio para conectar-se a um repositório central de ativos Git. O repositório armazena regras, modelos, funções e processos.
Você pode clonar um repositório remoto Git ou importar um repositório local Git.
Procedimento 8.4. Clonando um Repositório Remoto Git
- Inicie o Red Hat JBoss BRMS/BPM Suite Server (o que for aplicável) selecionando o servidor através da guia servidor e clique no ícone iniciar.
- Simultaneamente, inicie o servidor Secure Shell, se ainda não estiver em execução, usando o comando a seguir. O comando é específico ao Linux e Mac apenas. Caso o sshd já tenha sido iniciado nessas plataformas, esse comando não funcionará. Nesse caso, é mais seguro ignorar essa etapa.
/sbin/service sshd start
/sbin/service sshd startCopy to Clipboard Copied! Toggle word wrap Toggle overflow - No JBoss Developer Studio, selecione → e navegue até a pasta Git. Abra a pasta Git e selecione e clique em .
- Selecione a fonte do repositório como e clique em .
- Insira os detalhes do repositório Git na próxima janela e clique em .
Figura 8.1. Detalhes do Repositório Git
- Selecione a ramificação que você deseja importar na janela seguinte e clique em .
- Para definir o armazenamento local deste projeto, insira (ou selecione) um diretório não vazio, aplique quaisquer alterações de configuração e clique em .
- Importe o projeto como um projeto geral na janela seguinte e clique em . Nomeie o projeto e clique em .
Procedimento 8.5. Importando um Repositório Local Git
- Inicie o Red Hat JBoss BRMS/BPM Suite Server (o que for aplicável) selecionando o servidor através da guia servidor e clique no ícone iniciar.
- No JBoss Developer Studio, selecione → e navegue até a pasta Git. Abra a pasta Git e selecione e clique em .
- Selecione a fonte do repositório como e clique em .
Figura 8.2. Detalhes do Repositório Git
- Selecione o repositório a ser configurado a partir da lista de repositórios disponíveis e clique em .
- Na caixa de diálogo que abrir, selecione o botão de opção do e clique em . Nomeie o projeto e clique em .
Figura 8.3. Assistente para a Importação de Projetos
Capítulo 9. Corrigindo e Atualizando o Red Hat JBoss BPM Suite
Copiar o linkLink copiado para a área de transferência!
9.1. Sobre as Correções e os Upgrades
Copiar o linkLink copiado para a área de transferência!
As correções ao Red Hat JBoss BPM Suite podem ser aplicadas como uma atualização assíncrona ou planejada:
- Atualizações assíncronas: correções individuais que são liberadas fora do ciclo normal de atualização do produto existente. Podem incluir correções de segurança, assim como outras correções individuais fornecidas pelo Serviço de Suporte Global Red Hat (GSS) para corrigir problemas específicos.
- Atualizações planejadas: correções cumulativas de um produto existente, incluindo todas as atualizações desenvolvidas previamente para essa versão do produto.
As correções aplicadas ao Red Hat JBoss BPM Suite podem ser baixadas através do link https://access.redhat.com/downloads/.
Os arquivos a seguir são incluídos como parte de um lançamento de correção do JBoss BRMS e JBoss BPM Suite.
- Clientes JBoss BRMS -
jboss-brms-<version>-patch.zip - Clientes JBoss BPM Suite -
jboss-bpmsuite-<version>-patch.zip - Atualizações do repositório do Maven (as mesmas para clientes JBoss BRMS e JBoss BPM Suite) -
jboss-brms-bpmsuite-<version>-incremental-maven-repository.zip
9.2. Aplicando correções ao Red Hat JBoss BPM Suite 6.2
Copiar o linkLink copiado para a área de transferência!
No Red Hat JBoss BPM Suite, a ferramenta de aplicação de correções do cliente é distribuída como um arquivo zip que inclui os scripts simples
.sh e .bat, permitindo a aplicação automática e fácil das atualizações de uma instalação do JBoss BPM Suite 6.1 (ou superior) existente.
Importante
A ferramenta de aplicação de correção deve ser usada com o JBoss BPM Suite 6.1 ou superior e não deve ser usada nas versões anteriores. Para mais informações, consulte https://access.redhat.com/articles/1455733.
O script necessita de dois parâmetros mandatórios:
<path-to-distribution-root> e <type-of-distribution>. Por exemplo, o comando a seguir aplica as atualizações ao pacote JBoss EAP especificado:
Nota
As atualizações de correção não devem ser aplicadas enquanto você estiver executando uma instância do Red Hat JBoss BPM Suite. Certifique-se de que o servidor esteja desligado antes de executar o comando a seguir.
./apply-updates.sh ~/EAP_HOME/jboss-eap-6.4 eap6.x
$ ./apply-updates.sh ~/EAP_HOME/jboss-eap-6.4 eap6.x
Os tipos de distribuição a seguir possuem suporte:
- eap6.x
- eap6.x-bc
- eap6.x-kie-server
- eap6.x-dashbuilder
- generic
- generic-bc
- generic-kie-server
- generic-dashuilder
- was8
- was8-bc
- was8-kie-server
- was8-dashbuilder
- wls12c
- wls12c-bc
- wls12c-kie-server
- wls12c-dashbuilder
- brms-engine
- planner-engine
- supplementary-tools
A ferramenta de migração e os guias de início rápido também estão incluídos na correção e estão disponíveis para download como um arquivo zip.
Nota
Somente as atualizações do BRMS/BPM Suite estão incluídas na distribuição de correção. As correções do próprio EAP devem ser aplicadas usando o mecanismo de aplicação de correção do EAP. Consulte Red Hat JBoss EAP Installation Guide.
Recurso de Backup
Antes de aplicar qualquer atualização, o script do cliente faz um backup da distribuíção especificada. Ele copia o arquivo de distribuição ou o diretório no subdiretório
backup/<current-timestamp>. O diretório de backup de nível superior é criado no mesmo nível do sistema de arquivos, como o script apply-updates.
Recurso da Lista Negra (em inglês, Blacklist)
A ferramenta de aplicação de correção do cliente fornece um recurso de lista negra, permitindo que você informe ao script os arquivos que não devem ser atualizados. Esse é um recurso muito útil que ajuda a preservar os seus arquivos configurados de serem substituídos automaticamente pelo processo de atualização. Mas, você pode especificar os arquivos não configurados também, caso necessário.
Para especificar os arquivos na lista negra, abra o arquivo
blacklist.txt dentro da distribuição de correção. Insira o caminho relativo para os arquivos que não devem ser atualizados. Cada arquivo deve ser especificado em sua própria linha.
Os arquivos especificados no arquivo
blacklist.txt que possuem conteúdos atualizados na correção, não são tocados pela ferramenta de atualização. Ao invés disto, a ferramenta copia o arquivo novo e atualizado no mesmo local e anexa o sufixo new, 'novo', a ele. Por exemplo, após executar a ferramenta de correção, ambos os arquivos existirão na pasta styles, continuando com o arquivo blacklist.txt no exemplo acima.
ls styles
$ ls styles
base.css base.css.new
Cabe a você comparar os conteúdos dos dois arquivos e mesclar as alterações.
Caso existam arquivos que não sejam distribuídos mais, mas você gostaria de mantê-los, você deve colocá-los também no arquivo
blacklist.txt. A ferramenta de atualização de correção não excluirá esses arquivos, ao contrário, criará um arquivo marcador vazio com o sufixo removed, 'removido'. Cabe a você também manter ou excluir esses arquivos manualmente.
Continuando com o exemplo anterior, se o arquivo
base.css foi removido e ele estava listado no arquivo blacklist.txt, então, após a ferramenta de correção ter sido executada, os conteúdos do diretório styles pareceriam com o seguinte:
ls styles
$ ls styles
base.css base.css.removed
9.3. Corrigindo Outros Aplicativos e Plataformas
Copiar o linkLink copiado para a área de transferência!
Os comandos a seguir podem ser usados para a atualização de outras plataformas com suporte e outros aplicativos comuns no Red Hat JBoss BPM Suite.
Correções no arquivo web (WAR) do Business Central no EAP 6.x
./apply-updates.[sh|bat] <some-path>/jboss-eap-6.4/standalone/deployments/business-central.war eap6.x-bc
$ ./apply-updates.[sh|bat] <some-path>/jboss-eap-6.4/standalone/deployments/business-central.war eap6.x-bcCorreções no arquivo web (WAR) do Servidor Genérico KIE
./apply-updates.[sh|bat] <some-path-to-tomcat-home>/webapps/kie-server.war generic-kie-server
$ ./apply-updates.[sh|bat] <some-path-to-tomcat-home>/webapps/kie-server.war generic-kie-serverCorreções no pacote WebLogic 12c
./apply-updates.[sh|bat] <path-to-unzipped-wls12c-bundle> wls12c
$ ./apply-updates.[sh|bat] <path-to-unzipped-wls12c-bundle> wls12cCorreções no pacote do mecanismo Planner
./apply-updates.[sh|bat] <path-to-unzipped-planner-bundle> planner-engine
$ ./apply-updates.[sh|bat] <path-to-unzipped-planner-bundle> planner-engineApêndice A. Histórico de Revisões
Copiar o linkLink copiado para a área de transferência!
| Histórico de Revisões | |||
|---|---|---|---|
| Revisão 6.2.0-2.1 | Mon Feb 15 2016 | ||
| |||
| Revisão 6.2.0-2 | Mon Nov 30 2015 | ||
| |||
| Revisão 6.2.0-1 | Mon Nov 20 2015 | ||
| |||
Nota Legal
Copiar o linkLink copiado para a área de transferência!
Copyright © 2015 Red Hat, Inc.
This document is licensed by Red Hat under the Creative Commons Attribution-ShareAlike 3.0 Unported License. If you distribute this document, or a modified version of it, you must provide attribution to Red Hat, Inc. and provide a link to the original. If the document is modified, all Red Hat trademarks must be removed.
Red Hat, as the licensor of this document, waives the right to enforce, and agrees not to assert, Section 4d of CC-BY-SA to the fullest extent permitted by applicable law.
Red Hat, Red Hat Enterprise Linux, the Shadowman logo, JBoss, OpenShift, Fedora, the Infinity logo, and RHCE are trademarks of Red Hat, Inc., registered in the United States and other countries.
Linux® is the registered trademark of Linus Torvalds in the United States and other countries.
Java® is a registered trademark of Oracle and/or its affiliates.
XFS® is a trademark of Silicon Graphics International Corp. or its subsidiaries in the United States and/or other countries.
MySQL® is a registered trademark of MySQL AB in the United States, the European Union and other countries.
Node.js® is an official trademark of Joyent. Red Hat Software Collections is not formally related to or endorsed by the official Joyent Node.js open source or commercial project.
The OpenStack® Word Mark and OpenStack logo are either registered trademarks/service marks or trademarks/service marks of the OpenStack Foundation, in the United States and other countries and are used with the OpenStack Foundation's permission. We are not affiliated with, endorsed or sponsored by the OpenStack Foundation, or the OpenStack community.
All other trademarks are the property of their respective owners.
'%20d='M201.5%20305.5c-13.8%200-24.9-11.1-24.9-24.6%200-13.8%2011.1-24.9%2024.9-24.9%2013.6%200%2024.6%2011.1%2024.6%2024.9%200%2013.6-11.1%2024.6-24.6%2024.6zM504%20256c0%20137-111%20248-248%20248S8%20393%208%20256%20119%208%20256%208s248%20111%20248%20248zm-132.3-41.2c-9.4%200-17.7%203.9-23.8%2010-22.4-15.5-52.6-25.5-86.1-26.6l17.4-78.3%2055.4%2012.5c0%2013.6%2011.1%2024.6%2024.6%2024.6%2013.8%200%2024.9-11.3%2024.9-24.9s-11.1-24.9-24.9-24.9c-9.7%200-18%205.8-22.1%2013.8l-61.2-13.6c-3-.8-6.1%201.4-6.9%204.4l-19.1%2086.4c-33.2%201.4-63.1%2011.3-85.5%2026.8-6.1-6.4-14.7-10.2-24.1-10.2-34.9%200-46.3%2046.9-14.4%2062.8-1.1%205-1.7%2010.2-1.7%2015.5%200%2052.6%2059.2%2095.2%20132%2095.2%2073.1%200%20132.3-42.6%20132.3-95.2%200-5.3-.6-10.8-1.9-15.8%2031.3-16%2019.8-62.5-14.9-62.5zM302.8%20331c-18.2%2018.2-76.1%2017.9-93.6%200-2.2-2.2-6.1-2.2-8.3%200-2.5%202.5-2.5%206.4%200%208.6%2022.8%2022.8%2087.3%2022.8%20110.2%200%202.5-2.2%202.5-6.1%200-8.6-2.2-2.2-6.1-2.2-8.3%200zm7.7-75c-13.6%200-24.6%2011.1-24.6%2024.9%200%2013.6%2011.1%2024.6%2024.6%2024.6%2013.8%200%2024.9-11.1%2024.9-24.6%200-13.8-11-24.9-24.9-24.9z'/%3e%3c/svg%3e){kind=small}