Quercus: Drupal

From Resin 3.0

(Difference between revisions)
Jump to: navigation, search
 
(12 intermediate revisions by 4 users not shown)
Line 1: Line 1:
[[Category:Quercus]]
+
[[Category: Quercus]]
  
[http://drupal.org Drupal], a forum/blog content management system, now works on Quercus (requires the latest snapshot or 3.0.18).  The [http://windansea.caucho.com Caucho Forum] is now running using Drupal.
+
=Running Drupal 6.2 on Resin 3.1.6=
  
== installation ==
+
==Requirements==
 +
# MySQL server
 +
# Java 1.5 or higher
  
Drupal requires [[JavaMail]] to send user confirmation and passwords.  You will need to download JavaMail from the Sun site and install it in resin/lib for Drupal to work.
+
==Quick start==
 +
Follow these instructions if you would simply like to evaluate running Drupal without doing a system-wide installation.
  
To install Drupal, just expand the Drupal .tar file into [[webapps]]/drupal (or [[webapps]]/ROOT).  From there, follow the Drupal documentation.   Essentially, you'll just need to:
+
# Download Drupal 6.2 from http://drupal.org/drupal-6.2
 +
# Download Resin 3.1.6 from http://www.caucho.com/download
 +
# Unzip Resin 3.1.6
 +
# Unzip Drupal and copy all files and directories to resin-3.1.6/webapps/ROOT
 +
# Create the Drupal database: <pre>mysql -u root</pre><pre>mysql> CREATE DATABASE drupal;</pre>
 +
# Create the directory resin-3.1.6/webapps/ROOT/WEB-INF/lib
 +
# Download MySQL Connector/J 5.1.6 (http://dev.mysql.com/downloads/connector/j/5.1.html)
 +
# Unzip MySQL Connector/J and place the mysql-connector-java-5.1.6-bin.jar in resin-3.1.6/webapps/ROOT/WEB-INF/lib
 +
# Create the following resin-3.1.6/webapps/ROOT/WEB-INF/resin-web.xml:
 +
#:<pre>
 +
#:<web-app xmlns="http://caucho.com/ns/resin">
 +
#:  <welcome-file-list><welcome-file>index.php</welcome-file></welcome-file-list>
 +
#:
 +
#:  <rewrite-dispatch>
 +
#:    <dispatch regexp="\.(php|gif|css|jpg|png|ico|js|html|htm|txt)"/>
 +
#:    <forward regexp="^/" target="/index.php?q="/>
 +
#: </rewrite-dispatch>
 +
#:</web-app></pre>
 +
# Run <pre>java -jar resin-3.1.6/lib/resin.jar</pre>
 +
# Browse to http://localhost:8080 and set up Drupal according to the online directions
  
* modify drupal/sites/default/settings.php (to set the expected URL)
+
==Full installation==
* create the database with 'mysql drupal < drupal/database/database.mysql'
+
Follow these instructions if you would like to perform a permanent installation with virtual hosts. Follow the above directions for a quick start evaluation.
* Add a drupal/WEB-INF/resin-web.xml to configure Quercus and modify the URLs
+
  
== resin-web.xml configuration file ==
+
# Download Drupal 6.2 from http://drupal.org/drupal-6.2
 
+
# Download Resin 3.1.6 from http://www.caucho.com/download
The [[resin-web.xml]] file is placed in [[webapps]]/drupal/WEB-INF/resin-web.xml.
+
# Unzip Resin 3.1.6 in /usr/local/share
 
+
# Copy /usr/local/share/resin-3.1.6/conf/resin.conf to /etc/resin/resin.conf
Configuring the <[[database]]> is optional, but allows you complete control over the database connections Drupal uses. If you do not configure the <[[database]]>, Quercus will create a new database pool automatically.
+
# Edit /etc/resin/resin.conf to change the host-deploy directory:<pre><host-deploy path="/var/www/hosts"></pre>
 
+
# Create a virtual host directory for your domain:<pre>/var/www/hosts/drupal.example.com/webapps/ROOT</pre> (in this example, the domain is drupal.example.com)
The <[[rewrite-dispatch]]> lets you use clean URLs, so your paths will look like http://windansea.caucho.com/forum instead of http://windansea.caucho.com/index.php?q=forum
+
# Unzip Drupal and copy all files and directories to /var/www/hosts/drupal.example.com/webapps/ROOT
 
+
# Create the Drupal database: <pre>mysql -u root</pre><pre>mysql> CREATE DATABASE drupal;</pre>
<web-app xmlns="http://caucho.com/ns/resin">
+
# Create the directory /var/www/hosts/drupal.example.com/webapps/ROOT/WEB-INF/lib
  <database jndi-name="jdbc/drupal">
+
# Download MySQL Connector/J 5.1.6 (http://dev.mysql.com/downloads/connector/j/5.1.html)
    <driver type="com.mysql.jdbc.jdbc2.optional.MysqlConnectionPoolDataSource">
+
# Unzip MySQL Connector/J and place the mysql-connector-java-5.1.6-bin.jar in /var/www/hosts/drupal.example.com/webapps/ROOT/WEB-INF/lib
      <url>jdbc:mysql://localhost:3306/drupal</url>
+
# Create the following /var/www/hosts/drupal.example.com/webapps/ROOT/WEB-INF/resin-web.xml:
      <user>root</user>
+
#:<pre>
      <password></password>
+
#:<web-app xmlns="http://caucho.com/ns/resin">
    </driver>
+
#:  <welcome-file-list><welcome-file>index.php</welcome-file></welcome-file-list>
  </database>
+
#:
+
#:  <rewrite-dispatch>
  <servlet servlet-name="php"
+
#:    <dispatch regexp="\.(php|gif|css|jpg|png|ico|js)"/>
            servlet-class="com.caucho.quercus.servlet.QuercusServlet">
+
#:    <forward regexp="^/" target="/index.php?q="/>
    <init database="jdbc/drupal"/>
+
#:  </rewrite-dispatch>
  </servlet>
+
#:</web-app></pre>
+
# Run <pre>java -jar /usr/local/share/resin-3.1.6/lib/resin.jar -conf /etc/resin/resin.conf start</pre>
    <servlet-mapping url-pattern="*.php" servlet-name="php"/>
+
# Browse to <nowiki>http://drupal.example.com:8080</nowiki> and set up Drupal according to the online directions
 
+
  <welcome-file-list><welcome-file>index.php</welcome-file></welcome-file-list>
+
+
  <rewrite-dispatch>
+
    <dispatch regexp="\.(php|gif|css|jpg|png|ico|js)"/>
+
    <forward regexp="^/" target="/index.php?q="/>
+
  </rewrite-dispatch>
+
</web-app>
+

Latest revision as of 21:10, 2 July 2009


Contents

Running Drupal 6.2 on Resin 3.1.6

Requirements

  1. MySQL server
  2. Java 1.5 or higher

Quick start

Follow these instructions if you would simply like to evaluate running Drupal without doing a system-wide installation.

  1. Download Drupal 6.2 from http://drupal.org/drupal-6.2
  2. Download Resin 3.1.6 from http://www.caucho.com/download
  3. Unzip Resin 3.1.6
  4. Unzip Drupal and copy all files and directories to resin-3.1.6/webapps/ROOT
  5. Create the Drupal database:
    mysql -u root
    mysql> CREATE DATABASE drupal;
  6. Create the directory resin-3.1.6/webapps/ROOT/WEB-INF/lib
  7. Download MySQL Connector/J 5.1.6 (http://dev.mysql.com/downloads/connector/j/5.1.html)
  8. Unzip MySQL Connector/J and place the mysql-connector-java-5.1.6-bin.jar in resin-3.1.6/webapps/ROOT/WEB-INF/lib
  9. Create the following resin-3.1.6/webapps/ROOT/WEB-INF/resin-web.xml:
    <web-app xmlns="http://caucho.com/ns/resin">
    <welcome-file-list><welcome-file>index.php</welcome-file></welcome-file-list>
    <rewrite-dispatch>
    <dispatch regexp="\.(php|gif|css|jpg|png|ico|js|html|htm|txt)"/>
    <forward regexp="^/" target="/index.php?q="/>
    </rewrite-dispatch>
    </web-app>
  10. Run
    java -jar resin-3.1.6/lib/resin.jar
  11. Browse to http://localhost:8080 and set up Drupal according to the online directions

Full installation

Follow these instructions if you would like to perform a permanent installation with virtual hosts. Follow the above directions for a quick start evaluation.

  1. Download Drupal 6.2 from http://drupal.org/drupal-6.2
  2. Download Resin 3.1.6 from http://www.caucho.com/download
  3. Unzip Resin 3.1.6 in /usr/local/share
  4. Copy /usr/local/share/resin-3.1.6/conf/resin.conf to /etc/resin/resin.conf
  5. Edit /etc/resin/resin.conf to change the host-deploy directory:
    <host-deploy path="/var/www/hosts">
  6. Create a virtual host directory for your domain:
    /var/www/hosts/drupal.example.com/webapps/ROOT
    (in this example, the domain is drupal.example.com)
  7. Unzip Drupal and copy all files and directories to /var/www/hosts/drupal.example.com/webapps/ROOT
  8. Create the Drupal database:
    mysql -u root
    mysql> CREATE DATABASE drupal;
  9. Create the directory /var/www/hosts/drupal.example.com/webapps/ROOT/WEB-INF/lib
  10. Download MySQL Connector/J 5.1.6 (http://dev.mysql.com/downloads/connector/j/5.1.html)
  11. Unzip MySQL Connector/J and place the mysql-connector-java-5.1.6-bin.jar in /var/www/hosts/drupal.example.com/webapps/ROOT/WEB-INF/lib
  12. Create the following /var/www/hosts/drupal.example.com/webapps/ROOT/WEB-INF/resin-web.xml:
    <web-app xmlns="http://caucho.com/ns/resin">
    <welcome-file-list><welcome-file>index.php</welcome-file></welcome-file-list>
    <rewrite-dispatch>
    <dispatch regexp="\.(php|gif|css|jpg|png|ico|js)"/>
    <forward regexp="^/" target="/index.php?q="/>
    </rewrite-dispatch>
    </web-app>
  13. Run
    java -jar /usr/local/share/resin-3.1.6/lib/resin.jar -conf /etc/resin/resin.conf start
  14. Browse to http://drupal.example.com:8080 and set up Drupal according to the online directions
Personal tools