Instalação Via Scripts

Para agilizar o processo de onboard, foram criados uma aplicação para realizar o download do binário e scripts para realizar a configuração automática do ambiente para o AutoTEF.

Script Windows

Junto ao pacote de instalação fornecido pelo seu BizDev (Account Manager), você encontrará um arquivo chamado InstallWindows.ps1. Esse script verificará se o runtime 6.0 já está instalado no seu ambiente. Caso não esteja, ele realizará a instalação automaticamente e, em seguida, executará a aplicação responsável por baixar os binários do Slim.

Para executar o script, basta abrir o Power Shell e rodar o comando abaixo:

.\InstallWindows.ps1 -StoneCode <Stone Code> -SerialNumber <Serial-do-Pinpad> -State 'RJ' -City 'Rio de janeiro' -DirectoryInstalation 'C:\AutoTEFSlim\'

Instalação Linux

O mesmo pacote, existe o script específico para o Linux InstallLinux.sh . Ao Abrir o bash, execute o comando inicial para permitir executar o script:

chmod -x ./InstallLinux.sh

Já o comando abaixo executa o script que fará a busca e a instalação do Slim em seu ambiente linux:

./InstallLinux.sh "<Stone Code>" "<Serial-do-Pinpad>" "RJ" "Rio de janeiro" "/home/root/AutoTEFSlim"

Executando diretamente o Instalador

Junto ao pacote, também possui um arquivo chamado AutoTEF.Setup.dll, ele pode ser executado diretamente para realizar a operação de instalação ou update da aplicação. É através dele que verificamos se existem novas versões em nossos servidores. Porém é preciso notar que o ASP.NET Core Runtime .NET 6 também é necessário para rodar essa aplicação.

Instalação

Abra uma tela de comando, vá até a pasta da aplicação e execute o comando abaixo:

dotnet AutoTEF.Setup.dll install --affiliationCode <Stone Code> --serialNumber <Serial-do-Pinpad> --state  'RJ' --city 'Rio de Janeiro'  --sourceDirectory 'C:\AutoTEFSlim\'

Update

Abra uma tela de comando, vá até a pasta da aplicação e execute o comando abaixo:

dotnet AutoTEF.Setup.dll update -a <Stone Code> -s <Serial-do-Pinpad> -S 'RJ' -C 'Rio de Janeiro' -v '4.2.2' -D "C:\AutoTEFSlim\" -P 99999

Help

dotnet AutoTEF.Setup.dll -h /ou --Help; -?

🚧
O instalador/script pode apresentar erros relacionados a permissões de acesso. Caso isso ocorra, verifique se os arquivos foram corretamente salvos na pasta indicada. Em seguida, execute o programa manualmente para confirmar se está funcionando corretamente.

Instalação Manual

Caso seja necessário realizar a instalação manual do binário, veja os detalhes abaixo:

Instalação Windows:

Para a instalação do AutoTEF Slim é preciso ter instalado o ASP.NET Core Runtime .NET 6, veja a versão da plataforma e faça a instalação seguindo a documentação da Microsoft. aqui

Copie os arquivos para uma pasta em sua escolha. Ex: C:\autotef\
Execute o arquivo .exe para levantar a aplicação.
```
C:\autotef\> AutoTEF.Service.exe
```

👍
Endereço local que tem que ser chamado.
http://localhost:8000/

📘
O pacote Slim já está compactado como serviço Windows, dessa forma o programa irá executar em segundo plano.

Reiniciando o windows e executando o Slim automaticamente:

1 - Vá na pasta do Slim e crie um atalho para o executável Auto TEF.Service.exe. Clique no executável com o botão direito Enviar para > Área de trabalho (criar atalho)).

2 - Use a combinação de teclas “Windows + R” e digite o comando “shell:startup” e clique no botão “OK”. Mantenha a janela que abrir, aberta.

3 - Copie o atalho que você criou na área de trabalho.

4 - Cole o atalho na pasta que foi aberta anteriormente chamada “Inicializar”.

5 - Reinicie o computador.

Instalação Linux:

Para a instalação do AutoTEF Slim é preciso ter instalado o ASP.NET Core Runtime .NET 6, veja a versão da plataforma e faça a instalação seguindo a documentação da Microsoft. aqui

📘
Instalando na distribuição Ubuntu 20.04

Copie os arquivos para uma pasta em sua escolha na plataforma linux. ex: cd /home/user/autotef;
Utilize o runtime para executar a aplicação
```
$ dotnet AutoTEF.Service.dll
```
Garanta que o AutoTEF Slim tenha acesso a porta do Pinpad, se o AutoTEF Slim não reconhecer automaticamente a porta, utilize o comando abaixo.
```
$ sudo chmod  a+rw /dev/ttyACM0
```

📘
Instalando na distribuição Ubuntu 22.04

Copie os arquivos para uma pasta em sua escolha na plataforma linux. Ex: cd /home/user/autotef;
Comando para Configuração de segurança Open SSl do Slim na distribuição 22.04:
```
$ sudo gedit /etc/ssl/openssl.cnf
```
Após abertura de nova janela, colocar na última a linha o seguinte comando;
```
Options = UnsafeLegacyRenegotiation
```
Utilize o runtime para executar a aplicação;
```
$ dotnet AutoTEF.Service.dll
```
Garanta que o AutoTEF Slim tenha acesso a porta do Pinpad, se o AutoTEF Slim não reconhecer automaticamente a porta, utilize o comando abaixo.
```
$ sudo chmod  a+rw /dev/ttyACM0
```

Criação de Worker (Opcional)

A criação de um worker permitirá que o projeto inicie como um serviço.

Execute o comando para criar o arquivo de serviço;
```
$ sudo nano /etc/systemd/system/kestrel-autotef.service
```
Copie o código abaixo, alterando o que for pertinente ao seu ambiente;

[unit]
Description=Aplicação AutoTEF Service Slim

[Service]
WorkingDirectory=/home/myuser/autotef
ExecStart=.\AutoTEF.Service
Restart=always
SyslogIdentifier=autotef-ident
User=root
Enviroment=ASPNETCORE_ENVIROMENT=Production

[Install]
WantedBy=multi-user.target

Execute os comandos para habilitar e iniciar o serviço.

🚧
Não deixe de consultar a página Configurações Iniciais para entender em qual ambiente sua aplicação está pré-configurada para rodar.