Drupal.Org Local Install Guide for Redesign Implementers

Events happening in the community are now at Drupal community events on www.drupal.org.
You are viewing a wiki page. You are welcome to join the group and then edit it. Be bold!

Requirements

PHP 5.2 or later
Java 1.5 or later

1. Checkout the latest version of Drupal from the redesign SVN branch.

cd to the directory you would like to install the site in.

Create an empty database and update settings.php as you would for any other site.

2. Security

If you are using a public-facing computer, you must pasword-protect your site using htpassword. You are responsible for making sure your development version of drupal.org is not publicly accessible.

Add the following lines to your .htaccess file.

AuthUserFile /path/to/protected/directory/.htpasswd
AuthGroupFile /dev/null
AuthName "Drupal.org local development"
AuthType Basic
require valid-user

Then cd to the directory above in AuthUserFile to create the .htpasswd file. Replace username with the desired username. You will be prompted to set a password and confirm it.

htpasswd -c /path/to/drupal/.htpasswd username

Test the password protection and make sure it works. You are responsible for making sure your development version of drupal.org is not publicly accessible

3. Download the exported database and import it into your site.

The database is available from the drupal.org redesign administrators. In order to get the database, you must be on the task list (http://groups.drupal.org/node/37064) or otherwise have a valid reason to request it. Do not distribute the database.

You can import the database directly from the gzip file like this.

gunzip <  /path/to/tinydrupalorg.mysql.gz | mysql -u root -proot > localdrupalorgdatabasename

On windows, you can use 7zip and import it like this:

"c:\path\to\7-Zip\7z" e -so tinydrupalorg.mysql.gz | C:\path\to\mysql tinydrupal -u root -p

You can also just unpack the database and install it directly.

mysql -u root -proot  localdrupalorgdatabasename < tinydrupalorg.mysql

Be patient, the database may take a long time to import. On a linux box it took about 20 minutes. On a older windows laptop it took a looooong time.

If possible you should change your local my.cnf file's settings (which unfortunately doesn't live in a consistent place)

innodb_buffer_pool_size = 64M
innodb_additional_mem_pool_size = 8M
# Set .._log_file_size to 25 % of buffer pool size
innodb_log_file_size = 16M
innodb_log_buffer_size=8M

The above settings will speed up the import by a factor of 4 - and also make the site run faster locally.

4. Log in

Get the username and password from whoever gave you the database.

5. Go to admin/settings/performance and turn off caching and clear cache.

6. Apache Solr

The Solr index is available from the drupal.org redesign administrators. In order to get the database, you must be on the task list (http://groups.drupal.org/node/37064) or otherwise have a valid reason to request it. Do not distribute the database.

Once downloaded, unpack the database.

You must check your version of Java. You must have 1.5 or later.

java -version

Installing Java

Windows: If you don't have the right version you can download it from http://java.sun.com/javase/downloads/index.jsp.

OSX
Apple Computer supplies their own version of Java. Use the Software Update feature (available on the Apple menu) to check that you have the most up-to-date version of Java for your Mac.

Linux
Packages are usually available. Debian instructions below.

Installing Java on Debian

Open /etc/apt/sources.list

deb http://www.backports.org/debian/ etch-backports main contrib non-free

Then
aptitude update
aptitude install sun-java6-jre

Once Java is installed start Solr

If using Linux or OSX:

Inside the unpacked tinydrupalorg-solr directory you'll find start.sh and stop.sh wrapper scripts to start and stop Solr within a jetty servlet on port 8983.

Run start.sh and visit http://localhost:8983/solr/admin/ to confirm that Solr is working. Solr will run in the background and can be stopped with stop.sh.

If using Windows:

cd to the tinydrupalorg-solr directory

java -jar start.jar

visit http://localhost:8983/solr/admin/ to confirm
that Solr is working

Visit in your tinydrupalorg install: ?q=admin/settings/apachesolr

Click "Reset to defaults" and then check off "Enable spellchecker and
suggestions" and submit. The default settings look for Solr running
locally on port 8983

Drupal.org Improvements

Group categories

Group notifications

This group offers an RSS feed. Or subscribe to these personalized, sitewide feeds: