File: getting_started.txt

# getting_started.txt

Path: | doco/getting_started.txt
Last Update: | Sat Aug 21 02:15:54 -0600 2010

## Quick Start for a 1-Server Solution:

### Setup

- Create a deploy file, usually in "config/deploy.rb":

        set :application, "project"
        set :domain, "example.com"
        set :deploy_to, "/path/to/install"
        set :repository, 'http://svn.example.com/project/branches/stable/'

This defaults to using ‘svn export’ from `repository`, and a single server for `app`, `db`, and `www`. If you need to tweak these things, refer to the variable documentation.

- If you want a multi-config environment, change your config like so:

        set :application, "project"
        set :repository, 'http://svn.example.com/project/branches/stable/'

        task :beta do
          set :domain,    "beta.example.com"
          set :deploy_to, "/path/to/install-beta"
        end

        task :dev do
          set :domain,    "dev.example.com"
          set :deploy_to, "/path/to/install-dev"
        end

        task :prod do
          set :domain,    "example.com"
          set :deploy_to, "/path/to/install"
        end

- Add the following to your Rakefile:

        begin
          require 'vlad'
          Vlad.load
        rescue LoadError
          # do nothing
        end

Vlad.load has a lot of flexibility. See the rdoc for full information.

You don‘t need the begin/rescue/end block if you ensure that Vlad is installed on all your servers. To be lazy, you can install vlad via:

        % rake vlad:invoke COMMAND='sudo gem install vlad -y'

### Initial Launch

- Run `rake vlad:setup vlad:update vlad:migrate vlad:start`

### Subsequent Updates:

- `rake vlad:update vlad:migrate vlad:start`

Each step may be run separately.

[Validate]