summaryrefslogtreecommitdiff
path: root/INSTALL
diff options
context:
space:
mode:
Diffstat (limited to 'INSTALL')
-rw-r--r--INSTALL37
1 files changed, 13 insertions, 24 deletions
diff --git a/INSTALL b/INSTALL
index ae2ba808..1a17118d 100644
--- a/INSTALL
+++ b/INSTALL
@@ -1,27 +1,27 @@
Installing LedgerSMB 1.2
-This document contains information on how to upgrade from earlier versions of
-LedgerSMB or SQL-Ledger. This upgrade is a major revision and may not go
-smoothly. We recommend that the reader start by reading the section on manual
-installation and then start by trying the automated means mentioned later.
+This document contains information on how to install LedgerSMB. We recommend
+that the reader start by reading the section on manual installation and then
+start by trying the automated means mentioned later.
Also this document assumes that the reader is already familiar with the release
notes. If you have not already done so, please read the release_notes file in
the doc/ directory.
-MANUAL UPGRADE:
+MANUAL INSTALL:
===============================================================================
1) Untar in desired location.
-2) Check New Dependencies
+2) Check Dependencies
The Build.PL script can be used to test for unmet dependencies and run other
tests. It doesn't install anything yet, but it will tell you what you are
missing. To check for dependencies, run "perl Build.PL" from the command line.
Missing dependencies can generally be installed via a Linux distributor's
-package manager or by CPAN.
+package manager or by CPAN. (Build.PL itself uses Module::Build, which is
+available in packages like perl-Module-Build or libmodule-build-perl.)
Once this is done and dependencies are satisfied, you can check to see whether
the installation nominally works by running "./Build test" from the command
@@ -33,28 +33,17 @@ and may not be required in all circumstances. These include:
* Net::TCLink for credit card processing in a POS environment
* Parse::RecDescent for the CLI script host
-3) Install database
-
- a) cd to the sql/legacy/ directory of the new ledger directory
- b) run "psql" with appropriate options to connect to your database.
- c) Note the db version by running the following query:
- "SELECT version FROM defaults;"
- d) Run the SQL upgrade scripts in order starting with the one whose name
- begins with "Pg-database" (each of these scripts will upgrade to
- the next database version which is also identified in the file name).
-
-Note that this will create three tables that may not actually be used depending
-on your setup: users, users_conf, and session. In general if you have multiple
-datasets, these tables will only be used in one.
-
-4) Decide where to put the user/session management tables. In general, we
+3) Decide where to put the user/session management tables. In general, we
recommend as follows:
a) Single dataset installations should use the user tables in the dataset.
b) Multicompany installations should use user tables in a separate dataset
from any accounting data.
-If you need to create another dataset, you can create the db and import the
-sql/Pg-central.sql file into it.
+4) Create central database
+
+ a) cd to the sql/ directory of the new ledger directory.
+ b) run "psql" with appropriate options to connect to your database.
+ c) Run the SQL script Pg-central.sql.
5) Set the admin password:
a) From psql, determine what admin password you wish to use. Then type: