Processo de atualização

A versão 2 da do sistem Badiu GC2 traz um conjunto de atualizações em relação à versão 1, e o processo de atualização precisa não só da substituição de arquivos, como também da atualização dos servidores.

O sistema Badiu GC2 foi implementado na plataforma Badiu.Net. Na versão 2, ele passou a utilizar o servidor PHP na versão 8.0.2 ou superior, e o banco de dados MySQL seria recomendado a versão 8. Esses são os requisitos técnicos para o processo de atualização.

No processo de atualização, há basicamente duas alternativas. A primeira é criar novas instâncias na versão mais recente, importar as configurações do sistema e do PHP, e depois restaurar o banco de dados. A outra alternativa seria atualizar diretamente o banco e o servidor existente. Nós recomendamos a primeira alternativa, ou seja, criar servidores separados na nova versão, importar as configurações e restaurar o banco de dados.

Para efetuar a atualização , siga os seguintes passos a seguir. 

1 - Baixar código do sistema

Faça download do Badiu.Net no git  https://bitbucket.org/equipei/badiunet-gc2/src/main/

Descompacte o arquivo que fez download.  Feito isso, deve encontrar a seguinte estrutura de pasta

         Essa estrutura são os arquivos do Badiu.Net

2 - Instalar no ambiente web

No que tange ao servidor web, caso você tenha adotado a primeira alternativa, que envolve instalar um servidor web na versão mais recente, o procedimento é o seguinte: faça o download da aplicação e coloque-a no novo servidor web. As configurações que antes ficavam no arquivo BADIUNET_DIR_INSTALL/app/config/parameters.yml devem ser migradas para o novo local de instalação, que agora utiliza um arquivo .env. Para isso, renomeie o arquivo.env.dist que fica evm BADIUNET_DIR_INSTALL para .env e ajuste as configurações antigas para esse novo formato, especialmente o valor da variável  badiu.system.file.defaultpath deve ser definido na variável BADIUNET_FILE_DEFAULT_PATH do arquivo .env

Caso você tenha atualizado o servidor onde os arquivos atuais já estão rodando, exclua todo o conteúdo dentro do diretório BADIUNET_DIR_INSTALL mantendo apenas a cópia das configurações do arquivo app/config/parameters.yml, que deve ser levada para o .env. Também defina o valor da variável badiu.system.file.defaultpath em BADIUNET_FILE_DEFAULT_PATH do arquivo .env. Além disso, a pasta de uploads não deve ser excluída, ela deve ser movida para uma pasta específica e preservada, independentemente da alternativa escolhida. Trata--se do endereço definido em badiu.system.file.defaultpath. 

Coloque os arquivos da aplicação no ambiente do servidor web. O conteúdo da pasta public deve ficar na raiz da aplicação web. As demais, devem ficar fora da raiz da web;
Em uma instalação para ambiente de desenvolvimento / homologação, você pode colocar toda aplicação na raiz da web. Não faça isso em ambiente de produção.

Se a pasta onde fica a aplicação web for /var/www/html, crie uma pasta badiunet nesse endereço.  Coloque todos os arquivos da aplicação na pasta badiunet. Deste modo, no diretório /var/www/html/badiunet ficará a lista dos arquivos da aplicação.

 O endereço onde fica a aplicação é referenciado pela expressão BADIUNET_DIR_INSTALL. No exemplo abordado aqui para demonstração de instalação fica em /var/www/html/badiunet

Em ambiente de produção, a pasta public deve estar na raiz do servidor web e visível na web. No exemplo, configure o caminho para /var/www/html/badiunet/public, garantindo que esse diretório seja acessível publicamente.

3 - Configuração do banco de dados

Para efetuar a configuração do banco de dados, é necessário abrir o arquivo .env, que fica na raiz da instalação em BADIUNET_DIR_INSTALL. Neste arquivo, localize a variável DATABASE_URL e, nela, faça a configuração das credenciais de acesso ao banco de dados, como a porta, o usuário, a senha, o nome do banco e também o host do banco de dados. Tudo as variavés de configuração referenciado precisam ser substituidas pelos valores correspondentes.

Como se trata de uma nova instalação, antes de realizar a configuração, será necessário instalar o servidor de banco de dados, ou usar uma já existente,  e criar uma instância de banco de dados. Essa instância deve ser devidamente configurada. Assim, ao iniciar a instalação do sistema, as tabelas necessárias serão automaticamente criadas, e as configurações iniciais serão inseridas nessas tabelas.

4 - Permissão dos arquivos

As permissões de arquivo consistem em atribuir privilégio de escrita na pasta de dados referente aos arquivos de upload do sistema e cache. Para isso, clique aqui e veja como configurar.

5 - Executar Instalação de Biblitecas

A instalação deve ser efetivada via comandos do Composer e do Symfony. Para isso, acesse um terminal shell em ambiente Linux, ou um terminal DOS em ambiente Windows, e navegue até a pasta raiz da instalação da aplicação, que fica no endereço BADIUNET_DIR_INSTALL. Caso o Composer não esteja instalado, será necessário efetuar sua instalação e configuração antes de prosseguir. Depois disso, execute os comandos a seguir.

composer install
composer dump-autoload
php bin/console cache:clear
php bin/console doctrine:schema:update --force
php bin/console badiu:install

Ao executar os comandos, deve aparecer no console o resultado de acompanhamento. O primeiro comando, composer install, faz a instalação de todas as dependências do Symfony e das bibliotecas PHP do projeto, gerando a pasta do Composer. O segundo comando, composer dump-autoload, ajusta a configuração da aplicação do Symfony em todos os modulos. O terceiro comando php bin/console cache:clear efetua a limpeza de cache. O quarto comando php bin/console doctrine:schema:update --force cria as tabelas no banco de dados configurado no arquivo .env. E, por fim, o último comando php bin/console badiu:install efetua a instalação da aplicação no banco de dados, criando caches e a estrutura de arquivos necessários.

6 - Acessar aplicação pelo URL 

Acesse o Badiu.Net  no URL que aponta para o servidor web. Se a pasta da raiz da web for  /var/www/html seguindo o exemplo apresentado, a aplicação deve ser acessado no endereço  http://enderecodoservidor/badiunet/public/index.php Se o raiz da web  for  /var/www/html/badiunet/public, a aplicação deve ser acessado no endereço  http://enderecodoservidor/index.php. Esse endereço é representado pela expressão BADIUNET_URL Para a aplicação diretamente do domínio sem invocar o arquivo index.php, é necessário efetuar a configuração do proxy no domínio virtual. 

Ao colocar o endereço BADIUNET_URL que acesse o sistema instalado, deve ser exibido a tela inicial da de instalação.

A tela  do termo de aceite exibe o termo de licença de uso GNU. Ao aceitar o termo, clique no botão continuar para iniciar a instalação. Se tudo der certo, deve levar alguns minutos processando.  Ao terminar a execução, será exibida a tela inicial do sistema Badiu.Net.