INSTALL

   1 == Installing Mwamko ==
   2
   3 1. Install the Free Software that Mwamko needs.
   4
   5    Read: ./DEPENDENCIES.
   6
   7
   8 2. Connect to Mwamko to your database manager.
   9
  10    There must be a database manager running on the system and
  11    Mwamko must be able to connect to it.
  12
  13    By default Mwamko is configured for PostgreSQL.
  14
  15    The following file will help: ./config/database.yml
  16
  17
  18 3. Create the databases that Mwamko will be using.
  19
  20    Databases must have names that a specified in: ./config/database.yml
  21
  22    By default the names are:
  23     * mwamko_development
  24     * mwamko_test
  25     * mwamko_production
  26
  27    If you have PostgreSQL then use the commands:
  28     * createdb
  29     * createuser
  30     * psql
  31
  32    You should also create a separate Linux user (e.g. "postgres")
  33
  34    See the following link to learn how to configure permissions
  35      http://www.postgresql.org/docs/8.2/interactive/ddl-priv.html
  36
  37    NOTE: Mwamko hoping to develop documentation or automatic features
  38          that will assist you in these tasks.
  39
  40 4. Populate the databases.
  41
  42    Run:
  43      rake db:migrate VERSION=1000 RAILS_ENV=development
  44      rake db:migrate VERSION=1000 RAILS_ENV=test
  45      rake db:migrate VERSION=1000 RAILS_ENV=production
  46
  47 5. Use the Rails console to a new Mwamko user account.
  48
  49    Run:
  50      ./script/console
  51
  52    In there run:
  53      u = User.new
  54      u.name = "your@email.org"
  55      u.password = "yourpassword"
  56      u.password_confirmation = "yourpassword"
  57      u.save!
  58
  59
  60 6. Now run:
  61
  62    ./script/mwamko start
  63
  64
  65 7. Point your browser to http://localhost:7000 and login.