Skip to content
Snippets Groups Projects
Select Git revision
  • 603c49f1da85f0bdceff88ee8e79ffa0d7955804
  • master default protected
  • update-renderer-class
3 results

cronlog.class.php

Blame
  • storage_helper.sh

    The script should be alwys started with the non privileged user (imlbackup).

    Without a parameter you get a help:

    imlbackup@backup-host:~$ ./storage_helper.sh 
    
    ---------- :: STORAGE :: storage-connector :: ----------
    
    SYNTAX:
    storage_helper.sh [function]
    
      backupstatus
        show all servers and their backup times
    
      register [hostname]
        add a slot for a backup client
    
      unregister [hostname] [statuscode]
        remove slot for a backup client.
        The statuscode is an integer of the return code.
    
      setactive
        Reactivate an inctave backup repo.
    
      setinactive
        Mark a backup repo as inactive.
        This prevents errors of missing backup data
        if a host is obsolete and was shut down.
    
      status
        show current reserved slots
    
      usage [full|[filter to hostname]] - DEPRECATED
        show used diskspace
        you can set a string to show additionally details if these hosts
        if you add "full" then details of all hosts will be shown

    What backup clients do

    Before a backup client send its data it wants to register. ./storage_helper.sh register [hostname]

    The exitcode is 0 if it got a free slot. And non-zero if all slots are in use (see iMaxConnections in config). The backup client will wait a random time until it gets a free slot to write its data.

    If the backup is finished it sends ./storage_helper.sh unregister [hostname]

    Admin tasks

    See current activity

    $ ./storage_helper.sh status
    
    ---------- :: STORAGE :: storage-connector :: ----------
    
    STATUS: 0 existing connection(s). Allowed maximum is 10.
    

    Backup status

    You get a table of all servers that sent backup data. There are listed

    • last backup with start time, end time, duration, existcode
    • age of the last backup (to see if a system does not send data anymore)
    • size of backup data
    • Each line per server is colored depending on backup status or time of last sent data
    $ ./storage_helper.sh backupstatus
    
    ---------- :: STORAGE :: storage-connector :: ----------
    
    STATUS: 0 existing connection(s). Allowed maximum is 10.
    
    This table shows the time and duration [s] of the last backup for each server.
    
      server                     | start                | end                  | duration |  rc | age [h] | size 
    -----------------------------------------------------------------------------------------------------------------------------
    . srv1.example.com            | 2022-09-19 23:04:14  | 2022-09-19 23:17:52  |      818 |   0 |      12 | 951G /netshare/restic-backup/srv1.example.com 
    . srv2.example.com            | 2022-09-19 23:03:06  | 2022-09-19 23:18:28  |      922 |   0 |      12 | 955G /netshare/restic-backup/srv2.example.com
    ...
    
    Legend
    . OK | ? not started | R running | D disabled | E error
    
    total : 26 servers
    errors: 0
    
    rc=0

    deactivate a backup folder

    If you delete a host but must keep its backup data then you can set it inactive. Then you don't get an error because of missing incoming data.

    To disable a backup target:

    $ ./storage_helper.sh setinactive
    
    ---------- :: STORAGE :: storage-connector :: ----------
    
    --- list of backup repositories
    /netshare/restic-backup/srv1.example.com (active)
    /netshare/restic-backup/srv1.example.com (active)
    ...
    Repo to deactivate >

    Enter the full path here, eg. /netshare/restic-backup/srv1.example.com and Return. Then comes an optional input for a hint - that is just for you and your team. Leave a message if the host is deprecated, the application was moved etc.

    In the backup status the deactivated target is listed with D = Disabled and is gray.

    BTW: the opposite way is possible to:

    ./storage_helper.sh setactive