Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
Browse files

Updates recipes for 1.2 series. Elaborates on installation methods

git-svn-id: svn://cherokee-project.com/cherokee/trunk@6356 5dc97367-97f1-0310-9951-d761b3857238
  • Loading branch information...
commit 69860fe13ca1d4807aaa32b486f025a6e7c75c70 1 parent 4fc63e9
taher authored
View
12 doc/Makefile.am
@@ -266,6 +266,17 @@ media/images/cookbook_zend1.png \
media/images/cookbook_joomla.png \
media/images/cookbook_https_accelerator_handler.png \
media/images/cookbook_https_accelerator_sources.png \
+media/images/cookbook_drupal_dir_rules_1.png \
+media/images/cookbook_drupal_dir_rules_2.png \
+media/images/cookbook_drupal_dir_rules_3.png \
+media/images/cookbook_drupal_dir_rules_4.png \
+media/images/cookbook_drupal_dir_rules_6.png \
+media/images/cookbook_drupal_dir_rules_7.png \
+media/images/cookbook_drupal_dir_rules.png \
+media/images/cookbook_drupal_vserver_rules.png \
+media/images/cookbook_wp_example1.png \
+media/images/cookbook_wp_example2.png \
+media/images/cookbook_wp_example3.png \
media/images/proxy_phase1.png \
media/images/proxy_phase2.png \
media/images/screencast.png \
@@ -275,7 +286,6 @@ media/images/other_graphs_conns.png \
media/images/other_graphs_logging.png \
media/images/other_graphs_traffic.png
-
EXTRA_DIST = \
$(doc_DATA) \
$(docmediacss_DATA) \
View
177 doc/cookbook_joomla.txt
@@ -1,138 +1,40 @@
== link:index.html[Index] -> link:cookbook.html[Cookbook]
///////////////////////////////////////////////////////////////////
Last checked:
-* Cherokee 1.0.1b
+* Cherokee: 1.2.0
* Joomla 1.5.16 stable
-* Joomla 1.6.0 beta1
+* 2011/02/23
///////////////////////////////////////////////////////////////////
Cookbook: Setting up Joomla
---------------------------
Setting up link:http://www.joomla.org/[Joomla] with Cherokee is really
-easy. A configuration wizard is provided that can either be used to
-install Joomla as a new dedicated Virtual Server, or to set it up
-inside a Directory.
+easy. Joomla is offered through the Cherokee Market and can be
+automatically installed as a new dedicated Virtual Server, or to set
+it up inside a Directory.
-This recipe contains three sections detailing how to:
-. Configure Cherokee for either installation mode using the Wizard.
+This recipe contains sections detailing how to:
+. Configure Cherokee for either installation mode using the Market.
. Install Joomla v1.5.14 which is the last one available at the time
of writing.
. Configure Cherokee manually.
-You don't need to worry about the manual installation. It is legacy
-documentation from the time when the wizards weren't available. Every
-step described there is taken care of by the wizard.
+[[market_configuration]]
+Configure Cherokee using the Market
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-[[wizard_configuration]]
-Configure Cherokee using the Wizard
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+The easiest way is to look for the application in the Market and
+follow the point and click interface.
-Two common scenarios are contemplated: installation on a dedicated
-virtual server (http://joomla.example.net/, for instance) or under a
-subdirectory on an existing virtual server (as could be
-http://example.net/joomla/).
-
-[[cherokee_vserver]]
-Setting up Joomla as a new Virtual Server
-^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
-
-The first step would be visiting the virtual server list page and
-clicking on the `Add` button at the top of the panel to show the list
-of available wizards.
-
-image::media/images/admin_vservers_wizard.png[Virtual Server Wizards]
-
-Now, you will have to select the `CMS` category, and run the Joomla
-wizard. At this stage the Joomla wizard will ask you for some basic
-parameters about the installation. It will try to auto-fill as many
-entries of the form as possible. For instance, if it finds Joomla
-installed in a standard location it will use that path as the default
-directory.
-
-The new virtual server will be created after this form is submitted.
-The virtual server configuration will cover the vast majority of the
-cases. Most probably it will cover your needs, although you are free
-to modify it as you will.
-
-[[cherokee_dir]]
-Setting up Joomla inside a Directory
-^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
-
-Joomla can also be configured inside a directory. Let's suppose we
-want to set up Joomla inside the `/blog` directory of one of our
-virtual servers.
-
-In this case, the first thing you will have to do is to enter the
-virtual server configuration you'd like to configure Joomla in. Once
-in there, visit the `Behavior` tab and trigger the `Rule panel` by
-clicking on the `Rule Management` button. Then, use the `Add` button
-at the top of the panel to see the available wizards:
-
-image::media/images/admin_vserver_wizard.png[Virtual Server Wizards]
-
-As in the previous case, this wizard will ask some very basic
-information, including the public web directory where Joomla will be
-set up and the local Joomla source directory.
-
-
-
-[[package_installation]]
-Installing Joomla
-~~~~~~~~~~~~~~~~~
-
-Once Cherokee is ready, only the database issue remains to be able to
-install Joomla. Log in to MySQL:
-
-----------------
-mysql -u root -p
-----------------
-
-And create the database for Joomla. We will be using the name
-'joomla', the user 'joomlauser' and the password 'joomlapassword', but
-you should set up your own.
-
-------------------------------------------------------------------------
-CREATE DATABASE joomla;
-GRANT ALL PRIVILEGES ON joomla.* TO joomlauser@localhost IDENTIFIED BY 'joomlapassword';
-GRANT ALL PRIVILEGES ON joomla.* TO joomlauser@localhost.localdomain IDENTIFIED BY 'joomlapassword';
-FLUSH PRIVILEGES;
-quit;
-------------------------------------------------------------------------
-
-Then point your web browser to `http://localhost/joomla` and follow
-the instructions provided by the Joomla installer.
-
-There is not much else you must do for Cherokee to work with
-Joomla. If you follow the Joomla installer's instructions -providing
-valid database information in most cases will suffice-, you will go
-thorough every step swiftly. Once you are done you will have to
-eliminate the `installation` subdirectory, as Joomla does not allow
-going any further until you do so as a security precaution. It is also
-a good idea to make the `cache` directory world writable.
-
------------------------------------
-rm -rf /var/www/joomla/installation
-chmod 777 /var/www/joomla/cache
------------------------------------
-
-image::media/images/cookbook_joomla.png[Joomla Demo]
-
-Now to set up Joomla. Visit
-link:http://localhost/administration[http://localhost/administration]
-and log in. Go to the `Global Configuration` option and enable all the
-*SEO Settings*, including the ones for Apache mod_rewrite.
-
-Mission accomplished. You can skip the rest of the document unless you
-want some more insight on what exactly has been done by the
-Cherokee-Admin Joomla Wizard.
+However, these are the steps for those wanting to install it manually.
[[manual_configuration]]
Configuring Cherokee manually
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-The wizard handles both series of Joomla, 1.5.x and 1.6.x. This manual
-process was documented for 1.5.x and does not work for 1.6.x.
+The Market can handle both series of Joomla, 1.5.x and 1.6.x. This manual
+process was documented for 1.5.x and might not work for 1.6.x.
You will need PHP support correctly configured in Cherokee, and PHP
with the MySQL module installed. For this you will require php-cgi
@@ -191,3 +93,52 @@ Each should be managed by a handler that returns an error:
After this you are done! Remember that all these settings are
refinements not really needed by Joomla to perform its basic
functions.
+
+[[package_installation]]
+Installing Joomla
+~~~~~~~~~~~~~~~~~
+
+Both Cheroee and the system have to be prepared for Joomla to be
+installed. The database issue can be taken care of with the following
+steps. Log in to MySQL:
+
+----------------
+mysql -u root -p
+----------------
+
+And create the database for Joomla. We will be using the name
+'joomla', the user 'joomlauser' and the password 'joomlapassword', but
+you should set up your own.
+
+------------------------------------------------------------------------
+CREATE DATABASE joomla;
+GRANT ALL PRIVILEGES ON joomla.* TO joomlauser@localhost IDENTIFIED BY 'joomlapassword';
+GRANT ALL PRIVILEGES ON joomla.* TO joomlauser@localhost.localdomain IDENTIFIED BY 'joomlapassword';
+FLUSH PRIVILEGES;
+quit;
+------------------------------------------------------------------------
+
+Then point your web browser to `http://localhost/joomla` and follow
+the instructions provided by the Joomla installer.
+
+There is not much else you must do for Cherokee to work with
+Joomla. If you follow the Joomla installer's instructions -providing
+valid database information in most cases will suffice-, you will go
+thorough every step swiftly. Once you are done you will have to
+eliminate the `installation` subdirectory, as Joomla does not allow
+going any further until you do so as a security precaution. It is also
+a good idea to make the `cache` directory world writable.
+
+-----------------------------------
+rm -rf /var/www/joomla/installation
+chmod 777 /var/www/joomla/cache
+-----------------------------------
+
+image::media/images/cookbook_joomla.png[Joomla Demo]
+
+Now to set up Joomla. Visit
+link:http://localhost/administration[http://localhost/administration]
+and log in. Go to the `Global Configuration` option and enable all the
+*SEO Settings*, including the ones for Apache mod_rewrite.
+
+Mission accomplished!
View
23 doc/cookbook_liferay.txt
@@ -1,13 +1,21 @@
== link:index.html[Index] -> link:cookbook.html[Cookbook]
///////////////////////////////////////////////////////////////////
Last checked:
-* Cherokee 0.99.25
+* Cherokee: 1.2.0
* Liferay
+* 2011/02/23
///////////////////////////////////////////////////////////////////
Cookbook: Setting up Liferay
----------------------------
+You could just use the automatic installer present in the Cherokee
+Market. It would download and install everything, and make the
+necessary adjustments for you, both to Cherokee and your system.
+
+But for those wanting to do everything manually, here is what you
+should do.
+
For this recipe we will be using
link:http://www.liferay.com/web/guest/downloads/portal[Liferay Portal
5.1.2 Standard Edition].
@@ -71,15 +79,7 @@ image::media/images/cookbook_liferay.png[Liferay]
[[Cherokee]]
Phase two: Cherokee
~~~~~~~~~~~~~~~~~~~
-
-Now to set up Cherokee. To do this, use the provided `Wizard`. Launch
-Cherokee-Admin on your proxy machine and then you will find this
-assistant under the `Platforms` category of the Wizards. Click, answer a few
-questions and you are done. You can then skip the rest of this
-document.
-
-Should you have any problem with the assistant, you can perform the
-same tasks manually. Simply set up Cherokee as reverse proxy. You can
+Simply set up Cherokee as reverse proxy. You can
either create a new virtual server with a matching rule (be it
`default` or anything else) if you are sharing the proxy machine, or
dedicate another machine to the Proxy Handler. This will be our
@@ -92,8 +92,7 @@ server running Liferay at port 8080.
Launch Cherokee-Admin on your proxy machine, create a rule that
matches the desired path on your web server hierarchy -`/liferay` for
instance- in your virtual server of choice, and define the `HTTP
-reverse proxy` handler from within the `Handler` tab. Make sure to
-enable the `Preserve Host` checkbox.
+reverse proxy` handler from within the `Handler` tab.
You will need to assign it an information source you define for the
server running Liferay. We will assume the IP is `192.168.1.100` in
View
83 doc/cookbook_moodle.txt
@@ -1,8 +1,9 @@
== link:index.html[Index] -> link:cookbook.html[Cookbook]
///////////////////////////////////////////////////////////////////
Last checked:
-* Cherokee 0.99.25
-* Moodle 1.9.5+
+* Cherokee: 1.2.0
+* Moodle 2.0
+* 2011/02/23
///////////////////////////////////////////////////////////////////
Cookbook: Setting up Moodle
@@ -20,50 +21,34 @@ requirements] at Moodle's site. Don't worry about this point. The
installer will detail exactly what are the missing modules, soy you
can install whatever you need during that part of the process.
-Cherokee can be configured in a breeze thanks to the provided Moodle
-Wizard.
+Cherokee can be configured in a breeze thanks to the Cherokee
+Market. After deploying it automatically you can feel free to manually
+tune whatever parameters you see fit, but no more intervention is
+really needed.
-[[wizard_configuration]]
-Configure Cherokee using the Wizard
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-
-[[cherokee_vserver]]
-Setting up Moodle as a new Virtual Server
-^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
-
-The first step would be to go to the virtual server list page. Then,
-click on the `Add` button at the top of the panel to show the list of
-available wizards.
-
-image::media/images/admin_vservers_wizard.png[Virtual Server Wizards]
-
-Then, select the `Misc` category, run the Moodle wizard and you are
-good to go.
-
-Feel free to manually tune whatever
-parameters you see fit, but no more intervention is needed.
-
-[[cherokee_dir]]
-Setting up Moodle inside a Directory
-^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+[[manual_configuration]]
+Setting up Moodle manually
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-Moodle can also be configured inside a directory. Let's suppose we
-want to set up Moodle inside the `/course` directory of one of our
-virtual servers.
+Using the Market is the recommended option to set up Moodle on
+Cherokee. However, should you wish to do it manually you will just
+need PHP support correctly configured in Cherokee. Please refer to the
+PHP Wizard or to the pertaining documentation section about
+link:cookbook_php.html[setting up PHP] in case you don't have it
+available for some reason.
-In this case, the first thing you will have to do is to enter the
-virtual server configuration you'd like to configure Moodle in. Once
-in there, click on the rule addition button and choose the `Moodle`
-wizard.
+Besides the PHP requirement, nothing else is needed on Cherokee's
+part.
-As in the previous case, this wizard will ask some very basic
-information, including the public web directory where Moodle will be
-set up and the local Moodle source directory.
+Simply set the `Document root` to `/var/www/moodle` and you are ready
+to go. This is done within the `Basics` tab of the chosen `Virtual
+Server`.
+image::media/images/cookbook_moodle_document_root.png[Moodle settings]
[[moodle]]
-Setting up Moodle
-~~~~~~~~~~~~~~~~~
+Moodle manula steps
+~~~~~~~~~~~~~~~~~~~
Of course, you will need to download Moodle from the
link:http://download.moodle.org/[download site] if you don't already
@@ -137,23 +122,3 @@ link:http://docs.moodle.org/en/Backup_settings[backup settings]. You
can find all the information to create new courses and everything else
there is to know in link:http://docs.moodle.org/[Moodle's
documentation].
-
-
-[[manual_configuration]]
-Setting up Cherokee manually
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-
-Using the wizard is the recommended option to set up Moodle on
-Cherokee. However, should you wish to do it manually you will just
-need PHP support correctly configured in Cherokee. Please refer to the
-PHP Wizard or to the pertaining documentation section about
-link:cookbook_php.html[setting up PHP] in case you don't have it
-available for some reason.
-
-Besides the PHP requirement, nothing else is needed.
-
-Simply set the `Document root` to `/var/www/moodle` and you are ready
-to go. This is done within the `Basics` tab of the chosen `Virtual
-Server`.
-
-image::media/images/cookbook_moodle_document_root.png[Moodle settings]
View
22 doc/cookbook_trac.txt
@@ -1,8 +1,9 @@
== link:index.html[Index] -> link:cookbook.html[Cookbook]
///////////////////////////////////////////////////////////////////
Last checked:
-* Cherokee 0.99.25
-* Trac 0.11.1
+* Cherokee: 1.2.0
+* Trac 0.12
+* 2011/02/23
///////////////////////////////////////////////////////////////////
Cookbook: Setting up Trac
@@ -53,26 +54,25 @@ installation instructions] on the official site.
Cherokee
~~~~~~~~
-
The configuration on Cherokee's side is quite simple. In fact, the
-configuration of Cherokee is so simple that you only have to click on
-the Trac Wizard with Cherokee-Admin. You will be asked for the minimal
-information required, and everything else will be handled for you.
+configuration of Cherokee is so simple that you can find the
+application in the Market and have it deployed within seconds. You
+will be asked for the minimal information required, and everything
+else will be handled for you.
By now, your Trac installation should be up and running. Try it out!
.Complete Trac installation
image::media/images/cookbook_trac.png[Trac]
-If you used the Wizard, you can skip the rest of the document. It only
-details what manual steps must be taken. You might find it interesting
-to know exactly what the wizard does for you, though.
+If you used the Market, you can skip the rest of the document. It only
+details what manual steps must be taken.
You will only need to know that you can spawn Trac as an SCGI process.
.Command to launch Trac
-------
-/usr/bin/tracd --single-env --protocol=scgi /
+/usr/bin/tracd --single-env --daemonize --protocol=scgi /
--hostname=localhost --port=4433 /path/to/project
-------
@@ -90,7 +90,7 @@ image::media/images/cookbook_trac_info.png[Information source]
[cols="20%,80%",options="header"]
|=========================================================================
|Host |Interpreter
-|localhost:4433 |/usr/bin/tracd --single-env --protocol=scgi \
+|localhost:4433 |/usr/bin/tracd --single-env --daemonize --protocol=scgi \
--hostname=localhost --port=4433 /path/to/project/
|=========================================================================
Please sign in to comment.
Something went wrong with that request. Please try again.