KNOWLEDGE BASE

Error: "Tableau Server could not verify that there is sufficient disk space for backup." when Creating a Backup on Tableau Server 2021.4.7 or 2021.1.2


Published: 03 Jun 2022
Last Modified Date: 22 Jun 2022

Issue

In Tableau Server 2021.4.7 or 2022.1.2, creating a backup may fail with the following error:
 
Tableau Server could not verify that there is sufficient disk space for backup. If you believe there is enough space, you may skip the disk space check and force creation of a backup by using the '--override-disk-space-check' option. The backup will fail if it runs out of space.
 
Attempting to bypass the error with the --override-disk-space-check option will still fail with the following error:
 
An error occurred on the server generating the backup. 
This job failed due to unexpected error: 'BackupRestoreException' 
BackupRestoreException(message:ProxyClient was unable to find a gRPC channel to the service 'extract_service' as required by class 'com.tableausoftware.domain.extractdata.grpc.IExtractServiceMaintenanceGrpc'.)

Environment

  • Tableau Server 2021.4.7 
  • Tableau Server 2022.1.2 
  • No Data Management add-on enabled
  • Multi-node, High Availability (HA) environment with either:
    • (Modern HA) Two instance of the Repository (active and passive) and a Filestore co-located on the same non-tabadmincontroller node as one of the Repository instances
    • (Classic HA) Once instance of the Repository where Filestore is co-located on the same non-tabadmincontroller node as one of the the Repository 
 

Resolution

To resolve this issue, upgrade Tableau Server to the June 21st, 2021 or later maintenance releases: v2021.4.8 or v2022.1.3.

If an upgrade is not immediately feasible, the following options will mitigate the issue to allow creation of backups:

Option 1: Move the Filestore process
 
For Modern HA environments:
In environments where a Passive Repository is co-located with a Filestore, decommission the Filestore from the Passive Repository node. This method assumes that the Active Repository is on the TSM Controller ("tabadmincontroller") node and the TSM Controller node is set as the pgsql.preferred_host (preferred active repository). 

For Classic HA environments:
In environments where there is a single, Active Repository co-located with Filestore on a non-tabadmincontroller node, the Filestore can be decommissioned and/or moved to another node.

Option 2: It may also be possible to take postgres-only backups using the -po flag option with tsm maintenance backup.

 

Cause

This issue is a known issue with ID 1420983, and is resolved in v2021.4.8, v2022.1.3, and later releases of Tableau Server.

Additional Information

  • This issue does not impact single-node environments
  • This issue does not impact environments where Data Management add-on licenses are actively being used (extract service is active).
  • Using --override-disk-space-check will not resolve the error
  • Setting the preferred Repository to node1 Hostname will not, by itself, work around the error
Did this article resolve the issue?