Welcome to CBB! Here are instructions for installing the program:
NOTE: Significant changes have been made between 0.8.1 and later versions, especially to the format of account and group files. Also, the way categories are handled has been changed as well. IT'S HIGHLY RECOMMENDED YOU BACKUP YOUR CBB DATA BEFORE ATTEMPTING TO UPGRADE!
Did I mention that you should BACKUP YOUR CBB DATA BEFORE UPGRADING?
- Requirements
Tested for Linux Redhat 6.2, but should work just fine with most UNIX systems.
Perl & Tcl/Tk: CBB required both Perl and Tcl/Tk to run. These programs are now provided as standard software on most Linux/UNIX distributions these days. If you don't have them, you can find and download them from www.perl.org and www.tcltk.org. Make sure that both programs are in your PATH.
- Installation
BACKUP YOUR CBB DATA BEFORE UPGRADING!
Versions of CBB later than 0.8.1 install in their own cbb-<version> libdir, but it's still a good idea to back up your current CBB installation prior to upgrading.
Neither Perl nor Tcl/Tk code needs to be compiled. The only required step is to tell the programs where they will be installed: some of the programs need to know where to find the other components. To do this, run: './configure' in this directory. By default, CBB will copy the main program to /usr/local/bin/cbb, and will create a library directory at /usr/local/lib/cbb-<version>, where <version> is the current major version.
***You will probably need root permission to install CBB at that location.***
Alternatively, you can specify a directory prefix under which to install the bin and lib files by specifying the configure "--prefix" option.
Example:
./configure --prefix=/opt/local
Note that relative paths will not work correctly with this option; always use absolute paths.
Please refer to the INSTALL file for more details.
Once you have configured the program files, you can install the programs by running 'make install'. If you have chosen to place CBB in a root-access-only location, it is necessary to 'su root' before running 'make install'.
- Upgrading
BACKUP YOUR CBB DATA BEFORE UPGRADING!
Versions <= 0.8.1:
rm ~/.cbbcur.tcl
Start CBB. Create new account (File->Make New Account) or, if you don't care about groups, or create new group (File->Make New Group) then create a new account. Select Import File->CBB 0.8, double-click account to import. Save each account. Manually copy "Categories" file to "~/.cbb/<groupname>/<groupname>.cat". Note that account entries in the category file will no longer be valid. You can add these manually using a [group.account] format.
Versions <= 0.9.4:
rm ~/.cbbcur.tcl
Start CBB. Create new account (File->Make New Account) or, if you don't care about groups, or create new group (File->Make New Group) then create a new account. Select Import File->CBB 0.9, double-click account to import. Save each account. Manually copy "Categories" file to "~/.cbb/<groupname>/<groupname>.cat". Note that account entries in the category file will no longer be valid. You can add these manually using a [group.account] format.
Versions == 0.9.4p1:
This patch instituted default data file storage in ~/.cbb. Therefore, you MUST move this out of the way before running newer versions of CBB:
cp -a ~/.cbb ~/.cbb-old
rm -rf ~/.cbb
rm ~/.cbbcur.tcl
Proceed as with version 0.9.4, above.