Wagn: how pioneers roll
Basics
Wagn is an open web platform for building coherent web systems.
Using simple wiki-inspired building blocks called cards, “Wagneers” construct sites ranging from simple content managers to custom project trackers to fully integrated web suites.
System Requirements
- Ruby
-
version 1.8.7 or higher
- Bundler
-
version 1.0 or higher
- ImageMagick
- A database engine
-
Either MySQL or PostgreSQL
Installation
1. install the gem
gem install wagn
Watch carefully for errors!
2. create a new wagn application
wagn new mysite
3. create / seed database
Edit the config/database.yml file as necessary. More about database configuration at www.wagn.org/database_configuration.
Then run
cd mysite
wagn seed
..to create and seed the database
4. start your server
To fire up the default, built-in WEBrick server, just run:
wagn server
…and point your browser to localhost:3000 (unless otherwise configured).
WEBrick is great for a quick test run. To run a production website, see www.wagn.org/wagn_in_production.
Upgrading
Standard Upgrades
1. Backups
Always back up your database and uploaded files.
2. Update Libraries
From your wagn root directory run:
bundle update
3. Update Database
Run the following:
wagn update
4. Restart your server.
Upgrading pre-gem Wagn sites
First check the Wagn version of your existing site.
Version 1.10 or newer
-
Create a new Wagn app using steps 1 and 2 from the installation section above.
-
Copy config/database.yml from the old site to the new one.
-
Copy the old local/files contents to the new “files” directory.
-
If you have edited wagn.yml in your old site, make the corresponding changes to the new config/application.rb file.
-
Follow the standard upgrade procedure above.
Older than Version 1.10
First update your Wagn to version 1.10 via the old update mechanisms, and then follow the directions above.
More Resources
Find lots more info at wagn.org