TODO: Add note about mount path for backup pvc to restore AWX from existing backup files

[neofright]

In the restore documentation the manual restoration examples use the directory name of /data/backups but in the backup documentation the folder is /data/backup.

I spent more time than I'd like to admit before I finally diagnosed the stat: cannot statx '/data/backups/tower-openshift-backup-2024-08-04-130151 errors and realised why.

These directory names should probably be consistent in the documentation and yaml.

[kurokobo]

I can't find the string /data/backups in my repository 🤔
Could you please clarify which part of the description is making you concerned?

[neofright]

Sure. In the manual restore instructions it says:

If the AWXBackup object no longer exists, place the backup files under /data/backup

Then afterwards specifies backup_dir: /backups/.

Should it be backup_dir: /data/backup/ or backup_dir: /backup/ in order to use the existing backups?

[kurokobo]

Thanks for the update, I understand your situation.

It's indeed a difficult point to grasp. Unfortunately, the AWX Operator is designed to mount the specified PVC at /backups. It is hard coded so it is impossible to change the /backups in backup_dir to another path. Therefore, the only thing that can be done to align the directory names is to change /data/backup used in this repository to /data/backups (with trailing s). However, renaming the directory used in the PV would have a significant impact on existing users of this repository, so I don't want to do that.

That said, I have written about the mounted path in backup_dir in some issues in this repo and forums several times in the past, so I will also add similar comments to my guide.

Thanks for your report :)

• can not restore from backup files #285 (comment)
• Restore fails  #14 (comment)
• https://forum.ansible.com/t/awx-backup-fails/7739/38?u=kurokobo
• etc.