sql-ledger/sql-ledger/doc/UPGRADE-2.2.7-2.4.0

   1 Upgrading to version 2.4.0
   2
   3 1. install SQL-Ledger over top
   4    # cd /usr/local
   5    # tar zxvf sql-ledger-2.4.0.tar.gz
   6
   7 2. fix permissions
   8    # chown -hR nobody:nogroup *
   9    # chmod 711 templates users spool
  10
  11 replace nobody:nogroup with your web server user and group
  12
  13 3. install the plpgsql language compiler for PostgreSQL
  14    # createlang plpgsql <dataset>
  15
  16 4. install plpgsql in template1
  17    # createlang plpgsql template1
  18
  19 5. Edit your templates! The old address fields are obsolete.
  20
  21 The new fields are:
  22   address1
  23   address2
  24   city
  25   state
  26   zipcode
  27   country
  28
  29 The same applies to the "shipto" addresses.
  30
  31 Before you log in edit Pg-upgrade-2.3.4-2.3.5.sql and change the
  32 way addresses are rewritten if you don't want US style addresses.
  33
  34 North-american addresses are usually in the form of
  35
  36 Five Star Stables
  37 123 Horsehoe Blvd.
  38 Sweetgrass, MT 19867
  39 U.S.A
  40
  41 addr1 --> address1
  42 addr2 --> city
  43 addr3 --> country
  44 addr4 --> state
  45
  46 addr4 was put into the state field to bring the field forward
  47 to the new layout. To check if there is something in the field run
  48 a report and sort by the "State" field.
  49
  50 Either edit the records or run the SQL queries below to take them apart.
  51
  52 If you have anything in the "state" field change the records to match
  53 the others before you run the following queries.
  54
  55 dbname=# update customer set state = substr(city,strpos(city,' ')+1);
  56 dbname=# update customer set zipcode = substr(state,strpos(state,' ')+1);
  57 dbname=# update customer set state = substr(state,1,strpos(state,' ')-1);
  58 dbname=# update customer set city = substr(city,1,strpos(city,',')-1);
  59
  60 do the same with the vendor and shipto table.
  61
  62 6. create a new set of templates
  63
  64   * load admin.pl and edit one of the user's
  65   * in the "New Templates" field enter "new" and save the user
  66   * go back in your browser so you have the same screen again
  67     as before
  68   * change the template directory back to what it was before
  69     the change and save the user
  70
  71   * drop into a shell window
  72   * cd to sql-ledger/templates/new
  73   * copy the additional templates to your private template directory
  74
  75 7. Printers
  76
  77 printer setup has changed to multiple printers which allow
  78 users to choose a printer. Printers can be defined in sql-ledger.conf
  79
  80
  81 Oracle and DB2:
  82 ===============
  83 There is no upgrade available for Oracle and DB2 yet.
  84