 |
|
|
|
|
|
|
|
|
|
|
 |
 |
 |
 |
 |
 |
 |
 |
 |
 |
|
|
|
This file serves as the method to get you started using banal.
http://www.starnix.com/banal/dl/
rpm -ivh banal-*
This will install both the client and server RPMs. You can install just the client RPM on other machines (but you'll have to set the BKPORT environment variable.
If you see a warning like "chkconfig: command not found", then you'll have to put the links from /etc/rc.d/init.d/banal to the various runlevels.
The following commands (as root) should do the trick:
ln -s ../init.d/banal /etc/rc.d/rc{3,4,5}/S95banal
ln -s ../init.d/banal /etc/rc.d/rc{0,1,2,6}/K05banal
If you have no books setup, an empty set will be placed in:
/home/banal/books
As a non-root user, untar the tarball in a directory of your choice with the command (for example, we'll assume the you chose /usr/local/banal/banal-<VERSION> for the installation and /usr/local/banal/books as the final resting place for your data):
cd /usr/local/banal
gzip -dc banal-<VERSION>.tgz | tar xvf -
If you don't already have some books, you can start with the empty books that come with the tarball. Do this (or something equivalent) to make a copy:
cp -avr banal-<VERSION>/samples/empty books
/etc/rc.d/init.d/banal start
With the tar balled version you'd have to run a command similar to:
/usr/local/banal/banal-<VERSION>/bkd -b /usr/local/banal/books >BKLOG 2>&1 &
If you did the tarball installation, you will either need to add /usr/local/banal/banal-<VERSION>/bin to your PATH environment variable or read the user guide on installing the client.
bk client FBI
Fill in the form, save the file and exit the editor. If you filled in all of the required fields, everything should be fine. If you get a message about some fields not being a valid value for the category (like State and Country) just leave them blank until you figure out what the category values are.
Now the FBI is a valid client ID, change the setting for the CompanyID with:
bk setting /UserInfo/CompanyID
Change the value field to FBI (or whatever you picked), save and exit the editor.
bk help setting
General help is available with:
bk help
A list of commands is available with:
bk help commands
You can't use an ID from another table until it is defined. For example, invoices, require a Client ID. You must first define the client with bk client SOME_ID and then you can use it in an invoice.
Create the invoice, then create the charges (line items).
When creating a new invoice, charge, timesheet, ... leave the ID as 'new' if you don't care what the ID is. This will keep you from having to come up with a new ID everytime. I only explicitly define them for Clients.
Read the user guide's information on how to add values to a category.
When you're ready to start adding your own tax codes, read the user quide's information on TaxCodes. HINT: You have to make the Tax a legal value in the Category table and then you have to define its percentage and behaviour in the Setting table.
Read the user guide.
Ask questions on the mailing list. Simply send an e-mail to banal-request@starnix.com with the subject of the message (NOT the body) saying: subscribe
An e-mail will be sent to you asking you to confirm the request. Follow the instructions sent. An e-mail with your password will be sent upon confirmation. This will be needed later.
Send your questions and comments to: banal@starnix.com