Better Readme

This commit is contained in:
Janic Voser 2022-07-04 23:40:55 +02:00
parent ab812ee0ba
commit 8730667cea

View File

@ -1,3 +1,70 @@
# TUBS # TUBS
The Ultimate Backup Script The Ultimate Backup Script
# Features
| ID | NAME | STATE | Version |
|:---: |:---: |:---: |:---: |
| 1 | Backup Directory | Working | 1.0 |
| 2 | Incremental Backup | Working | 1.1 |
| 3 | Initialisation | Working | 2.0 |
| 4 | Quick Help | Working | 2.0 |
| 5 | Remote Backup Location (SSH) | Working | 3.0 |
| 7 | Multiple Configuration files | Planned | 4.0 |
| 8 | MYSQL Backup | Planned | 5.0 |
# Repository Structure
```
.
├── .git - Git stuff can be ignored
├── .gitignore - File to ignore when pushing
├── .ignoreme - Inspirational Files OSS(Cranix) Server
│   └── Bash-OSS-Backup - Original file
├── LICENSE - Apache 2.0 License
├── README.md - The file you are currenly reading
├── TEST - Tests can be ignored
├── tubs.config - The configuration file
└── tubs.sh - The accual backup script
```
# Usage
## File Structure on your system
```
/ - Root of your filesystem
├── var - stuff to backup (example)
└── etc - configuration directory
├── tubs.sh - Backup Script
   └── tubs.config - Example configuration
```
1. Create a folder in /etc with the name "tubs"
2. In there(/etc/tubs/) you have to copy the [scirpt](./tubs.sh)
3. Now create an [configuration file named "tubs.config"](./tubs.config) in this directory you can see an example in this repo. If the path of this file is not exactly /etc/tubs/tubs.config, then you need to adjust this in the [script](./tubs.sh) on Line 16 (CONFIG_FILE="path/to/file")
## Execution
1. Run the script with the "init" argument to create the directory structure in the destination
```
/etc/tubs/tubs.sh init
```
2. Run the script with the "backup" argument to run the backup job
```
/etc/tubs/tubs.sh backup
```
You will get colorful output if something does not work.
## Cron Job
Create an cron job to run this script every day (or whenever you want)
```
crontab -e # to edit (then 'i': insert, ':wq!': save and quit)
10 * * * * /etc/tubs/tubs.sh backup # every hour at 10"
0 */4 * * * /etc/tubs/tubs.sh backup # every 4 hours at 0"
0 9-17 * * * /etc/tubs/tubs.sh backup # every hour at 0" between 9 and 17
0 2 * * * /etc/tubs/tubs.sh backup # daily at 2am
0 0 * * MON /etc/tubs/tubs.sh backup # every Monday at 0am
0 0 * * 1-5 /etc/tubs/tubs.sh backup # daily from Monday to Friday at 0am
0 0 * * 0 /etc/tubs/tubs.sh backup # weekly on Sunday
0 0 1 * * /etc/tubs/tubs.sh backup # monthly (1rst day at 0am)
0 0 1 */3 * /etc/tubs/tubs.sh backup # every quarter (1rst day at 0am)
0 0 1 1 * /etc/tubs/tubs.sh backup # yearly (01/01)
```
# Issues
If you find an Issue, feel free to create an Issue or contact [me](mailto:janic@voser.cloud), maby I see your message and if you have even more luck there could be the slight possibility that I know a solution to your Issue.