This README assumes that you are running a Debian based system and have configured your server with a working Apache/Nginx & MySQL. The stack should be optimized to run a Drupal site.
Loop uses Apache Solr for searching (and indexing) content using the "Search API Solr Search" module. See the section on Apache Solr for installation instructions.
For installation and setup you should have drush and unzip installed, if not run:
sudo apt-get install drush
sudo apt-get install unzip
Check out the notes on the Loop saml module if it's installed.
See Upgrading an old Loop installation for details on how to upgrade existing Loop installations.
- Apache/Nginx
- MySQL/MariaDB/Etc.
- Apache Solr
- Drush 6.1.0
- Unzip (used by the make-files)
drush make https://raw.github.com/os2loop/profile/main/drupal.make htdocs
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/os2loop/profile/develop/drupal.make htdocs
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 or use an exiting 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
Then install Drupal either by visiting the site or using drush.
Now you can sign into Loop with the admin credentials you selected during install.
By default only the core features are enabled so you should visit the features overview and enable any additional features you would need.
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
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.
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.
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 and Java 7
sudo apt-get update
sudo apt-get install -y tomcat7 openjdk-7-jre
# Make Tomcat run on post 8983 (rather than 8080)
sudo sed --in-place '/\<Connector port="8080" protocol="HTTP\/1.1"/c \<Connector port="8983" protocol="HTTP\/1.1"' /var/lib/tomcat7/conf/server.xml
# Make Tomcat use Java 7
sudo sed --in-place 's@.*JAVA_HOME.*@JAVA_HOME=/usr/lib/jvm/java-7-openjdk-amd64@' /etc/default/tomcat7
# Restart tomcat
sudo service tomcat7 restart
# Check that tomcat is running (expect "HTTP/1.1 200 OK")
curl --head http://localhost:8983/
# 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 -
# Set file permissions
sudo chown -R tomcat7:tomcat7 /var/lib/tomcat7/solr
# Restart tomcat
sudo service tomcat7 restart
# Check that solr is running on tomcat (expect "HTTP/1.1 200 OK")
curl --head http://localhost:8983/solr/
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" (expect "HTTP/1.1 200 OK")
curl --head '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'
/admin/config/search/search_api/index/post