BBSTOREACCOUNTS(8)

✨ NAME ✨

bbstoreaccounts — the Box Backup store accounts manager 💅 she's the girl who runs the whole accounts situation on your store server, no cap

---

🌸 SYNOPSIS 🌸

bbstoreaccounts [-c config-file] command account-id
                [command-specific arguments]

---

🎀 DESCRIPTION 🎀

okay so bbstoreaccounts is literally THE tool for managing accounts on the store server. she can show you info about accounts, and she can create, change, and delete accounts on the store server. all of it. icon behavior 💖

she always takes at least 2 parameters: the command name and the account ID. some commands need extra parameters, and some commands have optional ones. iykyk 🦋

🧚 Options 🧚

• -c config-file — the config file to use for connecting to the store. the default is /etc/box/bbstored.conf, bestie. yes, she has a default, she's prepared like that ✨

👑 Commands 👑

the commands are what tell bbstoreaccounts what action to perform. slay.

🌈 check account-id [fix]

the check command verifies the integrity of the store account you gave her, and optionally fixes any corruptions. 🩹

note: it is recommended to run the 'simple' check command (without fix) before using the fix option. that way you get an overview of the extent of any problems before you attempt to fix them. look before you leap, gorgeous 🙈

💖 create account-id disc-set soft-limit hard-limit

creates a new store account with the parameters given. the parameters are as follows:

• account-id — the ID of the new account to be created. a 32-bit hexadecimal number. it cannot already exist on the server. no duplicates, we don't do that here 💀
• disc-set — the disc set from raidfile.conf(5) where the backups for this client will be stored. a number. each RAID-file set has a number in raidfile.conf. this number is what's used. 🗂️
• soft-limit — the soft limit is the amount of storage that the server will guarantee to be available for storage.
• hard-limit — the amount of storage that the server will allow, before rejecting uploads, and starting to eliminate old and deleted files to get back down to soft-limit. 🚫

🦋 delete account-id [yes]

deletes the account from the store server completely. removes all backups and deletes all references to the account in the config files. gone. poof. ✨

delete will ask for confirmation from the user when called. using the yes flag eliminates that need — super useful when you're deleting accounts from within a script or some other automated means. 0

⭐ info account-id

displays information about the given account. example:

[root]# bbstoreaccounts info 1
                  Account ID: 00000001
              Last object ID: 58757
                 Blocks used: 9864063 (38531.50Mb)
    Blocks used by old files: 62058 (242.41Mb)
Blocks used by deleted files: 34025 (132.91Mb)
  Blocks used by directories: 6679 (26.09Mb)
            Block soft limit: 11796480 (46080.00Mb)
            Block hard limit: 13107200 (51200.00Mb)
         Client store marker: 1139559852000000

explanation, bestie, here we go:

• Account ID — the account ID being displayed.
• Last Object ID — a counter that keeps track of the objects that have been backed up. this number refers to the last file that was written to the store. the ID is displayed as a decimal number, and the object ID can be converted to a path name to a file as follows: convert the number to hex (e.g.: 58757 => 0xE585); the last backed up file will be (relative from the client's store root): e5/o85.rfw. longer numbers infer more directories in the structure, so as an example 3952697264 as the last object ID gives 0xEB995FB0, which translates to a backup pathname of eb/99/5f/ob0.rfw. 🧮
• Blocks used — the number of blocks used by the store. the size in Mb depends on the number of blocks, as well as the block size for the disc set given in raidfile.conf(5). in this case the block size is 4096.
• Blocks used by old files — the number of blocks occupied by files that have newer versions in the store. ⚠️ this data is at risk for being removed during housekeeping.
• Blocks used by deleted files — the number of blocks used by files that have been deleted on the client. ⚠️ this data is at risk for being removed during housekeeping.
• Blocks used by directories — the number of blocks used by directories in the store.
• Block soft limit — the soft limit in blocks. the soft limit is the maximum guaranteed storage space available to the account. when housekeeping starts, and the old and deleted files are removed, they are removed in chronological order (oldest first), until the data used is less than the soft limit. 🕰️
• Block hard limit — the hard limit in blocks. the hard limit is the most amount of storage the server will allow in an account. any data above this amount will be rejected. housekeeping will reduce the storage use, so more data can be uploaded. 💪
• Client store marker — bbstored(8) uses this number to determine if it needs to rescan the entire store. if this number is different from the last time it checked, a rescan will take place. 👀

🫶 setlimit account-id soft-limit hard-limit

changes the storage space allocation for the given account. no server restart is needed. periodt 💅

parameters:

• account-id — the ID of the account to be modified.
• soft-limit — the soft limit is the amount of storage that the server will guarantee to be available for storage.
• hard-limit — the amount of storage that the server will allow before rejecting uploads and starting to eliminate old and deleted files to get back down to soft-limit.

---

🔥 EXAMPLES 🔥

create an account with ID 3af on disc set 0, with a 20GB soft-limit and a 22GB hard-limit:

bbstoreaccounts create 3af 0 20G 22G

alter existing account ID 20 to have a 50GB soft-limit and a 55GB hard-limit:

bbstoreaccounts setlimit 20 50G 55G

---

🍓 FILES 🍓

/etc/box/bbstored/accounts.txt

---

🧚 SEE ALSO 🧚

bbstored(8), bbstored-config(8)

---

💜 AUTHORS 💜

Ben Summers

Per Thomsen

James O'Gorman

---

and that's the whole page, bestie 🫶 this was Box Backup version 0.11, dated 06/06/2024, and honestly? iconic. go manage some accounts. mwah 💋