Instalação do Anvaigo OnPrem (Tipo B e C)
Existem diferentes variantes da instalação do Anvaigo Mobile App: Como variante gerida com o Anvaigo Mobile App Cloud Service e como variante auto-gerida com o Anvaigo Server. Para obter uma síntese das variantes disponíveis, consultar os requisitos do sistema. Este guia de instalação descreve o Anvaigo Tipo B e C: auto-gerido.
Quando é que devo utilizar a gestão ou a autogestão?
A variante gerida é a opção significativamente mais rápida e simples. A Anvaigo fornece o App Service e o Delta Service como uma solução SaaS. Se não pretender executar o seu próprio servidor Anvaigo, seleccione a variante de instalação Anvaigo Tipo A (gerida).
O Anvaigo Server fornece o Anvaigo App Service, bem como o Delta Service (para instalações do Anvaigo B). Tanto o Anvaigo Server como a base de dados PostgreSQL têm capacidade para múltiplas instâncias, o que lhes permite serem utilizados para múltiplos sistemas, tais como ambientes de produção e sandbox.
O Anvaigo App Service é a ligação entre a Anvaigo Mobile App instalada em dispositivos móveis e o Microsoft Dynamics System. É utilizado para autenticação e segurança e pode ser instalado à frente de uma firewall para proteger o seu sistema.
O Anvaigo Server é necessário para as variantes de infraestrutura Anvaigo B e C. Pode instalá-lo facilmente utilizando uma configuração. Em alternativa, o Anvaigo Mobile App Cloud Service pode ser utilizado para instalar o Anvaigo Server. Mais informações sobre o Anvaigo Mobile App Cloud Service podem ser encontradas aqui.
A Variante B da Infraestrutura Anvaigo também requer a instalação de uma base de dados PostgreSQL. A base de dados PostgreSQL fornece o Anvaigo Delta Server, que é obrigatório para o Anvaigo Delta Service. Esta instalação é descrita a seguir. Na Variante C da Infraestrutura Anvaigo, o Delta Server é instalado diretamente no banco de dados SQL onde reside o banco de dados Microsoft Dynamics. Por conseguinte, o serviço Delta não é necessário para esta variante de instalação.
Instalar o servidor Anvaigo
Instale o Anvaigo Server executando o ficheiro“Anvaigo Server Setup.exe“. Seleccione o idioma e o diretório de destino.
Em seguida, ser-lhe-á pedido que seleccione uma porta e uma palavra-passe. A palavra-passe será necessária mais tarde para a configuração no Microsoft Dynamics. Por razões de segurança, só deve ser conhecido pelo administrador.
Devido à transferência encriptada de dados entre o servidor Anvaigo e o cliente da aplicação móvel Anvaigo, recomendamos a utilização de um certificado SSL. Para mais informações sobre a utilização de um certificado, consulte a nossa Knowledge Base aqui. Para ambientes de teste, pode deixar este campo em branco e será criado um certificado auto-assinado
Onde posso encontrar a impressão digital do meu certificado SSL?
Pode encontrar a impressão digital do seu certificado SSL da seguinte forma:
Introduza “Certificados” ou “certlm.msc” na pesquisa do Windows. Aparecerá a seguinte janela:
No separador “Detalhes”, encontrará a impressão digital:
Depois de introduzir a “impressão digital”, pode verificar as suas definições e iniciar a instalação.
Nota: Ao copiar e colar a partir deste campo, são incluídos caracteres especiais invisíveis no início ou no fim, consoante a versão do Windows. Estes devem ser eliminados por supressão.
Após a conclusão da instalação, é possível verificar se o Anvaigo Server foi iniciado com êxito.
Em caso de erro, verifique as mensagens de erro. As causas possíveis podem ser uma impressão digital incorrecta do certificado SSL ou uma porta TCP já atribuída.
Instalação da base de dados PostgreSQL
Para utilizar o Anvaigo Server dentro da instalação do Anvaigo B, é necessário o banco de dados PostgreSQL. Pode descarregá-lo a partir desta ligação.
Note-se que para o Anvaigo Varainte C a base de dados PostgresSQL não é necessária e esta secção pode ser ignorada. Continuar com a “Configuração da Firewall do Windows”.
Para ambientes de teste, recomendamos a instalação da base de dados PostgreSQL no mesmo servidor que o Anvaigo Server.
Para sistemas activos, recomendamos a utilização de servidores separados. Isso permite que o servidor Anvaigo seja localizado como um servidor frontent na DMZ, enquanto o PostgreSQL é instalado em um ambiente seguro. Ao instalar em um servidor diferente, configurações adicionais de segurança devem ser feitas no PostgreSQL, que não estão documentadas aqui. Para informações mais pormenorizadas, consultar esta ligação.
No primeiro passo, seleccione o local de instalação.
Instalar os componentes seleccionados por predefinição. O Stack Builder não é necessário. Assim, pode removê-lo dos componentes a instalar.
No passo seguinte, pode alterar o diretório de destino da base de dados.
Defina a palavra-passe para a base de dados. Esta palavra-passe deve ser muito diferente da do servidor Anvaigo e também conhecida apenas pelo administrador.
O próximo passo é definir a porta para a base de dados PostgreSQL. Se possível, a porta padrão (5432) do PostgreSql deve ser usada. No entanto, se necessário, pode alterá-lo.
Pode personalizar a língua/localização no passo seguinte. Recomendamos que mantenha a predefinição.
Antes de iniciar a instalação, pode ainda verificar todas as entradas.
Finalmente, a instalação é iniciada:
Configuração da Firewall do Windows
A comunicação entre o Anvaigo Server, o Anvaigo Mobile App e o Dynamics requer a configuração das portas apropriadas no Firewall do Windows.
Comunicação do Anvaigo Server com Microsoft Dynamics
O Anvaigo Server comunica com o Microsoft Dynamics Web Service através da porta de configuração do Anvaigo Server. Esta é a porta 8888 por defeito, mas pode ser definida de forma diferente ao instalar o Anvaigo Server. Esta porta só precisa de ser aberta para comunicação com o Microsoft Dynamics Web Services. Não é recomendável definir esta porta como Pública.
Abrir a Firewall do Windows.
Especificar o tipo.
A porta é especificada no passo seguinte.
O passo seguinte é especificar a direção.
E, nesse caso, a regra da firewall deve entrar em vigor.
Finalmente, a nova regra de firewall precisa de um nome significativo.
Comunicação do Anvaigo Server com o Anvaigo Mobile App
A comunicação do Anvaigo Server com o Anvaigo Mobile App requer duas portas por instância. Por defeito, estas são as portas 7020 e 7021. Estas portas devem ser acessíveis ao público.
Nota: Se estiver a planear outra instância neste servidor Anvaigo, pode, por exemplo, ativar portas adicionais como 7022-7023.
Criar uma nova regra de firewall e especificar o seu tipo.
Introduzir as portas adequadas.
Siga os passos seguintes, tal como descrito acima. Por fim, introduza novamente um nome com significado.
Depois de a configuração ter sido concluída com êxito, deverá ver as novas regras na firewall.
Nota:
Se a base de dados PostgreSQL não estiver instalada no mesmo servidor, deve ser activada outra porta. No servidor da instalação do PostgreSQL, a porta 5432 (ou a porta personalizada) deve ser aberta por padrão para comunicação com o servidor Anvaigo. Esta porta também deve ser acessível apenas internamente e não deve ser acessível a partir do exterior.
Configuração no Microsoft Dynamics
No Microsoft Dynamics, abra o Assistente de Configuração do Anvaigo Mobile App.
Inicie a configuração do Anvaigo Mobile App no Microsoft Dynamics especificando que você instalou o Anvaigo Server em sua própria infraestrutura (Self-managed Anvaigo Server). Além disso, especifique um nome de instância Anvaigo único. Este será utilizado mais tarde nos dispositivos móveis para o início de sessão. O nome da instância deve conter company name da sua company name e ser tão curto e conciso quanto possível. Aqui pode encontrar uma lista de nomes de instâncias que não são permitidos.
Na secção seguinte, ser-lhe-á pedido que introduza os detalhes da ligação ao servidor Anvaigo.
O Endereço do Serviço de Aplicações (externo) é o “Nome de Domínio Completo Qualificado” (FQDN) para o qual necessita de um certificado válido e oficialmente confirmado. O servidor Anvaigo pode ser alcançado pelo cliente da aplicação móvel Anvaigo a partir do exterior através deste endereço. Para que seja efectuada uma verificação do certificado SSL, deve ser utilizado um FQDN neste ponto e não um endereço IP.
A porta TCP do serviço de aplicações é predefinida para 7020, exceto se for ajustada manualmente. Se vários Anvaigo App Services forem fornecidos por um servidor Anvaigo, esta porta é diferente da predefinida.
A porta http do serviço de aplicações é normalmente 7021. Isto também pode ser diferente para instalações múltiplas.
O Anvaigo Server Address (internal) é o endereço interno no qual o Microsoft Dynamics pode alcançar o Anvaigo Server. Importante: Este endereço não deve estar disponível para o mundo exterior.
A Porta do Servidor é 8888 por defeito e também foi definida durante a instalação do Servidor Anvaigo.
A senha do servidor Anvaigo foi atribuída durante a instalação anterior do servidor Anvaigo.
Depois de introduzir os dados de ligação para o servidor Anvaigo, o passo seguinte consiste em configurar os dados de ligação para a base de dados PostgreSQL.
O Database Address é o “Full Qualified Domain Name” (FQDN) ou endereço IP sob o qual a base de dados PostgreSQL pode ser alcançada a partir do servidor Anvaigo. Se a base de dados PostgreSQL estiver instalada no mesmo servidor que o servidor Anvaigo, introduza “localhost” aqui. Se a base de dados PostgreSQL estiver instalada num servidor diferente, o acesso externo deve ainda ser configurado. Pode encontrar mais informações sobre este assunto nesta ligação.
O modo SSL é Desativar.
O utilizador da base de dados é “postgres” por predefinição.
A palavra-passe da base de dados foi atribuída durante a instalação da base de dados PostgreSQL.
O passo seguinte é especificar o URL do serviço Web e o cliente predefinido.
O passo seguinte consiste em configurar o servidor Anvaigo.
O próximo passo é atribuir uma licença à instância.
Atenção:
Esta não é uma mensagem de erro. Contacte a nossa equipa em [email protected]. Podem criar uma licença de avaliação para si ou atribuir a sua licença ativa existente à instância. Para tal, introduza o nome da instância Anvaigo que atribuiu no início. Depois de receber uma resposta da nossa equipa, reinicie o Anvaigo Wizard.
O Anvaigo Wizard continua a configuração definindo o “Job Interval” (Intervalo de trabalho).
Para o cálculo dos dados delta, recomendamos a criação de um job no Microsoft Dynamics que determine automaticamente as modificações nos dados do Dynamics e as transmita para o Anvaigo Delta Service em intervalos regulares.
Este cálculo é iniciado automaticamente sempre que os utilizadores Anvaigo sincronizam. O trabalho automático minimiza significativamente o tempo de sincronização, uma vez que os dados são sempre calculados entretanto e não no momento da sincronização.
Replicação de dados para o serviço Anvaigo Delta
A replicação de dados para o Anvaigo Delta Service é um recurso necessário que é automaticamente configurado para a primeira instalação usando o Assistente de Instalação. No entanto, se estiver a configurar a aplicação para satisfazer as suas necessidades, é necessário um olhar mais atento à configuração do Anvaigo Delta Service.
O que faz o serviço Anvaigo Delta?
A fim de proporcionar ao utilizador uma sincronização rápida, apenas as alterações de dados (o delta de dados) e nem sempre todos os dados (a chamada carga total)
são transferidos entre a Dynamics e a Anvaigo Mobile App. Para este fim, as alterações de dados no Dynamics são determinadas em tempo real pelo Anvaigo Delta Service e disponibilizadas para o Anvaigo Mobile App através do Anvaigo App Service.
Para o efeito, todas as alterações de dados são periodicamente transferidas do Dynamics para o serviço Anvaigo Delta, para que este possa efetuar o cálculo rapidamente. Isto é tratado pelo Delta Service Replication.
No cliente Anvaigo Mobile App no dispositivo móvel, apenas os dados definidos pelos pacotes de sincronização Anvaigo e a configuração do servidor Delta – consulte Configuração do servidor Delta – estão disponíveis.
Importante! Re-login após alterações de configuração
Devido a algumas limitações do Microsoft Dynamics, é necessário fazer logoff e logon novamente todos os usuários após ter feito algumas alterações de configuração no Anvaigo Delta Service Setup. Por conseguinte, recomendamos que as alterações sejam efectuadas fora do horário de trabalho. Atualmente, é necessário um período de inatividade para os utilizadores móveis enquanto as alterações são ressincronizadas. Em versões futuras, será possível ressincronizar automaticamente as alterações à noite sem tempo de inatividade.
Instalar a aplicação Anvaigo Sales ou Service
Se tiver instalado a aplicação Anvaigo Sales ou Service como uma extensão, ser-lhe-á perguntado se pretende configurá-las.
Anvaigo Sales App
Aqui pode encontrar os manuais de instalação para as soluções prontas a utilizar da aplicação Anvaigo Sales.
Anvaigo Service App
Aqui pode encontrar os manuais de instalação para as soluções prontas a utilizar da Anvaigo Service App.