====== Instalação ======
===== Instalação com o "Assistente de Instalação" =====
1 - Execute o arquivo "Setup.exe" referente ao WebService.
{{ :ws:diretorio_instalador.jpg?nolink |}}
2 - O "Assistente de Instalação" será aberto, clique no botão "Avançar >".
{{ :ws:instalador_welcome.jpg?nolink |}}
3 - Na tela de configuração do banco de dados, deverão ser informados a porta de comunicação do web service, o caminho ou alias do banco bem como seu usuário e senha. Logo abaixo, o usuário deverá informar o IP do servidor que possui a base de dados. Se o Web Service for instalado no próprio servidor, o usuário deverá marcar a opção "Servidor Local".
{{ :ws:instalador_bd.jpg?nolink |}}
Não use uma Porta que já esteja sendo utilizada por outro serviço ou programa!
Será iniciado um teste de conexão com o banco de dados. Se ocorrer algum erro referente a conexão será exibido a seguinte mensagem:
{{ :ws:instalador_bd_erro_sql.jpg?nolink |}}
Se a conexão com o banco de dados estiver correta, o instalador irá realizar uma verificação para saber se a aplicação está liberada para o cliente. Se
a liberação estiver correta, será exibida a seguinte mensagem:
{{ :ws:instalador_bd_liberacao_sucesso.jpg?nolink |}}
Caso ocorra algum erro no processo de liberação será exibida a seguinte mensagem:
{{ :ws:instalador_bd_liberacao_erro.jpg?nolink |}}
4 - Na tela de [[instalacao_web_service#configurar_e-mail|Configuração do e-mail]], o usuário deverá preencher com as informações do servidor de SMTP e clicar no botão "Avançar".
{{ :ws:instalador_email.jpg?nolink |}}
Algumas aplicações não possuem a funcionalidade do envio de e-mail, assim seu instalador não irá exibir esta tela.
5 - Na tela de "Endereço da API" o usuário deverá preencher a URL da API.
{{ :ws:instalador_api.jpg?nolink |}}
6 - Nesta tela o usuário deverá escolher um caminho para instalação do WebService.
{{ :ws:instalador_pasta.jpg?nolink |}}
7 - Nesta tela é exibido o local de destino do WebService. Se estiver tudo certo clique em "instalar".
{{ :ws:instalador_instalar.jpg?nolink |}}
8 - No final do processo o "Assistente de Instalação" irá realizar a instalação do serviço.
{{ :ws:instalador_servico_sucess.jpg?nolink |}}
Se a Porta de comunicação do WebService já esteja sendo utilizada por um outro serviço ou programa, o serviço será instalado, porém não será possível iniciá-lo. O usuário deverá reinstalar o WebService, mas definindo uma Porta que não esteja sendo usada.
{{ :ws:instalador_port_used.jpg?nolink |}}
9 - Clique em "Concluir" para encerrar o "Assistente de Instalação".
{{ :ws:instalador_concluir.jpg?nolink |}}
===== Instalação sem o "Assistente de Instalação" =====
1 - Navegue até o diretório raiz da instalação do Intellicash.
{{ ::ws:diretorio-raiz.jpg?nolink |}}
2 - Crie um novo diretório com o nome do serviço.
{{ ::ws:diretorio-servico.jpg?nolink |}}
3 - Copie o executavél do serviço e a DLL "dbxfb" para o novo diretório.
{{ ::ws:copia-arquivos.jpg?nolink |}}
4 - Abra o prompt de comando e digite o comando "C:\caminho do executavel /install"
{{ ::ws:instalar-servico.jpg?nolink |}}
5 - Será exibida uma mensagem confirmando que o serviço foi instalado com sucesso.
{{ ::ws:sucesso-instalar-servico.jpg?nolink |}}
6 - Localize o serviço instalado e o inicie.
{{ ::ws:iniciar-servico.jpg?nolink |}}
7 - Após iniciar o serviço, será criado um arquivo com a extensão ".ini" com o mesmo nome do executável. Este arquivo apresenta a seguinte estrutura:
| Campo |
Descrição |
Valor |
| Port |
Porta para acesso ao serviço (Qualquer porta pode ser utilizada, desde que não esteja sendo utilizada por outros serviços. ). |
8086(Intelligroup), 8085 (Cotação) |
| Path |
Caminho do arquivo de banco de dados. |
Padrão (INTELLISTORE3) |
| Pwd |
Senha do banco de dados. |
Padrão (masterkey) |
| UserName |
Usuário do banco de dados. |
Padrão (SYSDBA) |
| ServerIP |
Endereço do Servidor do Cliente |
IP do Servidor |
====== Testes ======
===Ping===
Para saber se o servidor do cliente está online se utiliza o comando ping. Abra o Prompt de Comando e digite ping, o endereço do servidor do cliente e pressione enter.
{{ :ws:ping-02.jpg?nolink |}}
Será enviados pequenos pacotes de dados ao servidor. Repare que é exibido o tamanho do pacote e o tempo que demorou para obter resposta do servidor.
{{ :ws:ping-03.jpg?nolink |}}
Na Estatísticas do Ping. É informado quantos pacotes foram enviados, quantos pacotes recebidos e quantos foram perdidos, depois é demonstrado quanto houve de perda em porcentagem.
{{ :ws:ping-04.jpg?nolink |}}
Neste exemplo podemos concluir que este servidor está online. Houve resposta do servidor dos pacotes enviados e na Estatíscas do Ping houve 0% de perda.
Neste outro caso a estatísticas do Ping retornou que também houve 0% de perda, mas perceba que no envio de pacotes foi retornado: Host de destino inacessível. Isto significa que o servidor **NÃO** está online.
{{ :ws:ping-01.jpg?nolink |}}
Neste caso não foi obtido Resposta e na Estatíscas do Ping houve 100% perda. Logo este servidor **NÃO** está online.
{{ :ws:ping-05.jpg?nolink |}}
===Telnet===
Abra o prompt de comando e digite: telnet endereço do servidor e porta.
{{ :ws:telnet-01.jpg?nolink |}}
Se for exibido uma tela vazia e com o endereço do servidor no titulo da janela significa que o serviço está funcionando.
{{ :ws:telnet-02.jpg?nolink |}}
Caso o Telnet não consiga conectar na porta será exibido a informação que não possivel abrir conexão com o Host.
{{ :ws:telnet-03.jpg?nolink |}}
===Acesso ao Serviço através do browser===
Abra seu navegador de preferência e digite: endereço do servidor, dois pontos e a porta.
{{ :ws:browser-01.jpg?nolink |}}
Se o serviço estiver certo será exibido uma página em branco e no título da aba será o endereço do servidor e a porta.
{{ :ws:browser-03.jpg?nolink |}}
Se não for possível realizar a conexão será exibido falha ao carregamento da página.
{{ :ws:browser-02.jpg?nolink |}}
ou
{{ :ws:browser-04.jpg?nolink |}}
====== Portas ======
| Aplicação |
Porta Padrão |
| Cotação Online |
8087 |
| Ecomerce |
8089 |
| IntelliGroup |
8086 |
| Liberação |
8085 |
| Venda Assistida |
8088 |
====== Configurar E-mail ======
Na instalação do serviço do **Cotação Online** é pedido as configurações de e-mail. O e-mail configurado irá enviar notificações para os usuários cadastrados e também para o estabelecimento que foi instalado o serviço do **Cotação Online**. Não há necessidade de acessár o e-mail de configuração do serviço, pois sua única função é disparar notificações.
No Intellicash configure o e-mail padrão da empresa para um e-mail de uso do estabelecimento para receber as notificações.
É recomendado que crie um e-mail (Gmail da Google) específico para o **Cotação Online**. O padrão do E-mail é: __cotacao.(número do CNPJ do Estabelecimento)@gmail.com__ e a senha sendo o CNPJ do Estabelecimento.
Exemplo: cotacao.01234567890123@gmail.com
| Configuração |
Valor |
| Porta |
465 |
| Host |
smtp.gmail.com |
| Nome |
Supermecado X |
| Usuário |
cotacao.(número do CNPJ do Estabelecimento)@gmail.com |
| Senha |
CNPJ do Estabelecimento *A senha deve estar na base64 |
| Exige autenticação |
Sim |
No arquivo .ini ficará assim:
[Mail]
Port=465
Host=smtp.gmail.com
Name=Supermercado X
UserName=cotacao.(número do CNPJ do Estabelecimento)@gmail.com
Pwd=**********
Auth=1
É necessário a ativar o acesso das aplicações no Gmail.
====== Ativar acesso no E-mail do Gmail ======
Após criar o E-mail no Gmail é necessário ativar o acesso de aplicações na configuração de Conta da Google.
Abra o e-mail criado e clique no botão {{:ws:config-email-bota-menu.jpg?nolink|}} e depois clique em **Conta**, conforme demonstra a figura abaixo.
{{ :ws:config-email-menu-configuracao.jpg?nolink |}}
Clique em **Segurança**, conforme demonstra a figura abaixo.
{{ :ws:config-email-configuracao-seguranca.jpg?nolink |}}
Localize **Acesso a app menos seguro** e depois clique em **Ativar acesso (não recomendado)**, conforme demonstra a figura abaixo.
{{ :ws:config-email-configuracao-permitir-acesso.jpg?nolink |}}
Clique no botão {{:ws:config-email-bota-ativar.jpg?nolink|}} para perimitir o acesso, conforme demonstra a figura abaixo.
{{ :ws:config-email-configuracao-ativar-acesso.jpg?nolink |}}
Feche as configurações do e-mail.
{{ :ws:config-email-configuracao-acesso-ativado.jpg?nolink |}}