Baixe e instale o Engine nos servidores e PDVs da sua empresa. Para prosseguir com a instalação, preencha as informações abaixo. Se desejar apenas utilizar o sistema, acesse-o aqui
Instalando o Engine como cliente no Windows
No Windows, o Engine é um aplicativo com interface gráfica e possui um instalador integrado. Quando o download concluir, execute o instalador do Engine. Será solicitado o endereço do servidor do sistema e o nome da base de dados. Essas informações deverão ser fornecidas pelo administrador do sistema. Após confirmar essas informações, o Engine baixará automaticamente as suas dependências e criará um atalho para o sistema no menu Iniciar.
Para desinstalar o Engine, remova o diretório de instalação do sistema.
Instalando o Engine como serviço no Windows
Em servidores Windows, é recomendado que o Engine seja instalado como serviço, garantindo que ele seja iniciado automaticamente ao iniciar o servidor. Para instalar um Engine servidor como serviço, execute o comando abaixo em um Prompt de Comando com permissão de administrador.
engine64.exe /install -s -svc "SERVICE-NAME"
Em estações clientes ou em servidores de filiais, o serviço deve ser configurado informando o endereço do servidor e o nome da base de dados, conforme exemplo abaixo:
engine64.exe /install ENGINE-URL DB-NAME -svc "SERVICE-NAME"
Para desinstalar o Engine, execute o comando abaixo para remover o serviço e em seguida remova o diretório de instalação do sistema.
engine64.exe /uninstall -svc "SERVICE-NAME"
Quando o Engine é configurado como servidor, sem informar o endereço e a base de dados, a atualização de versão deve ser realizada manualmente por meio dos processos Atualização de Sistema ou Atualização de Engine. Quando configurado como cliente, a atualização do sistema ocorrerá automaticamente ao reiniciar o serviço ou ao reiniciar o servidor. Caso o servidor não seja reiniciado periodicamente, configure o serviço do Windows para ser reiniciado diariamente, possibilitando que o sistema possa ser atualizado automaticamente.
Observação: caso esteja utilizando a versão 32 bits do Engine, o nome do executável será engine32.exe.
Instalando o Engine como cliente no Linux
No Linux, o Engine não possui interface gráfica e deve ser disparado manualmente via linha de comando. Após o download do arquivo concluir, ele deve ser modificado para ser um executável e deve ser chamado informando o endereço do servidor e o nome da base de dados, conforme comandos abaixo:
mkdir INSTALL-DIR
cd INSTALL-DIR
wget SERVER-URL/dist/engine
chmod +x engine
./engine ENGINE-URL DB-NAME
O Engine automaticamente descarregará as dependências e o cache local, iniciando o atendimento da porta HTTP em seguida. Será escrito no console a URL que pode ser utilizada para acessar o sistema. Para encerrar o Engine, pode ser utilizada combinação de teclas "CTRL + C" no terminal ou o comando kill.
Para desinstalar o Engine, remova o diretório de instalação do sistema.
Importante: a versão Linux do Engine é experimental e somente pode ser utilizada em bases de dados de testes específicas que são compatíveis com a nova plataforma. Ela não pode ser utilizada em bases de dados que contenham dados de produção, nem mesmo nas bases de desenvolvimento e homologação. Essa restrição será eliminada no futuro, quando a versão Linux for considerada estável.
Instalando o Engine como serviço no Linux
Em servidores Linux, é recomendado que o Engine seja instalado como serviço via systemd, garantindo que ele seja iniciado automaticamente ao iniciar o servidor. Para instalar um Engine servidor como serviço, execute os comandos abaixo no terminal:
mkdir INSTALL-DIR
cd INSTALL-DIR
wget SERVER-URL/dist/linux-x86_64.zip -O temp.zip
unzip temp.zip
rm temp.zip
chmod +x engine
sudo ./engine install -s -svc SERVICE-NAME
sudo systemctl enable SERVICE-NAME
sudo systemctl start SERVICE-NAME
Por padrão, um serviço do systemd é executado com o usuário "root". Para informar um outro usuário, deve-se utilizar a opção "--serviceUser" na instalação do serviço. O nome do usuário precisa ser informado com aspas duplas caso contenha espaços. Exemplo:
sudo ./engine install -s -svc SERVICE-NAME --serviceUser="user name"
Em estações clientes ou em servidores de filiais, o serviço deve ser configurado informando o endereço do servidor e o nome da base de dados, conforme exemplo abaixo:
sudo ./engine install ENGINE-URL DB-NAME -svc SERVICE-NAME
Para desinstalar o Engine, execute os comandos abaixo para desinstalar o serviço e em seguida remova o diretório de instalação do sistema.
sudo systemctl stop SERVICE-NAME
sudo systemctl disable SERVICE-NAME
sudo ./engine uninstall -svc SERVICE-NAME
Quando o Engine é configurado como servidor, sem informar o endereço e a base de dados, a atualização de versão deve ser realizada manualmente por meio dos processos Atualização de Sistema ou Atualização de Engine. Quando configurado como cliente, a atualização do sistema ocorrerá automaticamente ao reiniciar o serviço ou ao reiniciar o servidor. Caso o servidor não seja reiniciado periodicamente, configure um script via cron para reiniciar o serviço diariamente, possibilitando que o sistema possa ser atualizado automaticamente.
Importante: a versão Linux do Engine é experimental e somente pode ser utilizada em bases de dados de testes específicas que são compatíveis com a nova plataforma. Ela não pode ser utilizada em bases de dados que contenham dados de produção, nem mesmo nas bases de desenvolvimento e homologação. Essa restrição será eliminada no futuro, quando a versão Linux for considerada estável.