Habilitar Localização de Arquivo Local¶

Introdução¶

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

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

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

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

Determinando Se o Local do Arquivo Local Está Desativado¶

Como os locais de arquivos locais estão desabilitados por padrão em Agentes Privados, se você ainda não configurou seus Agentes Privados para habilitar o local de arquivos locais, ao testar a conexão com um endpoint de armazenamento local do Cloud Studio ou origem ou destino de arquivo local do Design Studio, esse 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á desabilitada 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 arquivos locais para Agentes em Nuvem.

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

Para habilitar arquivos locais, você precisa editar o arquivo de configuração do Agente Privado e então 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 ativar o armazenamento local de arquivos 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 o Grupo de Agentes Privados e use seu menu suspenso Action para selecionar Jitterbit Conf.

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

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

   

5. Clique em Enviar para concluir a alteração da configuração.

6. Reinicie o Agente Privado para que as alterações tenham efeito.

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

Estas etapas resumidas mostram como ativar o armazenamento de arquivos 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 está 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 ( Harmony Jitterbit): 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, encontre 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 tenham efeito.

Reinicie o Agente Privado para Que as Alterações Tenham Efeito¶

Todos os serviços Jitterbit devem ser reiniciados para que a alteração da configuração ocorra. Em cada máquina onde o Agente Privado estiver instalado, primeiro interrompa os serviços e depois reinicie-os, utilizando 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 “Running”. A nova configuração agora estará em vigor. Por exemplo:

Confirmando Que o Local do Arquivo Local Está Ativado¶

Estas etapas mostram como confirmar se os locais de arquivos locais estão habilitados. 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 se um arquivo acionador 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 utiliza o Agente Privado configurado nas etapas acima.

2. Confirme se agora você pode usar locais de arquivos locais no Cloud Studio ou 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 deverá ser exibida indicando que a conexão foi bem-sucedida.

   • Design Studio: Crie um novo arquivo local fonte ou alvo, especificando um caminho de pasta local e arquivos. Depois que seus parâmetros específicos forem listados, clique em Testar conexão. Uma mensagem deverá ser exibida indicando que a conexão foi bem-sucedida e exibindo os arquivos locais.

   Nota

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