summaryrefslogtreecommitdiff
path: root/INSTALL
diff options
context:
space:
mode:
authorMarcello Stanisci <marcello.stanisci@inria.fr>2016-03-15 09:49:16 +0100
committerMarcello Stanisci <marcello.stanisci@inria.fr>2016-03-15 09:49:16 +0100
commit964e8fa93877e1be51d1deb7a1c4817af2b384a9 (patch)
treee7093da78f31dac03143c469f4bb30476bf6c2ad /INSTALL
parentae4ce9ac189d61c731ba78a488f9dcaf8b1dbc37 (diff)
downloadbank-964e8fa93877e1be51d1deb7a1c4817af2b384a9.tar.gz
bank-964e8fa93877e1be51d1deb7a1c4817af2b384a9.tar.bz2
bank-964e8fa93877e1be51d1deb7a1c4817af2b384a9.zip
Further instructions to INSTALL the GNU way
Diffstat (limited to 'INSTALL')
-rw-r--r--INSTALL42
1 files changed, 38 insertions, 4 deletions
diff --git a/INSTALL b/INSTALL
index d53b84a..7f83974 100644
--- a/INSTALL
+++ b/INSTALL
@@ -1,5 +1,19 @@
================== HOW RUN THE PYTHON BANK =====================
+----------------------------0 Preface --------------------------
+
+In order to get the whole bank's codebase, a submodule needs to be
+pulled; so from the bank's top directory, run
+
+$ git submodule update --init
+
+(this submodule carries some HTML/JS code which is reused among all
+Taler's Web components)
+
+As for the database backend, the bank uses PostgreSQL and needs a
+database called 'talertest' in it, owned by the user which launches
+the bank
+
---------------------1 The Pythonic way ------------------------
Make sure your system has 'virtualenv' and 'pip' installed.
@@ -60,18 +74,38 @@ The '--prefix' option will point a directory which hosts both the virtualenv
data and the bank's website itself
$ ./configure
-$ make dependencies
+$ make
$ make install
+# PHONY for the following two?
$ make buildcss
-$ make builddb
+$ make definedb
+
+Though not strictly needed, the following step populates the database with
+sample data
+
+$ make populatedb
-If the previous steps was successful, then
+If the previous steps were successful, then
$ cd PFX/src # where PFX is the location of '--prefix'
$ ./taler-bank-wsgi.sh # this should launch the bank
Please note that the bank works properly only via nginx since it uses
-SSI includes
+SSI includes.
+
+To quickly run the bank without nginx, do
+
+$ source PFX/venv/bin/activate
+$ cd PFX/src
+$ python manage.py runserver 127.0.0.1:8000
+
+To laterly populate the database, do
+
+$ source PFX/venv/bin/activate
+$ cd PFX/src
+$ python manage.py pre_accounts
+$ python manage.py sample_data
+
----------------- 3 How to bind Django and nginx ---------------