Quercus: Drupal

From Resin 3.0

(Difference between revisions)
Jump to: navigation, search
 
(5 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>
−
<pre>
+
# Create the directory /var/www/hosts/drupal.example.com/webapps/ROOT/WEB-INF/lib
−
<web-app xmlns="http://caucho.com/ns/resin">
+
# Download MySQL Connector/J 5.1.6 (http://dev.mysql.com/downloads/connector/j/5.1.html)
−
  <database jndi-name="jdbc/drupal">
+
# 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
−
    <driver type="com.mysql.jdbc.jdbc2.optional.MysqlConnectionPoolDataSource">
+
# Create the following /var/www/hosts/drupal.example.com/webapps/ROOT/WEB-INF/resin-web.xml:
−
      <url>jdbc:mysql://localhost:3306/drupal</url>
+
#:<pre>
−
      <user>root</user>
+
#:<web-app xmlns="http://caucho.com/ns/resin">
−
      <password></password>
+
#:  <welcome-file-list><welcome-file>index.php</welcome-file></welcome-file-list>
−
    </driver>
+
#:
−
  </database>
+
#:  <rewrite-dispatch>
−
+
#:    <dispatch regexp="\.(php|gif|css|jpg|png|ico|js)"/>
−
  <servlet servlet-name="php"
+
#:    <forward regexp="^/" target="/index.php?q="/>
−
            servlet-class="com.caucho.quercus.servlet.QuercusServlet">
+
#:  </rewrite-dispatch>
−
    <init database="jdbc/drupal"/>
+
#:</web-app></pre>
−
  </servlet>
+
# Run <pre>java -jar /usr/local/share/resin-3.1.6/lib/resin.jar -conf /etc/resin/resin.conf start</pre>
−
+
# Browse to <nowiki>http://drupal.example.com:8080</nowiki> and set up Drupal according to the online directions
−
    <servlet-mapping url-pattern="*.php" servlet-name="php"/>
+
−
 
+
−
  <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>
+
−
</pre>
+
−
 
+
−
== clean URLs ==
+
−
 
+
−
You may need to modify the settings.php to force clean URLs
+
−
 
+
−
  $conf['clean_url'] = 1;
+

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








Retrieved from "http://wiki3.caucho.com/index.php?title=Quercus:_Drupal&oldid=3374"

						
			

		

	

		

		

	
	

		
Personal tools