#summary How to install Substruct
= Installing Substruct =
== Introduction ==
This software package is developed using the Engines plugin. To find out more about how to use engines in general, go to http://rails-engines.org
*These directions assume you already have a working Rails hosting environment. This means...*
* A web server such as
* Webrick (included with Rails)
* Apache
* Lighttpd
* A rails app server
* Mongrel
* FastCGI
* MySQL / PGSql
* Ruby
* Rails
* Rubygems
These directions _also_ assume you have some familiarity with developing Rails applications in general and a working knowledge of your file system.
== Installation ==
=== 0. Install the following gems...Substruct needs them to function properly. ===
* RedCloth
* fastercsv
* mime-types
* mini_magick
* ezcrypto
{{{
gem install RedCloth
gem install fastercsv
gem install mime-types
gem install mini_magick
gem install ezcrypto
}}}
!! NOTE !! Be sure openssl is also installed. For Debian linux boxes this is _not_ included in the default Ruby installer. If you are running on debian it's as easy as typing 'apt-get install libopenssl-ruby1.8'
=== 1. Download & extract the latest release ===
All releases are stored as tar / gzipped files here:
http://code.google.com/p/substruct/downloads/list
They are marked with version numbers. Grab the latest one and extract it.
For instance, if you were working with release 0.97, you'd type the following on OS X and Linux
{{{
tar -xzvf substruct_rel_0-97.tar.gz
}}}
[GettingTheCode If you'd rather use SVN to download the latest code click here.]
=== 2. Set up your databases and edit your database.yml file ===
You'll need to have a running MySQL or PGSql instance, and create the proper databases for use.
We recommend the following:
* substruct_development
* substruct_test
* substruct_production
Edit your database.yml file to make sure that Rails can access your database properly.
For more information on the database.yml file, visit this url: http://wiki.rubyonrails.org/rails/pages/database.yml
=== 3. Initialize your database ===
Run this command from inside the substruct directory you extracted previously
{{{
rake substruct:db:bootstrap
}}}
== Usage ==
Fire up your environment!
{{{
ruby script/server
}}}
Try to login to http://localhost:3000/admin as ''admin'' / ''admin''
=== Misc ===
If you're going to be doing credit card transactions you need a processor account. [wiki:AuthorizeNet Check out how to get one.]
Make sure you check out [MaintainingSubstruct how to maintain Substruct via cron] as well.