As configurações de ambiente definem as principais características dos ambientes de desenvolvimento, testes e execução (produção) do software. Tais configurações devem ser observadas (e atualizadas) sempre que uma nova versão do software for desenvolvida, para que este registro seja compatível com a última versão do software.
| Nome | Tipo | Versão | Descrição | Usado para |
|---|---|---|---|---|
| IB Express | Externo | — | Componentes de acesso à dados (recompilados internamente) | Acesso à banco de dados. |
| MX OutlookBar | Externo | 1.0.0 | Criação de barras de ferramentas. | Menu lateral do software. |
| SASTEC | Interno | 2.0.0 | Chave de ativação. | Restringir o acesso ao sistema apenas à clientes licenciados. |
| LockBox | Externo | 1.0.0 | Biblioteca de criptografia | Criptografar senhas de usuários. |
| Api do Geoserviços | Interno | 1.6.0 | API de integração com o Geoserviços | Acesso aos dados do Geoserviços |
| Api do Monnae | Interno | 1.15.0 | API de integração com Monnae | Acesso aos dados do Monnae. |
| TeeChart | Externo | 7.0.10 | Biblioteca de gráficos | Exibição de gráficos. |
| Indy | Externo | 10 | Componentes de comunicação cliente/servidor | Envio de e-mails |
Nenhum requisito adicional necessário.
Observação: O Ambiente de testes deve conter apenas os softwares definidos para o ambiente. A cada novo teste, o ambiente precisa ser “limpo” para que possa reproduzir com o máximo de fidelidade as configurações do ambiente de execução (produção).
A seguinte estrutura de diretórios deve ser criada no servidor:
| Diretório | Descrição |
|---|---|
| C:\Tecsystem | Diretório de instalação padrão. |
| C:\Tecsystem\Temp | Diretório de armazenamento de arquivos temporários. |
| C:\Tecsystem\Backup | Diretório de armazenamento de cópias de segurança dos arquivos de dados. |
| C:\Tecsystem\Tecsystem Geagro | Diretório de instalação do software. |
| C:\Tecsystem\Tecsystem Geagro\Dados | Diretório de armazenamento de arquivos de dados. |
A seguinte estrutura de diretórios deve ser criada na estação de trabalho (cliente):
| Diretório | Descrição |
|---|---|
| C:\Tecsystem | Diretório de instalação padrão. |
| C:\Tecsystem\Backup | Diretório de armazenamento de cópias de segurança dos arquivos de dados. |
| C:\Tecsystem\Tecsystem Geagro | Diretório de instalação do software. |
Caso exista na empresa um servidor de dados dedicado, apenas o banco de dados deve ser implantado no servidor. Neste caso, a localização dos arquivos no servidor deve seguir as normas estabelecidas pelo departamento de TI da empresa e o software deve ser implantado como uma estação de trabalho (cliente) nos demais computadores.
As estruturas de diretórios descritas acima são criadas automaticamente pelos respectivos programas de instalação.
Este software não implementa nenhum mecanismo de cópia de segurança dos dados, devendo esta ser realizada através de softwares de terceiros. Devem ser mantidas cópias de segurança dos seguintes arquivos e diretórios:
| Nome do arquivo/diretório | Descrição |
|---|---|
| Configuracao.ini | Arquivo de configuração do software. |
| Geagro.fdb | Banco de dados do software. |
A implantação de novas versões nos computadores dos clientes é parcialmente automatizada através dos programas de instalação, como descrito acima.
Tanto o executável, quanto os arquivos auxiliares e o banco de dados são instalados ou atualizados pelos instaladores.
Todo o processo descrito abaixo é válido somente para atualização nos servidores. Nas novas instalações e nas atualizações dos clientes, nenhuma alteração é feita no banco de dados.
O programa de instalação do servidor deve fazer um backup local do banco de dados antes da atualização. Caso o backup falhe, a atualização não é executada. Por padrão o backup é feito em <drive>:\Tecsystem\Backup indicando o número da versão antes da atualização.
Cada migração é um script SQL a ser executado no banco de dados.
A atualização é feita com a ajuda da ferramenta MyBatis Migrations. Ela é responsável por verificar o estado atual do banco de dados e executar os scripts pendentes.
Todos os scripts, arquivos de configuração e dependências estão localizados na pasta dat\migrations dentro do repositório de código. O seu conteúdo foi organizado da seguinte forma:
Esta estrutura de pastas, junto com o script de atualização em produção (abaixo) deve ser incluída no pacote de instalação do servidor.
O MyBatis permite a definição de múltiplos ambientes. Cada ambiente é definido por um arquivo de configuração indicando o caminho do banco de dados.
Convencionou-se usar um alias do Firebird para cada ambiente, quando for possível. Assim podemos conectar a vários bancos de dados sem a necessidade de atualizar constantemente os arquivos de configuração.
Além disso, foram criados alguns scripts para facilitar a migração em cada ambiente.
| Ambiente | Configuração do MyBatis | Alias / caminho | Script |
|---|---|---|---|
| Desenvolvimento/testes | development | geagro_dev | console.cmd |
| Banco de dados vazio | vazio | geagro_vazio | migrate-bd-vazio.cmd |
| Produção | producao-c ou producao-d | C:\Tecsystem\Tecsystem Geagro\Dados\Geagro.fdb ou D:\Tecsystem\Tecsystem Geagro\Dados\Geagro.fdb | migrate-producao.cmd |
A migração manual é feita pelo script console.cmd com os comandos:
O banco vazio deve ser atualizado durante o fechamento da versão para ser implantado em novas instalações. O script workspace\hooks\fechamento_da_versao.sql é executado automaticamente após a atualização para acertar o número da versão no banco vazio e deixá-lo pronto para a instalação, conforme a documentação em http://www.mybatis.org/migrations/hooks.html.
No ambiente de produção o script será executado pelo programa de instalação. O script procura o banco de dados nas unidades C: e D: e atualiza o primeiro encontrado. Como a migração é automatizada, o instalador gerará um arquivo de log para verificar se a atualização foi bem sucedida.
A versão do JayBird deve ser compatível a versão do OpenJDK.
Nenhuma.