By admin, on April 18th, 2011%
We have created a new sql-ledger virtual appliance using virtual box. Here are the details:
- Built using: Sun’s virtual box
- RAM: 256MB
- Hard disk: 10 GB
- Guest operating system: FreeBSD 8.2
- Packages: Enhanced SQL-Ledger, Postgresql 8.4.7, Perl 5.10.1, git 1.7.3, phpPgAdmin 5.0.2, Lighttpd 1.4.28, Postfix 2.8
- Root password: none
- Postgresql super user: pgsql, password: none
- SQL-Ledger admin.pl password: none
Quick Install Instructions
- Download virtual box for your operating system.
- Download SQL-Ledger virtual appliance from your order confirmation email. (filename: FreeBSD-8.2.ova)
- Import this virtual appliance into virtual box using menu option: File->Import Appliance.
- Change network settings to ‘Bridged’ using Machine->Settings menu option. Select the network interface (eth0, wlan0 etc.) to bridge this appliance with.
- Boot virtual appliance using ‘Start’ button on virtualbox toolbar.
- Watch booting process carefully and note down the virtual appliance IP address.
- In your browser, visit http://appliance-ip-address/ for home page.
- Visit http://appliance-ip-address/ledger123/ and login to pre-installed database with user ‘admin@ledger123′ and without any password.
For support, send email to support@ledger123.com.
By admin, on January 21st, 2011%
This virtual appliance comes pre-configured with our enhanced SQL-Ledger as well as LedgerSMB. Follow these instructions to get up and running:
Summary
- This virtual appliance has been built using FreeBSD 7.3. You do not need to know or install FreeBSD to use it.
- Download and uncompress this virtual appliance (url is in your order confirmation email.)
- Click ‘New’ to run virtual machine creation wizard and create a virtual machine with following specs:
- Name: SQL-Ledger (or whatever)
- Operating system: BSD
- Version: FreeBSD
- Memory: 256 MB
- Boot Hard Disk: Use existing hard disk (Browse to add the uncompressed hard disk image in above step)
- Change the network settings to ‘Bridged’
- Boot your virtual machine.
- Root password: ledger123
- IP Address: Login to appliance from console using root/ledger and issue ‘ifconfig’ to find the appliance IP address.
- Using your browser visit http://appliance.ip-address/. Here you will find links to sql-ledger, sql-ledger admin and phpPgAdmin.
- There is no password for sql-ledger admin screen. (You can set password after login)
- Create your datasets using ‘sql-ledger’ postgres user. This user does not require any password.
Continue reading VirtualBox SQL-Ledger Appliance
By admin, on January 19th, 2011%
It is easy to import CSV data into sql-ledger which is not support by ‘Import’ menu.
- Export your data from spreadsheet or software in a suitable CSV format. Assume it is named “/tmp/cities.csv”.
- Create a suitable table if it does not already exist.
CREATE TABLE customertmp (id INTEGER, city TEXT);
- Add following lines at the top of your CSV file (adjust for your needs).
COPY customertmp(id, city) FROM STDIN CSV HEADER;
Your final csv file should look like this:
COPY customertmp(id,city) FROM STDIN CSV HEADER;
id,city
"11733","Newyork"
"11748","London"
"11752","Paris"
- Import data using following command:
psql -U postgres your-db-name < /tmp/cities.csv
Notes:
- You can directly import into standard sql-ledger tables but I find it easier and less error prone to import data into a temporary stagging table and then use INSERT/UPDATE statements to update standard tables.
- This method works with LedgerSMB databases as well.
- Gnumeric has more flexiable CSV export facility than openoffice calc. (On my Ubuntu 10.04 it took just 'apt-get install gnumeric' to get it installed.)
By admin, on January 17th, 2011%
LedgerSMB is particularly difficult to install and configure for newbies due to its dependence on few CPAN Perl modules, fixes required and creation/configuration of a central database to store users.
Our sql-ledger vmware virtual appliance now comes with LedgerSMB 1.2.21. (with our enhancements.) It is fully configured with a blank dataset and one user. You just download it and start using it immediately. (You can create more datasets and users yourself through web interface.)
You can easily upgrade to the newer version (as well as to our new enhancements) by running ‘git pull’ in the ‘/usr/local/www/data/ledgersmb/’ folder.
Order this appliance from our order page. Your order confirmation email will include the download link.
Instructions on using vmware appliance are here.
By admin, on January 16th, 2011%
This virtual appliance comes pre-configured with our enhanced SQL-Ledger. Follow these instructions to get up and running:
Summary
- This virtual appliance has been built using FreeBSD 6.4. You do not need to know or install FreeBSD to use it.
- Root password: none
- IP Address: Login to appliance from console using root (without password) and issue ‘ifconfig’ to find the appliance IP address.
- Using your browser visit http://appliance.ip-address/. Here you will find links to sql-ledger, sql-ledger admin and phpPgAdmin.
- There is no password for sql-ledger admin screen. (You can set password after login)
- Create your datasets using ‘sql-ledger’ postgres user. This user does not require any password.
Continue reading Vmware Virtual Appliance
By admin, on January 15th, 2011%
You can export data from your sql-ledger tables using following command in ‘psql’.
COPY (SELECT id, partnumber, description FROM parts ORDER BY partnumber) TO '/tmp/parts.csv' CSV HEADER;
By admin, on January 6th, 2011%
SQL-Ledger is a browser-based application. Anybody familiar with internet browsing should feel at home using sql-ledger.
All Sql-Ledger user-interface elements (menu, forms, reports) are displayed using standard HTML. You can use any modern browser to run the application. Firefox is recommended.
Main menu
Sql-ledger menu is displayed in left frame. Menu items can be collapsed into sub menus or individual menu items by clicking them.

Update button
Lookup information (customer/vendor address) and calculations (invoices subtotals etc) are not automatically updated on a form after a change. You need to click the Update button to do these.
Update button does not store anything into database. It just looks up appropriate missing information, does any pending calculations, and adds one more line on multi-line forms like invoices and orders.
It is safe to click Update button as many times as you like. You can also trigger update action by pressing ‘Enter’ key in any text field.

Adding, changing and deleting records
You can add a new transaction (order, invoice etc.) or a master record (part, customer, vendor etc.) directly through the module menu.
To change or delete a transaction or master record, you use the Reports menu option in the sub menu. Once you display the report by clicking the Continue button, you can use the hyper links on report to change or delete the record.
Example
For example to add a new sale invoice, you click AR–Sale Invoice. To change or delete an existing invoice, you click AR–Reports–Transactions. A selection form is displayed where you can specify date range and include/exclude columns.

When you click Continue, all existing invoices are displayed. Now you can open any existing invoice by clicking invoice number hyper link.

Customers and vendors lookup
There are two ways customer / vendor can be selected on an invoice (or order, quotation).
Method 1
By default customer and vendors are displayed as drop down menus on invoices, orders and quotations.External Link

Method 2
If you have a large number of customers and/or vendors, it is more convenient to select customer by typing its number or name. To do so, goto Preferences and change Dropdown Limit to 0. Now invoice form will allow you to enter customer number or part of customer name to select it.

Parts Lookup
There are three possible ways you can lookup a part on an invoice, order or quotation.
Method 1: Specify Part Number
You can lookup a part by its number.
If you enter partial number, all parts matching this number will be displayed.
You can select the required part and click Continue to return back to invoice screen.
Method 2: Specify Part Description (Name)
You can enter complete or partial part description. If there are more than one part descriptions which match, these will be displayed.
Method 3: Specify Group to List Items in the Group
Departments, warehouses and projects
You can classify your transactions by specifying department, warehouse or project during transaction entry. More details on using these features can be found else where on this wiki.
The important thing to note is that you need to define at lease one department, warehouse or project before the respective drop down list will appear on transaction forms.
Item notes, serial numbers, delivery date, packaging information on invoice lines
By defaults line items on invoices show most commonly used columns.
If you want to enter more information against each line item, check the box next to Description heading on line items. Now when you enter an item code and update, you will see additional columns for delivery date, item notes, serial number, project, packaging, net weight, gross weight and volume.
By admin, on January 6th, 2011%
We have enhanced sql-ledger csv data import function. Now you can import following additional transactions. You already have these scripts if you are using our enhanced sql-ledger version.
- Sales invoices with payments (enhanced built-in functionality)
- Receipts and payments
- AR/AP transactions
- General Ledger
- Purchase Orders
- Parts and Price lists
- Customers and Vendors
- Chart of Accounts
These import scripts can be used with LedgerSMB with some minor changes. To get this code visit our git repository.
By admin, on January 6th, 2011%
Sales invoices can be imported from text files.
- Format your data
For list of additional data columns that can be imported see step 4.
invnumber,transdate,duedate,customernumber,curr,invoicedescription,partnumber,qty,sellprice,employeenumber,AR,department,warehouse
A100,10/12/2008,10/30/2008,AE001,GBP,Invoice description comes here,B001,10,102,E-001,1100,HARDWARE,LONDON
A100,10/12/2008,10/30/2008,AE001,GBP,Invoice description comes here,F003,6,69,E-001,1100,HARDWARE,LONDON
A101,10/12/2008,10/31/2008,CP002,GBP,Test description,F003,2,32,E-002,1100,SERVICES,PARIS
A102,10/13/2008,11/1/2008,ER003,GBP,Sale of goods,T007,6,12,E-003,1100,SERVICES,LONDON
A103,10/14/2008,11/2/2008,SP007,GBP,Sale,K001,12,32,E-004,1100,HARDWARE,PARIS
(The last column AR is accounts receivable account number which is 1100 in UK chart of accounts)
If your data contains invoices with more than one part, repeat the row with same invoice header information and change the part number and price information. Sql-ledger will import all these rows as a single invoice. (See invoice number A100 above)
- Upload and preview
Using Import–Sales Invoices menu option, upload this file into Sql-Ledger. You will be shown what will be imported before actual import is done. At this point you can check and uncheck the invoices to be imported.

- Confirm data import
When you click the Import Sales Invoices button, invoices will be imported. You will be show which invoices were imported successfully.

- Additional data which can be imported
The sample csv file provided above contains only the most commonly used columns. Here is the complete list.
transdate
invnumber
customernumber
curr
duedate
employeenumber
ordnumber
quonumber
datepaid
shippingpoint
shipvia
waybill
terms
notes
intnotes
language_code
ponumber
cashdiscount
discountterms
partnumber
description
sellprice
discount
qty
unit
serialnumber
projectnumber
deliverydate
AR
taxincluded
By admin, on January 6th, 2011%
- Format your data according to following sample:
partnumber,description,unit,partsgroup,listprice,sellprice,lastcost,rop,bin,image,drawing,notes
B002,"Brush Set",NOS,brush,9.99,9.99,7,150,TOP,noimage,brush.jpg,notes about brush set
D010,"Deluxe Hand Saw",NOS,SAW,17.99,17.99,16,50,TOP,saw.jpg,nodrawing,notes about hand saw
D011,"Digger Hand Trencher",NOS,Picks & Hatchets,18.99,18.99,15,200,TOP,,nodrawing,notes about hand saw
System assigns a unique parts_id to each part imported or group created. Duplicates are not allowed and duplicate check is done on partnumber.
- To start the import process, click ‘Data Import–Parts’ in the menu. Following page will be displayed.

- Click ‘Browse’ to select your CSV file, mark the taxes applicable and select the account links (Defaults are enough most of the time) Click ‘Continue’ when done. You will be presented with the following screen.

- On this screen you can mark the parts to be imported by checking or un-checking the checkbox on each line.
Please note:
1. The parts which are already in the system (based on partnumber) will not imported. (You will not see a check box with them)
2. Parts groups which are new will be added. These are marked by a ‘+’ sign after group name.
- Click ‘Import Parts’. Your CSV file will be processed and parts will be imported. Any new groups will also be added. You will see an output like the following:
|
|