Bitbucket backup client throws BackupException : Some files could not be read in Bitbucket home

[Alexey Bevetskiy]

I use bitbucket backup client for scheduled backups. Since couple of days I started receiving the following messages in log file:

A backup could not be created
com.atlassian.bitbucket.internal.backup.client.BackupException: Some files could not be read in Bitbucket home. Please change their permissions to make them readable by the user running the backup client or exclude them from the backup using the bitbucket.home.excludes property and retry. The following files could not be read:
D:\Atlassian\ApplicationData\Bitbucket\shared\config\ssh-server-keys.pem

The file is readable neither from my user account, nor from domain admin account.
How can I exclude the problem file from the backup or somehow solve the issue?

[Caterina Curti · Accepted solution]

Hi @Alexey Bevetskiy,

The file is not a default one provided with the installer, and it could be that the issue started when that file has been copied to the directory.

Since it has been placed in the shared directory, it is likely that this was intentional and you may want to add it to a backup so that, in case a restore is needed, this file will be also restored.

I would suggest proceeding in this way:

- If the file is needed and part of the installation, attempt to fix the permissions so that the user running the backup has access to the file

- If the file is not needed, remove it.

To answer your question, it is possible to exclude the files by adding the following exclusion rule:

bitbucket.home.excludes=shared/config/ssh-server-keys.pem

The syntax above is Glob so the / are correct even on a Windows installation.

If we choose this option, the file will not be backed up and will not be available as part of a restore and this could lead to potential problems.

Cheers,

Caterina - Atlassian

[Alexey Bevetskiy]

Hi @Caterina Curti!

Thank you for the prompt reply.

I've managed to fix the permission issue via reassigning owner of the file and granting permission to read/write this file to a user making the backup. After this fix the backup script has been fihished without errors.

Best regards,

Alexey

[Caterina Curti]

Great @Alexey Bevetskiy!
Thanks for the feedback.