Instalação e configuração do Microsoft Dynamics AX
Introdução
Um endpoint do Microsoft Dynamics AX requer o uso de um agente privado do Windows com um Jitterbit Microsoft Dynamics AX REST Connector. Esses dois softwares devem ser baixados, instalados e configurados antes do uso e configuração do conector Design Studio Microsoft Dynamics AX.
Nota
O Jitterbit Microsoft Dynamics AX REST Connector é um componente adicional, separado do Jitterbit Design Studio Microsoft Dynamics AX Connector. O conector REST deve ser baixado do portal Harmony Downloads e instalado no mesmo servidor que o agente. O Design Studio Microsoft Dynamics AX Connector será instalado automaticamente no agente conforme exigido pelo Design Studio.
Pré-requisitos
Estes são os pré-requisitos para os conectores AX REST do Jitterbit Microsoft Dynamics AX 4.0, 2009 e 2012:
-
O .Net framework 4.0 ou superior é necessário.
Instalando e configurando um agente e um conector Jitterbit AX REST
Siga estas etapas para instalar e configurar o agente e o conector Jitterbit AX REST:
-
Etapa 2: Instalar e configurar um conector Jitterbit AX REST
-
Etapa 3: testar a configuração do serviço do Windows do agente e do conector
Etapa 1: instalar um agente privado do Windows
As instruções sobre como instalar um agente privado do Windows estão detalhadas em Instalar um agente do Windows.
Depois de instalar o agente privado e ele aparecer no Jitterbit Management Console Agentes página como Running, prossiga para instalar o conector Jitterbit AX REST apropriado.
Etapa 2: instalar um conector Jitterbit AX REST
Diferentes versões do Jitterbit Microsoft Dynamics AX REST Connector estão disponíveis para download, dependendo da versão do Microsoft Dynamics AX à qual você está se conectando. Todos os conectores Jitterbit AX REST estão disponíveis no Harmony Downloads e estão listados em Conectores:
Escolha o conector Jitterbit Microsoft Dynamics AX REST com base na versão do Microsoft Dynamics AX à qual você está se conectando:
| Servidor Microsoft Dynamics AX | Conector Jitterbit AX REST compatível |
|---|---|
| Microsoft Dynamics AX 4.0 | Microsoft Dynamics AX 4.0 |
| Microsoft Dynamics AX 2009 | Microsoft Dynamics AX 2009 |
| Microsoft Dynamics AX 2012 | Microsoft Dynamics AX 2012 |
Do Downloads, baixe e instale o conector apropriado, seguindo as instruções fornecidas pelo instalador. O instalador deve ser executado no mesmo servidor onde o agente privado do Windows está instalado e em execução.
Se você tiver vários agentes privados em um grupo de agentes, repita essas etapas de instalação para cada agente no grupo de agentes.
Nota
Apenas um serviço pode ser executado em um agente por vez. Todos os agentes no grupo de agentes precisam estar executando a mesma versão do serviço.
Aviso
Como o serviço do conector REST é instalado por um instalador diferente do instalador regular do agente Jitterbit, esse serviço não é desinstalado quando um agente é removido ou desinstalado. Em vez disso, siga as etapas regulares do Windows para remover um programa para remover o serviço do conector REST se estiver desinstalando um agente de um servidor.
Depois de instalar o Jitterbit Microsoft Dynamics AX REST Connector apropriado, certifique-se de que o servidor onde o Microsoft Dynamics AX REST Connector e o agente privado do Windows estão instalados pode resolver o nome DNS do servidor AX. Para fazer isso, abra um Prompt de Comando e execute ping <DNS name of AX server>. Se um endereço IP for retornado, prossiga para Etapa 3: testar a configuração do serviço do Windows do agente e do conector.
Se um endereço IP não for retornado, edite o arquivo hospedar do driver (C:\Windows\System32\drivers\etc\hosts) e adicione uma entrada com o endereço IP do seu servidor AX. Isso permitirá que o nome DNS do servidor AX seja resolvido.
Etapa 3: testar a configuração do serviço do Windows do agente e do conector
No console de serviços do sistema operacional Windows (services.msc), verifique se o Jitterbit Microsoft Dynamics (AX 4.0, AX 2009 ou 2012) REST Connector Service está instalado e em execução. Se não estiver em execução, inicie-o e defina-o para o modo de inicialização automática.
Verifique http://localhost:8000/AX/help em um navegador. Isso mostrará as operações disponíveis no serviço do conector. Se você não vir a lista de operações, isso geralmente indica que o serviço do Windows que hospeda o conector não foi iniciado.
Nota
Certifique-se de que o agente possa acessar sua instância do Microsoft Dynamics AX efetuando login na instância do Microsoft Dynamics AX a partir do agente.
Solução de problemas
Para depurar problemas com um conector Jitterbit Microsoft Dynamics AX REST, defina EnableWCFMessageTracing para true no arquivo de configuração do conector REST. Por exemplo, o arquivo de configuração para o conector REST do Microsoft Dynamics AX 2012 pode ser encontrado neste local:
C:\Program Files\Jitterbit\Jitterbit Dynamics AX 2012 Connector REST Service\Jitterbit.Connectors.Dynamics.AX2012.Host.exe.config
Nota
Os nomes dos diretórios variam dependendo do conector REST que está sendo usado.