rewrote help section
This commit is contained in:
parent
26524c97ed
commit
ca190c89bb
107
seafbackup.sh
107
seafbackup.sh
@ -96,40 +96,79 @@ exitError () {
|
|||||||
|
|
||||||
# display script help information
|
# display script help information
|
||||||
scriptHelp () {
|
scriptHelp () {
|
||||||
printf "\n"
|
printf "\n${cyan}%s\n" "--------------------------------------------------------------------------------"
|
||||||
printf "${magenta}%s usage instructions:${norm}\n\n" "$scriptName"
|
|
||||||
printf "This script performs a backup of your Seafile system assuming a fairly standard set up as per the documentation. Full details about this script can be found in the repo wiki at ${yellow}https://git.asifbacchus.app/asif/seafileBackup/wiki${norm}\n\n"
|
printf "Usage:${norm} %s [parameters]\n\n" "$scriptName"
|
||||||
printf "${magenta}Usage:${norm} %s ${cyan}[parameters]${norm}\n\n" \
|
printf "${cyan}Parameters ${yellow}(default value):${norm}\n"
|
||||||
"$scriptName"
|
printf "There are NO mandatory parameters. If a parameter is not "
|
||||||
printf "${magenta}Parameters (default in brackets):${norm}\n"
|
printf "supplied, it's\n"
|
||||||
printf "There are NO mandatory parameters. If a parameter is not supplied, it's default value will be used. In the case of a switch parameter, it will be remain deactivated if not specified.\n\n"
|
printf "default value will be used. In the case of a switch parameter, "
|
||||||
printf "${yellow}script related\n"
|
printf "it will\n"
|
||||||
printf "${cyan}-c, --config, --details (scriptPath/seafbackup.details)\n"
|
printf "remain deactivated if not specified.\n\n"
|
||||||
printf "${norm}Path to the '.details' configuration key/value pair file for this script.\n"
|
|
||||||
printf "${cyan}-h, -?, --help\n"
|
printf "${magenta}script related\n"
|
||||||
printf "${norm}This help screen.\n"
|
printf "${cyan}-c, --config, --details${norm}\n"
|
||||||
printf "${cyan}-l, --log (scriptPath/scriptName.log)\n"
|
printf "Path to the configuration key/value pair file for this script.\n"
|
||||||
printf "${norm}Path where the log file for this script should be written.\n"
|
printf "${yellow}(scriptPath/seafbackup.details)${norm}\n\n"
|
||||||
printf "${cyan}-v, --verbose (normal output, option is OFF)\n"
|
printf "${cyan}-h, -?, --help${norm}\n"
|
||||||
printf "${norm}Log borg output with increased verbosity including listing EVERY file processed. Use this sparingly since your log file can get very large, very quickly! This is a switch value, specifying it will turn the option ON.\n\n"
|
printf "This help screen.\n\n"
|
||||||
printf "${yellow}503 functionality\n"
|
printf "${cyan}-l, --log${norm}\n"
|
||||||
printf "${cyan}-5, --use-503 (do NOT copy, option is OFF)\n"
|
printf "Path to write log file.\n"
|
||||||
printf "${norm}Copy an 'error 503' page to your webroot. Your webserver can then scan for that file and display it (details in wiki for how to set that up). This is a switch value, specifying it will instruct the script to copy the error page.\n"
|
printf "${yellow}(scriptPath/scriptName.log)${norm}\n\n"
|
||||||
printf "${cyan}--503-path (scriptPath/503_backup.html)\n"
|
printf "${cyan}-v, --verbose${norm}\n"
|
||||||
printf "${norm}Path to the file you want copied to your webroot as the 'error 503' page during backup operations.\n"
|
printf "Log borg output with increased verbosity (list all files). "
|
||||||
printf "${cyan}-w, --webroot (/usr/share/nginx/html)\n"
|
printf "Careful! Your\n"
|
||||||
printf "${norm}Path to your webroot or wherever you want the 'error 503' file copied during backups.\n\n"
|
printf "log file can get large very quickly! This is a switch value, "
|
||||||
printf "${yellow}seafile related\n"
|
printf "specifying it\n"
|
||||||
printf "${cyan}-d, --data, --datadir, --seafdata (/var/seafile)\n"
|
printf "will turn the option ON.\n"
|
||||||
printf "${norm}Path to your seafile DATA base/root directory. All your seafile data exists under this path.\n"
|
printf "${yellow}(normal output, option is OFF)${norm}\n\n"
|
||||||
printf "${cyan}-o, --offline (leave seafile running, OFF)\n"
|
|
||||||
printf "${norm}If you want this script to stop your seafile systemd services and start them up again after the backup, then specify this option. This is a switch value.\n"
|
printf "${magenta}503 functionality\n"
|
||||||
printf "${cyan}-p, --seaf, --seafdir (/opt/seafile)\n"
|
printf "${cyan}-5, --use-503${norm}\n"
|
||||||
printf "${norm}Path to your seafile PROGRAM base/root directory. All your seafile configuration and program files exist under this path.\n"
|
printf "Copy an 'error 503' page to your webroot for your webserver to "
|
||||||
printf "${cyan}--seafile-service (seafile.service)\n"
|
printf "find. This is a\n"
|
||||||
printf "${norm}The name of your seafile systemd service. Only needed if you want the script to perform an offline backup and you are not using the default service name.\n"
|
printf "switch value, specifying it will instruct the script to copy the "
|
||||||
printf "${cyan}--seahub-service (seahub.service)\n"
|
printf "error page.\n"
|
||||||
printf "${norm}The name of your seahub (web) systemd service. Only needed if you want the script to perform an offline backup and you are not using the default service name.\n\n"
|
printf "${yellow}(do NOT copy, option is OFF)${norm}\n\n"
|
||||||
|
printf "${cyan}--503-path${norm}\n"
|
||||||
|
printf "Path to the file you want copied to your webroot as the 'error "
|
||||||
|
printf "503' page during\n"
|
||||||
|
printf "backup operations.\n"
|
||||||
|
printf "${yellow}(scriptPath/503_backup.html)${norm}\n\n"
|
||||||
|
printf "${cyan}-w, --webroot${norm}\n"
|
||||||
|
printf "Path to where the 'error 503' file should be copied during "
|
||||||
|
printf "backups.\n"
|
||||||
|
printf "${yellow}(/usr/share/nginx/html)${norm}\n\n"
|
||||||
|
|
||||||
|
printf "${magenta}seafile related\n"
|
||||||
|
printf "${cyan}-d, --data, --datadir, --seafdata${norm}\n"
|
||||||
|
printf "Path to your seafile DATA base/root directory."
|
||||||
|
printf "${yellow}(/var/seafile)${norm}\n\n"
|
||||||
|
printf "${cyan}-o, --offline${norm}\n"
|
||||||
|
printf "Stop your seafile systemd services and start them up again after "
|
||||||
|
printf "the backup.\n"
|
||||||
|
printf "This is a switch value.\n"
|
||||||
|
printf "${yellow}(leave seafile running, OFF)${norm}\n\n"
|
||||||
|
printf "${cyan}-p, --seaf, --seafdir${norm}\n"
|
||||||
|
printf "${norm}Path to your seafile PROGRAM base/root directory.\n"
|
||||||
|
printf "${yellow}(/opt/seafile)${norm}\n\n"
|
||||||
|
printf "${cyan}--seafile-service${norm}\n"
|
||||||
|
printf "The name of your seafile systemd service. Use with '--offline' "
|
||||||
|
printf "when using a\n"
|
||||||
|
printf "non-default service name.\n"
|
||||||
|
printf "${yellow}(seafile.service)${norm}\n\n"
|
||||||
|
printf "${cyan}--seahub-service${norm}\n"
|
||||||
|
printf "The name of your seahub (web) systemd service. Use with "
|
||||||
|
printf "'--offline' when using\n"
|
||||||
|
printf "a non-default service name.\n"
|
||||||
|
printf "${yellow}(seahub.service)${norm}\n\n"
|
||||||
|
|
||||||
|
printf "More details and examples of script usage can be found in the "
|
||||||
|
printf "repo wiki at\n"
|
||||||
|
printf "${yellow}https://git.asifbacchus.app/asif/seafileBackup.git"
|
||||||
|
printf "/wiki${norm}.\n"
|
||||||
|
|
||||||
|
printf "${cyan}%s${norm}\n\n" "--------------------------------------------------------------------------------"
|
||||||
}
|
}
|
||||||
|
|
||||||
# control seafile services (systemd)
|
# control seafile services (systemd)
|
||||||
|
Loading…
Reference in New Issue
Block a user