Permalink
Browse files

First part of InstallProdStable

  • Loading branch information...
1 parent 2f73102 commit a2add0bb7968d8e7fdd2ae0bf6a76e58dab6b5c8 @benjaminvialle benjaminvialle committed May 25, 2011
Showing with 107 additions and 23 deletions.
  1. +43 −0 ApacheMongrel.rst
  2. +1 −1 Passenger.rst → ApachePassenger.rst
  3. +1 −1 Home.rst
  4. +62 −21 InstallProdStable.rst
View
@@ -0,0 +1,43 @@
+================================================================================
+Configuration of Apache with Mongrel
+================================================================================
+Configure the MarkUs application in
+\<MarkUs-APP-Root\>/config/environments/production.rb (see our MarkUs
+[configuration documentation](wiki:InstallProd#Configure) below). **Note:**
+Please change the "secret" in the cookies related configuration section in
+config/environment.rb of your MarkUs instance (see
+<http://api.rubyonrails.org/classes/ActionController/Session/CookieStore.html>)
+
+Configure the mongrel cluster (see config/mongrel_cluster.yml) and start the
+mongrel servers::
+
+ mongrel_rails cluster::start # uses config settings defined in config/mongrel_cluster.yml
+
+The ``mongrel_cluster`` gem isn't really necessary. It is a nice utility for starting/stopping mongrels for your MarkUs app, though.
+For more information concerning mongrel clusters see: [http://mongrel.rubyforge.org/wiki/MongrelCluster](http://mongrel.rubyforge.org/wiki/MongrelCluster).
+
+Configure an httpd VirtualHost similar to the following (Reverse-Proxy-Setup)::
+
+ RewriteEngine On
+
+ # define proxy balancer
+ <Proxy balancer://mongrel_cluster>
+ BalancerMember http://127.0.0.1:8000 retry=10
+ BalancerMember http://127.0.0.1:8001 retry=10
+ BalancerMember http://127.0.0.1:8002 retry=10
+ </Proxy>
+
+
+ DocumentRoot /opt/markus/\<MarkUs-APP-Root\>/public
+ <Directory />
+ Options FollowSymLinks
+ AllowOverride None
+ </Directory>
+ <Directory /opt/markus/\<MarkUs-APP-Root\>/public>
+ Options Indexes FollowSymLinks MultiViews
+ AllowOverride None
+ Order allow,deny
+ allow from all
+ </Directory>
+ RewriteCond %{DOCUMENT_ROOT}/%{REQUEST_FILENAME} !-f
+ RewriteRule ^/(.*)$ balancer://mongrel_cluster%{REQUEST_URI} [P,QSA,L]
@@ -1,5 +1,5 @@
================================================================================
-How to use Phusion Passenger instead of Mongrel
+Configuration of Apache with Phusion Passenger
================================================================================
Passenger is not interesting when you are in development mode. It is only
View
@@ -269,7 +269,7 @@ MarkUs Deployment Documents (Installation Instructions for MarkUs using RAILS_EN
* [[Setup Instructions for MarkUs Stable (MarkUs 0.9.5)|InstallProdStable]]
* [[Hosting several MarkUs applications on one machine (for Production)|MultipleHosting]]
* [[How to use LDAP with MarkUs|LDAP]]
-* [[How to use Phusion Passenger instead of Mongrel|Passenger]]
+* [[How to use Phusion Passenger instead of Mongrel|ApachePassenger]]
* [[Old Setup Instructions for MarkUs Stable (MarkUs 0.5, 0.6, 0.7 and 0.8 branches)|InstallProdOld]]
View
@@ -26,27 +26,68 @@ Required Software (including known to be working versions)
We know that the following versions work and believe that whatever version
"gem" provides by issuing "gem install package" should also work.
- * Ruby (>=1.8.7) including development package (e.g. ruby-dev)
- * net/https Ruby library ('libopenssl-ruby' Debian package)
- * Gem (>= 1.3.6) see [Update gem on Debian](wiki:UpdateRailsDebian)
-
- * rails (gem) (2.3.2)
- * daemons (gem) (1.0.10)
- * mongrel (gem) (1.1.5)
- * mongrel_cluster (gem) (1.0.5)
- * ruby-pg (gem) (>=0.7.9.2008.01.28)
- * postgres (gem) (>=0.7.9.2008.01.28)
- * fastercsv (gem) (>=1.4.0)
- * rake (gem) (0.8.7)
- * ya2yaml
- * ruby-debug (gem)
- * will_paginate (gem) (>=2.3.11)
-
- * PostgreSQL including libpq-dev (>= 8.2, but any PostgreSQL version should work; We also know that MarkUs works with MySQL)
- * Apache httpd (1.3/2.x) (including mod_proxy, mod_rewrite, Subversion server modules if using Subversion as a backend) Note: Any other Webserver with similar features should also work.
- * 'build-essential' Debian package (required to build/compile some gem packages from source)
- * 'subversion' and 'libsvn-ruby1.8' (Ruby bindings for Subversion) if using an SVN Repository as back-end
- * ImageMagick (>=6.5.7, older versions should be fine too) Only required if you plan to be able to view and annotate pdfs within the browser (PDF_SUPPORT setting in config files)
+* Ruby (>=1.8.7) including development package (e.g. ruby-dev) (see 'ruby-full'
+ Debian package)
+* net/https Ruby library ('libopenssl-ruby' Debian package)
+* Gem (>= 1.3.6)
+* PostgreSQL including libpq-dev (>= 8.2, but any PostgreSQL version should
+ work; We also know that MarkUs works with MySQL)
+* Apache httpd (1.3/2.x) (including mod_proxy, mod_rewrite, Subversion server
+ modules if using Subversion as a backend) Note: Any other Webserver with
+ similar features should also work.
+* 'build-essential' Debian package (required to build/compile some gem packages
+ from source)
+* 'subversion' and 'libsvn-ruby1.8' (Ruby bindings for Subversion) if using an
+ SVN Repository as back-end
+* ImageMagick (>=6.5.7, older versions should be fine too) Only required if you
+ plan to be able to view and annotate pdfs within the browser (PDF_SUPPORT
+ setting in config files)
+* Ant (any recent version) if you plan to use the Test Framework (still in
+ alpha) Don't forget to embed all tools you would need to complete your test
+ toolchain (like gcc, make,…)
+
+Issue the following command on a terminal.::
+
+ #> aptitude install ruby-full build-essential rubygems rake libsvn-ruby
+ subversion imagemagick ruby-dev libopenssl-ruby ant
+
+Install Bundler, a gem for managing gems. ::
+
+ #> gem install bundler
+
+**NOTE** Apache installation will not be described here. Only configuration
+will be.
+
+**NOTE** In Production, you MUST either use PostgreSQL or MySQL databases. NOT
+SQLite3
+
+
+Setting up the Database
+--------------------------------------------------------------------------------
+
+Once you have decided what database best suits you :
+
+* [[Setting up the Database (MySQL)|SettingUpMySQL]]
+* [[Setting up the Database (PostgreSQL)|SettingUpPostgreSQL]]
+
+
+Get MarkUs
+--------------------------------------------------------------------------------
+
+[[Get latest stable release |
+http://www.markusproject.org/download/markus-latest-stable.tar.gz]]
+
+Extract it and setup all gems with bundler.
+
+
+Setting up the Rack Server
+--------------------------------------------------------------------------------
+
+Once you have decided what rack server best suits you :
+
+* [[Setting up Apache with Mongrel|ApacheMongrel]]
+* [[Setting up Apache with Passenger|ApachePassenger]]
+
Installation Proceedings (using a PostgreSQL database)
--------------------------------------------------------------------------------

0 comments on commit a2add0b

Please sign in to comment.