Quercus: Drupal

From Resin 3.0

(Difference between revisions)
Jump to: navigation, search
(Noted the need for Connector/J)
 
(10 intermediate revisions by 3 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://forum.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.  This example also uses MySQL as Drupal's database.  In order to connect to MySQL through Java, you will need to download MySQL Connector/J and install the jar file in resin/lib.
+
==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

[edit] Running Drupal 6.2 on Resin 3.1.6

[edit] Requirements

  1. MySQL server
  2. Java 1.5 or higher

[edit] 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

[edit] 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