acesse: tisasistemas.com.br, e faça download da api ... · acesse: virtualbox.org, e faça...

Acesse: tisasistemas.com.br, e faça download da API utilizando o link do Google Drive ou com um

programa de Torrent. A API possui 6,66 GB de tamanho, por isso, recomendamos o download via Torrent.

Será baixado um arquivo com nome ApiRest.ova, este será usado com o programa VirtualBox para montar uma máquina virtual (VM) que será o servidor do aplicativo.

Acesse: virtualbox.org, e faça download da versão disponível. Considerando que a configuração esta

sendo feita por um profissional de TI, não mostraremos passo a passo a instalação do VirtualBox dado a sua simplicidade.

Com o VirtualBox devidamente instalado, acesse: Arquivo -> Importar Appliance...

Selecione o arquivo ApiRest.ova

Com o arquivo ApiRest.ova selecionado, clique Próximo

Mantenha as configurações sugeridas e apenas clique Importar

Pronto! A máquina virtual já esta sendo importada. Aguarde!

Agora vamos iniciar a máquina virtual e configurá-la. Selecione-a e clique em Início Normal.

Observação: Após configurado a maquina virtual, é possível configurar a VM para iniciar junto com o sistema Operacional Windows como serviço pelo Agendador de Tarefas. Essa Configuração será

disponibilizado no final deste manual.

Entre com usuário e senha de login.

Usuário: rootSenha: admin@123

Não (Pular configuração de rede e ir para configuração de banco de dados)

Sim (Ir para configuração de rede)

Considerando que foi clicado em Sim na etapa anterior, vamos mostrar a configuração de rede da VM.

Entre com o ENDEREÇO IP conforme a rede de sua empresa. Neste exemplo vamos usar como referência a rede 192.168.1.0/24.

Nosso endereço IP para esta VM será: 192.168.1.200

Após digitado o endereço IP, pressione OK

Entre com a MASCARA DE REDE conforme a rede de sua empresa. Considerando a nossa rede 192.168.1.0/24.

Nossa mascara de rede será: 255.255.255.0

Após digitado mascara de rede, pressione OK

Para este exemplo o endereço IP do Gateway da nossa rede será: 192.168.1.1

Após digitado o Gateway, pressione OK

Neste passo, o servidor ira realizar um teste de conexão com a internet para validar as

configurações de rede.

Teste de ping em google.com - OK

Velocidade de Download/Upload - OK

Se no passo anterior o teste de conexão com a internet funcionou corretamente, pressione

Não para prosseguir.

Se no passo anterior o teste de conexão com

a internet falhou, pressione Sim para voltar

e configurar a rede corretamente.

Pressione Sim para iniciar a configuração

de conexão com o banco de dados Oracle.

Entre com o nome fantasia da empresa que será exibido no aplicativo.

Entre com o ENDEREÇO DE IP do servidor de banco de dados Oracle.Ex.: 192.50.0.10

Entre com a PORTA do servidor de banco de dados Oracle.

Porta padrão: 1521

Entre com o SERVICE NAME localizado no arquivo TNSNames.ora normalmente encontrado no seguinte diretório:

C:\oracle\product\10.2.0\client_1\network\ADMIN\TNSNames.ora

Entre com o nome de Usuário do banco de dados.Importante: Utilize mesmo usuário do sistema Winthor

Entre com a senha do banco de dados.

Esta API de Dados juntamente com o aplicativo Tisa D I R E T O R é configurado para gerenciar vários bancos de dados e todas as

filiais contidas nesses. Caso possua outro banco de dados, pressione SIM para configurar outro, senão, pressione NÃO para

finalizar a configuração.

O arquivo de banco de dados foi configurado, pressione OKpara prosseguir.

I M P O R T A N T E !Para que seu aplicativo consiga buscar dados na API de Dados é necessário criar uma regra NAT no seu servidor de

internet.

Redirecione tudo que chegar na porta 7777 no seu IP FIXO de internet para porta 80 no IP atribuído à maquina virtual.

***.***.***

I M P O R TA N T E !Caso sua empresa não possua um IP FIXO de internet, é fortemente recomendado que utilize um gerenciador de IP

Dinâmico para pleno funcionamento do aplicativo.Exemplo: https://ddns.winco.com.br/ ou https://www.noip.com/pt-BR

Ao pressionar OK na etapa anterior a VM será reiniciada para finalizar as configurações.

Com a máquina virtual configurada, vamos agora coloca-la para iniciar junto com o Sistema Operacional Windows em background.NOTA: O App funciona normalmente sem esse passo, mas automatizar é interessante em caso de desligamentos inesperados.

Aplicativo do VirtualBox responsável por iniciar a

VM

Nome da VM instalada no VirtualBox

1º - Crie uma pasta em C:/ com o nome vms2º - No diretório criado C:/vms, crie um arquivo com nome start.bat3º - No arquivo C:/vms/start.bat adicione o comando:

"C:\Program Files\Oracle\VirtualBox\VBoxManage.exe" startvm "ApiRest" default --type headless

No menu Iniciar do Windows busque por Agendador de Tarefas

Clique em Criar Tarefa

Na aba Geral preencha todas as informações conforme apresentado na figura abaixo. Após preenchido, confirme em OK.

Domínio/Usuário

Domínio/Usuário

Na aba Disparadores, clique em Novo e preencha todas as informações conforme apresentado na figura abaixo. Após preenchido, confirme em OK.

Na aba Ações, clique em Novo.

No botão n, navegue ate C:\vms\ e selecione o arquivo start.bat

Em Ação, selecione Iniciar um programa

Na aba Condições, preencha os dados abaixo e clique em OK.

Na aba Configurações, preencha os dados abaixo e clique em OK.

Finalizado! A VM já irá iniciar no modo background com o Windows.

TISA D I R E T O R

Baixe seu aplicativo na Google Play ou App Store

Acesse Configurações

128.***.***.***

192.168.1.200

T I S A S I S T E M A St i s a s i s t e m a s . c o m . b r

TISA D I R E T O R

Pronto! Agora é só desfrutar de seu App.