Avamar: SQL AG não reconhece o indicador --sqlserver

Summary: Os backups do Avamar SQL para grupos de disponibilidade do SQL Server (Always On AG) não reconhecem o indicador --sqlserver durante operações de navegação ou conjunto de dados iniciadas pela interface do usuário. Os backups de linha de comando funcionam conforme o esperado, mas as operações de navegação da interface do usuário falham porque o nome do SQL Server não é resolvido corretamente quando passado em minúsculas. ...

This article applies to This article does not apply to This article is not tied to any specific product. Not all product versions are identified in this article.
Check out other resources

Symptoms

  • Os backups do Grupo de disponibilidade do SQL Server (Always On AG) são executados com sucesso quando executados a partir da linha de comando.
  • As operações de procura e backup iniciadas na interface do usuário do Avamar Administrator falham.
  • O AG ou cluster do SQL não reconhece corretamente o --sqlserver quando fornecido por meio da interface do usuário ou do conjunto de dados.
  • Os seguintes parâmetros são necessários para ambientes SQL AG, mas não são respeitados corretamente: 
    --sqlserver=awdprdag
--hostname-sql=awdprdag
  • A operação de navegação da CLI é bem-sucedida usando o seguinte comando:  
    avsql --operation=browse --sqlserver=awdprdag --hostname-sql=awdprdag
 

Cause

O Avamar lê os parâmetros SQL do avsql.cmd localizado no diretório var. O arquivo é analisado corretamente, mas o nome do SQL Server é avaliado como minúsculo, o que causa falha na detecção de cluster do SQL AG.

As seguintes entradas de log confirmam que os indicadores são lidos, mas o cluster não foi aberto com sucesso: 

2019-05-15 12:19:51 avsql Info <5174>: - Reading \\S-AWDSQL01-PRD\AvamarCluster\Var\avsql.cmd
2019/05/15-16:19:51.97499 [avsql_assist]  uflags::parsefile  Printing flags from \\S-AWDSQL01-PRD\AvamarCluster\Var\avsql.cmd:
.cmd flag --sqlserver=awdprdag
.cmd flag --hostname-sql=awdprdag

2019/05/15-16:19:53.25600 [avsql_assist]  Connect to awdprdag server, because sqlserver flag is defined.

Falha na detecção do cluster com os seguintes erros: 

2019/05/15-16:19:51.95900 [avsql_assist]  Is always on test for 'awdprdag' server.
2019/05/15-16:19:51.95900 [avsql_assist]  Open Cluster error 5, try with NULL parameter...
2019/05/15-16:19:51.95900 [avsql_assist]  Open Cluster error 5
2019-05-15 12:19:51 avsql Info <17376>: Working on stand alone environment.

 Como resultado, o Avamar trata o ambiente como um SQL Server independente em vez de um grupo de disponibilidade.

 

Resolution

Atualize o nome do SQL Server na avsql.cmd para usar caracteres maiúsculos.

Etapas

  1. Navegue até o Avamar SQL Client Var diretório.
  2. Abra o avsql.cmd .
  3. Modifique os parâmetros para usar nomes SQL AG em maiúsculas: 
    --sqlserver=AWDPRDAG
--hostname-sql=AWDPRDAG
  4. Salve o arquivo.
  5. Repita a operação de procura ou backup do SQL a partir da interface do usuário do Avamar Administrator.

Após essa alteração, o AG SQL é detectado corretamente e as operações de navegação e conjunto de dados baseadas em interface do usuário funcionam conforme o esperado.

 

Additional Information

  • O requisito de usar nomes SQL Server em maiúsculas indica uma dependência da nomenclatura ambiental ou do comportamento de resolução do cluster.
  • Os backups de linha de comando podem continuar a funcionar mesmo quando as operações da interface do usuário falham, pois a CLI transmite explicitamente os parâmetros no tempo de execução.
  • Esse comportamento é específico do ambiente e normalmente não é necessário em implantações padrão do SQL Server.

Affected Products

Avamar

Products

Avamar, Avamar Client, Avamar Plug-in for SQL
Article Properties
Article Number: 000044561
Article Type: Solution
Last Modified: 02 Apr 2026
Version:  4
Find answers to your questions from other Dell users
Support Services
Check if your device is covered by Support Services.