From 0768be51831f61a0622ef85a310ba47c3bc78b18 Mon Sep 17 00:00:00 2001 From: James O'Gorman Date: Wed, 27 Feb 2008 18:50:44 +0000 Subject: * Move all commands from bin to sbin on Unix platforms * Update all associated docs and contributed distribution files --- documentation/adminguide.xml | 46 ++++++++++++++++++++++---------------------- 1 file changed, 23 insertions(+), 23 deletions(-) (limited to 'documentation') diff --git a/documentation/adminguide.xml b/documentation/adminguide.xml index d3552725..edb0a58c 100644 --- a/documentation/adminguide.xml +++ b/documentation/adminguide.xml @@ -96,11 +96,11 @@ cd boxbackup-0.10-server-darwin8.5.0 mkdir /tmp/boxbackupRepository # Create the directory chown _bbstored /tmp/boxbackupRepository/ # Change the owner to the new boxbackup daemon user -/usr/local/bin/raidfile-config /etc/box/ 1024 /tmp/boxbackupRepository +/usr/local/sbin/raidfile-config /etc/box/ 1024 /tmp/boxbackupRepository #substitute 1024 with the desired blocksize #substitute /tmp/boxbackupRepository with a directory that exists where you want the backup store located -#/usr/local/bin/raidfile-config --help shows you the options +#/usr/local/sbin/raidfile-config --help shows you the options Then create the configuration file /etc/box/bbstored.conf The hostname is tricky as it is used for two things: The name of the @@ -111,7 +111,7 @@ chown _bbstored /tmp/boxbackupRepository/ # Change the owner to the ListenAddresses directive in the /etc/box/bbstored.conf file. - /usr/local/bin/bbstored-config /etc/box hostname _bbstored + /usr/local/sbin/bbstored-config /etc/box hostname _bbstored This last step outputs 5 instructions that you must execute to the letter. A lot of questions are raised on the mailing list because @@ -164,7 +164,7 @@ chown _bbstored /tmp/boxbackupRepository/ # Change the owner to the To setup the basic key structure, do the following: - /usr/local/bin/bbstored-certs ca init + /usr/local/sbin/bbstored-certs ca init (See OpenSSL notes if you get an OpenSSL error) @@ -181,7 +181,7 @@ chown _bbstored /tmp/boxbackupRepository/ # Change the owner to the request (CSR) for you. Transfer it to the machine with your CA, then do: - /usr/local/bin/bbstored-certs ca sign-server hostname-csr.pem + /usr/local/sbin/bbstored-certs ca sign-server hostname-csr.pem This signs the certificate for the server. Follow the instructions in the output on which files to install on the server. @@ -199,7 +199,7 @@ chown _bbstored /tmp/boxbackupRepository/ # Change the owner to the 0, for example, 1 or 75AB23C. Then on the backup store server, create the account with: - /usr/local/bin/bbstoreaccounts create 75AB23C 0 4096M 4505M + /usr/local/sbin/bbstoreaccounts create 75AB23C 0 4096M 4505M This looks complicated. The numbers are, in order: @@ -261,7 +261,7 @@ chown _bbstored /tmp/boxbackupRepository/ # Change the owner to the Sign this CSR with this command: - /usr/local/bin/bbstored-certs ca sign 75AB23C-csr.pem + /usr/local/sbin/bbstored-certs ca sign 75AB23C-csr.pem Don't forget to check that the embedded account number is correct! Then send the two files back to the user, as instructed by @@ -345,7 +345,7 @@ touch /var/log/raidfile the configuration files and generate a private key and certificate request. - /usr/local/bin/bbackupd-config /etc/box lazy /usr/local/sbin/bbackupd-config /etc/box lazy 999 hostname /var/bbackupd /home @@ -407,7 +407,7 @@ touch /var/log/raidfile basic bbackupd configuration. You can then run the daemon (as root) by running - /usr/local/bin/bbackupd, and of course, adding it + /usr/local/sbin/bbackupd, and of course, adding it to your system's startup scripts. The first time it's run it will upload everything. Interrupting it and restarting it will only upload files which were not uploaded before - it's very @@ -517,7 +517,7 @@ touch /var/log/raidfile here -- they may be different for your system. - /usr/local/bin/bbackupd-config /etc/box lazy 51 server.example.com /var/bbackupd /home /etc/samba + /usr/local/sbin/bbackupd-config /etc/box lazy 51 server.example.com /var/bbackupd /home /etc/samba Setup bbackupd config utility. @@ -579,7 +579,7 @@ What you need to do now... more files will be backed up. You want to know about this. 6) Start the backup daemon with the command - /usr/local/bin/bbackupd + /usr/local/sbin/bbackupd in /etc/rc.local, or your local equivalent. Note that bbackupd must run as root. @@ -1304,7 +1304,7 @@ BackupLocations The command line syntax is: - /usr/local/bin/bbackupctl [-q] [-c config-file] command + /usr/local/sbin/bbackupctl [-q] [-c config-file] command The -q option reduces the amount of output the program emits, and -c allows an alternative configuration file to be @@ -1358,7 +1358,7 @@ BackupLocations Use bbackupd-config to write a configuration file in snapshot mode, and then run the following command as a cron job. - /usr/local/bin/bbackupctl -q sync + /usr/local/sbin/bbackupctl -q sync This will cause the backup daemon to upload all changed files immediately. bbackupctl will exit @@ -1376,7 +1376,7 @@ BackupLocations for this account. Either use the usage command in interactive mode, or type: - /usr/local/bin/bbackupquery -q usage quit + /usr/local/sbin/bbackupquery -q usage quit to show the space used as a single command. @@ -1388,11 +1388,11 @@ BackupLocations the limits. To display the space used on the server for an account, use: - /usr/local/bin/bbstoreaccounts info 75AB23C + /usr/local/sbin/bbstoreaccounts info 75AB23C To adjust the soft and hard limits on an account, use: - /usr/local/bin/bbstoreaccounts setlimit 75AB23C new-soft-limit new-hard-limit + /usr/local/sbin/bbstoreaccounts setlimit 75AB23C new-soft-limit new-hard-limit You do not need to restart the server. @@ -1538,7 +1538,7 @@ query > regularly, and check its output. You can run the command manually as follows: - /usr/local/bin/bbackupquery "compare -a" quit + /usr/local/sbin/bbackupquery "compare -a" quit This command will report all the differences found between the store and the files on disc. It will download everything, so may @@ -1561,7 +1561,7 @@ query > If you would like to do a "quick" check which just downloads file checksums and compares against that, then run: - /usr/local/bin/bbackupquery "compare -aq" quit + /usr/local/sbin/bbackupquery "compare -aq" quit However, this does not check that the file attributes are correct, and since the checksums are generated on the client they @@ -1595,7 +1595,7 @@ query > Type: - /usr/local/bin/bbackupquery + /usr/local/sbin/bbackupquery to run it in interactive mode. @@ -1628,7 +1628,7 @@ query > Firstly, run bbackupquery in interactive mode. It behaves in a similar manner to a command line sftp client. - /usr/local/bin/bbackupquery + /usr/local/sbin/bbackupquery Then navigate to the directory containing the file you want, using list, cd and pwd. @@ -1744,14 +1744,14 @@ Object ID 0000437e fetched successfully. First, run the check utility, and see what errors it reports. - /usr/local/bin/bbstoreaccounts check 1234 + /usr/local/sbin/bbstoreaccounts check 1234 This will take some time, and use a fair bit of memory (about 16 bytes per file and directory). If the output looks plausible and reports errors which need fixing, run it again but with the fix flag: - /usr/local/bin/bbstoreaccounts check 1234 fix + /usr/local/sbin/bbstoreaccounts check 1234 fix This will fix any errors, and remove unrecoverable files. Directories will be recreated if necessary. @@ -1841,7 +1841,7 @@ Object ID 0000437e fetched successfully. configuration file locations to daemons and programs. For example - /usr/local/bin/bbstored /some/other/dir/bbstored.config /usr/local/bin/bbackupquery -c /some/other/dir/bbackupd.config + /usr/local/sbin/bbstored /some/other/dir/bbstored.config /usr/local/sbin/bbackupquery -c /some/other/dir/bbackupd.config (daemons specify the name as the first argument, utility programs with the -c option). -- cgit v1.2.3