Installation

This README assumes that you have install a configured your server with a working Apache/Nginx. The stack should be optimized to run a Drupal site.

Dependencies

• Drush 6.1.0

Production

drush make https://raw.github.com/loopdk/profile/release-1.0.0/drupal.make htdocs

Development

If you want a developer version with working copies of the Git repositories, run this command instead.

drush make --working-copy https://raw.github.com/loopdk/profile/release-1.0.0/drupal.make htdocs

Installing Loop

After running the make file you should install the site as any other Drupal website.

First, create a database (loop) and a database user (loop) with access to the database

mysql --user=root --password --host=localhost
[enter root password]
create database `loop`;
create user 'loop'@'localhost' identified by 'loop';
grant all privileges on `loop`.* to 'loop'@'localhost';
quit

Now you can sign into Loop as admin with password admin – remember to change this!

By default only the core features are enabled so you should visit the features overview and enable any additional features you would need.

Setup for development

Enable the Loop example content feature and create a demo user account.

Download and enable the Devel module and use this for generating content:

drush --yes dl devel
drush --yes pm-enable devel_generate

Create taxonomi terms like this:

drush generate-terms keyword 10
drush generate-terms profession 10
drush generate-terms subject 10

Create 10 posts with (at most) 2 comment each like this:

drush generate-content --types=post 10 2

Apache Solr

Loop uses Apache Solr for searching (and indexing) content using the "Search API Solr Search" module.

The default Solr server settings are

  host: localhost
  port: 8983
  path: /solr/loop

After installing Loop these settings should be changed to match the actual Solr server setup (go to /admin/config/search/search_api) and edit the server named "Default").

See Installing Apache Solr below for details on how to get Solr up and running on your server.

Adding taxonomies

After installing the Loop profile you should create some taxomony terms in the vocabularies Keyword, Profession and Subject. At lease one term must be defined in the Subject vocabulary before users can create new posts.

Go to /admin/structure/taxonomy to add terms to the vocabularies.

As an alternative to manually creating terms, you can install the module Loop taxonomy terms (loop_taxonomy_terms) and get the default Loop taxonomy terms.

Installing Apache Solr

These script below will

• install Apache Solr 4.9.1 (as a Tomcat servlet) running on port 8983 and
• create a Solr core named "loop"

Change "8983" and "loop" as needed.

# Install tomcat7
sudo apt-get update
sudo apt-get install -y tomcat7

# Install Solr
cd ~
wget http://archive.apache.org/dist/lucene/solr/4.9.1/solr-4.9.1.tgz -O solr.tgz
tar xzf solr.tgz
rm solr.tgz
sudo cp solr-*/example/lib/ext/* /usr/share/tomcat7/lib/
sudo cp solr-*/dist/solr-*.war /var/lib/tomcat7/webapps/solr.war
sudo cp -R solr-*/example/solr /var/lib/tomcat7
rm -rf solr-*
cd -

# Make Solr run on post 8983 (rather than 8080)
sudo sed -i '/\<Connector port="8080" protocol="HTTP\/1.1"/c \<Connector port="8983" protocol="HTTP\/1.1"' /var/lib/tomcat7/conf/server.xml

# Set file permissions
sudo chown -R tomcat7:tomcat7 /var/lib/tomcat7/solr

# Restart tomcat
sudo service tomcat7 restart

# Check that tomcat is running
curl http://localhost:8983/

Adding a Solr core

The first Loop Solr core can be created like this

# Create Solr core "loop"
sudo cp -r /var/lib/tomcat7/solr/collection1 /var/lib/tomcat7/solr/loop
sudo sed -i 's/collection1/loop/' /var/lib/tomcat7/solr/loop/core.properties

# Get Drupal Solr configuration and copy it into the Solr installion
cd ~
drush pm-download search_api_solr
sudo cp search_api_solr/solr-conf/4.x/* /var/lib/tomcat7/solr/loop/conf/
rm -rf search_api_solr
cd -

# Set file permissions
sudo chown -R tomcat7:tomcat7 /var/lib/tomcat7/solr

# Restart tomcat
sudo service tomcat7 restart

# Check that Solr is running and that we can access the core "loop"
curl 'http://localhost:8983/solr/loop/select?q=*%3A*&wt=json&indent=true'

Additional Loop Solr cores can be created as shown above or be created as copies of already existing cores:

# Create Solr core "loop_custom" as a copy of "loop"
sudo cp -r /var/lib/tomcat7/solr/loop /var/lib/tomcat7/solr/loop_custom
sudo sed -i 's/loop/loop_custom/' /var/lib/tomcat7/solr/loop_custom/core.properties

# Set file permissions
sudo chown -R tomcat7:tomcat7 /var/lib/tomcat7/solr

# Restart tomcat
sudo service tomcat7 restart

# Delete all data in the copied core
curl http://localhost:8983/solr/loop_custom/update --data '<delete><query>*:*</query></delete>' -H 'Content-type:text/xml; charset=utf-8'
curl http://localhost:8983/solr/loop_custom/update --data '<commit/>' -H 'Content-type:text/xml; charset=utf-8'

Reindexing all data

/admin/config/search/search_api/index/post