EAPn - Escritório de Automação de Processos de Negócio:Montar um Servidor em Máquina Local

Montar um servidor em máquina local com a estrutura do servidor de testes para fins de testes de backup do servidor.

Instalação do Java (OpenJDK 11)

1. Abra o terminal e execute:

   $ sudo apt update

   Enter password: <senha do usuário root da máquina>

   $ sudo apt-get install -y openjdk-11-jdk unzip

2. Verifique a versão do Java

   $ java -version

Instalar e Configurar o MySQL Server

1. Abrir o terminal
2. Iniciar a instalação do pacote mysql server:

   $ sudo apt-get install mysql-server

   Enter password: <senha do usuário root da máquina>

3. No processo de instalação será solicitada uma senha para o usuário root do mysql, é necessário digitar a senha 2 vezes
4. Para testar se o mysql está funcionando digite o comando:

   $ mysql -u root -p

   Enter password: <senha do usuário root do mysql (definida no passo 3)>

5. Caso funcione o terminal do mysql abrirá

Terminal SQL iniciado com sucesso em máquina local

Criando o banco de dados do bonita e usuário para manipular a base

1. Acessar o mysql com o usuário root:

   $ mysql -u root -p

   Enter password: <senha do usuário root do mysql>

2. Criar o usuário:

   mysql> CREATE USER ‘<nome do usuário>’@’localhost’ IDENTIFIED BY ‘<definir senha para o usuário>’;

3. Criar as base de dados (precisamos de 2 bases para configuração do bonita);

   mysql> CREATE DATABASE <nome base de dados 1>;

   mysql> CREATE DATABASE <nome base de dados 2>;

4. Conceder privilégios de manipulação das bases de dados ao usuário:

   mysql> GRANT ALL PRIVILEGES ON <nome base de dados 1>.* TO ‘<nome do usuário>’@’localhost’;

   mysql> GRANT ALL PRIVILEGES ON <nome base de dados 2>.* TO ‘<nome do usuário>’@’localhost’;

Instalação do Pacote BonitaCommunity-2022.2-Tomcat-9.0.65.zip

1. Abra o terminal e execute o seguinte comando:

   $wget https://github.com/bonitasoft/bonita-platform-releases/releases/download/2022.2-u0/BonitaCommunity-2022.2-u0.zip

2. Extrair o servidor para a pasta "/opt/" (usar "sudo" por se tratar de uma pasta do sistema)

   $sudo unzip BonitaCommunity-2022.2-u0.zip -d /opt/

   Enter password: <senha do usuário root da máquina>

3. Dar permissão para o usuário controlar a pasta nova

   $sudo chown -R $USER:$USER /opt/BonitaCommunity-2022.2-u0/

   Enter password: <senha do usuário root da máquina>

Configuração do Banco de Dados

1. Alterar o arquivo de banco de dados database.properties:

   $cd /opt/BonitaCommunity-2022.2*/setup

   $nano database.properties

2. Ajuste as propriedades do banco de dados:

< %%%%%%%%%%%%%%%%%%% CÓDIGO %%%%%%%%%%%%%%%%%%%%%

#########################################
# Bonita database properties
#########################################

# valid values are (h2, postgres, sqlserver, oracle, mysql)
db.vendor=mysql
# when using h2, no server or port setting is needed since connexion is made using file protocol mode using relative directory:
db.server.name=127.0.0.1
db.server.port=3306
# if your database name contains a backslash (\) character, you must double it (\\):
db.database.name=<nome base de dados 1>
db.user=<nome do usuário do mysql>
# if your database password contains a backslash (\) character, you must double it (\\):
db.password=<senha do usuário do mysql>

###################################
# Business Data database properties
###################################
# valid values are (h2, postgres, sqlserver, oracle, mysql)
bdm.db.vendor=mysql
bdm.db.server.name=127.0.0.1
bdm.db.server.port=3306
bdm.db.database.name=<nome base de dados 2>
bdm.db.user=<nome do usuário do mysql>
bdm.db.password=<senha do usuário do mysql>


# IMPORTANT NOTE regarding H2 database:
# in case you move whole setup folder to another directory, you must change property below
# to point to original folder containing h2 database folder
# new value can be relative or absolute since it still points to the right folder
# WARNING for Windows users: keep forward slashes like below (instead of backslashes):
#h2.database.dir=../h2_database (comentar esta linha adicionando o # no início) 

%%%%%%%%%%%%%%%%%%% CÓDIGO %%%%%%%%%%%%%%%%%%%% >

Salve e feche o arquivo (Ctrl + O para salvar, Enter para confirmar, Ctrl + X para sair).

1. Volte para a pasta raiz do servidor e inicie o script para testar o servidor:

   $cd /opt/BonitaCommunity-2022.2-u0/

   $bash start-bonita.sh

Inicializar a Plataforma no Banco de dados

1. No mesmo diretório de `setup`, execute a inicialização para criar as tabelas no MySQL:

   $./setup.sh init

Automação do Servidor via systemd

1. Criar o arquivo de serviço

   $sudo nano /etc/systemd/system/bonita.service

2. Irá abrir um terminal vazio, insira o texto abaixo:

[Unit]
Description=Servidor Bonita BPM
After=network.target mysql.service

[Service]
Type=forking
User=SEU_USUARIO
Group=SEU_GRUPO
Environment="CATALINA_PID=/opt/BonitaCommunity-2022.2-u0/server/catalina.pid"
ExecStart=/bin/bash /opt/BonitaCommunity-2022.2-u0/start-bonita.sh
ExecStop=/bin/bash /opt/BonitaCommunity-2022.2-u0/stop-bonita.sh
Restart=on-failure

[Install]
WantedBy=multi-user.target

Salve e feche o arquivo.

Habilitar e Iniciar o Serviço

1. Recarregue o daemon(processo rodando em segundo plano) do systemd, inicie o Bonita e ative o boot automático:

   $sudo systemctl daemon-reload

   Enter password: <senha do usuário root da máquina>

   $sudo systemctl start bonita

   $sudo systemctl enable bonita

1. A partir deste momento, o servidor já estará rodando. Sua ativação será automática, sempre que o computador ligar, salvo comando para desativar o servidor

Primeiro Acesso e Configuração do Servidor

1. Abra o navegador e acesse "http://localhost:8080/bonita"
2. Realize o primeiro login como Super Admin:
   1. Usuário: install
   2. Senha: install
3. Crie um usuário padrão em "Organization->Users->Create;" adicione login e senha.
4. Atribua privilégios de administrador ao usuário recém criado
   1. "Organization->Profiles->Administrator->User mapping-> +Add a user"; adicione o usuário recém criado.

Esse usuário criado será o responsável por gerenciar processos e deploys.

Comandos Úteis ao Administrador

Verificar se o servidor está rodando:

$sudo systemctl status bonita

Parar o servidor (obrigatório antes de backups manuais):

$sudo systemctl stop bonita

Reiniciar o servidor:

$sudo systemctl restart bonita