Erro no backup do RSP: "HANA backup failed: Backup size limit argument value is not numeric"

Como resolver o erro de backup do RSP no SAP Business One HANA causado pelo parâmetro "limit" do BackupService com valor inválido (N/A).

4 min de leitura
TroubleshootingSap HanaSap

Erro no backup do RSP: "HANA backup failed: Backup size limit argument value is not numeric"

Sintoma

Ao executar backups agendados via **Remote Support Platform (RSP)** no SAP Business One, version for SAP HANA, a tarefa falha com a seguinte mensagem:

HANA backup failed: ERROR Backup size limit argument value is not numeric

No relatório do RSP, o status do backup aparece como **Fail**, com `Backup Path = N/A` e `Backup Result = Fail`.

Ao acessar a URL do BackupService no navegador:

https://<servidor-hana>:40000/BackupService/

O parâmetro `Limit` aparece como `N/A`:

Backup Service is up and running... Backup Path = /hana/shared/backup_service/backups Working Path = /tmp/backup_service Log Path = /var/log/SAPBusinessOne/BackupService/logs Compress = false Limit = N/A

Causa Raiz

O parâmetro `limit` do BackupService define o **tamanho máximo total (em MB)** que a pasta de backups pode atingir. Quando esse limite é alcançado, o serviço executa o housekeeping automático e remove os backups mais antigos.

O erro ocorre porque o parâmetro `limit` está:

  • **Ausente** no arquivo de configuração, ou
  • **Com valor inválido** (vazio, `0`, ou qualquer valor não numérico)

Quando isso acontece, o BackupService exibe `Limit = N/A` na interface e repassa esse valor não numérico para o utilitário de backup, que rejeita a operação.

Pré-requisitos

  • Acesso **SSH** ao servidor HANA como `root` (ou usuário com `sudo`)
  • Editor de texto disponível (vim, nano, etc.)
  • Janela de manutenção disponível — o reinício do `sapb1servertools` deixa o SLD/BackupService indisponíveis temporariamente

Diagnóstico

1. Confirme o estado atual do BackupService

Acesse no navegador:

https://<servidor-hana>:40000/BackupService/

Verifique se `Limit = N/A`.

2. Verifique o espaço em disco da pasta de backup

[bash] df -h /hana/shared/backup_service/backups

Anote o **Tamanho total**, **Usado** e **Disponível**.

3. Verifique o tamanho atual da pasta de backups

[bash] du -sh /hana/shared/backup_service/backups

Esse valor é importante para definir o `limit` corretamente — o valor configurado deve respeitar o espaço disponível e considerar o conteúdo já existente.

Solução

Passo 1 — Calcular o valor adequado do parâmetro `limit`

O valor é definido em **MB** e representa o tamanho máximo total da pasta de backups.

**Recomendação:**

  • Considere o espaço **total disponível** no filesystem `/hana/shared`
  • Reserve folga para outras operações do HANA (data, log, etc.)
  • Se a pasta de backups já estiver volumosa, defina um `limit` **abaixo do tamanho atual** para forçar o housekeeping automático a limpar os backups mais antigos

**Exemplo prático:**

| Item | Valor | |---|---| | Disco total `/hana/shared` | 192 GB | | Pasta `backups` atual | 95 GB | | Disponível | 65 GB | | **Valor recomendado para `limit`** | **80000** (80 GB) |

Nesse exemplo, o housekeeping limpará automaticamente cerca de 15 GB de backups antigos, liberando espaço para o próximo backup rodar com segurança.

Passo 2 — Editar o arquivo de configuração do BackupService

[bash] vim /usr/sap/SAPBusinessOne/Common/tomcat/conf/backup.properties

Localize a linha:

limit=

(ou `limit=0`, ou linha inexistente)

E altere para o valor calculado em MB. Exemplo:

limit=80000

Salve o arquivo (`ESC` → `:wq` → `Enter`).

Passo 3 — Confirmar a alteração

[bash] grep "limit" /usr/sap/SAPBusinessOne/Common/tomcat/conf/backup.properties

A saída deve conter:

limit=80000

Passo 4 — Reiniciar o `sapb1servertools`

> ⚠️ **Atenção:** o restart deixa SLD, BackupService, Analytics Platform e outros serviços indisponíveis por alguns minutos. Execute em janela de manutenção ou avise os usuários conectados.

[bash] /etc/init.d/sapb1servertools restart

Aguarde o serviço subir completamente (geralmente entre 30 segundos e 2 minutos).

Validação

1. Confirmar o parâmetro no BackupService

Acesse novamente:

https://<servidor-hana>:40000/BackupService/

O parâmetro `Limit` deve agora exibir o valor numérico configurado (ex: `Limit = 80000`), em vez de `N/A`.

2. Executar um backup manual via RSP

  1. Abra o **Remote Support Platform**
  2. Localize a tarefa de backup HANA agendada
  3. Execute manualmente (**Run Now**)
  4. Aguarde a conclusão — o status deve ser **Success**

3. Confirmar a presença dos arquivos de backup

[bash] ls -lh /hana/shared/backup_service/backups

Os novos arquivos de backup devem aparecer com timestamp recente.

Observações Importantes

  • **Não defina `limit=0`** — o BackupService trata zero como ausência de valor e volta a exibir `N/A`
  • **Não defina um valor superior ao espaço total do disco** — o housekeeping nunca seria acionado e o disco lotaria
  • **Monitore o crescimento da pasta** periodicamente para ajustar o `limit` conforme a base do cliente cresce
  • Caso a pasta de backups esteja **muito acima** do espaço seguro, considere fazer uma **limpeza manual prévia** dos backups mais antigos antes de definir o `limit`

Referências

  • SAP Community — [RSP HANA instance backup failed: backup size exceeded the -limit parameter](https://community.sap.com/t5/enterprise-resource-planning-q-a/rsp-hana-instance-bacup-failed-the-backup-export-size-exceeded-the-limit/qaq-p/12210239)
  • SAP Community — [SLD Backup Service – Localização do arquivo backup.properties](https://community.sap.com/t5/enterprise-resource-planning-q-a/sld-backup-service-compress-true/qaq-p/12283609)
  • SAP Note **2072868** — Backup service for SAP HANA best practices and known limitations
  • SAP Note **2157386** — HANA backups scheduling in RSP
  • [Central page of Backup/Recovery topic for SAP Business One, version for SAP HANA](https://blogs.sap.com/2015/07/08/central-page-of-backuprecovery-topic-for-sap-business-one-version-for-sap-hana/)