¶ ↑
Wagn: how pioneers roll¶ ↑
BasicsWagn 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 gemgem install wagn
Watch carefully for errors!
¶ ↑
2. create a new wagn applicationwagn new mysite
¶ ↑
3. create / seed databaseEdit 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 serverTo 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. BackupsAlways back up your database and uploaded files.
¶ ↑
2. Update LibrariesFrom your wagn root directory run:
bundle update
¶ ↑
3. Update DatabaseRun the following:
wagn update
¶ ↑
4. Restart your server.¶ ↑
Upgrading pre-gem Wagn sitesFirst 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.10First update your Wagn to version 1.10 via the old update mechanisms, and then follow the directions above.
¶ ↑
More ResourcesFind lots more info at wagn.org