Quercus: Drupal

From Resin 3.0

(Difference between revisions)
Jump to: navigation, search
(→resin-web.xml configuration file)
 
(4 intermediate revisions by 2 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|htm|html)"/>
+
−
    <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

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








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

						
			

		

	

		

		

	
	

		
Personal tools