Ativar Local de Arquivo Local¶

Introdução¶

Por padrão, o uso de arquivos locais está desabilitado para Jitterbit Harmony Agentes Privados. Isso inclui o uso de um Cloud Studio endpoint de armazenamento local ou um Design Studio fonte ou destino do arquivo local, bem como usar arquivos de gatilho ou pastas de sucesso/erro configuradas em outros endpoints ou origens/destinos.

Você pode habilitar localizações de arquivos locais se precisar trabalhar com um diretório local específico ou arquivos locais, ou usar o arquivo de gatilho ou as opções de pasta de sucesso/erro.

Locais de arquivos locais podem ser ativados apenas para Agentes Privados e não podem ser ativados em Agentes em Nuvem Jitterbit.

Observe que, independentemente dessa configuração, o Cloud Studio endpoints de armazenamento temporário e Design Studio fontes e destinos de armazenamento temporário estão sempre disponíveis, tanto para Private quanto para Agentes em Nuvem.

Determinando Se o Local do Arquivo Local Está Desativado¶

Como as localizações de arquivos locais são desabilitadas por padrão em Agentes Privados, se você ainda não configurou seus Agentes Privados para habilitar a localização de arquivos locais, então, ao testar a conexão com um endpoint de armazenamento local do Cloud Studio ou origem ou destino de arquivo local do Design Studio, este erro mensagem será exibida:

Using local files as a source/target, trigger file, or success/error folders is disabled by default.

Set EnableLocalFileLocation=true in the [Settings] section of jitterbit.conf and restart the Jitterbit Apache service to enable it.

A localização do arquivo local está desativada no Grupo de Agentes em Nuvem, portanto, a mesma mensagem de erro aparecerá se você estiver usando Agentes em Nuvem. Não é possível ativar a localização de arquivo local para Agentes em Nuvem.

Habilitando Localização de Arquivo Local em um Agente Privado¶

Para habilitar os arquivos locais, você precisa editar o arquivo de configuração do Agente Privado e reiniciar todos os serviços Jitterbit.

Existem duas maneiras de alterar o arquivo de configuração: remotamente ou manualmente. Remotamente é mais simples (especialmente com vários agentes em um Grupo de Agentes), mas manualmente pode ser preferível em determinados cenários.

Modificando Remotamente o Arquivo de Configuração do Agente Privado¶

Estas etapas resumidas mostram como habilitar o armazenamento de arquivos local remotamente usando o Management Console. Para obter mais instruções, consulte Editar o arquivo de configuração (jitterbit.conf).

1. Faça login no Portal Harmony e selecione Management Console. Use o menu para navegar até Agentes > Grupos de Agente.

2. Na tabela, selecione Grupo de Agentes Privados e use o menu suspenso Action para selecionar Jitterbit Conf.

3. Na abaConfig, clique em Editar. Role até chegar à linha Configurações, conforme mostrado na coluna esquerda Configuração.

4. Para a linha Chaves rotulada EnableLocalFileLocation, defina Valor como true.

   

5. Clique em Enviar para concluir a mudança de configuração.

6. Reinicie o Agente Privado para que as alterações entrem em vigor.

Modificando Manualmente o Arquivo de Configuração do Agente Privado¶

Essas etapas resumidas mostram como habilitar o armazenamento de arquivo local editando manualmente o arquivo de configuração. Para obter mais instruções, consulte Editar o arquivo de configuração (jitterbit.conf).

Em cada máquina onde o Agente Privado estiver instalado, navegue até o arquivo de configuração do agente. Ele estará localizado em seu diretório de instalação, geralmente em um destes locais:

• Windows (Jitterbit Harmony): C:\Program Files (x86)\Jitterbit Agent\jitterbit.conf

• Windows (Jitterbit v5.x): C:\Program Files (x86)\Jitterbit Integration Server\jitterbit.conf

• Linux: /opt/jitterbit/jitterbit.conf

Por exemplo, em um sistema operacional Windows:

1. Abra o jitterbit.conf arquivo em um editor de texto.

2. Sob o [Settings] seção do arquivo, localize a entrada EnableLocalFileLocation:

   

   Altere a linha mostrada acima em amarelo para ler:

   EnableLocalFileLocation=true
   

3. Salve e feche o arquivo de configuração.

4. Reinicie o Agente Privado para que as alterações entrem em vigor.

Reinicie o Agente Privado para Que as Alterações Entrem em Vigor¶

Todos os serviços Jitterbit devem ser reiniciados para que a alteração de configuração ocorra. Em cada máquina onde o Agente Privado estiver instalado, primeiro pare os serviços, depois reinicie-os, usando o procedimento apropriado para o sistema operacional:

Verificando o Agente Privado¶

Para verificar se o Agente Privado foi reiniciado com sucesso, acesse o Management Console e visualize o Agente. O status do Agente Privado deve ser "Executando". A nova configuração agora estará em vigor. Por exemplo:

Confirmando Se o Local do Arquivo Local Está Ativado¶

Estas etapas mostram como confirmar se os locais de arquivos locais estão ativados. Mesmo que você não pretenda usar um endpoint de armazenamento local ou origem/destino de arquivo local, você pode usar este procedimento para confirmar que um arquivo de gatilho ou uma pasta de sucesso/erro agora estará acessível em um determinado agente ou Grupo de Agentes.

1. Verifique se você está usando um ambiente que usa o Agente Privado que você configurou nas etapas acima.

2. Confirme que agora você pode usar localizações de arquivos locais no Cloud Studio ou no Design Studio:

   • Cloud Studio: Crie uma nova Conexão de armazenamento local, especificando um caminho de pasta local. Clique no botão Testar. Uma mensagem deve ser exibida indicando que a conexão foi bem-sucedida.

   • Design Studio: Crie um novo Local File source or target, especificando um caminho de pasta local e arquivos. Depois que seus parâmetros específicos forem listados, clique em Test Connection. Uma mensagem deve ser exibida indicando que a conexão foi bem-sucedida e exibir os arquivos locais.

   Nota

   Se você estiver usando um Agente em Nuvem (ou outro Agente Privado), receberá a mesma mensagem de erro de antes, porque habilitar arquivos locais não é possível usando um Agente em Nuvem ou porque você tem o agente ou Grupo de Agentes errado.