Agile Central: On-Prem - Backup fails with Access Denied Error. Can we find the file in a tmp folder?

Document ID : KB000104010
Last Modified Date : 03/07/2018
Show Technical Document Details
Introduction:
Agile Central On-Premise edition allows and recommends periodic data backups. This is required during an upgrade procedure, yet you will always benefit from periodic backups. These back ups can be scheduled and are launched from the Control Panel.

See more on the backup procecedure:
https://help.rallydev.com/upgrades-and-backups-premises

Learn about the Control Panel:
https://help.rallydev.com/rally-control-panel-0

Even more on Backup/Restore:
https://help.rallydev.com/rally-control-panel-0#backup
Question:
Our backup process has failed. The error message mentions: "put: Access failed: Failure"
The error mentions a dump file that was created.

- What is this error, why did the backup fail.
- Can we access and use the dump file instead?

From the control panel log:
Dump file set for SYSTEM.SYS_EXPORT_SCHEMA_01 is: 
/orahome/app/oracle/product/12.2.0.1/db/rdbms/log/directory-2018-06-27-02-00-10-dp.dmp 
Job "SYSTEM"."SYS_EXPORT_SCHEMA_01" successfully completed at Wed Jun 27 02:03:03 2018 elapsed 0 00:02:47 

<br /><strong>Step 4 of 6 - Tarring up Backup Files</strong> 
/bin/tar: Removing leading `/' from member names 
/tmp/directory-2018-06-27-02-00-10-dp.dmp 
/opt/RallyOnPrem/lib/onprem-lib.conf 
/opt/RallyOnPrem/web/var/www/html/announcements.html 
<br /><strong>Step 5 of 6 - Starting (S)FTP of backup file to sftp://<IP Address>/net/<MachineName>/export/homes/rallybackup/ </strong> 
put: Access failed: Failure (directory-2018-06-27-02-00-10-dp.tgz) 
<br /><strong>Backup Failed!</strong><br />There was an error with the (S)FTP of the backup file - Exiting backup 
 
Answer:
This error indicates that the FTP put command failed to write the dump file to your remote FTP location. This may be a result of lack of disk space in the remote destination ftp folder, it may also be lack of write permissions issue with the username you specified in the control panel for the FTP action.

To recover the error, examine your destination FTP folder and make certain it has ample disk space. To confirm your username has proper write permissions you can use an FTP browser (such as WinSCP), log into that remote location and confirm the permissions are adequate. 

The dump file that's created can not be extracted or used. The dump file is created locally before transferred to the storage location by FTP. However, Agile Central On-Prem is immediately deleting this file after the backup. This is part of a cleanup process that ensure enough disk space on the On-Prem server. The dump file will be deleted, can not and should not be used.

To recover the above error, make certain you fix the Access problem to the FTP site , then perform the backup again.