[FAQ] Backup & Archive – Perguntas Frequentes

Visão geral

Esta FAQ aborda perguntas comuns relacionadas ao Flosum Backup & Archive, incluindo sua arquitetura em diferentes plataformas de nuvem, segurança, comportamento operacional e funcionalidade de restauração.

Arquitetura e Infraestrutura

Qual é a configuração arquitetural do Flosum Backup & Archive na AWS?

O Flosum Backup & Archive é executado em uma instância Amazon EC2 e conecta-se ao Salesforce SaaS externamente.

• O Nginx lida com solicitações de proxy e habilita SSL.

• O User Pool Service gerencia o controle de acesso.

• O MySQL armazena configurações do aplicativo.

• Opções de armazenamento local incluem:

  • SSD (gp2 ou gp3)

  • Armazenamento de objetos S3

Qual é a configuração arquitetural para o Google Cloud Platform (GCP)?

Executa dentro de uma Máquina Virtual do GCP e conecta-se externamente ao Salesforce SaaS.

• Nginx para proxy/SSL

• Google Identity Platform para controle de acesso

• MySQL para armazenamento de configuração

• Armazenamento CSV local em SSD

Qual é a configuração arquitetural para o Azure?

Executa dentro de uma VM do Azure com acesso ao Salesforce SaaS.

• Nginx para proxy/SSL

• Azure Active Directory para controle de acesso

• MySQL para configurações do aplicativo

• Opções de armazenamento:

  • SSD (gp2 ou gp3)

  • Armazenamento compatível com S3

Qual é a finalidade do MySQL no Backup & Archive?

O MySQL (executando em um contêiner Docker) armazena dados de configuração, mas não armazena backups de clientes.

Quantas instâncias EC2 são necessárias?

Apenas uma instância EC2 é necessária para uma implantação padrão auto-hospedada.

Como faço para aplicar patch em uma instalação auto-hospedada do Backup & Archive?

Use os seguintes comandos para:

1. Executar

2. Atualizar

3. Verificar

sudo docker pull flosum/agent-node:x.xx.x
sudo docker-compose up -d
sudo docker ps

Segurança e Armazenamento

Os dados são criptografados antes da transmissão para a AWS?

Sim, os dados são criptografados tanto em trânsito quanto em repouso usando o SHA-256 algoritmo.

Podemos escolher SSD em vez de S3?

Sim, você pode escolher entre SSD (gp2/gp3) ou S3/S3 Glacier para suas necessidades de armazenamento local.

Qual é o papel das Configurações Globais e do Armazenamento Local?

• Global gerencia conexões com o Salesforce e controla o acesso de usuários com o AWS Cognito (ou provedores de identidade respectivos).

• Armazenamento Local serve como armazenamento temporário de dados durante o processamento.

Quais são os tipos de armazenamento local disponíveis

• SSD (gp2)

• SSD (gp3)

• S3 Glacier Instant Retrieval

• S3 Glacier Flexible Retrieval

Qual é a finalidade do Nginx?

• Fazer proxy das solicitações para o contêiner Docker

• Gerenciar terminação de SSL e certificados

• Habilitar HTTPS para comunicação segura

Comportamento de Backup e Restauração

Por que preciso de dois backups para restaurar dados (pontos de corrupção e recuperação)?

Para minimizar suposições e restaurar apenas os dados afetados. O Flosum compara alterações entre:

• O backup antes da perda de dados (Ponto de Recuperação)

• O backup depois do incidente (Ponto de Corrupção Conhecido)

Apenas os registros alterados são restaurados, garantindo precisão e velocidade.

Posso executar vários trabalhos de backup ou restauração simultaneamente?

Não, apenas um trabalho (backup, restauração, arquivamento ou pesquisa) pode ser executado em um dado momento.

O que acontece se um backup agendado coincidir com um trabalho em execução?

O backup que se sobrepõe é ignorado. O próximo slot não agendado capturará quaisquer alterações perdidas. Backups Compostos retomam e capturam todos os deltas desde a última execução bem-sucedida.

Por que objetos de Histórico não são restaurados?

No Salesforce, objetos de Histórico não possuem permissões de inserção/atualização Esta é uma restrição ao nível da plataforma Salesforce, não uma limitação do Flosum.

Como funcionam as contagens de registros nos trabalhos de backup?

Ao verificar um trabalho de backup concluído, o aplicativo exibe contagens de registros indicando quantos registros estão armazenados no backup e quantos foram processados naquele trabalho.

• Total: Contagem de todos os registros atualmente armazenados no aplicativo Backup & Archive para um objeto específico (por exemplo, Contas, Contatos).

• Clicar em uma linha de objeto abre a Tabela de Registros, mostrando:

  • Todos = Adicionados + Alterados + Excluídos

  • Adicionados = Novos registros capturados neste trabalho

  • Alterados = Registros existentes que foram atualizados

  • Excluídos = Registros removidos desde o último backup

Exemplo:

Por exemplo, um novo backup foi criado ontem e capturou 40 registros de Case da sua organização. O Total mostraria 40 registros de Case. Hoje, você adicionou 10 novos Cases e atualizou 5 Cases existentes.

O backup de hoje mostrará:

Total	50 (40 originais + 10 novos)
Adicionados	10
Alterados	5
Excluídos	0
Todos	15 (10 adicionados + 5 alterados)

Resumo:

• Total = Todos os registros armazenados

• Todos / Adicionados / Alterados / Excluídos = Alterações neste trabalho de backup específico

O que os ícones e labels representam na tela “Adicionar Objetos Filho” no aplicativo Backup & Archive?

Ícones e indicadores na tela "Adicionar Objetos Filho" transmitem relacionamentos importantes entre objetos pai e filho, especialmente durante exclusões ao arquivar:

Triângulo de Aviso Amarelo (Exclusão em Cascata)

• O objeto filho tem um relacionamento dependente (exclusão em cascata) com o pai.

• Estes são considerados objetos dependentes no Salesforce.

• Opcional incluir no arquivo.

• Se excluídos, os registros filhos serão removidos quando o pai for arquivado e excluído.

• Isso reflete o comportamento nativo de cascata do Salesforce.

Ícone de Cadeado Vermelho (Exclusão Restrita)

• O objeto filho tem um relacionamento de Exclusão Restrita com o objeto pai.

• Esses objetos são automaticamente incluídos no modelo de arquivamento e não podem ser excluídos.

• No Salesforce, relacionamentos de exclusão restrita impedem que o registro pai seja excluído a menos que os registros filhos relacionados sejam excluídos primeiro.

• Necessário para arquivar e evitar erros.

Por que estou recebendo o erro INVALID_CROSS_REFERENCE_KEY para o campo RecordTypeId no objeto Order durante a restauração?

Esse erro ocorre quando o RecordTypeId dos dados arquivados não existe mais ou não é acessível na organização atual.

Causas raiz:

• O registro arquivado possui um RecordTypeId atribuído implicitamente que:

  • Não existe mais na organização atual.

  • Não é visível/acessível para o usuário que executa a restauração (usuário em execução).

  • Estava vinculado a uma configuração passada ou pacote gerenciado.

Solução:

• Exclua o campo RecordTypeId durante a restauração.

• O Salesforce atribuirá automaticamente o Tipo de Registro padrão.

• Evita erros de referência cruzada e conclui a restauração.

Por que recebo o erro INVALID_OR_NULL_FOR_RESTRICTED_PICKLIST ao restaurar um registro EmailMessage com um FromAddress?

Isso acontece quando o FromAddress não é reconhecido ou validado em sua organização Salesforce.

O Salesforce permite apenas:

• Endereços de E-mail de Toda a Organização

• Endereços de roteamento Email-to-Case

• Endereços de e-mail de usuários ativos

Se o FromAddress no seu backup (por exemplo, [email protected]) não estiver validado, o Salesforce retornará:

• INVALID_OR_NULL_FOR_RESTRICTED_PICKLIST

• INVALID_FIELD_VALUE

Esse erro ocorre porque o Salesforce está aplicando uma restrição no FromAddress campo do EmailMessage objeto. O erro se refere a ValidatedFromAddress, mas o problema está no valor no FromAddress campo, que deve ser validado e autorizado no Salesforce.

Internamente, o Salesforce usa um campo chamado ValidatedFromAddress para garantir que o FromAddress esteja entre a lista de remetentes autorizados. Para evitar esse erro durante uma restauração ou inserção, exclua o ValidatedFromAddress campo da sua solicitação de restauração para registros EmailMessage.

Quando a permissão “Query All Files” deve ser concedida a um usuário que usa o aplicativo Backup & Archive, e o que acontece se ela não for concedida?

A "Query All Files" permissão é sensível e deve ser atribuída apenas a usuários de sistema ou de integração confiáveis.

Obrigatória quando:

• Fazendo backup ou restaurando arquivos que não foram explicitamente compartilhados com o usuário.

Se não for concedida:

• Apenas arquivos compartilhados serão copiados no backup.

• Alguns arquivos visíveis via acesso a registros poderão ser ignorados.

• A restauração pode perder anexos de arquivos que não foram capturados.

Impacto:

• Backup e restauração de arquivos incompletos.

• Risco de lacunas de dados em ambientes compartilhados ou colaborativos.