From 5339b82928f5433f1a33ea341a77faa1cd423ae5 Mon Sep 17 00:00:00 2001 From: kato Date: Sat, 21 Aug 2021 01:44:45 +0300 Subject: [PATCH] + Better README --- README.md | 63 ++++++++++++++++++++++++++++++++++++++++++++++++++++--- 1 file changed, 60 insertions(+), 3 deletions(-) diff --git a/README.md b/README.md index d6fc305..e9bc331 100644 --- a/README.md +++ b/README.md @@ -1,6 +1,63 @@ # DataHoard -#### About -DataHoard has been create for the sole reason of taking care of automatic mysql database backups. -This supports mailing for keeping track of +### About +DataHoard has been create for the sole reason of taking care of automatic mysql database backups. +This supports mailing for logging what is happening to the databases, future plans include supporting different services for updating the status of the databases, such as `Discord`, `Telegram`, `Slack` and more. + + +### Features + +[ ] Database Exporting +[ ] Log all errors to a final log +[ ] Email the log through email +[ ] Discord WebHook +[ ] Telegram Hook + +### How to Use +1. Setup the configuration file which is [This file](./config.example.json) and rename it into `config.json` instead of `config.example.json`. +2. Run the server by using the `npm start` command, this will start to run the program. +3. This does not run as a service and should be activated by a `cron` task, or on windows a `scheduler` task, this is completely up to you how you setup. + +Example Config File: ```js +{ + "options": { + "parallel_nodes": 2, // Run two database backups at a time + "parallel_node_tasks": 5, // Run 5 dumps at a time ( basically how many databases at once ) + "separate_into_tables": false // Separate all of the different tables into separate files + }, + + "smtp": { + "host": "", + "port": "", + "ssl": true, + "username": "", + "password": "", + "email_from": "" + }, + + "nodes": [ + { + "name": "Main Connection", + "debug": 0, + "log": true, + "mail": { + "enabled": true, + "email_to": "main@example.com", + "email_cc": [ + "first@example.com" + ] + }, + + "hostname": "localhost", + "username": "root", + "password": "", + "databases": { + // These two(2) can also be defined as Array for filtering. + "blacklist": ["mysql", "database_statistics", "not_important"], + "whitelist": null + } + } + ] +} +```