Bug 31099

Summary: [DOCS] Export data tool - setup so database and configuration data can be downloaded
Product: Koha Reporter: David Nind <david>
Component: DocumentationAssignee: Bugs List <koha-bugs>
Status: Needs documenting --- QA Contact: Testopia <testopia>
Severity: enhancement    
Priority: P5 - low CC: vbovictor
Version: Main   
Hardware: All   
OS: All   
See Also: https://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=31098
https://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=14564
GIT URL: Change sponsored?: ---
Patch complexity: --- Documentation contact:
Documentation submission: Text to go in the release notes:
Version(s) released in:
Circulation function:

Description David Nind 2022-07-05 00:06:49 UTC
Add information to the manual on how to set up Tools > Export data so that the database and configuration backups are enabled and shown.
Comment 1 David Nind 2022-07-05 00:31:14 UTC
This is set up by:

1. Enabling the export of the database and configuration in the Koha instance koha-conf.xml file:
   . backup directory: <backupdir>/var/spool/koha/kohadev</backupdir>
   . enable database and configuration dumps (change 0 to 1):
     <!-- Enable the two following to allow superlibrarians to download
          database and configuration dumps (respectively) from the Export
          tool -->
     <backup_db_via_tools>1</backup_db_via_tools>
     <backup_conf_via_tools>1</backup_conf_via_tools>

2. Running koha-run-backups so that the downloadable backups are created and available. Example: koha-run-backups --days 2 --output /var/spool/koha

3. This can be done either as a one-off, or as a setup as a cronjob so that it runs regularly.

Areas in the manual to update or cross-reference:
- tools.rst: https://koha-community.org/manual/22.05/en/html/tools.html#export-data
- cron_jobs.rst: https://koha-community.org/manual/22.05/en/html/cron_jobs.html#backup - this covers a different option that is a separate script to run a database backup and set it up as a cron job, once the relative merits of the different approaches are worked out add across-reference to how to do backups with koha-run-backups 

Ideas for improvement:
- Look at adding something/section/guide about system administration activities and tasks (as opposed to these are the cron jobs available, and the Koha package commands).
Comment 2 victor 2022-07-05 01:49:25 UTC
No, because the backup is not finalizing.

$koha-dump instance
Dumping Koha site instace: